Używane oprogramowanie nie jest na liście gotowych integracji, lub budują Państwo własną aplikację, która musi wysyłać i odbierać faktury przez Peppol? W takim przypadku można bezpośrednio zintegrować się z Procurement Service Bus (PSB) eConnect. PSB to techniczny system stojący za wszystkimi integracjami eConnect, dostępny na psb.econnect.eu. Platforma eConnect (platform.econnect.eu) to interfejs klienta, w którym m.in. tworzone są klucze połączenia i zarządzane ustawienia. PSB oferuje trzy metody połączenia: nowoczesne REST API, SFTP i HTTPS.

Najodpowiedniejsza metoda zależy od architektury, wymagań bezpieczeństwa i oczekiwanej objętości. Dokumentacja techniczna dla każdej metody jest dostępna na portalu deweloperskim PSB.

Najczęściej stosowana metoda dla nowych integracji. REST API PSB oferuje endpointy do wysyłania, odbierania i zarządzania fakturami, zamówieniami i odpowiedziami. Uwierzytelnianie odbywa się przez OAuth2, z dwoma dostępnymi flows: Resource Owner Password Credentials i Client Credentials. Tokeny są uzyskiwane poprzez POST /connect/token na identity.econnect.eu. Opcjonalnie można dodać nagłówek Subscription-Key dla dostępu specyficznego dla organizacji.

Odpowiednie dla: aplikacji SaaS, aplikacji webowych, mikroserwisów i nowoczesnych architektur.

Dokumentacja: PSB API & Swagger UI: interaktywna dokumentacja API, specyfikacja OpenAPI i Swagger Editor.

Wymiana plików przez bezpieczne połączenie SFTP. PSB obsługuje dwa przepływy: From SFTP (okresowe pobieranie plików z serwera SFTP użytkownika) i To SFTP (przesyłanie dokumentów na serwer użytkownika przy odbiorze). Oba przepływy konfiguruje się za pomocą hooków SFTP w PSB.

Odpowiednie dla: środowisk enterprise z przetwarzaniem wsadowym, systemów ERP takich jak SAP i Unit4 ERP CR.

Dokumentacja: PSB API & hooks: szukaj SFTP-hooks w endpointach Hook.

Bezpośrednie połączenie HTTPS do wymiany faktur. PSB odbiera dokumenty przez HTTPS POST i dostarcza je za pośrednictwem webhooków lub HTTPS inbound. Obsługuje IP-whitelisting i OAuth2.

Odpowiednie dla: integracji enterprise ze specyficznymi wymaganiami bezpieczeństwa.

Dokumentacja: PSB API & webhooks: HTTPS inbound/outbound i konfiguracja webhooków.

Technicznie: PSB komunikuje się wewnętrznie za pośrednictwem protokołu Peppol AS4 z innymi Access Pointami. To nie jest metoda połączenia, którą wybiera się jako klient; jest automatycznie stosowana przy wysyłaniu faktur przez Peppol.

Do każdej integracji z PSB potrzebne jest:

• Konto eConnect z co najmniej subskrypcją Professional dla SFTP i HTTPS (integracje na miarę wymagają subskrypcji Enterprise)
• Dane uwierzytelniające OAuth2 (client_id i client_secret) dla REST API PSB
• Dla protokołów enterprise: subscription key od działu sprzedaży

Najszybszym sposobem na start jest REST API: należy otworzyć psb.econnect.eu, zapoznać się z Swagger UI i wykonać pierwsze zapytanie API. Więcej informacji w sekcji API & integracja tej dokumentacji.

W przypadku integracji SFTP lub HTTPS prosimy o kontakt z działem sprzedaży eConnect w celu umówienia rozmowy wstępnej. Podczas rozmowy omawiane są szczegóły techniczne, oczekiwana objętość i wymagania bezpieczeństwa. Specyfikacje techniczne są dostępne w dokumentacji PSB API.

Wskazówka: Budują Państwo integrację dla pakietu oprogramowania używanego przez wielu klientów? Prosimy o kontakt z zespołem partnerskim eConnect. Jako partner można zbudować integrację jednokrotnie i udostępnić ją wszystkim swoim klientom.

Gotowi do startu? Dokumentacja PSB API lub przegląd PSB zawierają więcej informacji.