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

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/json
  • Auth-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": true y ninguno de invoice_id, invoice_number, invoice_issue_date o invoice_cufe.
  • invoice_period_start_date e invoice_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.

Recursos Adicionales