DocumentType ID

Przegląd identyfikatorów Peppol DocumentType: URN dla faktur, not kredytowych, zamówień i innych.

Każdy dokument w sieci Peppol posiada DocumentTypeId. Jest to unikalna nazwa URN (Uniform Resource Name), która precyzyjnie wskazuje, jaki format i profil dokument spełnia. DocumentTypeId jest używany podczas rejestracji SMP (aby wskazać, jakie dokumenty organizacja może odbierać), przy trasowaniu oraz podczas walidacji.

Jak odczytać DocumentTypeId?

Na pierwszy rzut oka DocumentTypeId może wyglądać na skomplikowany, ale ma ustaloną strukturę. Jako przykład weźmy DocumentTypeId faktury 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

Zawiera on trzy składniki:

SkładnikWartośćZnaczenieRoot namespaceurn:oasis:names:specification:ubl:schema:xsd:Invoice-2Schemat UBL InvoiceCustomizationurn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0EN 16931, zgodny z NLCIUSWersja2.1UBL wersja 2.1

Root namespace wskazuje, jaki schemat XML jest używany. Customization określa, jaki profil i jakie dostosowanie krajowe obowiązuje. Wersja odnosi się do wersji specyfikacji UBL.

DocumentType ID dla faktur

Poniższa tabela zawiera najczęściej używane DocumentTypeId dla faktur i not kredytowych.

Faktury UBL
FormatDocumentTypeIdPeppol 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 kredytowa)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 (Niemcy)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 (Belgia)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
Faktury CII
FormatDocumentTypeIdBIS 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 dla zamówień
FormatDocumentTypeIdOrder 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
Inne DocumentType ID
FormatDocumentTypeIdInvoice 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
Rodziny dokumentów w PSB

PSB eConnect grupuje DocumentTypeId w rodziny dokumentów. Podczas konfiguracji capability SMP lub zapytań o typy dokumentów za pośrednictwem API można używać tych nazw rodzin jako skrótu zamiast pełnych URN.

RodzinaObejmujeInvoiceBIS Billing V3, NLCIUS i wszystkie warianty fakturInvoiceResponseWiadomości Invoice ResponseReviewWiadomości MLR/MLSOrderPeppol Order (wszystkie profile)OrderResponseOrder Response (standard i advanced)OrderChangeOrder ChangeOrderCancellationOrder CancellationDespatchAdvicePeppol Despatch AdviceTimeCardSETU HR-XML Timecard

Wskazówka: Za pośrednictwem PSB-API można użyć queryRecipientParty, aby sprawdzić, jakie DocumentTypeId obsługuje dany odbiorca. Jest to przydatne do wcześniejszej weryfikacji, czy dokument może zostać prawidłowo dostarczony.

Przestarzałe formaty

Niektóre formaty nie są już ważne w sieci Peppol:

FormatStatusZamiennikSI-UBL 1.2Wycofany od 1 stycznia 2024NLCIUS / SI-UBL 2.0 lub BIS Billing V3Peppol BIS 2 formatsLegacy, nieważneOdpowiedniki BIS 3.0MLRZastąpiony przez MLS v1.0.0MLS (Message Level Status)

Uwaga: Jeśli faktury są odrzucane z błędem dotyczącym nieprawidłowego CustomizationID, należy sprawdzić, czy nie jest używany przestarzały format. Zalecana jest aktualizacja do NLCIUS/SI-UBL 2.0 lub BIS Billing V3.


Więcej informacji o kompletnych listach kodów można znaleźć w specyfikacji Peppol BIS Billing pod adresem docs.peppol.eu/poacc/billing/3.0/.

Pobierz pliki przykładowe

Powiązane