Resoluciones DIAN

curl -X POST https://api.onepay.la/v1/fiscal-resolutions \
  -H "Authorization: Bearer $ONEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "18760000001",
    "prefix": "FE",
    "document_type": "invoice",
    "from": 1,
    "to": 5000,
    "valid_from": "2026-01-15",
    "valid_until": "2027-01-15",
    "technical_key": "fc8eac4227b2b1e8..."
  }'

{
  "id": "res_01J8XK5M2P",
  "number": "18760000001",
  "prefix": "FE",
  "document_type": "invoice",
  "status": "draft",
  "from": 1,
  "to": 5000,
  "current": 0,
  "next_number": 1,
  "remaining": 5000,
  "usage_percentage": 0,
  "valid_until": "2027-01-15",
  "is_expired": false,
  "can_stamp": false
}

POST

fiscal-resolutions

curl -X POST https://api.onepay.la/v1/fiscal-resolutions \
  -H "Authorization: Bearer $ONEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "18760000001",
    "prefix": "FE",
    "document_type": "invoice",
    "from": 1,
    "to": 5000,
    "valid_from": "2026-01-15",
    "valid_until": "2027-01-15",
    "technical_key": "fc8eac4227b2b1e8..."
  }'

{
  "id": "res_01J8XK5M2P",
  "number": "18760000001",
  "prefix": "FE",
  "document_type": "invoice",
  "status": "draft",
  "from": 1,
  "to": 5000,
  "current": 0,
  "next_number": 1,
  "remaining": 5000,
  "usage_percentage": 0,
  "valid_until": "2027-01-15",
  "is_expired": false,
  "can_stamp": false
}

La resolución es el permiso de la DIAN para emitir documentos con un prefijo y un rango de números. La sacas del portal MUISCA y la cargas acá.

Carga una resolución por tipo de documento. Las facturas y las notas crédito llevan numeración separada: sin una resolución de credit_note, no vas a poder anular ni devolver.

Cargar una resolución

Nace en estado draft. Activarla es un paso aparte, después de que validemos los datos: una resolución mal digitada no falla al guardarse, falla al timbrar la primera factura real.

Body

string

required

Número de la resolución que asignó la DIAN.

string

required

Tipo de documento que numera: invoice, credit_note o debit_note.

integer

required

Primer número del rango autorizado.

integer

required

Último número del rango autorizado.

string

Prefijo autorizado. Acompaña al consecutivo en el número visible del documento (FE1, NC900).

date

Inicio de vigencia.

date

Fin de vigencia. Vencida deja de timbrar aunque queden números.

date

Fecha en que la DIAN expidió la resolución.

string

Clave técnica de la resolución. Entra en el cálculo del CUFE.

Se guarda encriptada y nunca vuelve en una respuesta de la API.

curl -X POST https://api.onepay.la/v1/fiscal-resolutions \
  -H "Authorization: Bearer $ONEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "18760000001",
    "prefix": "FE",
    "document_type": "invoice",
    "from": 1,
    "to": 5000,
    "valid_from": "2026-01-15",
    "valid_until": "2027-01-15",
    "technical_key": "fc8eac4227b2b1e8..."
  }'

{
  "id": "res_01J8XK5M2P",
  "number": "18760000001",
  "prefix": "FE",
  "document_type": "invoice",
  "status": "draft",
  "from": 1,
  "to": 5000,
  "current": 0,
  "next_number": 1,
  "remaining": 5000,
  "usage_percentage": 0,
  "valid_until": "2027-01-15",
  "is_expired": false,
  "can_stamp": false
}

Activar

POST /fiscal-resolutions/{resolution}/activate Al activar una resolución, la anterior del mismo prefijo y tipo queda fuera de servicio. Dos resoluciones activas a la vez serían dos numeraciones corriendo en paralelo.

curl -X POST https://api.onepay.la/v1/fiscal-resolutions/res_01J8XK5M2P/activate \
  -H "Authorization: Bearer $ONEPAY_API_KEY"

Falla con resolution_not_activatable si está vencida o ya consumió todo su rango.

Listar

GET /fiscal-resolutions Devuelve todas tus resoluciones con su consumo. Los campos que importan para operar:

Campo
`next_number`	El siguiente consecutivo que se va a usar
`remaining`	Números que quedan disponibles
`usage_percentage`	Porcentaje del rango consumido
`can_stamp`	Si esta resolución puede emitir ahora mismo

OnePay te avisa al 80% y al 95% del rango consumido, y 30 días antes del vencimiento. Conseguir una resolución nueva depende de los tiempos de la DIAN, así que carga la siguiente apenas recibas el primer aviso.

API

Empresas

Métodos de pago

Recaudo

Productos

Facturación

Balances

Webhooks

Fintech as a service

Cargar una resolución

Body

Activar

Listar

​Cargar una resolución

​Body

​Activar

​Listar

Cargar una resolución

Body

Activar

Listar