Rangos de numeración

Consulta los rangos de numeración autorizados por la DIAN en tu cuenta de AdapterDian y declara el numbering_prefix correcto al emitir.

Cada documento que emites consume un número de un rango que la DIAN te autorizó. Con un solo rango activo por tipo de documento no tienes que hacer nada. Con más de un rango activo del mismo tipo, declarar el numbering_prefix correcto es lo único que evita el rechazo del documento.

Consulta tus rangos

GET /invoices/v1/numbering-ranges

curl https://adapterdian.piensait.com/functions/v1/invoices/v1/numbering-ranges \
  -H "Authorization: Bearer $ADAPTERDIAN_API_KEY"

La nómina tiene sus propios rangos: GET /payrolls/v1/numbering-ranges.

Cada rango trae:

Campo	Significado
`prefix`	El valor que declaras como `numbering_prefix` al emitir.
`kind`	Tipo de documento, en el vocabulario de este contrato. `null` cuando el rango es de un tipo que AdapterDian todavía no emite.
`from`, `to`	Límites autorizados.
`current`	Último consecutivo consumido.
`is_active`	Si el rango se puede usar.

Declara el prefijo

Agrega numbering_prefix (de 1 a 10 caracteres) al cuerpo de la emisión:

{
  "numbering_prefix": "<prefijo>",
  "customer": { … },
  "items": [ … ],
  "payment_details": [ … ]
}

Vigila current frente a to

Cuando current se acerque a to, solicita a la DIAN una resolución nueva antes de que se agote el rango.