Crear Nota Crédito por API
Documentación Técnica de la API de DATAICO FACTURA ELECTRÓNICA
Referencia técnica de la API de DATAICO para la emisión de Notas Crédito.
Numeración
Para obtener los datos de tu numeración de Notas Crédito:
Ventas > Notas Crédito > Numeraciones > [Editar]
En la pantalla de edición encontrarás el prefijo, número de resolución y el consecutivo actual.
Crear Nota Crédito a una FE
Método: POST
Endpoint: https://api.dataico.com/direct/dataico_api/v2/credit_notes
Headers:
Content-Type: application/jsonAuth-token: <tu llave API o el Auth Token de la cuenta>
El JSON va dentro de credit_note, con el dataico_account_id de tu cuenta (el mismo que usas en la factura). La nota puede referenciar tres cosas:
| 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, igual que payment_means y payment_means_type |
| Una factura emitida fuera de Dataico | invoice_number (con prefijo), invoice_issue_date e invoice_cufe, los tres |
Obligatorio y completo |
| Ninguna factura | "sin_factura_referenciada": true |
Obligatorio y completo |
Motivo (reason) y controles
Los motivos de la Nota Crédito son ANULACION, DEVOLUCION, REBAJA, AJUSTE, DESCUENTO-PRONTO-PAGO y DESCUENTO-VOLUMEN. Si no envías reason, la nota es ANULACION. OTROS no es un motivo de Nota Crédito (sí de Nota Débito): no lo uses.
Sobre una factura emitida en Dataico, la API compara la nota con la factura:
| Motivo | Control | Mensaje si no se cumple |
|---|---|---|
ANULACION |
El total de la nota es igual al de la factura: envía los mismos ítems, precios y cantidades | El total de la Nota Credito '...' no es igual al total de la factura '...'. |
DEVOLUCION |
El total de la nota es igual o menor al de la factura: envía solo los ítems o cantidades devueltos | El total de la Nota Credito '...' debe ser igual ( o menos ) del total de la factura '...'. |
| Todos | La fecha de la nota no es anterior a la de la factura | La fecha de la nota crédito no puede ser anterior a la fecha de la factura |
Los demás motivos, y las notas sobre facturas externas, no tienen control de total.
Nota Crédito sobre una factura emitida fuera de Dataico
{
"credit_note": {
"invoice_number": "FE1234",
"invoice_issue_date": "15/10/2026",
"invoice_cufe": "<CUFE de la factura>",
"reason": "ANULACION",
"customer": { "...": "el cliente completo, como en la factura" },
"items": [ "..." ]
}
}
Si la factura original era en moneda extranjera, agrega currency, currency_exchange_rate y currency_exchange_rate_date: la API no los toma de una factura externa. (Sobre una factura de exportación emitida en Dataico, en cambio, la nota copia la moneda y la tasa de la factura.) Si falta alguno de los tres datos de la factura, o el CUFE trae espacios u otros caracteres, la respuesta es Si estás usando nota externa, necessitas declarar los campos "invoice_number" "invoice_issue_date" y "invoice_cufe". Ademas, el cufe debe ser solo letras o digitos sin espacios.
Nota Crédito sin factura de referencia
- Envía
"sin_factura_referenciada": truey ninguno deinvoice_id,invoice_number,invoice_issue_dateoinvoice_cufe. invoice_period_start_dateeinvoice_period_end_date(el periodo que corrige) son obligatorios. Sin ellos:Para esta Nota Credito, los campos de fechas de inicio de periodo y fin de periodo de facturación son requeridos.- El motivo no puede ser
ANULACION: no hay factura que anular. Si lo es:La razón de la Nota Credito (...) no es válida para este tipo (...).
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.