Clave numérica de 50 dígitos y consecutivo

Son los dos números que identifican a cada factura, tiquete o nota que emitís. Se calculan en el momento de emitir y viajan dentro del XML:

• Consecutivo (NumeroConsecutivo): 20 dígitos. Es tu numeración interna —el «número de factura»— pero con un formato fijo que codifica la sucursal, la caja, el tipo de documento y el correlativo.
• Clave numérica (Clave): 50 dígitos. Es el identificador único del comprobante ante Hacienda. Contiene al consecutivo adentro y le agrega el país, la fecha, tu cédula, la situación y un código de seguridad.

Dicho fácil: el consecutivo es cómo numerás vos tus documentos; la clave es cómo los reconoce Hacienda. La clave es también el número con el que después consultás el estado del comprobante o lo buscás en la consulta pública.

La clave se lee por bloques de izquierda a derecha. Seis campos que suman exactamente 50 dígitos:

El código de seguridad de 8 dígitos es lo que hace que dos comprobantes del mismo emisor, con el mismo consecutivo y fecha, tengan claves distintas. La situación vale 1 en operación normal; solo cambia a 2 (contingencia) o 3 (sin internet) cuando emitís sin poder contactar a Hacienda en el momento.

El consecutivo también se lee por bloques. Cuatro campos que suman 20 dígitos, y aquí es donde la sucursal y la caja entran en juego:

La clave importa: cada combinación de sucursal + caja + tipo tiene su propia secuencia. La caja 1 de tu local puede ir por la factura 300 mientras la caja 2 va por la 45, y las notas de crédito llevan su propio contador aparte de las facturas. Si dos comprobantes del mismo tipo, misma sucursal y misma caja repiten número, Hacienda lo rechaza por consecutivo duplicado.

La estructura de la clave (50 dígitos) y del consecutivo (20 dígitos) la define Hacienda en el anexo técnico de comprobantes electrónicos, y es la misma para la versión 4.4, obligatoria desde el 1 de setiembre de 2025 (con prórroga desde junio). Reglas que Hacienda valida en la recepción:

• La clave siempre empieza con 506, tiene exactamente 50 dígitos y es única: no puede repetirse ninguna clave ya emitida.
• El consecutivo debe ser correlativo por sucursal, caja y tipo: sin saltarse números ni repetir. Un duplicado o un salto genera rechazo.
• La sucursal y la caja del consecutivo deben corresponder a puntos de venta registrados en tu perfil de contribuyente. Un código no registrado invalida el comprobante.
• El dígito de situación distingue emisión normal (1) de contingencia (2) o sin internet (3), que activan plazos especiales de envío.

Un consecutivo repetido o una clave mal formada es una de las causas frecuentes de rechazo de Hacienda, y deja el comprobante sin validez fiscal hasta que lo corrijás. Estos identificadores son parte de la estructura de la facturación electrónica 4.4 y viven en el mismo comprobante electrónico que después se firma. Si tenés dudas sobre cómo registrar sucursales y cajas ante Hacienda, confirmá con tu contador.

Vos nunca escribís los 50 ni los 20 dígitos a mano. Plaxp arma los dos identificadores por vos, a partir de tu configuración: toma tu cédula del emisor, los códigos de la sucursal y la caja que ya registraste, y el número correlativo. Con eso construye el consecutivo de 20 y la clave de 50, con los ceros a la izquierda y la fecha calculada en hora de Costa Rica (UTC-6) para que el día no se corra si emitís de noche.

• Lleva el correlativo por sucursal, caja y tipo — no repite ni salta números.
• Rellena los ceros a la izquierda de la cédula, la sucursal y la caja automáticamente.
• Genera el código de seguridad de 8 dígitos y pone la situación (1 normal) por vos.
• Calcula la fecha en hora de Costa Rica, así el DDMMAA de la clave nunca queda un día corrido.

Consecutivo (20)  →  001 00002 01 0000000245
                     └┬┘ └─┬─┘ └┤ └───┬────┘
                  sucursal caja tipo  número (#245)

Clave numérica (50)  →  506 170726 003101123456 00100002010000000245 1 48920175
                        └┬┘ └──┬─┘ └────┬─────┘ └────────┬─────────┘ │ └──┬───┘
                       país  fecha    cédula        consecutivo   situación  seguridad
                             DDMMAA   (12 díg)         (20 díg)      (1)      (8 díg)

Por API es igual de simple: mandás codigo_sucursal, codigo_caja, tipo_documento y el número de consecutivo, y Plaxp devuelve la clave ya armada en la respuesta HTTP 202. Desde el panel, ni eso: Plaxp toma el siguiente número de la caja solo.

curl -X POST 'https://api.plaxp.com/api/procesar' \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $PLAXP_API_KEY" \
  -d '{
    "tipo_documento": "01",
    "codigo_sucursal": "001",
    "codigo_caja": "002",
    "consecutivo": 245,
    "condicion_venta": "01",
    "medios_pago": [{ "tipo": "01", "monto": 56500 }],
    "lineas": [{ "codigo_cabys": "4759000000000", "detalle": "Taladro", "cantidad": 1, "precio_unitario": 50000, "codigo_tarifa": "08", "tarifa": 13 }]
  }'
# 202 → { data: { clave, consecutivo } }  ← clave de 50 dígitos ya armada

Esa misma clave es la que después usás para consultar el estado del comprobante. Y como cada clave que emitimos ya vino con su consecutivo correcto por caja, no vas a ver rechazos por consecutivo duplicado ni por sucursal equivocada. Los detalles del flujo por API están en la documentación de la API.