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, comprador incorrecto 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

Úsalo cuando la factura original nunca debería haberse emitido (duplicado, comprador incorrecto, pedido cancelado).

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

Para los escenarios de corrección e importe insuficiente, 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", ... }
}
}
}

Usa el mismo destinatario que en la factura original, con el mismo canal de entrega y formato.

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