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. No debe construirse desde el sistema integrador; únicamente debe almacenarse 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 secuencialEl consecutivo se incrementa automáticamente por tipo de comprobante. Cada tenant tiene su propia secuencia.
Puede utilizarse
GET /api/v1/consecutivos/proximopara consultar cuál será el próximo número sin consumirlo.