Para corregir una factura electrónica previamente transmitida, emite una nota de crédito usando el tipo de operación CORRECTION con data.type = INVOICE. Una nota de crédito revierte los importes de la factura original — total o parcialmente. Si los datos originales también deben reemplazarse, se emite una nueva factura después de la nota de crédito.
La nota de crédito siempre hace referencia a la factura original y debe enviarse al mismo destinatario.
Uso de la API
INTENTION y TRANSACTION, con ejemplo de solicitud.
Cuándo emitir una nota de crédito
Cancelación, crédito parcial, corrección, importe insuficiente o destinatario incorrecto.
Flujos de corrección
El flujo de cada escenario.
Reglas
Importes, referencias, numeración y tipo de línea.
Uso de la API
Sección titulada «Uso de la API»INTENTION
Sección titulada «INTENTION»El paso INTENTION sigue el mismo patrón que para una factura estándar. Llama al endpoint createRecord con un Registro de tipo INTENTION asociado con el Sistema E_INVOICE_SERVICE.
TRANSACTION
Sección titulada «TRANSACTION»Llama al endpoint createRecord con un Registro de tipo TRANSACTION:
- Establece el tipo de operación en
CORRECTIONcondata.type = INVOICE - Haz referencia a la factura original mediante
operation.record.id - Incluye las líneas que se acreditan (con importes positivos)
- Usa el mismo destinatario que la factura original
Ejemplo de petición — nota de crédito parcial
{ "content": { "type": "TRANSACTION", "record": { "id": "<intention-record-id>" }, "operation": { "type": "CORRECTION", "record": { "id": "<original-invoice-transaction-record-id>" }, "data": { "type": "INVOICE", "document": { "number": "CN-2026-000001" }, "entries": [ { "type": "RETURN", "details": { "concept": "GOOD" }, "data": { "type": "ITEM", "text": "White sugar", "unit": { "quantity": "1.00", "price": { "inclusive": "1220.00", "exclusive": "1000.00" } }, "value": { "base": "1000.00" }, "vat": { "type": "VAT_RATE", "code": "STANDARD", "percentage": "22.00", "exclusive": "1000.00", "inclusive": "1220.00", "amount": "220.00" } } } ], "breakdown": [ { "type": "VAT_RATE", "code": "STANDARD", "percentage": "22.00", "exclusive": "1000.00", "inclusive": "1220.00", "amount": "220.00" } ], "totals": { "vat": { "amount": "220.00", "exclusive": "1000.00", "inclusive": "1220.00" } }, "recipients": [ { "type": "BUSINESS", "name": "Dolci Italiani S.r.l.", "identification": { "type": "VAT", "value": "IT12345678901" }, "address": { "street": "Via Roma 1", "city": "Milano", "code": "20121", "region": "MI", "country": "IT" }, "invoicing": { "type": "SDI", "destination_code": "ABC1234" } } ] } } }}Las notas de crédito se crean en el sistema E_INVOICE_SERVICE, siguiendo el mismo flujo INTENTION → TRANSACTION que para las facturas electrónicas.
Cuándo emitir una nota de crédito
Sección titulada «Cuándo emitir una nota de crédito»| Escenario | Acción | Documentos emitidos |
|---|---|---|
| Cancelación total — duplicado o transacción cancelada | Acreditar el importe total | Solo nota de crédito |
| Crédito parcial — devolución, descuento o sobrefacturación | Acreditar solo las líneas o importes afectados | Solo nota de crédito |
| Corrección — datos o importes incorrectos en la factura original | Acreditar el importe total y luego re-emitir corregida | Nota de crédito + nueva factura |
| Importe insuficiente — el importe original era demasiado bajo | Acreditar el importe total y luego re-emitir con el importe correcto | Nota de crédito + nueva factura |
| Destinatario incorrecto — factura enviada al comprador equivocado | Acreditar el importe total al destinatario original y luego facturar al destinatario correcto | Nota de crédito + nueva factura |
Flujos de corrección
Sección titulada «Flujos de corrección»Cancelación total
Sección titulada «Cancelación total»Úsalo cuando la factura original nunca debería haberse emitido (duplicado, pedido cancelado). Si se envió al comprador equivocado, consulta Destinatario incorrecto.
Original Invoice INV-001 €6300.00 ↓Credit Note CN-001 €6300.00 (references INV-001) ↓Net result: €0.00La factura original permanece en el registro. La nota de crédito crea una reversión total.
Crédito parcial
Sección titulada «Crédito parcial»Úsalo cuando solo parte de la factura original debe revertirse (artículo devuelto, descuento acordado, sobrefacturación en líneas específicas).
Original Invoice INV-001 €6300.00 ↓Credit Note CN-002 €600.00 (references INV-001, affected lines only) ↓Net result: €5700.00Solo las líneas acreditadas se incluyen en la nota de crédito. La factura original sigue siendo válida para todas las líneas no acreditadas.
Corrección (crédito + re-emisión)
Sección titulada «Corrección (crédito + re-emisión)»Úsalo cuando la factura original contenía datos o importes incorrectos.
Original Invoice INV-001 €6300.00 ↓Credit Note CN-003 €6300.00 (full reversal, references INV-001) ↓New Invoice INV-002 €5950.00 (corrected data) ↓Net result: €5950.00Revierte completamente la original mediante una nota de crédito y luego emite una nueva factura con los datos correctos.
Importe insuficiente (crédito + re-emisión mayor)
Sección titulada «Importe insuficiente (crédito + re-emisión mayor)»Úsalo cuando el importe de la factura original era demasiado bajo.
Original Invoice INV-001 €5000.00 ↓Credit Note CN-004 €5000.00 (full reversal, references INV-001) ↓New Invoice INV-003 €6300.00 (correct amount) ↓Net result: €6300.00Destinatario incorrecto (crédito + nueva factura)
Sección titulada «Destinatario incorrecto (crédito + nueva factura)»Úsalo cuando la factura se envió al destinatario equivocado.
Original Invoice INV-056 €119.00 (sent to the wrong recipient) ↓Credit Note CN-012 €119.00 (references INV-056, same recipient as INV-056) ↓New Invoice INV-057 €119.00 (correct recipient)La nota de crédito anula la factura original por completo. Va al mismo destinatario que la factura original, es decir, al equivocado, porque es a quien iba dirigida la factura. Después emite una nueva factura, con un nuevo número de factura, al destinatario correcto.
Nota de crédito + re-emisión
Sección titulada «Nota de crédito + re-emisión»Para los escenarios de corrección, importe insuficiente y destinatario incorrecto, se necesitan dos transacciones separadas:
- Crea un registro
CORRECTION(nota de crédito) que haga referencia a la factura original - Crea un nuevo registro
INVOICEcon los datos corregidos
Ambos registros siguen el flujo estándar INTENTION → TRANSACTION.
Los importes deben ser positivos
Sección titulada «Los importes deben ser positivos»Todos los importes en una nota de crédito deben ser positivos. El tipo de documento indica que los importes positivos de línea representan créditos. Los valores negativos causarán errores de validación. Emite siempre una nota de crédito como CORRECTION. Una INVOICE con importes negativos no es una nota de crédito.
La referencia al documento precedente es obligatoria
Sección titulada «La referencia al documento precedente es obligatoria»Toda nota de crédito hace referencia a la factura original. En la solicitud CORRECTION::INVOICE, proporciona el ID del registro de transacción original en el campo content.operation.record.id. fiskaly resuelve los detalles del documento precedente automáticamente.
{ "content": { "type": "TRANSACTION", "record": { "id": "<intention-record-id>" }, "operation": { "type": "CORRECTION", "record": { "id": "<original-transaction-record-id>" }, "data": { "type": "INVOICE", ... } } }}El destinatario debe coincidir
Sección titulada «El destinatario debe coincidir»La nota de crédito debe usar el mismo destinatario que la factura original: los mismos datos del destinatario, el mismo canal de entrega (invoicing.type), la misma dirección de email o el mismo ID de Peppol y el mismo invoicing.format.
Si algo difiere, la solicitud se acepta igualmente y el record queda en COMPLETED, pero no se envía nada. El record recibe un log ERROR en content.logs: invoice correction recipients do not match the original invoice. Revisa los logs de cada nota de crédito que crees.
Serie de numeración separada
Sección titulada «Serie de numeración separada»Las notas de crédito deben usar una serie de numeración secuencial separada (p. ej. CN-2026-000001). Incluye el prefijo de la serie en document.number y deja document.series sin definir.
Tipo de línea
Sección titulada «Tipo de línea»El tipo de documento no lo defines tú: se deriva de la operación de la Unified API que llamas. Una CORRECTION produce una nota de crédito y una INVOICE produce una factura, sea cual sea el tipo de línea.
Establece entries[].type = RETURN en cada línea abonada, con importes positivos. Las líneas de la factura original usan SALE.
Para cobrar artículos nuevos, emite una factura aparte.
Campos de línea que no tienes que hacer coincidir
Sección titulada «Campos de línea que no tienes que hacer coincidir»Dos campos de entries[] generan trabajo innecesario en una nota de crédito:
entries[].details.numberno se usa en facturación electrónica. Existe para los productos de fiscalización, donde identifica la línea original que se corrige. No traslades los números de línea originales a una nota de crédito: el vínculo con la factura original se establece una sola vez, a nivel de documento, medianteoperation.record.id.entries[].data.textno se valida y no tiene que repetir el texto de la factura original.
Una factura, varias notas de crédito
Sección titulada «Una factura, varias notas de crédito»Varias notas de crédito pueden hacer referencia a la misma factura original — por ejemplo, cuando la mercancía de una misma factura se devuelve en varios envíos, o cuando se abonan líneas distintas en momentos distintos. Cada una es un record CORRECTION independiente con el mismo operation.record.id que contiene únicamente las líneas que abona. La factura original sigue siendo válida para las líneas no abonadas. Asegúrate de que las notas de crédito de una misma factura no sumen más que la factura. Una nota de crédito que se ha anulado con una nueva factura ya no cuenta para este total.
fiskaly no comprueba este total: una nota de crédito por encima del importe restante se acepta y se envía. Llevar el control del total abonado es responsabilidad tuya.
Una nota de crédito nunca se abona
Sección titulada «Una nota de crédito nunca se abona»Una nota de crédito siempre hace referencia a una factura, nunca a otra nota de crédito. No puedes emitir un CORRECTION sobre una nota de crédito: la solicitud falla con 405. La única forma de anular una nota de crédito es una nueva factura que haga referencia a ella.
Si la propia nota de crédito debe corregirse, emite en su lugar un documento nuevo. Cuál, depende de lo que estuviera mal:
| Qué estaba mal | Acción | Documentos emitidos |
|---|---|---|
| Crédito insuficiente | Abona el importe que falta | Otra nota de crédito que hace referencia a la factura original |
| Crédito excesivo o emitida por error | Factura la diferencia | Nueva factura que hace referencia a la nota de crédito |
| Datos erróneos en la nota de crédito | Factura el importe de la nota de crédito y vuelve a abonar correctamente | Nueva factura que hace referencia a la nota de crédito + nueva nota de crédito que hace referencia a la factura original |
Crédito insuficiente
Sección titulada «Crédito insuficiente»Original Invoice INV-001 €6300.00 ↓Credit Note CN-001 €300.00 (references INV-001, should have been €600.00) ↓Credit Note CN-002 €300.00 (references INV-001, the missing amount) ↓Net result: €5700.00Crédito excesivo o emitida por error
Sección titulada «Crédito excesivo o emitida por error»Original Invoice INV-001 €6300.00 ↓Credit Note CN-001 €6300.00 (references INV-001, should have been €600.00) ↓New Invoice INV-002 €5700.00 (references CN-001, the difference) ↓Net result: €5700.00Si la nota de crédito se emitió por error, la nueva factura es por el importe total de la nota de crédito.
Datos erróneos en la nota de crédito
Sección titulada «Datos erróneos en la nota de crédito»Original Invoice INV-001 €6300.00 ↓Credit Note CN-001 €600.00 (references INV-001, wrong data) ↓New Invoice INV-002 €600.00 (references CN-001, reverses it) ↓Credit Note CN-002 €600.00 (references INV-001, correct data) ↓Net result: €5700.00La nueva factura incluye en document.references.preceding_document el número y la fecha de emisión de la nota de crédito que revierte.
Abonar una factura que fiskaly no transmitió
Sección titulada «Abonar una factura que fiskaly no transmitió»El tipo de documento se deriva de la operación y no lo defines tú: una CORRECTION produce una nota de crédito y una INVOICE produce una factura. Referenciar una factura emitida externamente como documento precedente en una operación INVOICE se transmitirá correctamente, pero el documento lleva el tipo factura, lo que incrementa el importe adeudado en lugar de cancelarlo.
Si estás migrando a fiskaly, mantén disponible tu sistema de facturación electrónica anterior hasta que toda factura emitida en él esté liquidada o abonada. Cuando una corrección puntual sea inevitable, algunas autoridades fiscales permiten al comerciante emitir una nota de crédito manualmente, fuera de su proveedor: la disponibilidad y el procedimiento varían según el país, así que consulta la página del país correspondiente.
Reglas específicas por país
Sección titulada «Reglas específicas por país»- Alemania: los datos que hay que volver a enviar en cada nota de crédito y cómo reflejar los reembolsos en
payments. Consulta Alemania: notas de crédito.