FatturaPA Dokumenttyp-Codes

Beim Versand von Rechnungen an die italienische SDI (Sistema di Interscambio) im FatturaPA-Format können Sie den Dokumenttyp mit dem Feld type_document angeben. Dieses Feld entspricht dem Element TipoDocumento in der FatturaPA-XML-Struktur.

Verwendung

Das Feld type_document ist optional beim Erstellen von Rechnungen. Falls nicht angegeben, weist B2Brouter automatisch einen geeigneten Standardwert basierend auf dem Rechnungstyp (Standardrechnung, Gutschrift usw.) zu.

Setting type_document via API

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

Gültige FatturaPA-Dokumenttyp-Codes

Die folgenden Codes sind gültig für italienische FatturaPA-Rechnungen:

Rechnungstypen

Code	Beschreibung (Italienisch)	Beschreibung (English)
TD01	Fattura	Standardrechnung
TD02	Acconto/Anticipo su fattura	Anzahlung / Vorschuss auf Rechnung
TD03	Acconto/Anticipo su parcella	Anzahlung / Vorschuss auf Proforma-Rechnung
TD04	Nota di credito	Gutschrift
TD05	Nota di debito	Lastschrift
TD06	Parcella	Proforma-Rechnung
TD16	Integrazione fattura reverse charge interno	Lokale Reverse Charge
TD17	Integrazione o autofattura per acquisti di servizi da soggetto non residente ai sensi dell’articolo 17, comma 2, DPR 633/1972	Selbstfakturierung für EU-Dienstleistungen
TD18	Integrazione della fattura del fornitore UE per acquisto intracomunitario di beni	EU-Kauf Reverse Charge
TD19	Integrazione o autofattura per acquisti di beni da soggetti non residenti ai sensi dell’articolo 17, comma 2, DPR 633/1972	Erwerb von Nichtansässigen Reverse Charge
TD20	Autofattura per regolarizzazione e integrazione delle fatture	Selbstfakturierung
TD21	In caso di emissione di autofattura per regolarizzazione dello splafonamento	Regulierte Schwellenüberschreitung Selbstrechnung
TD22	In caso di estrazione beni da Deposito IVA	Umsatzsteuer-Depot
TD23	In caso di estrazione beni da Deposito IVA con versamento dell’IVA	Umsatzsteuer-Depot mit Umsatzsteuer-Zahlung
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	Gestaffelte Rechnung mit DDT
TD25	Fattura differita di cui all’art. 21, 4 comma, lett. b), del DPR 633/72, quindi fattura differita per operazioni triangolari interne	Gestaffelte Rechnung für interne Dreiecksoperationen
TD26	Per la cessione di beni ammortizzabili e per passaggi interni	Verkauf von Vermögenswerten
TD27	In caso di fatture per auto consumo o per cessioni gratuite senza rivalsa	Unentgeltliche oder Eigenverbrauchsrechnung

Besondere Überlegungen

TD16-TD19 (Integrationsdokumente)

Diese Codes stellen Integrationsdokumente für Reverse Charge und ähnliche Mechanismen dar. Bei Verwendung dieser Codes:

• Sie beeinflussen die Berechnung des ausführbaren Betrags
• Besondere Steuerbehandlung gilt
• Die Rechnung stellt ein Selbstfakturierungs- oder Integrationsszenario dar

Standardverhalten

Wenn type_document nicht angegeben wird:

• TD01 wird für Standardrechnungen verwendet
• TD04 wird für Gutschriften verwendet (wenn is_credit_note: true)
• Andere Typen müssen bei Bedarf explizit festgelegt werden

Validierung

Ungültige Codes führen zu einem Validierungsfehler, das die Liste der gültigen Codes angibt.

Beispiel: Vollständige Rechnung mit 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": "Professionelle Dienstleistungen",
        "taxes_attributes": [
          {
            "name": "IVA",
            "percent": 22
          }
        ]
      }
    ]
  }
}