Tipo documento (TD)
The tipo_documento values FatturaPA allows, from TD01 to TD29.
tipo_documento maps to the FatturaPA field 2.1.1.1 TipoDocumento. Descriptions are the official Italian ones, with an English gloss.
Ordinary invoice
| Code | Official description | In English |
|---|---|---|
TD01 | Fattura | Invoice. The normal case |
TD02 | Acconto/anticipo su fattura | Advance payment on an invoice |
TD03 | Acconto/anticipo su parcella | Advance payment on a professional fee note |
TD04 | Nota di credito | Credit note |
TD05 | Nota di debito | Debit note |
TD06 | Parcella | Professional fee note |
TD16 | Integrazione fattura reverse charge interno | Self-billing, domestic reverse charge |
TD17 | Integrazione/autofattura per acquisto servizi dall'estero | Self-billing, services bought from abroad |
TD18 | Integrazione per acquisto di beni intracomunitari | Self-billing, goods bought in the EU |
TD19 | Integrazione/autofattura per acquisto di beni ex art. 17 c. 2 DPR 633/72 | Self-billing, goods from non-resident suppliers |
TD20 | Autofattura per regolarizzazione e integrazione delle fatture (ex art. 6 c. 9-bis D.Lgs. 471/97 o art. 46 c. 5 D.L. 331/93) | Self-billing to correct or complete invoices |
TD21 | Autofattura per splafonamento | Self-billing for exceeding the VAT-free ceiling (seller and buyer are the same) |
TD22 | Estrazione beni da Deposito IVA | Goods taken out of a VAT warehouse |
TD23 | Estrazione beni da Deposito IVA con versamento dell'IVA | Same, with VAT paid |
TD24 | Fattura differita di cui all'art. 21, comma 4, lett. a) | Deferred invoice for goods with delivery notes or documented services |
TD25 | Fattura differita di cui all'art. 21, comma 4, terzo periodo lett. b) | Deferred invoice for triangular sales |
TD26 | Cessione di beni ammortizzabili e per passaggi interni (ex art. 36 DPR 633/72) | Sale of depreciable assets and internal transfers |
TD27 | Fattura per autoconsumo o per cessioni gratuite senza rivalsa | Own use or free supplies (seller and buyer are the same) |
TD28 | Acquisti da San Marino con IVA (fattura cartacea) | Purchases from San Marino with VAT (paper invoice) |
TD29 | Comunicazione per omessa o irregolare fatturazione (art. 6, comma 8, D.Lgs. 471/97) | Report of a missing or irregular invoice. Since spec version 1.9 |
Codes TD07 to TD15 are not used in the ordinary invoice.
Simplified invoice
| Code | Official description | In English |
|---|---|---|
TD07 | Fattura semplificata | Simplified invoice |
TD08 | Nota di credito semplificata | Simplified credit note |
TD09 | Nota di debito semplificata | Simplified debit note |
SDI checks tied to the document type
00471: forTD01,TD02,TD03,TD06,TD16–TD20,TD24,TD25,TD28,TD29(andTD07) seller and buyer must be different parties.00472: forTD21andTD27seller and buyer must be the same.00473:TD17,TD18,TD19andTD28do not allow an Italian seller;TD29requires an Italian seller.00475:TD16–TD20,TD22,TD23,TD28andTD29require the buyer's VAT number.
Details in SDI rejection codes.
Source: Agenzia delle Entrate, FatturaPA format technical specifications version 1.4 and Allegato A technical specifications version 1.9 (31 January 2025).
bank_connection.expired Webhook
The consent of a bank connection ended or was revoked (status requires_reconnect; once per consent): automatic updates stopped until it is reconnected. data.object is the BankConnection. Live endpoints only. Sent as JSON with a Getbeel-Signature header (t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" keyed with your endpoint secret>). Answer 2xx; other answers are retried with backoff for about 3 days.
Natura IVA (N)
The natura codes for lines without VAT, N1 to N7 with sub-codes.