Codes de type de document FatturaPA

Lors de l’envoi de factures au SDI italien (Sistema di Interscambio) au format FatturaPA, vous pouvez spécifier le type de document à l’aide du champ type_document. Ce champ correspond à l’élément TipoDocumento dans la structure XML FatturaPA.

Utilisation

Le champ type_document est optionnel lors de la création de factures. S’il n’est pas fourni, B2Brouter attribuera automatiquement une valeur par défaut appropriée en fonction du type de facture (facture standard, avoir, etc.).

Définir type_document via l’API

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

Codes de type de document FatturaPA valides

Les codes suivants sont valides pour les factures italiennes FatturaPA :

Types de facture

Code	Description (italien)	Description (français)
TD01	Fattura	Facture standard
TD02	Acconto/Anticipo su fattura	Acompte / avance sur facture
TD03	Acconto/Anticipo su parcella	Acompte / avance sur facture pro forma
TD04	Nota di credito	Avoir
TD05	Nota di debito	Note de débit
TD06	Parcella	Facture pro forma
TD16	Integrazione fattura reverse charge interno	Autoliquidation locale
TD17	Integrazione o autofattura per acquisti di servizi da soggetto non residente ai sensi dell’articolo 17, comma 2, DPR 633/1972	Auto-facturation pour services UE
TD18	Integrazione della fattura del fornitore UE per acquisto intracomunitario di beni	Autoliquidation pour acquisition intracommunautaire
TD19	Integrazione o autofattura per acquisti di beni da soggetti non residenti ai sensi dell’articolo 17, comma 2, DPR 633/1972	Autoliquidation pour acquisition auprès d’un non-résident
TD20	Autofattura per regolarizzazione e integrazione delle fatture	Auto-facturation
TD21	In caso di emissione di autofattura per regolarizzazione dello splafonamento	Auto-facture pour régularisation du plafond
TD22	In caso di estrazione beni da Deposito IVA	Dépôt TVA
TD23	In caso di estrazione beni da Deposito IVA con versamento dell’IVA	Dépôt TVA avec paiement de la TVA
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	Facture différée avec DDT
TD25	Fattura differita di cui all’art. 21, 4 comma, lett. b), del DPR 633/72, quindi fattura differita per operazioni triangolari interne	Facture différée pour opérations triangulaires internes
TD26	Per la cessione di beni ammortizzabili e per passaggi interni	Vente d’immobilisations
TD27	In caso di fatture per auto consumo o per cessioni gratuite senza rivalsa	Gratuité ou autoconsommation

Points particuliers

TD16-TD19 (documents d’intégration)

Ces codes représentent des documents d’intégration pour l’autoliquidation et des mécanismes similaires. Lors de l’utilisation de ces codes :

• Ils affectent le calcul du montant exécutable
• Un traitement fiscal spécial s’applique
• La facture représente un scénario d’auto-facturation ou d’intégration

Comportement par défaut

Si type_document n’est pas spécifié :

• TD01 est utilisé pour les factures standard
• TD04 est utilisé pour les avoirs (lorsque is_credit_note: true)
• Les autres types doivent être explicitement définis si nécessaire

Validation

Des codes invalides produiront une erreur de validation indiquant la liste des codes valides.

Exemple : facture complète avec 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
          }
        ]
      }
    ]
  }
}