Registrar rango de numeración / resolución
const url = 'https://example.com/v1/tenant/numbering-ranges';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"kind":"invoice","prefix":"","from":1,"to":1,"current":1,"resolutionNumber":"example","resolutionDate":"2026-04-15","validFrom":"2026-04-15","validTo":"2026-04-15","technicalKey":"example","active":true}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/v1/tenant/numbering-ranges \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "kind": "invoice", "prefix": "", "from": 1, "to": 1, "current": 1, "resolutionNumber": "example", "resolutionDate": "2026-04-15", "validFrom": "2026-04-15", "validTo": "2026-04-15", "technicalKey": "example", "active": true }'Authorizations
Sección titulada «Authorizations»Parameters
Sección titulada «Parameters»Header Parameters
Sección titulada «Header Parameters»Id o NIT del facturador. Obligatorio con llaves de cuenta; ignorado con llaves restringidas.
Request Bodyrequired
Sección titulada «Request Bodyrequired»Un rango de numeración, con resolución de la DIAN o propio del facturador
object
Tipo de documento que numera
Prefijo que va antes del número: hasta 4 caracteres, vacío por defecto
Primer número autorizado
Último número autorizado
Último número ya usado (0, por defecto, si no se ha usado ninguno: el siguiente es from)
Número de la resolución de la DIAN; obligatorio para facturas, documentos soporte y documentos POS
Fecha de la resolución
Primer día de vigencia de la resolución
Último día de vigencia de la resolución; después de él no se puede emitir
Clave técnica de la resolución, del portal de la DIAN; obligatoria para facturas de venta (entra en el CUFE)
Si está en uso (true por defecto); el rango activo más reciente de un tipo es el que numera sus documentos
Responses
Sección titulada «Responses»Rango creado
object
Rango creado
object
Id del rango (rangeId al emitir)
Id del facturador
Tipo de documento que numera
Prefijo que va antes del número (puede estar vacío)
Primer número autorizado
Último número autorizado
Último número asignado (0: aún no se usa)
Número de la resolución de la DIAN
Fecha de la resolución (YYYY-MM-DD)
Primer día de vigencia de la resolución (YYYY-MM-DD)
Último día de vigencia de la resolución (YYYY-MM-DD)
Clave técnica (solo factura de venta)
Si está en uso; el rango activo más reciente de un tipo es el que numera sus documentos
Cuándo se creó
Example
{ "data": { "kind": "invoice", "createdAt": "2026-01-15T15:30:00.000Z" }}La petición no cumple el esquema (VALIDATION_ERROR, con details por campo)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Falta la credencial o no es válida (UNAUTHORIZED)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}La llave no puede hacer esto (FORBIDDEN)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}No existe, o no es de esta cuenta (NOT_FOUND)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Conflicto con el estado actual (CONFLICT, INVALID_STATE)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Regla de negocio (VALIDATION_ERROR, NUMBERING_*, CERTIFICATE_UNAVAILABLE…)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Demasiadas peticiones para esta cuenta (RATE_LIMITED; vea X-RateLimit-* y Retry-After)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Error del servicio o de la DIAN (DIAN_UNAVAILABLE, DIAN_PROTOCOL_ERROR)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}