Clave y consecutivo
La clave numérica (50 dígitos)
La clave numérica es el identificador único oficial del comprobante. Sigue esta estructura:
506 15 01 26 003101123456 0010 0001 01 0000000123 4 56789012
└─┬─┘└┬─┘└┬─┘└┬─┘└────┬─────┘└─┬──┘└─┬──┘└┬─┘└──┬─────┘└┬─┘└──┬──┘
país día mes año cédula emisor sucursal punto tipo consec sit cód seg| Posición | Largo | Significado |
|---|---|---|
| 1–3 | 3 | Código país (506 Costa Rica) |
| 4–9 | 6 | Día, mes, año de emisión (DDMMAA) |
| 10–21 | 12 | Cédula del emisor (rellena con ceros) |
| 22–24 | 3 | Casa matriz |
| 25–28 | 4 | Punto de venta |
| 29–30 | 2 | Tipo de comprobante |
| 31–40 | 10 | Consecutivo |
| 41 | 1 | Situación (1=normal, 2=contingencia, 3=sin internet) |
| 42–50 | 9 | Código de seguridad aleatorio |
💡 LX CloudPos genera la clave automáticamente. Nunca debes construirla tú. Solo guárdala como referencia.
El consecutivo (20 dígitos)
Es la parte interna del emisor (posiciones 22–40 de la clave, sin los códigos de país y fecha). Estructura:
001 0001 01 0000000123
└┬─┘└─┬──┘└┬─┘└────┬────┘
casa punto tipo número secuencial💡 El consecutivo se incrementa automáticamente por tipo de comprobante. Cada tenant tiene su propia secuencia.
📖 Usa
GET /api/v1/consecutivos/proximopara ver cuál será el próximo número sin consumirlo.