Przejdź do głównej treści
XRechnung · reguły KoSIT

Błąd BR-DE-15 w XRechnung: faktura nie ma Buyer reference (BT-10)

BR-DE-15 to reguła XRechnung, niemieckiego formatu faktury elektronicznej: każda faktura musi zawierać referencję nabywcy, pole BT-10. Dla niemieckiej jednostki publicznej wpisuje się tam jej Leitweg-ID; dla firmy, referencję, którą Ci podała. Jeśli jej brakuje, walidator KoSIT uznaje fakturę za nieprawidłową.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 4 listopada 2026

Najważniejsze

Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym modułu, wersja 17.0 i 20.0 · w źródłach podanych na końcu
Czas czytania
3 min

Treść reguły, tak jak pojawia się w raporcie walidatora (KoSIT zapisuje ją po niemiecku), brzmi: «Das Element "Buyer reference" (BT-10) muss übermittelt werden.» Po polsku: element Buyer reference musi zostać przekazany. W Schematronie XRechnung 3.0.2 (wydanie KoSIT v2.6.0) jej waga to fatal: to nie ostrzeżenie, faktura nie przechodzi.

Co sprawdza, a czego nie

Reguła sprawdza tylko, czy pole istnieje i nie jest puste. Nie weryfikuje, czy wartość ma sens: spełnia ją każdy tekst. W UBL jest to element cbc:BuyerReference w nagłówku dokumentu.

Peppol BIS, format używany w Belgii czy Holandii, jest łagodniejszy: wystarczy referencja nabywcy albo numer zamówienia, jak mówi jego reguła PEPPOL-EN16931-R003: «A buyer reference or purchase order reference MUST be provided.» Dlatego faktura, która bez problemu przechodzi przez Peppol, może trafić na BR-DE-15, gdy przerobisz ją na XRechnung dla niemieckiego klienta.

Karta reguły BR-DE-15 w XRechnung
BR-DE-15 jest fatal w Schematronie KoSIT: bez BT-10 XRechnung nie jest prawidłowa.

Skąd Odoo bierze BT-10

Eksport XRechnung dostarczany z Odoo (bez modułów zewnętrznych) wypełnia pole tak:

WersjaWartość BT-10Jeśli brak
Odoo 17Pole Referencja firmy klienta. Jeśli jej adres Peppol (EAS) to 0204, jej Peppol Endpoint.Wpisuje „N/A”.
Odoo 18 i 19Pole Referencja kontaktu lub, jeśli jest puste, firmy. Przy EAS 0204 Peppol Endpoint.Wpisuje „N/A”.
Odoo 20Tak samo, ale schemat i identyfikator nazywają się Routing ID i Routing Endpoint. Przy Routing ID 0204 Routing Endpoint.Wpisuje „N/A”.

Przy XRechnung z Odoo BR-DE-15 w ogóle nie zadziała, bo pole nigdy nie jest puste. Ale „N/A” spełnia tylko literę reguły. To nie jest referencja, której oczekuje Twój klient, a jeśli fakturujesz jednostkę publiczną, to nie jest jej Leitweg-ID. Zanim wyślesz, otwórz XML lub podgląd i sprawdź, co zawiera BT-10.

Gdy klientem jest jednostka publiczna

0204 to schemat Leitweg-ID na liście schematów adresów elektronicznych. Jeśli w karcie jednostki ustawisz ten schemat i jej Leitweg-ID jako identyfikator, Odoo skopiuje go do BT-10, więc nie będziesz go wpisywać na każdej fakturze. Dla prywatnej firmy zwykle jest to referencja, o którą poprosi, często numer jej zamówienia lub numer dostawcy: wpisuje się ją w polu Referencja jej karty.

Z naszym modułem XRechnung i ZUGFeRD

Moduł dodaje w karcie klienta własną zakładkę E-Invoicing z dwoma polami na tę daną: Leitweg-ID (BT-10), używane, gdy klient jest oznaczony jako jednostka publiczna (B2G Partner), oraz Buyer Reference (BT-10) dla pozostałych. Jeśli oznaczysz klienta jako jednostkę publiczną, a Leitweg-ID jest pusty, moduł nie wygeneruje faktury: zatrzyma się z komunikatem „B2G partner requires a Leitweg-ID (BT-10).”. Jeśli nie jest, a Buyer Reference jest pusta, XML wyjdzie bez BuyerReference, bez wypełniaczy typu „N/A”, i wtedy pojawia się BR-DE-15.

Karta klienta publicznego w Odoo 20 z zakładką E-Invoicing modułu XRechnung
Klient oznaczony jako B2G Partner, z Leitweg-ID (BT-10) i pustym polem Buyer Reference. Zrzut ekranu Odoo 20 z danymi demonstracyjnymi.

W Odoo 18, 19 i 20 widzisz to przed wysłaniem czegokolwiek: z subskrypcją FlexigoTech Cloud każda wygenerowana XRechnung jest walidowana regułami KoSIT, a błędy zostają na fakturze, w Validation Errors, po jednej linii na regułę. Faktura z BR-DE-15 nie dostaje statusu Ready to send. Wersja opublikowana dla Odoo 17 generuje XRechnung, ale jej nie waliduje.

Jak to naprawić

  1. Jeśli klientem jest niemiecka jednostka publiczna, poproś o jej Leitweg-ID i wpisz go w karcie kontaktu: w polu Leitweg-ID w zakładce E-Invoicing przy naszym module albo jako adres elektroniczny ze schematem 0204 w Odoo.
  2. Jeśli to firma, zapytaj, jakiej referencji sobie życzy, i zapisz ją w karcie kontaktu (Buyer Reference przy module, Referencja w Odoo).
  3. Wygeneruj XRechnung ponownie: ta, która już poszła, się nie zmieni, a jeśli została odrzucona, wysyłasz poprawioną.
  4. Sprawdź BT-10 w wyniku przed wysłaniem.

Czytaj dalej

XRechnung: błędy BR-DE-2 do BR-DE-7, BR-DE-27 i BR-DE-28, kontakt sprzedawcyBR-DE-2 do BR-DE-7 wymagają w XRechnung miasta, kodu pocztowego, osoby kontaktowej, telefonu i e-maila sprzedawcy. Co mówi każda reguła i jak ją spełnić w Odoo.Błędy BR-DE-1, BR-61 i BR-DE-23 w XRechnung: instrukcje płatnościBR-DE-1 wymaga w XRechnung instrukcji płatności (BG-16), a BR-61 konta przy płatności przelewem. Co zapisuje Odoo 17, 18, 19 i 20 i jak to naprawić.Błędy PEPPOL-EN16931-R010 i R020: adres elektroniczny nabywcy lub sprzedawcyPEPPOL-EN16931-R010 i R020 wymagają adresu elektronicznego nabywcy i sprzedawcy, a BR-62, BR-63 oraz BR-CL-25 jego schematu. Gdzie to znaleźć w Odoo 17, 18, 19 i 20.
Sprawdzone w kodzie źródłowym modułu (wersja 17.0 i 20.0) i w podlinkowanych źródłach

Źródła