Costruzione, validazione e serializzazione fatture elettroniche FatturaPA.
Builder fluent per la costruzione di fatture.
import { FatturaBuilder } from '@fatturazione-elettronica-aruba/xml-builder';
const builder = FatturaBuilder.create();
Crea una nuova istanza del builder.
const builder = FatturaBuilder.create();
Imposta la versione dello schema (default: '1.2.2').
builder.setVersione('1.2.2');
Imposta i dati di trasmissione completi.
builder.setDatiTrasmissione({
idTrasmittente: { idPaese: 'IT', idCodice: '01234567890' },
progressivoInvio: '00001',
formatoTrasmissione: 'FPR12',
codiceDestinatario: 'ABC1234',
pecDestinatario?: string,
contattiTrasmittente?: { telefono?: string, email?: string },
});
Helper per trasmissione B2B (formato FPR12).
builder.setTrasmissioneB2B({
idPaese: string;
idCodice: string;
progressivoInvio: string;
codiceDestinatario?: string; // Default: '0000000'
pecDestinatario?: string;
});
Helper per trasmissione PA (formato FPA12).
builder.setTrasmissionePA({
idPaese: string;
idCodice: string;
progressivoInvio: string;
codiceDestinatario: string; // Codice IPA 6 caratteri
});
Imposta il cedente/prestatore (venditore).
builder.setCedentePrestatore({
datiAnagrafici: {
idFiscaleIVA?: { idPaese: string, idCodice: string },
codiceFiscale?: string,
anagrafica: { denominazione?: string, nome?: string, cognome?: string },
regimeFiscale: RegimeFiscale,
},
sede: Indirizzo,
stabileOrganizzazione?: Indirizzo,
iscrizioneREA?: IscrizioneREA,
contatti?: Contatti,
riferimentoAmministrazione?: string,
});
Imposta il cessionario/committente (acquirente).
builder.setCessionarioCommittente({
datiAnagrafici: {
idFiscaleIVA?: { idPaese: string, idCodice: string },
codiceFiscale?: string,
anagrafica: { denominazione?: string, nome?: string, cognome?: string },
},
sede: Indirizzo,
stabileOrganizzazione?: Indirizzo,
rappresentanteFiscale?: RappresentanteFiscale,
});
Imposta i dati generali del documento.
builder.setDatiGenerali({
datiGeneraliDocumento: {
tipoDocumento: TipoDocumento,
divisa: string, // Es: 'EUR'
data: string, // YYYY-MM-DD
numero: string,
importoTotaleDocumento?: number,
causale?: string[],
datiRitenuta?: DatiRitenuta,
datiBollo?: DatiBollo,
},
datiOrdineAcquisto?: DatiDocumentoCorrelato[],
datiContratto?: DatiDocumentoCorrelato[],
datiDDT?: DatiDDT[],
});
Imposta le linee di dettaglio e riepilogo IVA.
builder.setDatiBeniServizi({
dettaglioLinee: [
{
numeroLinea: number,
descrizione: string,
quantita?: number,
unitaMisura?: string,
prezzoUnitario: number,
prezzoTotale: number,
aliquotaIVA: number,
natura?: Natura,
scontoMaggiorazione?: ScontoMaggiorazione[],
},
],
datiRiepilogo: [
{
aliquotaIVA: number,
imponibileImporto: number,
imposta: number,
natura?: Natura,
esigibilitaIVA?: 'I' | 'D' | 'S',
riferimentoNormativo?: string,
},
],
});
Aggiunge dati di pagamento.
builder.addDatiPagamento({
condizioniPagamento: 'TP01' | 'TP02' | 'TP03',
dettaglioPagamento: [
{
modalitaPagamento: ModalitaPagamento,
importoPagamento: number,
dataScadenzaPagamento?: string,
iban?: string,
istitutoFinanziario?: string,
},
],
});
Finalizza il body corrente e inizia uno nuovo (per fatture lotto).
builder
.setDatiGenerali({ ... })
.setDatiBeniServizi({ ... })
.newBody()
.setDatiGenerali({ ... }) // Nuova fattura
.setDatiBeniServizi({ ... });
Costruisce la fattura elettronica.
const fattura: FatturaElettronica = builder.build();
Resetta il builder allo stato iniziale.
builder.reset();
Validatore per fatture elettroniche.
import { FatturaValidator, validateFattura } from '@fatturazione-elettronica-aruba/xml-builder';
// Istanza
const validator = new FatturaValidator(options);
const result = validator.validate(fattura);
// Helper
const result = validateFattura(fattura, options);
interface ValidationOptions {
validateTotals?: boolean; // Default: true
validateCodiceFiscale?: boolean; // Default: true
validatePartitaIVA?: boolean; // Default: true
validateDates?: boolean; // Default: true
strict?: boolean; // Default: false
}
interface ValidationResult {
valid: boolean;
errors: ValidationError[];
warnings: ValidationError[];
}
interface ValidationError {
path: string;
message: string;
code: string;
}
Serializza fatture in XML.
import { FatturaSerializer } from '@fatturazione-elettronica-aruba/xml-builder';
const serializer = new FatturaSerializer({
includeSchemaLocation?: boolean, // Default: true
});
const xml = serializer.serialize(fattura);
type TipoDocumento =
| 'TD01' | 'TD02' | 'TD03' | 'TD04' | 'TD05' | 'TD06'
| 'TD07' | 'TD08' | 'TD09' | 'TD10' | 'TD11' | 'TD12'
| 'TD16' | 'TD17' | 'TD18' | 'TD19' | 'TD20' | 'TD21'
| 'TD22' | 'TD23' | 'TD24' | 'TD25' | 'TD26' | 'TD27' | 'TD28';
type RegimeFiscale =
| 'RF01' | 'RF02' | 'RF04' | 'RF05' | 'RF06' | 'RF07'
| 'RF08' | 'RF09' | 'RF10' | 'RF11' | 'RF12' | 'RF13'
| 'RF14' | 'RF15' | 'RF16' | 'RF17' | 'RF18' | 'RF19';
type Natura =
| 'N1' | 'N2' | 'N2.1' | 'N2.2'
| 'N3' | 'N3.1' | 'N3.2' | 'N3.3' | 'N3.4' | 'N3.5' | 'N3.6'
| 'N4' | 'N5' | 'N6' | 'N6.1' | 'N6.2' | 'N6.3' | 'N6.4'
| 'N6.5' | 'N6.6' | 'N6.7' | 'N6.8' | 'N6.9' | 'N7';
type ModalitaPagamento =
| 'MP01' | 'MP02' | 'MP03' | 'MP04' | 'MP05'
| 'MP06' | 'MP07' | 'MP08' | 'MP09' | 'MP10'
| 'MP11' | 'MP12' | 'MP13' | 'MP14' | 'MP15'
| 'MP16' | 'MP17' | 'MP18' | 'MP19' | 'MP20'
| 'MP21' | 'MP22' | 'MP23';
interface Indirizzo {
indirizzo: string;
numeroCivico?: string;
cap: string;
comune: string;
provincia?: string;
nazione: string;
}