# BR-04 Codice tipo fattura obbligatorio

Una fattura deve avere un codice tipo fattura (BT-3) che identifichi il tipo funzionale del documento, ad esempio fattura commerciale o nota di credito.

## Descrizione del problema

> **ERRORE**: Regola di business della norma EN 16931 (CEN)

## Contesto e significato

È una regola di base della norma EN 16931. Il codice tipo indica al destinatario se trattare il documento come fattura, fattura rettificativa o nota di credito; regole nazionali come BR-DE-17 restringono ulteriormente i codici accettati. Né lo schema UBL né quello CII rendono obbligatorio l’elemento, quindi un’esportazione che lo omette supera il controllo di schema e fallisce solo su BR-04.

## Soluzione

Aggiungi cbc:InvoiceTypeCode con un codice UNTDID 1001 consentito, ad esempio 380 per una fattura commerciale o 384 per una fattura rettificativa. In UBL una nota di credito (381) si emette come documento CreditNote con cbc:CreditNoteTypeCode; BR-CL-01 rifiuta 381 in cbc:InvoiceTypeCode. In CII il codice si trova in rsm:ExchangedDocument/ram:TypeCode.

- [Valida XML](/it/xrechnung-validator?source=resource&rule=BR-04)
- [Converti fattura](/it/pdf-to-xrechnung?source=resource&rule=BR-04)

## Esempi validi

- BT-3 = 380 — fattura commerciale
- BT-3 = 381 — nota di credito (in UBL come cbc:CreditNoteTypeCode in un documento CreditNote)

## Esempi non validi

- L’elemento cbc:InvoiceTypeCode è assente nell’intestazione della fattura

## Esempi di codice

### XML valido
```
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
```

### XML non valido
```
<cbc:IssueDate>2024-05-01</cbc:IssueDate>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
```

## Campi interessati

- [BT-3 Codice tipo fattura](/resources/xrechnung/bt-3-invoice-type-code)

## Regole correlate

- [BR-02](/resources/kosit-validator-errors/br-02-invoice-number-required)
- [BR-03](/resources/kosit-validator-errors/br-03-invoice-issue-date-required)

## Strumenti di validazione

- [Validatore KoSIT ufficiale](https://github.com/itplr-kosit/validator): Esegui il validatore ufficiale KoSIT con la configurazione XRechnung per controllare le regole EN 16931 e XRechnung.
- [Converti PDF in XRechnung](/pdf-to-xrechnung): Individua gli errori di validazione durante la conversione e verifica ogni correzione.

## Risorse correlate

- [Specifiche ufficiali](https://docs.peppol.eu/poacc/billing/3.0/rules/ubl-tc434/)
- [Test suite](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Tutti gli errori di validazione](/resources/kosit-validator-errors): Panoramica delle regole di validazione EN 16931, XRechnung e Peppol spiegate qui.