Przegląd Procurement Service Bus (PSB) API firmy eConnect: architektura, możliwości i typy dokumentów.
Procurement Service Bus (PSB) to centralna brama API firmy eConnect, która umożliwia wysyłanie, odbieranie i przetwarzanie e-faktur, zamówień i innych e-dokumentów. PSB łączy Państwa oprogramowanie z siecią Peppol i innymi sieciami e-fakturowania za pośrednictwem nowoczesnego REST API zabezpieczonego protokołem OAuth2.
Niezależnie od tego, czy są Państwo dostawcą oprogramowania pragnącym zintegrować e-fakturowanie, czy organizacją chcącą zautomatyzować przepływy dokumentów, PSB zapewnia infrastrukturę pozwalającą robić to w sposób niezawodny i skalowalny.
PSB to coś więcej niż kanał wysyłkowy. To pełnoprawna platforma do przetwarzania e-dokumentów, oferująca funkcjonalność obejmującą cały cykl purchase-to-pay.
E-fakturowanie stanowi rdzeń usługi. Za pośrednictwem API mogą Państwo wysyłać faktury sprzedażowe do odbiorców w sieci Peppol i odbierać faktury zakupowe od dostawców. PSB automatycznie kieruje dokumenty do właściwego Access Point i potwierdza dostarczenie aktualizacjami statusu w czasie rzeczywistym.
E-ordering wykracza poza fakturowanie. PSB obsługuje wysyłanie i odbieranie zamówień, potwierdzeń zamówień, zmian i anulowań. Domyślnie obsługiwane są tylko zamówienia Peppol (Order Only i Advanced Ordering); wiadomości DICO (w tym wiadomość konserwacyjna) są dostępne tam, gdzie ma to zastosowanie, a zamówienia Coupa (cXML) na żądanie. Order-flip (przekształcenie zamówienia w fakturę jednym działaniem) nie jest funkcją PSB; jest dostępny wyłącznie na platformie Collabrr.
Self-billing umożliwia tworzenie i wysyłanie faktur w imieniu dostawcy. Jest to istotne dla organizacji, które wystawiają faktury zakupowe na podstawie otrzymanych towarów lub usług.
Walidacja oferuje samodzielny endpoint, za pomocą którego można sprawdzić poprawność dokumentów XML bez ich wysyłania. Validate API automatycznie rozpoznaje format dokumentu, testuje go względem najnowszych artefaktów i dostarcza szczegółową, wielojęzyczną informację zwrotną dla każdej reguły walidacji.
Transformacja konwertuje dokumenty z jednego formatu e-faktur na inny. Dokument dostarcza się w formacie generowanym przez własne oprogramowanie, a PSB automatycznie konwertuje go na format oczekiwany przez odbiorcę. PSB obsługuje ponad 20 standardów, w tym UBL 2.1, NLCIUS, Peppol BIS Billing V3, PINT, CII, XRechnung, Factur-X/ZUGFeRD, FatturaPA, ebInterface, Svefaktura, e-FFF, OIOUBL, Finvoice, ISDOC oraz formaty branżowe takie jak DICO, SETU i SEEF. Format jest wykrywany automatycznie przy uploadzie; nie trzeba określać, jaki format się dostarcza.
Validated Party Data (VPD) to API GraphQL, które umożliwia odpytywanie i weryfikację danych podmiotów. Mogą Państwo sprawdzić, czy numer KvK, OIN lub NIP rzeczywiście należy do danej organizacji, zanim wyślą Państwo fakturę. W In Control ta sama funkcjonalność znana jest pod komercyjną nazwą Purple Pages.
Intelligent Document Recognition (IDR) konwertuje faktury PDF na ustrukturyzowany XML za pomocą OCR i AI. IDR jest bezpośrednio sterowany przez PSB API, z konfigurowalnymi poziomami jakości i priorytetami.
PSB jest zbudowany na modelu Actor w klastrze Microsoft Azure Service Fabric. Choć brzmi to technicznie, korzyści są konkretne: dokumenty są przetwarzane równolegle na wielu serwerach, bez wzajemnego oczekiwania. W przypadku awarii serwera przetwarzanie jest automatycznie kontynuowane na innym węźle, bez utraty danych.
W praktyce oznacza to czas przetwarzania poniżej 100 milisekund na dokument przy wysyłce, udowodnioną wydajność 200.000 wiadomości na godzinę oraz dostępność na poziomie 99,99% (ponad osiem lat bez nieplanowanych przestojów).
PSB działa jako Peppol Access Point z wieloma Access Pointami w konfiguracji standardowej. Wolumen jest dynamicznie rozdzielany przez niezawodne kolejki. Każdy tenant jest logicznie izolowany: technicznie niemożliwe jest uzyskanie dostępu do dokumentów innego tenanta. PSB działa na Microsoft Azure (regiony Holandia i Irlandia); całe przetwarzanie danych odbywa się w UE/EOG.
Dzięki jednej integracji API uzyskują Państwo dostęp do wielu sieci. PSB automatycznie kieruje dokumenty do właściwego kanału na podstawie odbiorcy.
PSB jest przygotowany na europejską dyrektywę ViDA (VAT in the Digital Age), która od 1 lipca 2030 r. wprowadza obowiązkowe Digital Reporting Requirements (DRR) dla transgranicznych transakcji B2B. Przy wysyłaniu faktury PSB automatycznie generuje podsumowanie DRR na podstawie danych z faktury i przesyła je do właściwego urzędu skarbowego. Jako integrator nie trzeba wykonywać żadnych dodatkowych działań: faktura jest wysyłana przez standardowe API, a PSB zajmuje się raportowaniem.
PSB implementuje w tym celu model Peppol 5-corner, w którym Access Point realizuje raportowanie CTC (Continuous Transaction Controls) w imieniu nadawcy. Komunikaty statusowe, pliki dowodowe i komunikaty raportowania CTC są wliczone w cenę dokumentu, bez dodatkowych kosztów za wiadomość.
PSB działa w trybie event-driven. Zamiast okresowo odpytywać o nowe dokumenty, mogą Państwo skonfigurować webhooki, które bezpośrednio powiadamiają aplikację o istotnych zdarzeniach: otrzymaniu faktury, pomyślnym dostarczeniu faktury, błędzie wysyłki lub Invoice Response od odbiorcy.
Hooki obsługują wiele typów akcji: webhooki HTTPS, powiadomienia e-mail, push SFTP, a nawet przetwarzanie wsadowe, w którym dokumenty są okresowo udostępniane jako archiwum ZIP. Każdy typ hooka jest zabezpieczony podpisami HMAC SHA256.
PSB wykorzystuje OAuth 2.0 do uwierzytelniania, ze wsparciem zarówno dla przepływu Client Credentials, jak i Resource Owner Password Credentials. Cała komunikacja odbywa się przez TLS 1.2 lub nowszy. Przesyłane pliki binarne są automatycznie skanowane pod kątem wirusów i malware, a dokumenty XML są walidowane zgodnie ze standardowymi zestawami reguł.
Każdy tenant działa w logicznie izolowanym środowisku. PSB przetwarza dokumenty dla ponad 20.000 organizacji.
PSB REST API (v1) jest zorganizowane wokół następujących grup endpointów:
Pełna dokumentacja endpointów z formatami żądań i odpowiedzi jest dostępna jako interaktywny Swagger UI. Powiązany plik swagger.json można pobrać w celu wygenerowania kodu klienta.
Są Państwo gotowi, aby rozpocząć? Poniższe artykuły pomogą w pierwszych krokach, od złożenia wniosku o konto testowe po wykonanie pierwszego wywołania API.
PSB udostępnia endpointy do e-fakturowania (wysyłka i odbiór), e-orderingu, self-billingu, walidacji, transformacji, danych podmiotów (VPD) oraz rozpoznawania PDF (IDR). Dzięki jednej integracji API uzyskują Państwo dostęp do Peppol i innych sieci procurement, takich jak Coupa, Ariba i Tungsten.
PSB przetwarza dokumenty w czasie krótszym niż 100 milisekund przy wysyłce, z udowodnioną wydajnością 200.000 wiadomości na godzinę. Dostępność wynosi 99,99%, przy ponad ośmiu latach bez nieplanowanych przestojów.
PSB wykorzystuje OAuth 2.0 do uwierzytelniania, ze wsparciem zarówno dla przepływu Client Credentials, jak i Resource Owner Password Credentials. Cała komunikacja odbywa się przez TLS 1.2 lub nowszy.
Dokument dostarcza się w formacie generowanym przez własne oprogramowanie. PSB automatycznie wykrywa format dokumentu i transformuje go na format oczekiwany przez odbiorcę. Obsługiwanych jest ponad 20 standardów, w tym UBL, NLCIUS, BIS Billing V3, PINT, CII, XRechnung, Factur-X, FatturaPA oraz formaty branżowe takie jak DICO i SETU. Nie trzeba martwić się o format odbiorcy.
PSB jest ViDA-ready. Przy wysyłaniu faktury PSB automatycznie generuje podsumowanie DRR (Digital Reporting Requirement) na podstawie danych z faktury i przesyła je do właściwego urzędu skarbowego. Jako integrator nie trzeba wykonywać żadnych dodatkowych działań. Komunikaty statusowe, pliki dowodowe i komunikaty raportowania CTC są wliczone w cenę dokumentu.
Zobacz interaktywną dokumentację API