Codis de tipus de document FatturaPA

Quan envieu factures a l’SDI italià (Sistema di Interscambio) en format FatturaPA, podeu especificar el tipus de document mitjançant el camp type_document. Aquest camp es correspon amb l’element TipoDocumento de l’estructura XML de FatturaPA.

Ús

El camp type_document és opcional en crear factures. Si no s’informa, B2Brouter assignarà automàticament un valor per defecte adequat segons el tipus de factura, com ara factura estàndard o nota de crèdit.

Definir type_document via API

{
  "invoice": {
    "type_document": "TD01",
    "number": "1",
    "date": "2025-01-26",
    "contact_id": 12345,
    "invoice_lines_attributes": [...]
  }
}

Codis vàlids de tipus de document FatturaPA

Els codis següents són vàlids per a factures italianes FatturaPA:

Tipus de factura

Code	Description (Italian)	Description (English)
TD01	Fattura	Standard invoice
TD02	Acconto/Anticipo su fattura	Down payment / Advance on invoice
TD03	Acconto/Anticipo su parcella	Down payment / Advance on proforma invoice
TD04	Nota di credito	Credit note
TD05	Nota di debito	Debit note
TD06	Parcella	Proforma invoice
TD16	Integrazione fattura reverse charge interno	Local reverse charge
TD17	Integrazione o autofattura per acquisti di servizi da soggetto non residente ai sensi dell’articolo 17, comma 2, DPR 633/1972	Self-billing for EU services
TD18	Integrazione della fattura del fornitore UE per acquisto intracomunitario di beni	EU acquisition reverse charge
TD19	Integrazione o autofattura per acquisti di beni da soggetti non residenti ai sensi dell’articolo 17, comma 2, DPR 633/1972	Not resident acquisition reverse charge
TD20	Autofattura per regolarizzazione e integrazione delle fatture	Self-billing
TD21	In caso di emissione di autofattura per regolarizzazione dello splafonamento	Regulated plafond self invoice
TD22	In caso di estrazione beni da Deposito IVA	VAT deposit
TD23	In caso di estrazione beni da Deposito IVA con versamento dell’IVA	VAT deposit with VAT payment
TD24	Fattura differita – art 21, 4 comma, lett. a), del DPR 633/72, quindi fattura differita di beni e servizi collegata a DDT per i beni o da idonea documentazione di prova dell’effettuazione per le prestazioni di servizio	Deferred invoice with DDT
TD25	Fattura differita di cui all’art. 21, 4 comma, lett. b), del DPR 633/72, quindi fattura differita per operazioni triangolari interne	Deferred invoice for internal triangular operations
TD26	Per la cessione di beni ammortizzabili e per passaggi interni	Sales of assets
TD27	In caso di fatture per auto consumo o per cessioni gratuite senza rivalsa	Free of charge or self-consumption

Consideracions especials

TD16-TD19 (documents d’integració)

Aquests codis representen documents d’integració per a reverse charge i mecanismes similars. Quan utilitzeu aquests codis:

• Afecten el càlcul de l’import executable
• S’hi aplica un tractament fiscal especial
• La factura representa un escenari d’autofacturació o d’integració

Comportament per defecte

Si no s’especifica type_document:

• TD01 s’utilitza per a factures estàndard
• TD04 s’utilitza per a notes de crèdit, quan is_credit_note: true
• Els altres tipus s’han d’indicar explícitament quan calgui

Validació

Els codis no vàlids provoquen un error de validació que indica la llista de codis vàlids.

Exemple: factura completa amb type_document

{
  "send_after_import": true,
  "invoice": {
    "type": "IssuedInvoice",
    "type_document": "TD01",
    "number": "FAT-2025-001",
    "date": "2025-01-26",
    "due_date": "2025-02-26",
    "contact_id": 12345,
    "invoice_lines_attributes": [
      {
        "quantity": 1,
        "price": 100.0,
        "description": "Professional services",
        "taxes_attributes": [
          {
            "name": "IVA",
            "percent": 22
          }
        ]
      }
    ]
  }
}