Panoramica dei Peppol DocumentType identifier: URN per fatture, note di credito, ordini e altro.
Ogni documento sulla rete Peppol possiede un DocumentTypeId. Si tratta di un URN (Uniform Resource Name) univoco che indica esattamente quale formato e profilo segue il documento. Il DocumentTypeId viene utilizzato nella registrazione SMP (per indicare quali documenti un'organizzazione può ricevere), nell'instradamento e nella validazione.
A prima vista un DocumentTypeId può sembrare complesso, ma segue una struttura fissa. Prendiamo come esempio il DocumentTypeId della fattura NLCIUS:
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0::2.1
Questo contiene tre componenti:
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.02.1Il root namespace indica quale schema XML viene utilizzato. La customization indica quale profilo e quale adattamento nazionale si applica. La versione fa riferimento alla versione della specifica UBL.
La tabella seguente contiene i DocumentTypeId più utilizzati per fatture e note di credito.
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2::CreditNote##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0#conformant#urn:fdc:nen.nl:gaccount:v1.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#conformant#urn:UBL.BE:1.0.0.20180214::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:peppol:pint:billing-1@eu-1::2.1urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0#compliant#urn:fdc:setu.nl:invoice:v2.2::2.1urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100::CrossIndustryInvoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::D16Burn:oasis:names:specification:ubl:schema:xsd:Order-2::Order##urn:fdc:peppol.eu:poacc:trns:order:3::2.1urn:oasis:names:specification:ubl:schema:xsd:OrderResponse-2::OrderResponse##urn:fdc:peppol.eu:poacc:trns:order_response:3::2.1urn:oasis:names:specification:ubl:schema:xsd:OrderResponse-2::OrderResponse##urn:fdc:peppol.eu:poacc:trns:order_response_advanced:3::2.3urn:oasis:names:specification:ubl:schema:xsd:OrderChange-2::OrderChange##urn:fdc:peppol.eu:poacc:trns:order_change:3::2.3urn:oasis:names:specification:ubl:schema:xsd:OrderCancellation-2::OrderCancellation##urn:fdc:peppol.eu:poacc:trns:order_cancellation:3::2.3urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2::ApplicationResponse##urn:fdc:peppol.eu:poacc:trns:invoice_response:3::2.1urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2::ApplicationResponse##urn:peppol:edec:mls:1.0::2.1urn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice-2::DespatchAdvice##urn:fdc:peppol.eu:poacc:trns:despatch_advice:3::2.1La PSB di eConnect raggruppa i DocumentTypeId in famiglie di documenti. Durante la configurazione delle capability SMP o la consultazione dei tipi di documento tramite l'API, è possibile utilizzare questi nomi di famiglia come abbreviazione al posto degli URN completi.
InvoiceInvoiceResponseReviewOrderOrderResponseOrderChangeOrderCancellationDespatchAdviceTimeCardSuggerimento: Tramite la PSB-API è possibile utilizzare
queryRecipientPartyper verificare quali DocumentTypeId sono supportati da un destinatario. Questo è utile per controllare preventivamente se il documento può essere consegnato correttamente.
Alcuni formati non sono più validi sulla rete Peppol:
Attenzione: Se le fatture vengono rifiutate con un errore relativo a un CustomizationID non valido, verifichi se sta ancora utilizzando un formato obsoleto. Effettui l'aggiornamento a NLCIUS/SI-UBL 2.0 o BIS Billing V3.
Ulteriori informazioni sulle liste di codici complete sono disponibili nella specifica Peppol BIS Billing su docs.peppol.eu/poacc/billing/3.0/.
Scarichi i file di esempio