Skip to main content

Generazione Documenti

Questa sezione descrive le funzionalità di generazione PDF e XML.

📄 Generazione XML​

Il formato XML è conforme alle specifiche dell'Agenzia delle Entrate.

Servizio InvXmlService​

Il servizio InvXmlService gestisce:

  • Generazione del file XML dalla fattura
  • Validazione contro lo schema XSD ministeriale
  • Formattazione conforme FatturaPA

Validazione XML​

La validazione avviene tramite InvXmlValidationService:

  • Controllo struttura contro schema XSD
  • Verifica campi obbligatori
  • Validazione formati (date, importi, codici)

Download XML​

È possibile scaricare l'XML della fattura per:

  • Archiviazione locale
  • Verifica manuale del contenuto
  • Import in altri sistemi

📑 Generazione PDF​

Il PDF viene generato per visualizzazione e stampa.

Caratteristiche​

  • Layout conforme al formato fattura
  • Dati mittente e destinatario
  • Dettaglio righe con totali
  • Riepilogo IVA per aliquota

Accesso sicuro al PDF​

Il sistema utilizza chiavi temporanee per l'accesso:

// Generazione chiave (valida 10 minuti)
$key = $invoiceService->generatePdfKey($invoice);

// Verifica chiave
$isValid = $invoiceService->checkPdfKey($invoice, $key);

La chiave viene salvata in cache e permette l'accesso al PDF senza autenticazione per un periodo limitato.

📥 Download formati​

Formati disponibili​

  • PDF: per visualizzazione e stampa
  • XML: formato ministeriale per SDI
  • PDF da XML: rendering del formato ministeriale

API endpoints​

MetodoEndpointDescrizione
GET/invoices/{id}/pdf-keyGenera chiave accesso PDF
GET/invoices/{id}/pdf/{key}Visualizza PDF
GET/invoices/{id}/xmlDownload XML