Section navigation

Nota de crédito

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.

Cuándo emitir una nota de crédito

Escenario	Acción	Documentos emitidos
Cancelación total — duplicado, comprador incorrecto 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

Flujos de corrección

Cancelación total

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

Factura original   INV-001   €6.300
     ↓
Nota de crédito    CN-001    €6.300  (referencia INV-001)
     ↓
Resultado neto: €0

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

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

Factura original   INV-001   €6.300
     ↓
Nota de crédito    CN-002    €600    (referencia INV-001, solo líneas afectadas)
     ↓
Resultado neto: €5.700

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.

Corrección (crédito + re-emisión)

Úsalo cuando la factura original contenía datos o importes incorrectos.

Factura original   INV-001   €6.300
     ↓
Nota de crédito    CN-003    €6.300  (reversión total, referencia INV-001)
     ↓
Nueva factura      INV-002   €5.950  (datos corregidos)
     ↓
Resultado neto: €5.950

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)

Úsalo cuando el importe de la factura original era demasiado bajo.

Factura original   INV-001   €5.000
     ↓
Nota de crédito    CN-004    €5.000  (reversión total, referencia INV-001)
     ↓
Nueva factura      INV-003   €6.300  (importe correcto)
     ↓
Resultado neto: €6.300

Reglas

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.

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

El destinatario de la nota de crédito debe coincidir con el destinatario de la factura original.

Serie de numeración separada

Las notas de crédito deben usar una serie de numeración secuencial separada (p. ej. CN-2026-000001). Proporciónala a través del campo series, de la misma manera que para las facturas estándar.

Tipo de línea

Cada línea abonada usa entries[].type = SALE, el mismo tipo de línea que en una factura estándar. Es el tipo de documento — no el tipo de línea — el que indica que los importes son abonos.

El tipo de línea no aporta ninguna semántica de abono o devolución en la facturación electrónica. En Italia no se lee en absoluto al generar la FatturaPA, de modo que poner RETURN — el valor que usan los productos SIGN en una corrección — no convierte el documento en una nota de crédito. Solo lo hace la operación que invocas.

Campos de línea que no tienes que hacer coincidir

Dos campos 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. A diferencia de SIGN IT, donde se espera que coincida, puedes describir la línea abonada como deba aparecer.

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.

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. Si la propia nota de crédito debe corregirse, usa el flujo de nota de crédito + reemisión descrito abajo: una nota de crédito posterior hace referencia a la factura de reemplazo, no a la nota de crédito anterior.

Abonar una factura que fiskaly no transmitió

⚠️Una factura emitida externamente no puede abonarse

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.

Esto se deriva del diseño actual de la Unified API y puede cambiar en una versión futura.

Uso de la API

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

Llama al endpoint createRecord con un Registro de tipo TRANSACTION:

Establece el tipo de operación en CORRECTION con data.type = INVOICE
Incluye la referencia al documento precedente de la factura original
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",
          "series": "CN"
        },
        "entries": [
          {
            "type": "SALE",
            "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"
            }
          }
        ]
      }
    }
  }
}

💡Nota

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.

Nota de crédito + re-emisión

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

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

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