Dokumentacja integracji obejmująca lookup, walidację, wysyłanie, odbieranie, webhooki i eksport audytowy. Opisuje zalecane podejście do wdrożenia, zasady bezpieczeństwa i scenariusze integracji.
Dostępne endpointy mogą różnić się w zależności od środowiska i typu wdrożenia. Klucze produkcyjne należą do serwera, nie do przeglądarki. Publiczny frontend nie może wywoływać prywatnych tras produkcyjnych bezpośrednio.
Prywatne klucze API należą do serwera, nie do JS przeglądarki. Wysyłka i ponowienia powinny używać Idempotency-Key.
Endpointy uwzględniają nie tylko wysyłkę, ale też odbiór, akceptacje, kody odpowiedzi, pakiety dowodowe i przepływ archiwizacji.
Integrator potrzebuje krótkiego quickstartu, przykładów payloadu, reguł retry, webhooków i jasnego rozróżnienia między trybem testowym a produkcyjnym.
Dla klientów enterprise ważny jest w pełni zautomatyzowany przepływ: system przyjmuje feed, waliduje go, konwertuje, wysyła i zwraca finalne artefakty z powrotem do archiwum lub ERP.
Integracja uwzględnia feed JSON/XML, przetwarzanie wsadowe i bezpieczne kanały jak SFTP. Interface Control Document może mieć formę specyfikacji OpenAPI/Swagger uzupełnionej o mapowanie i reguły retry.
Przy błędzie system powinien zwrócić szczegółowy powód, rule ID, węzeł XML i zalecaną poprawkę. Źródłem poprawki pozostaje system źródłowy, a eFaktúra centrum zwraca wynik przez webhook.
Klienci enterprise często potrzebują odzyskać finalne XML i PDF, mieć portal do przeglądu przetworzonych faktur i przygotować własny szablon PDF zgodny z brandingiem.
Kontrakt dla feedu, mapowania, katalogu błędów, wersjonowania i listy kontrolnej dla zespołów enterprise.
Cykl życia dostawy, payloady callback, model podpisu, retries i kolejność zdarzeń.
Zwrot finalnego XML/PDF, pakiet niestandardowego szablonu i przekazanie do archiwum w systemie klienta.
Lista kontrolna promocji, payloady testowe, zabezpieczenia idempotencji i reguły cutover przed startem produkcyjnym.
Rule ID, waga, ścieżka XML, wskazówki naprawcze i model właściciela dla triage enterprise.
Konwencje nazewnictwa, manifesty, pliki ACK, częściowy retry i identyfikowalność dla feedów korporacyjnych.
Rezydencja danych w UE, logi audytowe, retencja i model operacyjny enterprise do przeglądu technicznego.
SSO, cykl życia i zarządzanie rolami dla tenantów korporacyjnych i zespołów integracyjnych.
API pay-as-you-go, plany dla księgowych i middleware enterprise w jednym modelu komercyjnym.
Rozdzielenie uprawnień admina, księgowego i developera, w tym klucze API i role audytowe.
Priorytetowa lista systemów dla rynku słowackiego ze statusem kompatybilności. Import działa już z POHODA XML, eksportami KROS, Money/MRP CSV i ISDOC; kolejne bezpośrednie konektory są dodawane stopniowo.
Techniczna baza dla nagłówków edge, CORS, kontroli payloadu, auth i hardeningu enterprise.
Strona statusu, log dostaw webhooków, correlation ID i raportowanie incydentów dla wsparcia enterprise.
Pakiet e-Discovery dla klientów potrzebujących eksportu XML/PDF/log za dany okres.
Reguły, dopasowanie PO, spory i smart intake dla bardziej zaawansowanych scenariuszy automatyzacji.
Factur-X, clearance i roaming jako kierunek wielokrajowy dla kolejnych integracji.
Lookup partnera w formacie 0245:2020123456. Wynik: rejestracja, nazwa, obsługiwane dokumenty, status gotowości i zalecany kanał.
Walidacja XML zwraca rule_id, wagę problemu i zalecenie naprawy. W lokalnym przeglądzie zawsze powinno być jasno oznaczone, że nie jest to wynik produkcyjny.
Excel, CSV lub przygotowane eksporty na wejściu, ZIP z gotowymi XML lub raportem wsadowym na wyjściu. Odpowiednie dla stopniowego przejścia bez nowego ERP.
Przygotowanie i wysyłka dokumentu przez podłączonego certyfikowanego partnera, z naciskiem na Idempotency-Key, ID transmisji, evidence i kolejne zdarzenia response.
Przegląd ACK, NACK, odrzuceń i innych zdarzeń wraz ze znaczeniem biznesowym i osią czasu przetwarzania.
Pakiet do audytu lub kontroli wewnętrznej: payload, podsumowanie walidacji, zdarzenia response, wersja reguł i oś czasu przetwarzania.
Poniższe przykłady służą jako wzorzec sandboxa lub integracji server-side. Produkcyjny URL, autoryzacja i dostępne endpointy zależą od wybranego wdrożenia.
Warstwa transportowa potwierdziła dostarczenie do sieci lub odbiorcy.
Odrzucenie transportowe lub biznesowe. Zazwyczaj otwiera remediation flow.
Warunkowa akceptacja, timeout lub konflikt danych workflow.
Dokument został zamknięty i oznaczony do archiwizacji z pakietem evidence.
Finalny XML i PDF są gotowe do zwrotu do wewnętrznego archiwum lub systemu billingowego klienta.
Wejścia o niskim zaufaniu powinny przechodzić przez ręczny przegląd, nie autonomiczną wysyłkę.
Peppol ID, numer podatkowy, IBAN i identyfikatory partnera trzeba zwalidować przed batchem.
ACK nie oznacza akceptacji biznesowej. Workflow powinien czekać na kolejne zdarzenie response.
Dla nieprzygotowanego partnera zwróć zalecany kanał, nie tylko komunikat "partner nie znaleziony".