Una fattura PDF non è tecnicamente una fattura elettronica: i dati non sono in un formato strutturato e l'accuratezza non può essere garantita dal solo riconoscimento tramite scansione. Tuttavia, eConnect offre una soluzione per inviare fatture PDF tramite Peppol. La PSB riconosce il PDF tramite l'IDR (Intelligent Document Recognizer), valida i campi essenziali rispetto ai metadati forniti e lo trasforma in una fattura elettronica valida.

Nota: questa pagina descrive l'invio di un PDF singolo senza UBL (riconoscimento tramite l'IDR sulla base dei metadati forniti). Desidera invece allegare un PDF a una fattura elettronica che fornisce già in UBL? Veda allora Includere allegati in Inviare una fattura tramite l'API.

Esistono due modi per inviare una fattura PDF alla PSB. Entrambi i metodi richiedono gli stessi metadati.

Invii il PDF come allegato all'indirizzo e-mail protetto del Suo tenant PSB. Nel corpo dell'e-mail, inserisca i metadati di controllo in formato Markdown:

[factuurnummer](INV-2026-0042)
[totaalfactuur](1.250,00)
[totaalbtw](262,50)
[ontvangerSchemeId](0106)
[ontvangerIdentifier](12345678)
[ontvangerNaam](Voorbeeldbedrijf B.V.)
[ontvangerEmail](finance@voorbeeld.nl)

I tag tra parentesi quadre vengono stabiliti durante la configurazione iniziale. È importante che non vengano più modificati una volta che la connessione è attiva.

Nota: L'indirizzo e-mail esatto e i tag disponibili vengono configurati per cliente da eConnect. Contatti il TechSupport per la configurazione iniziale.

Invii il PDF all'API GenericSend e fornisca i metadati come metaAttributen (coppie chiave-valore):

{
  "factuurnummer": "INV-2026-0042",
  "totaalfactuur": "1250,00",
  "totaalbtw": "262,50",
  "ontvangerSchemeId": "0106",
  "ontvangerIdentifier": "12345678"
}

Quando invia tramite l'API, riceve un documentId in risposta. Può collegare questo ID alla fattura nel Suo software, per seguire lo stato dell'invio. Può anche fornire un proprio documentId.

I seguenti campi sono richiesti come minimo:

Tag aggiuntivi possono essere aggiunti in consultazione.

Dopo la ricezione, il PDF passa attraverso i seguenti passaggi:

1. Riconoscimento: l'IDR riconosce la fattura PDF e la converte in una fattura XML (UBL)
2. Campi di instradamento: i dati del destinatario dai metadati vengono trasferiti nell'XML
3. Validazione: i metadati di controllo vengono confrontati con i valori riconosciuti dall'IDR. Il numero di fattura, il nome del destinatario e gli identificativi dai Suoi metadati possono sovrascrivere i valori riconosciuti. Se l'importo della fattura o dell'IVA differisce dal riconoscimento, anche quel campo viene sovrascritto e la fattura viene rifiutata
4. Invio o notifica: se la validazione ha esito positivo, la fattura viene inviata tramite Peppol (o un altro metodo di consegna configurato). Se la validazione non riesce, Lei riceve una notifica

Se la validazione non ha esito positivo (ad esempio perché l'importo riconosciuto differisce dall'importo fornito), ci sono tre modi per ricevere una notifica:

Nel riconoscimento delle righe, l'IDR trasmette le righe di fattura solo se la somma degli importi delle righe corrisponde al totale esclusa IVA. Se le righe non corrispondono, l'IDR inserisce il totale per categoria IVA come riga di fattura nell'XML. Desidera che la fattura venga rifiutata invece di essere inviata in quel caso? È configurabile. Se non viene riconosciuta alcuna riga di fattura, è possibile impostare anche questo in modo opzionale affinché la fattura venga rifiutata invece di essere inviata senza righe; riceve la stessa notifica prevista per un altro errore di validazione.

Importante: Una fattura rifiutata non può essere corretta a posteriori e inviata automaticamente. L'unica opzione è caricare l'XML manualmente tramite la piattaforma.

Questa soluzione è pensata per situazioni in cui la fonte di fatturazione non può generare un formato strutturato, ma si desidera comunque inviare tramite Peppol. Scenari tipici:

• Pacchetti software che supportano solo l'esportazione in PDF
• Ambienti ibridi in cui parte del flusso di fatturazione è già digitale e parte funziona ancora con PDF
• Migrazione graduale verso la fatturazione elettronica completa

Per la migliore qualità e affidabilità, è sempre consigliabile consegnare direttamente in formato UBL tramite l'API.

Desidera configurare PDF via Peppol? Contatti il nostro team per la configurazione iniziale.