Importa la resolución desde la DIAN

POST/api/v1/numbering-ranges/import

Consulta a la DIAN (GetNumberingRange, firmado con el certificado de la cuenta) las resoluciones asociadas al software del emisor y crea los rangos con su número, fechas y clave técnica: el cliente no la copia a mano. Con prefix importa solo esa; sin él, todas. Un prefijo que la cuenta ya tiene no se duplica (va en existing). Solo factura, documento soporte y POS (las notas y la nómina no llevan resolución). En el ambiente de pruebas no aplica (409 error.numbering.import_staging). Si el software no tiene ese prefijo: 404 error.numbering.not_in_dian con los prefijos que sí tiene en details.

Cuerpo de la petición application/json

document_typestring· por defecto invoice
Valores: invoice · support_document · pos
prefixstring
Vacío = todas las resoluciones del software
Ejemplo: FECO
next_numberinteger
Al venir de otro proveedor: el siguiente número que no usó
Ejemplo: 51

Respuestas

201Rangos creados

itemsarray<object>
+ Ver 14 campos− Ocultar 14 campos
- 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
existingarray<string>
Prefijos que la cuenta ya tenía

200Nada nuevo: todos los prefijos ya estaban (ver existing)Sin contenido

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

404No existe (o es de otra cuenta)

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

422Faltan datos para generar el XML (error.document.incomplete, campos en details)

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