Skip to Content
v1.5Official documentation for the LX CloudPos API · stable in production
v1.5 (current)Domain conceptsKey and consecutive number

Key and consecutive number

The numeric key (50 digits)

The numeric key is the document’s official unique identifier. It follows this structure:

506 15 01 26 003101123456 0010 0001 01 0000000123 4 56789012 └─┬─┘└┬─┘└┬─┘└┬─┘└────┬─────┘└─┬──┘└─┬──┘└┬─┘└──┬─────┘└┬─┘└──┬──┘ country day month year issuer ID branch POS type seq. no. stat sec. code
PositionLengthMeaning
1–33Country code (506 Costa Rica)
4–96Day, month, year of issuance (DDMMYY)
10–2112Issuer’s ID number (padded with zeros)
22–243Headquarters
25–284Point of sale
29–302Document type
31–4010Consecutive number
411Situation (1=normal, 2=contingency, 3=no internet)
42–509Random security code

LX CloudPos generates the key automatically. Do not build it from your system — only store it as a reference.

The consecutive number (20 digits)

It is the issuer’s internal portion (positions 22–40 of the key, excluding the country and date codes). Structure:

001 0001 01 0000000123 └┬─┘└─┬──┘└┬─┘└────┬────┘ branch POS type sequential number

The consecutive number increases automatically by document type. Each tenant has its own sequence.

You can use GET /api/v1/consecutivos/proximo to check what the next number will be without consuming it.