Ir al contenido

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.

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.

Llama al endpoint createRecord con un Registro de tipo TRANSACTION:

  • Establece el tipo de operación en CORRECTION con data.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"
}
}
]
}
}
}
}
EscenarioAcciónDocumentos emitidos
Cancelación total — duplicado o transacción canceladaAcreditar el importe totalSolo nota de crédito
Crédito parcial — devolución, descuento o sobrefacturaciónAcreditar solo las líneas o importes afectadosSolo nota de crédito
Corrección — datos o importes incorrectos en la factura originalAcreditar el importe total y luego re-emitir corregidaNota de crédito + nueva factura
Importe insuficiente — el importe original era demasiado bajoAcreditar el importe total y luego re-emitir con el importe correctoNota de crédito + nueva factura
Destinatario incorrecto — factura enviada al comprador equivocadoAcreditar el importe total al destinatario original y luego facturar al destinatario correctoNota de crédito + nueva factura

Ú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.00

La factura original permanece en el registro. La nota de crédito crea una reversión total.

Ú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.00

Solo 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.

Ú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.00

Revierte 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.00

Destinatario 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.

Para los escenarios de corrección, importe insuficiente y destinatario incorrecto, se necesitan dos transacciones separadas:

  1. Crea un registro CORRECTION (nota de crédito) que haga referencia a la factura original
  2. Crea un nuevo registro INVOICE con los datos corregidos

Ambos registros siguen el flujo estándar INTENTION → TRANSACTION.

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", ... }
}
}
}

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.

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.

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.

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.number no 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, mediante operation.record.id.
  • entries[].data.text no se valida y no tiene que repetir el texto de la factura original.

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.

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 malAcciónDocumentos emitidos
Crédito insuficienteAbona el importe que faltaOtra nota de crédito que hace referencia a la factura original
Crédito excesivo o emitida por errorFactura la diferenciaNueva factura que hace referencia a la nota de crédito
Datos erróneos en la nota de créditoFactura el importe de la nota de crédito y vuelve a abonar correctamenteNueva factura que hace referencia a la nota de crédito + nueva nota de crédito que hace referencia a la factura original
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.00
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.00

Si la nota de crédito se emitió por error, la nueva factura es por el importe total de 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.00

La 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ó»
  • 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.