Pola wysyłki w UBL

Pola określające miejsce docelowe faktury: EndpointID, CompanyID i ich priorytet.

Podczas wysyłania e-faktury przez Peppol określone pola w strukturze UBL decydują o tym, dokąd zostanie skierowany dokument. Prawidłowe wypełnienie tych pól jest kluczowe: błąd w polach trasowania może spowodować, że faktura nie dotrze do celu lub trafi do niewłaściwej strony.

Priorytet trasowania

PSB eConnect wykorzystuje następujące pola do określenia odbiorcy, w malejącym porządku priorytetów:

PriorytetŚcieżka XMLCel1 (najwyższy)cac:AccountingCustomerParty/cac:Party/cbc:EndpointIDPrimarne trasowanie Peppol2cac:AccountingCustomerParty/cac:Party/cac:PartyLegalEntity/cbc:CompanyIDIdentyfikator prawny (KvK, OIN)3cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyIDNumer VAT

System rozpoczyna od priorytetu 1 i sprawdza, czy identyfikator jest zarejestrowany w sieci Peppol (poprzez SMP-lookup). Jeśli tak, faktura jest dostarczana przez Peppol. Jeśli nie, sprawdzane jest kolejne pole w kolejności priorytetów.

EndpointID: najważniejsze pole

EndpointID to primarne pole trasowania w Peppol BIS Billing V3. Pole to zawiera identyfikator Peppol odbiorcy, wraz ze schemeID wskazującym typ użytego identyfikatora.

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

W tym przykładzie trasowanie odbywa się na podstawie numeru KvK 12345678 (schemeID 0106). PSB wyszukuje ten numer w SMP i dostarcza fakturę do odpowiedniego Access Point.

Ważne: EndpointID jest obowiązkowe w Peppol BIS Billing V3. Pusta wartość lub brak tego elementu powoduje błąd walidacji. Należy zawsze podać prawidłowy numer identyfikacyjny.

Wskazówka: chcą Państwo dokładnie określić, do której organizacji trafi faktura? Proszę wypełnić EndpointID identyfikatorem, który odbiorca zarejestrował w Peppol. Bez EndpointID system wykorzystuje numer KvK z pola CompanyID.

CompanyID: identyfikator prawny

Jeśli EndpointID nie jest wypełnione lub identyfikator nie został znaleziony w Peppol, PSB sprawdza pole CompanyID w ramach PartyLegalEntity. Pole to zazwyczaj zawiera numer KvK lub OIN:

<cac:PartyLegalEntity>
  <cbc:CompanyID schemeID="0106">12345678</cbc:CompanyID>
</cac:PartyLegalEntity>
PartyTaxScheme: numer VAT

Jeśli również CompanyID nie daje rejestracji Peppol, numer VAT z PartyTaxScheme jest wykorzystywany jako ostatnia opcja trasowania przez sieć:

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

Jeśli żaden z powyższych identyfikatorów nie daje rejestracji Peppol, faktura może zostać dostarczona za pośrednictwem poczty elektronicznej. Platforma wyszukuje adres e-mail w następujących polach:

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

Obsługiwane są wielokrotne adresy e-mail (rozdzielone przecinkiem lub średnikiem), wysyłane jako To + CC.

Dane kontaktowe nadawcy

Element Contact nadawcy (AccountingSupplierParty) jest również funkcjonalnie istotny. Jeśli pole ElectronicMail dostawcy nie jest wypełnione, eConnect automatycznie dodaje support@econnect.eu. Zapewnia to, że odrzucone faktury (komunikaty Invoice Response) mimo wszystko trafią do nadawcy i mogą zostać przekazane dalej.

Wskazówka: proszę zawsze wpisywać adres e-mail swojej organizacji w danych kontaktowych dostawcy. Dzięki temu komunikaty o odrzuceniu będą trafiać bezpośrednio do Państwa skrzynki pocztowej.

Częste błędy
BłądKonsekwencjaRozwiązanieEndpointID puste lub brakująceBłąd walidacji w Peppol BIS V3Należy zawsze podać prawidłowe EndpointIDNieprawidłowe schemeIDFaktura nie zostaje znaleziona w PeppolNależy użyć 0106 dla KvK, 0190 dla OIN"NA" jako wartość identyfikatoraBłąd trasowaniaNależy zawsze podać rzeczywisty numer identyfikacyjnyBrak adresu e-mail odbiorcyBrak fallbacku w przypadku niepowodzenia trasowania PeppolNależy wypełnić pole ElectronicMail jako fallback e-mail

Nie są Państwo pewni, który identyfikator jest zarejestrowany dla danego odbiorcy? Proszę wyszukać organizację w Peppol Directory lub skorzystać z funkcji queryRecipientParty w API PSB.

Pobierz pliki przykładowe

Powiązane