E-INVOICE - Come rappresentare i pagamenti su una fattura

I pagamenti vengono trasmessi in payments[] sull'operazione di fattura. L'array accetta da 1 a 10 elementi. I campi da valorizzare dipendono dal fatto che la fattura sia già stata saldata oppure no.

Pagamento già incassato

Si seleziona il tipo di pagamento applicabile — CASH, CARD, ONLINE, VOUCHER o OTHER — e si valorizza details.amount.  Alcuni tipi richiedono campi aggiuntivi:

Facoltativamente, details può contenere anche date, discount e properties. La currency del primo pagamento dell'array determina la valuta dell'intera fattura ed  EUR è l'unico valore accettato.

I pagamenti di questi tipi risultano già incassati e riducono l'importo che l'acquirente deve ancora corrispondere sulla fattura. Gli scenari possibili sono 2:

• Se coprono il totale della fattura, non serve altro.
•  Se non lo coprono, si aggiunge un pagamento OUTSTANDING per l'importo residuo; in caso contrario la fattura viene rifiutata perché gli importi non quadrano.

Pagamento ancora da incassare

Si utilizza payments[].type: "OUTSTANDING". payments[].concept è richiesto e indica se l'importo residuo riguarda un GOOD, un SERVICE o una INVOICE. 

OUTSTANDING prevede un oggetto details: 

• details.amount è richiesto e contiene l'importo ancora dovuto. 
• anche details.date è richiesto e imposta la data di scadenza del pagamento: un pagamento da incassare privo di data di scadenza viene rifiutato.

• Istruzione di pagamento
  L'oggetto instruction è facoltativo. Si aggiunge quando sulla fattura si vuole indicare all'acquirente come effettuare il pagamento: nel caso di un bonifico bancario contiene l'IBAN sul quale l'acquirente invia il denaro.

  Se viene omesso, la fattura viene comunque accettata e trasmessa. In questo caso fiskaly riporta la modalità di pagamento come bonifico bancario, senza alcun dato di conto. Si include quindi un'instruction quando si vogliono riportare in fattura i propri dati di conto, oppure quando l'acquirente paga in altro modo (ad esempio con addebito diretto SEPA).

  Quando instruction viene fornito, instruction.type è CREDIT_TRANSFER oppure DIRECT_DEBIT. Un'istruzione priva di uno di questi campi viene rifiutata:

   

  • CREDIT_TRANSFER richiede type, account, name e payment_service_provider: tutti e quattro. L'IBAN va in account, in formato ISO 13616 (15–34 caratteri). payment_service_provider è il codice BIC/SWIFT della banca (ad es. BCITITMM): il nome della banca non viene accettato.

  • DIRECT_DEBIT richiede type, mandate_reference, creditor_id e debited_account, con l'IBAN in debited_account. 

    Si noti che creditor_id è un oggetto e non una stringa — { "type": "SEPA", "identifier": "IT05ZZZ12345678901" } — e che l'identificativo è da indicare nel formato dell'identificativo creditore SEPA (9–35 caratteri), in cui il carattere successivo al codice business di tre lettere è una cifra.

    Entrambe le varianti accettano inoltre i campi facoltativi text e properties.  properties ha una struttura diversa a seconda di dove compare: su details è un oggetto con un massimo di 16 voci i cui valori sono stringhe fino a 64 caratteri, mentre su instruction è una singola stringa fino a 128 caratteri.

Esempio di pagamento da incassare tramite bonifico bancario

{
  "payments": [
    {
      "type": "OUTSTANDING",
      "concept": "INVOICE",
      "details": {
        "amount": "122.00",
        "date": "2026-09-30"
      },
      "instruction": {
        "type": "CREDIT_TRANSFER",
        "account": "IT60X0542811101000000123456",
        "name": "Officina Rossi S.r.l.",
        "payment_service_provider": "BCITITMM"
      }
    }
  ]
}

Esempio di pagamento da incassare tramite addebito diretto SEPA

Rispetto all'esempio con bonifico riportato sopra cambia solo l'oggetto instruction; type, concept e details restano invariati.

{
  "instruction": {
    "type": "DIRECT_DEBIT",
    "mandate_reference": "MANDATE-2026-0042",
    "creditor_id": {
      "type": "SEPA",
      "identifier": "IT05ZZZ12345678901"
    },
    "debited_account": "IT60X0542811101000000123456"
  }
}