---
title: Crear Nota Crédito por API
description: "Endpoint POST para crear Notas Crédito por API: sobre una factura de Dataico, sobre una factura externa o sin factura de referencia; motivos válidos…"
---

[Ir directamente al contenido](https://portaldelcliente.dataico.com/es/knowledge/crear-nota-crédito#main-content)

Español

Traducciones de Mostrar submenú de

![facturaelectronica.dataico.comhs-fshubfslogoDataico2-1.png\]](https://portaldelcliente.dataico.com/hs-fs/hubfs/social-suggested-images/facturaelectronica.dataico.comhs-fshubfslogoDataico2-1.png?height=40&name=facturaelectronica.dataico.comhs-fshubfslogoDataico2-1.png)

Abrir navegación principal

Cerrar navegación principal

- Español
  
  Traducciones de Mostrar submenú de
- <https://www.dataico.com/>

<https://www.dataico.com/>

 ¿Cómo podemos ayudarte?

- No hay sugerencias porque el campo de búsqueda está vacío.

1. [Centro de Ayuda](https://portaldelcliente.dataico.com/es/knowledge?hsLang=es)
2. [Integración API DATAICO S.A.S](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es)
3. [Factura Electrónica.](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#factura-electr%C3%B3nica)

# 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?](https://portaldelcliente.dataico.com/es/knowledge/recibos-referencia-en-documentos-de-venta?hsLang=es).

#### **Estructuras JSON disponibles**

El ejemplo de la petición, con cada campo, está en la [documentación técnica de la API](https://app.dataico.com/api-docs).

### **Recursos Adicionales**

- [Guía de Solución de Problemas API DATAICO FE](https://portaldelcliente.dataico.com/es/knowledge/gu%C3%ADa-de-soluci%C3%B3n-de-problemas-api-dataico-factura-electr%C3%B3nica?hsLang=es)
- [Documentación Técnica FE](https://portaldelcliente.dataico.com/es/knowledge/documentaci%C3%B3n-t%C3%A9cnica-de-la-api-de-dataico-factura-electr%C3%B3nica?hsLang=es)
- [API DOCS](https://app.dataico.com/api-docs)

- [Módulo de Terceros](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-terceros?hsLang=es#main-content)

    - [Conceptos](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-terceros?hsLang=es#conceptos)
- [Módulo de Ventas](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#main-content)

    - [Onboarding Facturación](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#onboarding-facturaci%C3%B3n)
    - [Generales](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#generales)
    - [Facturas](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#facturas)
    - [Cotizaciones](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#cotizaciones)
    - [Notas crédito](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#notas-cr%C3%A9dito)
    - [Notas débito](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#notas-d%C3%A9bito)
    - [Facturación electrónica](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#facturaci%C3%B3n-electr%C3%B3nica)
    - [Onboarding POS Electrónico](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#onboarding-pos-electr%C3%B3nico)
    - [Generalidades de Documento Equivalente POS Electrónico](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#generalidades-de-documento-equivalente-pos-electr%C3%B3nico)
    - [Notas de Ajuste POS Electrónico](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#notas-de-ajuste-pos-electr%C3%B3nico)
- [Módulo de Contabilidad](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#main-content)

    - [Onboarding y conceptos](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#onboarding-y-conceptos)
    - [Configuración del módulo contable](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#configuraci%C3%B3n-del-m%C3%B3dulo-contable)
    - [Reglas y automatización](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#reglas-y-automatizaci%C3%B3n)
    - [Asientos y comprobantes](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#asientos-y-comprobantes)
    - [Reportes financieros](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#reportes-financieros)
    - [Certificados y exógena](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#certificados-y-ex%C3%B3gena)
- [Módulo de Nómina](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#main-content)

    - [Onboarding y conceptos](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#onboarding-y-conceptos)
    - [Configuración de Nómina](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#configuraci%C3%B3n-de-n%C3%B3mina)
    - [Empleados, contratos y terminaciones](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#empleados-contratos-y-terminaciones)
    - [Novedades y horas extras](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#novedades-y-horas-extras)
    - [Liquidación de Nómina](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#liquidaci%C3%B3n-de-n%C3%B3mina)
    - [Prestaciones Sociales](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#prestaciones-sociales)
    - [Colillas de Pago](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#colillas-de-pago)
    - [Nómina Electrónica](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#n%C3%B3mina-electr%C3%B3nica)
- [Módulo de Compras](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#main-content)

    - [Compras](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#compras)
    - [Documento Soporte](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#documento-soporte)
    - [Habilitar Documento Soporte](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#habilitar-documento-soporte)
    - [Eventos de Recepción](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#eventos-de-recepci%C3%B3n)
    - [Errores, notificaciones y rechazos de Eventos de Recepción](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#errores-notificaciones-y-rechazos-de-eventos-de-recepci%C3%B3n)
    - [Facturas Electrónicas de Compra](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#facturas-electr%C3%B3nicas-de-compra)
- [Módulo de Cartera](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#main-content)

    - [Onboarding](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#onboarding)
    - [Cuentas por Cobrar y cuentas por Pagar](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#cuentas-por-cobrar-y-cuentas-por-pagar)
    - [Bancos.](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#bancos)
    - [Configuración Módulo de Cartera](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#configuraci%C3%B3n-m%C3%B3dulo-de-cartera)
- [Módulo de Productos e Inventarios](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#main-content)

    - [Productos](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#productos)
    - [Inventarios.](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#inventarios)
    - [Ajuste de inventarios.](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#ajuste-de-inventarios)
    - [Productos de compra.](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#productos-de-compra)
- [Suscripciones](https://portaldelcliente.dataico.com/es/knowledge/suscripciones?hsLang=es)
- [Integración API DATAICO S.A.S](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#main-content)

    - [Modelo de Integración API DATAICO S.A.S](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#modelo-de-integraci%C3%B3n-api-dataico-s-a-s)
    - [Factura Electrónica.](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#factura-electr%C3%B3nica)
    - [Guía de Solución de Problemas API DATAICO FE](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#gu%C3%ADa-de-soluci%C3%B3n-de-problemas-api-dataico-fe)
    - [Nómina Electrónica.](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#n%C3%B3mina-electr%C3%B3nica)
    - [Documento Soporte (DS)](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#documento-soporte-ds)
    - [Eventos de Recepción (EV)](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#eventos-de-recepci%C3%B3n-ev)
    - [Sector Salud](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#sector-salud)
    - [POS ELECTRÓNICO](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#pos-electr%C3%B3nico)
- [Importaciones](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#main-content)

    - [General](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#general)
    - [Contabilidad](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#contabilidad)
    - [Productos](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#productos)
    - [Terceros](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#terceros)
- [Preguntas frecuentes (FAQ)](https://portaldelcliente.dataico.com/es/knowledge/preguntas-frecuentes-faq?hsLang=es)
- [Anexos Técnicos y Resoluciones](https://portaldelcliente.dataico.com/es/knowledge/anexos-t%C3%A9cnicos-y-resoluciones?hsLang=es#main-content)

    - [Resolución 000119 de 2024.](https://portaldelcliente.dataico.com/es/knowledge/anexos-t%C3%A9cnicos-y-resoluciones?hsLang=es#resoluci%C3%B3n-000119-de-2024)
    - [Anexo 1.9](https://portaldelcliente.dataico.com/es/knowledge/anexos-t%C3%A9cnicos-y-resoluciones?hsLang=es#anexo-1-9)
- [Recursos adicionales](https://portaldelcliente.dataico.com/es/knowledge/recursos-adicionales?hsLang=es)
- [Shopify](https://portaldelcliente.dataico.com/es/knowledge/shopify?hsLang=es)

[![Chill listening crop-3](https://portaldelcliente.dataico.com/hs-fs/hubfs/Lod%20DT.png?width=110&height=32&name=Lod%20DT.png "Chill listening crop-3")](https://www.dataico.com/)

Copyright © 2026, DATAICO S.A.S