Faktura PDF nie jest technicznie fakturą elektroniczną: dane nie są w formacie ustrukturyzowanym, a dokładność nie może być zagwarantowana wyłącznie przez rozpoznawanie skanów. Mimo to eConnect oferuje rozwiązanie do wysyłania faktur PDF przez Peppol. PSB rozpoznaje PDF za pomocą IDR (Intelligent Document Recognizer), waliduje istotne pola na podstawie dostarczonych przez Państwa metadanych i tworzy z niego prawidłową fakturę elektroniczną.

Uwaga: ta strona opisuje wysyłanie samodzielnego pliku PDF bez UBL (rozpoznawanie przez IDR na podstawie dostarczonych metadanych). Chcą Państwo zamiast tego dołączyć PDF jako załącznik do faktury elektronicznej, którą już dostarczają w formacie UBL? Proszę zapoznać się z sekcją Dołączanie załączników w artykule Wysyłanie faktury przez API.

Istnieją dwa sposoby przesłania faktury PDF do PSB. Obie metody wymagają tych samych metadanych.

Proszę wysłać PDF jako załącznik na zabezpieczony adres e-mail Państwa tenanta PSB. W treści e-maila należy umieścić metadane kontrolne w formacie Markdown:

[factuurnummer](INV-2026-0042)
[totaalfactuur](1.250,00)
[totaalbtw](262,50)
[ontvangerSchemeId](0106)
[ontvangerIdentifier](12345678)
[ontvangerNaam](Voorbeeldbedrijf B.V.)
[ontvangerEmail](finance@voorbeeld.nl)

Tagi w nawiasach kwadratowych są ustalane podczas konfiguracji początkowej. Ważne jest, aby nie ulegały zmianie po uruchomieniu połączenia.

Uwaga: Dokładny adres e-mail i dostępne tagi są konfigurowane indywidualnie dla każdego klienta przez eConnect. Proszę skontaktować się z TechSupport w sprawie konfiguracji początkowej.

Proszę wysłać PDF do API GenericSend i dostarczyć metadane jako metaAttributen (pary klucz-wartość):

{
  "factuurnummer": "INV-2026-0042",
  "totaalfactuur": "1250,00",
  "totaalbtw": "262,50",
  "ontvangerSchemeId": "0106",
  "ontvangerIdentifier": "12345678"
}

Przy przesyłaniu przez API otrzymują Państwo w odpowiedzi documentId. Mogą Państwo powiązać ten identyfikator z fakturą we własnym oprogramowaniu, aby śledzić status przesyłki. Mogą Państwo również podać własny documentId.

Następujące pola są wymagane jako minimum:

Dodatkowe tagi mogą zostać dodane w uzgodnieniu.

Po otrzymaniu PDF przechodzi przez następujące etapy:

1. Rozpoznawanie: IDR rozpoznaje fakturę PDF i konwertuje ją na fakturę XML (UBL)
2. Pola routingu: dane odbiorcy z metadanych są przenoszone do XML
3. Walidacja: metadane kontrolne są porównywane z wartościami rozpoznanymi przez IDR. Numer faktury, nazwa odbiorcy i identyfikatory z Państwa metadanych mogą nadpisać rozpoznane wartości. Jeśli kwota faktury lub kwota VAT różni się od rozpoznania, to pole również zostaje nadpisane, a faktura zostaje odrzucona
4. Wysyłka lub powiadomienie: jeśli walidacja przebiegnie pomyślnie, faktura jest wysyłana przez Peppol (lub inną skonfigurowaną metodę dostarczania). Jeśli walidacja nie powiedzie się, otrzymują Państwo powiadomienie

Jeśli walidacja nie powiedzie się (na przykład dlatego, że rozpoznana kwota różni się od podanej kwoty), istnieją trzy sposoby otrzymania powiadomienia:

Przy rozpoznawaniu pozycji IDR przekazuje pozycje fakturowe tylko wtedy, gdy suma kwot pozycji odpowiada łącznej kwocie bez VAT. Jeśli pozycje nie odpowiadają, IDR umieszcza łączną kwotę dla każdej kategorii VAT jako pozycję fakturową w XML. Czy chcą Państwo, aby faktura została odrzucona zamiast wysłana w takim przypadku? Jest to konfigurowalne. Jeśli nie zostanie rozpoznana żadna pozycja fakturowa, można to również opcjonalnie skonfigurować tak, aby faktura została odrzucona zamiast wysłana bez pozycji; otrzymają Państwo takie samo powiadomienie jak przy innym błędzie walidacji.

Ważne: Faktura, która została odrzucona, nie może być następnie skorygowana i wysłana automatycznie. Jedyną opcją jest ręczne przesłanie XML przez platformę.

To rozwiązanie jest przeznaczone dla sytuacji, w których źródło faktur nie może wygenerować formatu ustrukturyzowanego, ale nadal chcą Państwo wysyłać przez Peppol. Typowe scenariusze:

• Pakiety oprogramowania obsługujące wyłącznie eksport PDF
• Środowiska hybrydowe, w których część przepływu faktur jest już cyfrowa, a część nadal opiera się na PDF
• Etapowa migracja do pełnego fakturowania elektronicznego

Dla najlepszej jakości i niezawodności zawsze zaleca się dostarczanie bezpośrednio w formacie UBL przez API.

Chcą Państwo skonfigurować PDF via Peppol? Proszę skontaktować się z naszym zespołem w sprawie konfiguracji początkowej.