Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

Nota Débito por API

Documentación Técnica de la API de DATAICO FACTURA ELECTRÓNICA para el Sector Salud

Referencia técnica de la API de DATAICO para la emisión de Notas Débito.

Numeración

Para obtener los datos de tu autorización de numeración o consecutivo de Notas Débito:

Ventas > Notas Débito > Numeraciones > [Editar]

En la pantalla de edición encontrarás el prefijo, número de resolución y el consecutivo actual.

Crear Nota Débito a una FE

Método: POST

Endpoint: https://api.dataico.com/direct/dataico_api/v2/debit_notes

Headers:

  • Content-Type: application/json
  • Auth-token: <tu llave API o el Auth Token de la cuenta>

El JSON va dentro de debit_note, con el dataico_account_id de tu cuenta (el mismo que usas en la factura). number es obligatorio. La nota puede referenciar:

La nota es sobre Cómo se referencia customer
Una factura emitida en Dataico invoice_id (el uuid de la factura) o invoice_cufe Se ignora: se toma de la factura
Una factura emitida fuera de Dataico invoice_number (con prefijo), invoice_issue_date e invoice_cufe, los tres Obligatorio y completo
Ninguna factura Ver Nota Débito sin factura de referencia (API) Obligatorio y completo

Los motivos (reason) de la Nota Débito son INTERESES, GASTOS, CAMBIO_VALOR y OTROS. Si no envías reason, la nota es CAMBIO_VALOR.

Ejemplo sobre una factura emitida fuera de Dataico:

{
  "debit_note": {
    "number": "15",
    "numbering": { "prefix": "ND" },
    "invoice_number": "FE1234",
    "invoice_issue_date": "15/10/2026",
    "invoice_cufe": "<CUFE de la factura>",
    "reason": "INTERESES",
    "customer": { "...": "el cliente completo, como en la factura" },
    "items": [ "..." ]
  }
}

Recibos Referencia (receipt_documents)

Si tu cliente lleva su propio control de recepción de mercancía (un albarán, un DAFI, una guía de remisión), puedes enviar esos identificadores en la solicitud de creación con el campo opcional receipt_documents, un arreglo de textos:

"receipt_documents": ["ALB-4471", "DAFI-9930"]
  • Puedes enviar tantos como necesites, y repetir el mismo identificador.
  • Si no envías el campo, el documento se crea sin referencias.
  • Cada entrada viaja al XML de la DIAN y aparece en el PDF, en el bloque de datos junto a la Orden de Compra.

Es el mismo campo Recibos Referencia que se llena desde la interfaz de Dataico. Ver ¿Cómo agregar Recibos Referencia a una factura o nota?.

Estructuras JSON disponibles

El ejemplo de la petición, con cada campo, está en la documentación técnica de la API.

Recursos Adicionales