Platforma integracji ERP z API przewoźników

Dokument sprzedaży powstaje w ERP, a etykieta przewozowa w systemie operatora logistycznego. Bez integracji użytkownik musi ręcznie odnaleźć przesyłkę, pobrać PDF, znaleźć właściwy dokument i połączyć oba elementy. Zbudowałem platformę .NET 8 działającą w sieci wewnętrznej, która wykonuje ten proces cyklicznie i pozostawia ślad audytowy.

• 01Dokument sprzedaży i etykieta powstawały w różnych systemach.
• 02Każdy operator miał własny kontrakt integracyjny i sposób komunikacji.
• 03Zewnętrzne API może być czasowo niedostępne albo zwracać poprawny stan biznesowy, który jeszcze nie pozwala pobrać etykiety.
• 04Ręczny proces utrudniał audyt: brakowało spójnej informacji kiedy i w jaki sposób etykieta została powiązana z dokumentem.
• 05Rozwiązanie musiało obsługiwać kolejnych przewoźników bez przebudowy rdzenia.

Platforma integracyjna działa po stronie organizacji i łączy ERP z API operatorów logistycznych. Proces obejmuje cztery kroki.

• 01Wykrycie: cykliczne odpytywanie API operatora i odczyt referencji dokumentów po stronie ERP.
• 02Pobranie etykiety: PDF jest pobierany z systemu przewoźnika i składowany w repozytorium aplikacji.
• 03Dopasowanie: numer przesyłki jest łączony z właściwym dokumentem sprzedaży.
• 04Zapis w ERP: załącznik i odnośnik są zapisywane przez oficjalne API systemu ERP.

• 01Adapter przewoźnika jako granica systemu. Rdzeń nie zna szczegółów konkretnego operatora. Każdy dostawca implementuje wspólny kontrakt.
• 02Zapis do ERP wyłącznie przez oficjalny interfejs. Odczyt danych może korzystać z zapytań tylko do odczytu, ale operacje modyfikujące dokumenty przechodzą przez API producenta ERP.
• 03Kontrakty integracyjne wynikają ze specyfikacji. Struktury komunikatów są budowane na podstawie udokumentowanych kontraktów.
• 04Błąd techniczny i stan biznesowy to nie to samo. System odróżnia przejściową niedostępność API od poprawnej odpowiedzi informującej, że przesyłka nie jest jeszcze gotowa.

• 01Aplikacja webowa i procesy w tle w .NET 8.
• 02Integracja z katalogiem domenowym.
• 03SQL Server jako warstwa danych.
• 04Adaptery przewoźników za wspólnym interfejsem.
• 05Retry/circuit breaker i kontrolowane limity zapytań.
• 06Logowanie strukturalne oraz monitoring dostępności źródeł.
• 07Decyzje architektoniczne dokumentowane w repozytorium.
• 08Automatyczne testy chroniące kontrakty i logikę biznesową.

• 01Proces standardowy przebiega automatycznie, a użytkownik wraca do niego przede wszystkim przy wyjątkach wymagających decyzji.
• 02Powiązanie etykiety z dokumentem pozostawia ślad czasu, źródła i wyniku operacji.
• 03Kolejne konta nadawców i zakresy obsługi mogą być dodawane konfiguracyjnie.
• 04Warstwa adapterów pozwala rozwijać integrację o kolejnych operatorów bez przebudowy rdzenia.
• 05Rozwiązanie pracuje produkcyjnie i jest zaprojektowane na restart aplikacji oraz przejściową niedostępność zewnętrznego API bez utraty stanu procesu.