API DE NOTA DE CRÉDITO

¿Qué es una nota de crédito?

Es un CFDI de egreso: un comprobante que resta valor a una factura que ya emitiste. Tu cliente devolvió parte de la mercancía, le aplicaste un descuento por pronto pago, o facturaste $12,000 cuando eran $10,000. En vez de cancelar y rehacer, emites una nota de crédito por la diferencia.

La ventaja sobre cancelar es que la operación original queda intacta. Si tu cliente ya contabilizó esa factura, cancelársela le rompe su contabilidad; una nota de crédito simplemente la ajusta.

El endpoint

Mismo endpoint de CFDI. Lo que la convierte en nota de crédito es CfdiType: "E" —egreso— más el nodo Relations apuntando a la factura que corrige.

{
    "NameId": "2",
    "CfdiType": "E",
    "ExpeditionPlace": "78116",
    "PaymentForm": "03",
    "PaymentMethod": "PUE",
    "Relations": {
        "Type": "01",
        "Cfdis": [
            {
                "Uuid": "27568D31-7E57-442F-BA77-798CBF30BD7D"
            }
        ]
    }
}

El Uuid es el folio fiscal de la factura que estás corrigiendo. Y Type: "01" declara por qué las estás relacionando. Ese campo es el que más se equivoca, así que vale la pena verlo con calma.

El tipo de relación: elige bien

El SAT publica siete tipos de relación entre comprobantes. No son intercambiables:

Y si lo que hubo fue una devolución física de producto, la clave correcta es la 03, no la 01. La diferencia importa en una auditoría: una habla de dinero, la otra de mercancía que volvió a tu almacén.

Notas parciales y anticipos

Una nota de crédito no tiene que ser por el total de la factura. Si de una venta de $50,000 te devolvieron mercancía por $8,000, la nota va por $8,000 y la factura original sigue amparando los $42,000 restantes.

Puedes relacionar varios UUID en el mismo comprobante: Cfdis es un arreglo. Es útil cuando aplicas un descuento global sobre varias facturas del mismo cliente — aunque en la práctica conviene pensarlo dos veces, porque una nota que toca cinco facturas es infinitamente más difícil de conciliar después que cinco notas de una.

Caso aparte son los anticipos, que llevan su propia clave (07) y su propia mecánica: primero facturas el anticipo, luego la venta total, y después emites el egreso que descuenta lo ya cobrado.

Cuándo NO usar una nota de crédito

Si te equivocaste en el RFC del receptor, en el régimen fiscal o en cualquier dato de identificación, la nota de crédito no te sirve. Esos errores se corrigen cancelando con motivo de sustitución y emitiendo el comprobante correcto.

La regla mental es sencilla: la nota de crédito ajusta importes. Todo lo demás se arregla cancelando.

Lo demás del ciclo de vida

La respuesta trae Id y UUID. Con el Id consultas, descargas XML y PDF, envías por correo y cancelas. Y sí: una nota de crédito también se puede cancelar, con las mismas reglas que cualquier CFDI.

Guarda el UUID de tus facturas desde el día uno. Sin él no puedes emitir la nota de crédito correspondiente, y recuperarlo a posteriori significa buscar en el portal del SAT factura por factura.

SDKs

Librerías oficiales para PHP, Python, JavaScript, Java, Ruby y .NET (4.5+). Como comparte endpoint con la facturación normal, si ya emites CFDI esto es un tipo de comprobante más — no una integración nueva.

Preguntas frecuentes

¿Cuál es la diferencia entre nota de crédito y cancelación?

La nota de crédito ajusta el importe y deja viva la factura original. La cancelación la elimina. Si tu cliente ya contabilizó la factura, la nota de crédito es la vía limpia.

¿Qué tipo de relación uso para una devolución de mercancía?

La clave 03, "devolución de mercancía sobre facturas o traslados previos". La 01 es para ajustes de importe sin devolución física.

¿Puedo emitir una nota de crédito por un importe parcial?

Sí. El importe de la nota es independiente del de la factura original; solo tiene que ser menor o igual.

¿Sirve para corregir el RFC del cliente?

No. Los errores en datos de identificación se corrigen cancelando con motivo de sustitución y emitiendo un comprobante nuevo.