Crea un rango de numeración

POST/api/v1/numbering-ranges

Factura y documento soporte exigen resolución y vigencia; la factura además la clave técnica. Notas y nómina no tienen resolución.

Cuerpo de la petición application/json

document_typestringobligatorio
Valores: invoice · credit_note · debit_note · support_document · support_document_adjustment · payroll · payroll_adjustment · pos · pos_adjustment · pos_debit_adjustment
prefixstring
Ejemplo: SETP
resolution_numberstring
Ejemplo: 18760000001
resolution_datestring · date
Ejemplo: 2026-11-30
range_fromintegerobligatorio
Ejemplo: 990000000
range_tointegerobligatorio
Ejemplo: 995000000
next_numberinteger
Opcional: siguiente número a usar (por defecto range_from). Para seguir la numeración de otro proveedor
Ejemplo: 990000014
valid_fromstring · date
Ejemplo: 2026-11-30
valid_tostring · date
Ejemplo: 2026-11-30
technical_keystring
Clave técnica de la resolución (solo facturas). Se cifra y nunca se devuelve.

Respuestas

201Creado

idstring · uuid
document_typestring
Valores: invoice · credit_note · debit_note · support_document · support_document_adjustment · payroll · payroll_adjustment · pos · pos_adjustment · pos_debit_adjustment
prefixstring
resolution_numberstring
resolution_datestring
range_frominteger
range_tointeger
next_numberinteger
remaininginteger
valid_fromstring
valid_tostring
has_technical_keyboolean
is_activeboolean
created_atstring · date-time

400Datos inválidos (details trae los campos)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

409Conflicto con el estado actual (p. ej. documento referenciado no aceptado, rango agotado)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring