Códigos de tipo de documento FatturaPA

Al enviar facturas al SDI italiano (Sistema di Interscambio) en formato FatturaPA, puedes especificar el tipo de documento mediante el campo type_document. Este campo corresponde al elemento TipoDocumento en la estructura XML de FatturaPA.

Uso

El campo type_document es opcional al crear facturas. Si no se proporciona, B2Brouter asignará automáticamente un valor predeterminado adecuado según el tipo de factura (factura ordinaria, nota de crédito, etc.).

Configurar type_document mediante la API

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

Códigos de tipo de documento FatturaPA válidos

Los siguientes códigos son válidos para facturas italianas FatturaPA:

Tipos de documento

Código	Descripción (italiano)	Descripción (español)
TD01	Fattura	Factura estándar
TD02	Acconto/Anticipo su fattura	Anticipo sobre factura
TD03	Acconto/Anticipo su parcella	Anticipo sobre factura proforma
TD04	Nota di credito	Nota de crédito
TD05	Nota di debito	Nota de débito
TD06	Parcella	Factura proforma
TD16	Integrazione fattura reverse charge interno	Inversión del sujeto pasivo local
TD17	Integrazione o autofattura per acquisti di servizi da soggetto non residente ai sensi dell’articolo 17, comma 2, DPR 633/1972	Autofactura por servicios de la UE
TD18	Integrazione della fattura del fornitore UE per acquisto intracomunitario di beni	Inversión del sujeto pasivo por adquisición UE
TD19	Integrazione o autofattura per acquisti di beni da soggetti non residenti ai sensi dell’articolo 17, comma 2, DPR 633/1972	Inversión del sujeto pasivo por adquisición no residente
TD20	Autofattura per regolarizzazione e integrazione delle fatture	Autofactura
TD21	In caso di emissione di autofattura per regolarizzazione dello splafonamento	Autofactura por regularización de plafón
TD22	In caso di estrazione beni da Deposito IVA	Depósito de IVA
TD23	In caso di estrazione beni da Deposito IVA con versamento dell’IVA	Depósito de IVA con pago del IVA
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	Factura diferida con DDT
TD25	Fattura differita di cui all’art. 21, 4 comma, lett. b), del DPR 633/72, quindi fattura differita per operazioni triangolari interne	Factura diferida para operaciones triangulares internas
TD26	Per la cessione di beni ammortizzabili e per passaggi interni	Venta de activos
TD27	In caso di fatture per auto consumo o per cessioni gratuite senza rivalsa	Consumo propio o cesión gratuita

Consideraciones especiales

TD16-TD19 (Documentos de integración)

Estos códigos representan documentos de integración para la inversión del sujeto pasivo y mecanismos similares. Al utilizar estos códigos:

• Afectan al cálculo del importe ejecutable
• Se aplica un tratamiento fiscal especial
• La factura representa un escenario de autofacturación o integración

Comportamiento predeterminado

Si no se especifica type_document:

• TD01 se usa para facturas estándar
• TD04 se usa para notas de crédito (cuando is_credit_note: true)
• Los demás tipos deben configurarse explícitamente cuando sean necesarios

Validación

Los códigos no válidos generarán un error de validación que indicará la lista de códigos permitidos.

Ejemplo: Factura completa con 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
          }
        ]
      }
    ]
  }
}