DocumentType ID

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.

Come si legge un DocumentTypeId?

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:

ComponenteValoreSignificatoRoot namespaceurn:oasis:names:specification:ubl:schema:xsd:Invoice-2Schema UBL InvoiceCustomizationurn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0EN 16931, compliant con NLCIUSVersione2.1UBL versione 2.1

Il 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.

DocumentType ID per fatture

La tabella seguente contiene i DocumentTypeId più utilizzati per fatture e note di credito.

Fatture UBL
FormatoDocumentTypeIdPeppol BIS Billing V3urn: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.1Peppol BIS Billing V3 (nota di credito)urn: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.1NLCIUS / SI-UBL 2.0urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0::2.1NLCIUS G-rekeningurn: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.1BIS Self-Billing V3urn: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.1XRechnung V3.0 (Germania)urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0::2.1UBL.BE (Belgio)urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#conformant#urn:UBL.BE:1.0.0.20180214::2.1PINT EUurn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:peppol:pint:billing-1@eu-1::2.1SETU Invoice v2.2urn: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.1
Fatture CII
FormatoDocumentTypeIdBIS Billing V3 (CII)urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100::CrossIndustryInvoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::D16B
DocumentType ID per ordini
FormatoDocumentTypeIdOrder Onlyurn:oasis:names:specification:ubl:schema:xsd:Order-2::Order##urn:fdc:peppol.eu:poacc:trns:order:3::2.1Order Responseurn:oasis:names:specification:ubl:schema:xsd:OrderResponse-2::OrderResponse##urn:fdc:peppol.eu:poacc:trns:order_response:3::2.1Order Response Advancedurn:oasis:names:specification:ubl:schema:xsd:OrderResponse-2::OrderResponse##urn:fdc:peppol.eu:poacc:trns:order_response_advanced:3::2.3Order Changeurn:oasis:names:specification:ubl:schema:xsd:OrderChange-2::OrderChange##urn:fdc:peppol.eu:poacc:trns:order_change:3::2.3Order Cancellationurn:oasis:names:specification:ubl:schema:xsd:OrderCancellation-2::OrderCancellation##urn:fdc:peppol.eu:poacc:trns:order_cancellation:3::2.3
Altri DocumentType ID
FormatoDocumentTypeIdInvoice Responseurn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2::ApplicationResponse##urn:fdc:peppol.eu:poacc:trns:invoice_response:3::2.1Message Level Status (MLS)urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2::ApplicationResponse##urn:peppol:edec:mls:1.0::2.1Despatch Adviceurn:oasis:names:specification:ubl:schema:xsd:DespatchAdvice-2::DespatchAdvice##urn:fdc:peppol.eu:poacc:trns:despatch_advice:3::2.1
Famiglie di documenti nella PSB

La 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.

FamigliaCopreInvoiceBIS Billing V3, NLCIUS e tutte le varianti di fatturaInvoiceResponseMessaggi Invoice ResponseReviewMessaggi MLR/MLSOrderPeppol Order (tutti i profili)OrderResponseOrder Response (standard e advanced)OrderChangeOrder ChangeOrderCancellationOrder CancellationDespatchAdvicePeppol Despatch AdviceTimeCardSETU HR-XML Timecard

Suggerimento: Tramite la PSB-API è possibile utilizzare queryRecipientParty per verificare quali DocumentTypeId sono supportati da un destinatario. Questo è utile per controllare preventivamente se il documento può essere consegnato correttamente.

Formati obsoleti

Alcuni formati non sono più validi sulla rete Peppol:

FormatoStatoSostitutoSI-UBL 1.2Dismesso dal 1 gennaio 2024NLCIUS / SI-UBL 2.0 o BIS Billing V3Peppol BIS 2 formatsLegacy, non più validiEquivalenti BIS 3.0MLRSostituito da MLS v1.0.0MLS (Message Level Status)

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

Correlati