Campi di invio in UBL

I campi che determinano la destinazione della fattura: EndpointID, CompanyID e la loro priorità.

Quando si invia un'e-fattura tramite Peppol, campi specifici nella struttura UBL determinano dove viene instradato il documento. La corretta compilazione di questi campi è fondamentale: un errore nei campi di instradamento può comportare che la fattura non arrivi a destinazione o venga recapitata alla parte sbagliata.

Priorità di instradamento

La PSB di eConnect utilizza i seguenti campi per determinare il destinatario, in ordine di priorità decrescente:

PrioritàPercorso XMLScopo1 (massima)cac:AccountingCustomerParty/cac:Party/cbc:EndpointIDInstradamento Peppol primario2cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:CompanyIDIdentificativo giuridico (KvK, OIN)3cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyIDPartita IVA

Il sistema parte dalla priorità 1 e verifica se l'identificativo è registrato sulla rete Peppol (tramite una SMP-lookup). In caso affermativo, la fattura viene consegnata tramite Peppol. In caso contrario, viene verificato il campo successivo nell'ordine di priorità.

EndpointID: il campo più importante

L'EndpointID è il campo di instradamento primario in Peppol BIS Billing V3. Questo campo contiene l'identificativo Peppol del destinatario, compreso il schemeID che indica il tipo di identificativo utilizzato.

<cac:AccountingCustomerParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0106">12345678</cbc:EndpointID>
  </cac:Party>
</cac:AccountingCustomerParty>

In questo esempio l'instradamento avviene in base al numero KvK 12345678 (schemeID 0106). La PSB cerca questo numero nell'SMP e consegna la fattura all'Access Point corrispondente.

Importante: l'EndpointID è obbligatorio in Peppol BIS Billing V3. Un valore vuoto o l'assenza di questo elemento genera un errore di validazione. Utilizzi sempre un numero identificativo valido.

Suggerimento: desidera determinare con precisione a quale organizzazione viene inviata la Sua fattura? Compili l'EndpointID con l'identificativo che il destinatario ha registrato su Peppol. Senza EndpointID il sistema ricorre al numero KvK contenuto nel CompanyID.

CompanyID: l'identificativo giuridico

Se l'EndpointID non è compilato o l'identificativo non è stato trovato su Peppol, la PSB cerca il campo CompanyID all'interno di PartyLegalEntity. Questo campo contiene in genere il numero KvK o OIN:

<cac:PartyLegalEntity>
  <cbc:CompanyID schemeID="0106">12345678</cbc:CompanyID>
</cac:PartyLegalEntity>
PartyTaxScheme: la partita IVA

Se anche il CompanyID non produce una registrazione Peppol, la partita IVA contenuta in PartyTaxScheme viene utilizzata come ultima opzione di instradamento tramite la rete:

<cac:PartyTaxScheme>
  <cbc:CompanyID>NL123456789B01</cbc:CompanyID>
</cac:PartyTaxScheme>
E-mail come fallback

Se nessuno degli identificativi sopra menzionati produce una registrazione Peppol, la fattura può essere consegnata tramite e-mail. La piattaforma cerca un indirizzo e-mail nei seguenti campi:

  1. cac:AccountingCustomerParty/cac:Party/cac:Contact/cbc:ElectronicMail
  2. cac:AccountingCustomerParty/cac:AccountingContact
  3. cac:AccountingCustomerParty/cac:BuyerContact

Indirizzi e-mail multipli (separati da virgola o punto e virgola) sono supportati e vengono inviati come To + CC.

Dati di contatto del mittente

L'elemento Contact del mittente (AccountingSupplierParty) è anch'esso funzionalmente importante. Se il campo ElectronicMail del fornitore non è compilato, eConnect aggiunge automaticamente support@econnect.eu. Ciò garantisce che le fatture rifiutate (messaggi Invoice Response) raggiungano comunque il mittente e possano essere inoltrate.

Suggerimento: compili sempre l'indirizzo e-mail della Sua organizzazione nel contatto del fornitore. In questo modo riceverà i messaggi di rifiuto direttamente nella Sua casella di posta.

Errori frequenti
ErroreConseguenzaSoluzioneEndpointID vuoto o mancanteErrore di validazione in Peppol BIS V3Compili sempre un EndpointID validoSchemeID erratoLa fattura non viene trovata su PeppolUtilizzi 0106 per KvK, 0190 per OIN"NA" come valore identificativoErrore di instradamentoUtilizzi sempre un numero identificativo realeNessun indirizzo e-mail del destinatarioNessun fallback se l'instradamento Peppol fallisceCompili il campo ElectronicMail come fallback e-mail

Non è sicuro quale identificativo sia registrato per un determinato destinatario? Cerchi l'organizzazione nella Peppol Directory o utilizzi la funzione queryRecipientParty nell'API della PSB.

Scarichi i file di esempio

Correlati