Proposals & Invoices · Article 5.7
Peppol — identyfikatory, routing sieciowy, stany błędów
Peppol to ogólnoeuropejska sieć e-fakturowania. Wyślij fakturę UBL Peppol przez Clozo, a trafi ona przez Twój Access Point, katalog Peppol, Access Point klienta i do jego systemu księgowego — zazwyczaj w ciągu 1–10 minut.
Peppol to jeden z tych akronimów, który wygląda groźnie, ale w rzeczywistości jest jednym z prostszych kanałów e-fakturowania. To sieć czterech narożników: Ty, Twój Access Point (AP), AP odbiorcy i odbiorca. Katalog Peppol wskazuje Twojemu AP, gdzie dostarczyć; format jest znormalizowany; certyfikaty są zarządzane centralnie. Gdy obie strony są zarejestrowane, wysłanie faktury to jedno wywołanie API.
Step by step
Zarejestruj swój identyfikator Peppol
(jednorazowo):
/settings/payments→ sekcja Peppol →Zarejestruj. Zatwierdź ekran zgody. Poczekaj na odznakę „Zarejestrowany" (~5 minut konfiguracji, ~1–4 godziny propagacji w katalogu).Dodaj identyfikator Peppol klienta
:
/clients/{id}→ sekcja Peppol → wpisz pełny identyfikator uczestnika (np.iso6523-actorid-upis::0007:1234567890).Wygeneruj i wyślij
: z listy Dokumenty obok dowolnej faktury wybierz „Wyślij przez Peppol". Zgłoszenie zostaje wysłane; Oś Czasu rejestruje próbę.
Monitoruj dostarczenie
: w ciągu 1–10 minut Oś Czasu aktualizuje się z „Dostarczone do AP odbiorcy" (sukces) lub kodem błędu.
Ponów jeśli potrzeba
: ze zdarzenia na Osi Czasu kliknij
Ponów dostarczenie Peppoljeśli nie powiodło się. Przydatne przy przejściowych problemach (chwilowa awaria sieci, timeout AP). Dla „Odbiorca nie znaleziony" najpierw popraw identyfikator.
Akcja „Wyślij przez Peppol" przy każdej fakturze w obszarze Dokumenty. Zdarzenia na Osi Czasu dla zgłoszenia, potwierdzenia dostarczenia i wszelkich błędów. Baner oferty pokazuje „Faktura dostarczona przez Peppol dnia [data]" po sukcesie.
Why this works this way
Identyfikatory uczestników Peppol ("ID w narożniku sieci"). Każda strona w Peppol ma unikalny identyfikator w określonym schemacie. W większości krajów UE używany jest schemat iso6523-actorid-upis z podschematem identyfikującym organ krajowy:
- 0007 — Szwecja (Organisationsnummer)
- 0088 — Norwegia (Foretaksregister)
- 0192 — Norwegia (Mva-register)
- 0009 — Francja (SIRET)
- 0204 — Włochy (IPA)
- 0184 — Dania (CVR)
- 9925 — Belgia VAT
- 9930 — Niemcy VAT
- 9931 — Francja VAT
- 9932 — Hiszpania VAT
- 9933 — Włochy VAT
- 9934 — Holandia VAT
- 0007:1234567890 to kompletny identyfikator uczestnika dla szwedzkiej firmy z numerem organizacji 1234567890.
Clozo rejestruje Twój identyfikator Peppol używając Twojego numeru VAT w odpowiednim schemacie dla Twojego kraju (automatycznie wybranym na podstawie kodu kraju z profilu). Rejestracja to jednorazowy proces zajmujący około 5 minut, a propagacja w katalogu Peppol trwa 1–4 godziny.
Model czterech narożników.
``
[Ty] [Odbiorca]
↓ ↑
[Twój AP] [AP Odbiorcy]
↓ ↑
└──── Sieć Peppol ─────────┘
(katalog SMP + certyfikaty)
``
Twój AP to brama, przez którą wychodzą Twoje faktury. Peppol SMP (Service Metadata Publisher) mapuje identyfikatory uczestników na punkty końcowe AP — Twój AP odpytuje go, aby znaleźć miejsce dostarczenia. AP klienta to brama, przez którą wchodzą faktury; stamtąd są przekazywane do jego systemu księgowego/ERP przez lokalną integrację (zazwyczaj wtyczki dla SAP, Microsoft Dynamics, NetSuite, Visma, Exact itp.).
Clozo używa wstępnie zintegrowanego dostawcy AP; nie musisz go wybierać. Twoje faktury wychodzą przez ten AP automatycznie; strona odbiorcy należy do jego konfiguracji.
Format: UBL EN 16931. EN 16931 to europejska norma dla semantycznego modelu danych e-faktury. UBL to jedno z dwóch powiązań składniowych (drugie to UN/CEFACT CII; oba przekazują ten sam model EN 16931). Peppol używa profilu Peppol BIS Billing 3.0, który jest zasadniczo EN 16931 z kilkoma ograniczeniami specyficznymi dla Peppol. Clozo emituje XML zgodny z BIS Billing 3.0.
Przepływ routingu:
1. Klikasz „Pobierz jako Peppol UBL" lub auto-dostarczasz przez akcję Wyślij. 2. Clozo pakuje fakturę jako Peppol BIS Billing 3.0 UBL. 3. AP Clozo odpytuje Peppol SMP o punkt końcowy AP odbiorcy. 4. AP przesyła fakturę przez AS4 (przemysłowy protokół przesyłania wiadomości). 5. AP odbiorcy odbiera, waliduje i przekazuje do jego systemu księgowego. 6. AP odbiorcy zwraca potwierdzenie dostarczenia do Twojego AP w ciągu ~1–10 minut. 7. Clozo rejestruje potwierdzenie na Osi Czasu oferty.
Typowe stany błędów:
- Odbiorca nie znaleziony: podany identyfikator uczestnika nie istnieje w katalogu SMP. Klient podał błędny identyfikator lub jego AP nie jest zarejestrowany. Zweryfikuj z jego księgowym. - Schemat nieprawidłowy: dokument UBL nie przechodzi walidacji Peppol BIS Billing 3.0. Prawie zawsze problem po stronie Clozo — skontaktuj się z pomocą techniczną. - Odrzucony przez AP odbiorcy: AP odbiorcy egzekwuje lokalne reguły wykraczające poza Peppol BIS (np. wymagając określonego formatu numeru zamówienia). Komunikat błędu wskaże regułę. - Timeout dostarczenia: rzadkie; AP odbiorcy nie odpowiedział w ciągu 24 godzin. Clozo może ponowić na żądanie.
Troubleshooting
Keep reading
Proposals & Invoices
E-invoicing formats: which one for which country, and why
EU member states are migrating to mandatory structured e-invoicing on different timelines. Clozo supports the six major formats — Peppol UBL, Factur-X, ZUGFeRD, FacturaE, KSeF, FatturaPA — with the right one auto-selected by the client's country.
Configuration
Peppol participant ID and e-invoicing channels: when each is required
Peppol, KSeF, FatturaPA, Factur-X, FacturaE — the EU's e-invoicing networks each route invoices a different way. This article maps which channel applies in which country and what to fill in.
Proposals & Invoices
The final invoice (INV-) — Schlussrechnung, facture de solde
The final invoice closes the project. It states the full work value, then explicitly references the deposit invoice and **deducts both the deposit amount and the deposit VAT**, so you don't pay tax twice. This deduction is mandated by §14 UStG and parallel rules across the EU.