Integracje API w B2B – ERP, PIM i e-commerce

Integracje API w firmie B2B łączą ERP, PIM, sklep lub portal B2B, CRM i systemy partnerów w taki sposób, że każda dana ma jedno źródło prawdy, znany kierunek i ustaloną częstotliwość wymiany. Zanim powstanie pierwszy endpoint, warto więc narysować mapę przepływów: jakie dane krążą w firmie, skąd dokąd płyną, jak często i kto odpowiada za ich poprawność. Taka mapa jest najtańszym dokumentem w całym projekcie, a oszczędza najwięcej sporów i błędów. Poniżej pokazujemy, jak ją przygotować, i dajemy przykładową mapę dla typowej firmy B2B.

Po co mapa przepływów danych

Bez mapy integracje powstają punktowo: najpierw „trzeba wysłać zamówienia do ERP”, potem „trzeba pokazać stany w sklepie”, później „handlowcy chcą widzieć faktury w CRM”. Każde połączenie działa osobno, a po roku nikt nie wie, dlaczego cena w portalu różni się od ceny w CRM ani który system nadpisał adres klienta. Mapa pozwala:

• zobaczyć, gdzie te same dane są edytowane w kilku miejscach,
• ustalić jedno źródło prawdy dla każdego typu danych,
• zaplanować kolejność integracji,
• dobrać sposób wymiany (zdarzenie, harmonogram, plik) do rzeczywistej potrzeby, a nie do mody.

Jak zbudować mapę – pięć pytań dla każdej danej

Dla każdego typu danych (produkt, cena, stan, klient, zamówienie, dokument…) odpowiedz na pięć pytań:

1. Źródło prawdy – w którym systemie dana powstaje i jest poprawiana?
2. Odbiorcy – które systemy jej potrzebują i do czego?
3. Kierunek – jednostronny czy dwustronny? Jeśli dwustronny, które pola w którą stronę?
4. Częstotliwość – w czasie zbliżonym do rzeczywistego, co kilka minut, raz dziennie, na żądanie?
5. Właściciel – kto w firmie odpowiada za poprawność i kto reaguje na błędy?

Dopiero z tych odpowiedzi wynika technologia: webhook, kolejka, cykliczna synchronizacja przyrostowa czy nocny eksport pliku.

Przykładowa mapa przepływów dla firmy B2B

Poniższa lista to przykład dla firmy, która ma ERP, PIM, portal B2B, CRM i współpracuje z przewoźnikiem. W Twojej firmie układ może być inny – ważne jest, żeby każda pozycja miała wypełnione wszystkie pola.

• Kartoteka produktów (indeks, nazwa handlowa, jednostki, VAT) – źródło: ERP → PIM, portal B2B; częstotliwość: kilka razy dziennie i po zmianie; właściciel: dział zakupów lub logistyki.
• Opisy, zdjęcia, atrybuty, dokumenty techniczne – źródło: PIM → portal B2B, sklep, marketplace; częstotliwość: po publikacji w PIM; właściciel: zespół produktowy lub marketing.
• Ceny katalogowe i cenniki klientów – źródło: ERP → portal B2B, CRM; częstotliwość: po zmianie cennika plus pełne uzgodnienie nocne; właściciel: dział handlowy.
• Stany dostępne – źródło: ERP lub WMS → portal B2B; częstotliwość: przyrostowo co kilka minut; właściciel: magazyn.
• Kontrahenci i oddziały – źródło: ERP → portal B2B, CRM; nowe firmy z portalu → ERP po akceptacji; częstotliwość: na bieżąco; właściciel: dział obsługi klienta.
• Osoby kontaktowe – źródło: CRM → portal B2B (konta użytkowników), z możliwością zgłaszania zmian z portalu; częstotliwość: na bieżąco; właściciel: handlowcy.
• Szanse sprzedaży i oferty – źródło: CRM; do ERP trafiają dopiero jako zamówienie po akceptacji oferty; właściciel: handlowcy.
• Zamówienia – źródło: portal B2B → ERP; częstotliwość: zdarzeniowo przez kolejkę; właściciel: dział obsługi zamówień.
• Statusy realizacji – źródło: ERP → portal B2B, CRM; częstotliwość: po zmianie statusu; właściciel: dział obsługi zamówień.
• Przesyłki i numery listów przewozowych – źródło: system przewoźnika lub WMS → ERP, portal B2B; częstotliwość: po nadaniu i przy zmianie statusu; właściciel: magazyn.
• Faktury i dokumenty sprzedaży – źródło: ERP → portal B2B (do pobrania), CRM (podgląd); częstotliwość: po wystawieniu; właściciel: księgowość.
• Reklamacje i zwroty – źródło: portal B2B → system obsługi reklamacji lub ERP; statusy wracają do portalu; właściciel: dział reklamacji.

Już na takiej liście widać newralgiczne miejsca: kontrahenci i osoby kontaktowe płyną w dwie strony, a ceny są potrzebne w trzech systemach. Tam najczęściej powstają rozbieżności, więc tam trzeba najdokładniej opisać reguły.

Zasady, które porządkują mapę

• Jedno źródło prawdy na pole, nie na rekord. Klient może mieć NIP i warunki płatności z ERP, a osoby kontaktowe z CRM. To normalne, byle było zapisane.
• Systemy odbiorcze nie edytują danych źródłowych. Jeśli portal musi coś zmienić, wysyła propozycję zmiany, a nie nadpisuje.
• Identyfikatory są wspólne. Każdy system przechowuje identyfikator rekordu z systemu źródłowego – po nim, a nie po nazwie, łączy dane.
• Częstotliwość wynika z konsekwencji opóźnienia. Stan, który jest nieaktualny o godzinę, może oznaczać sprzedaż towaru, którego nie ma. Opis produktu nieaktualny o godzinę zwykle niczego nie psuje.
• Każdy przepływ ma właściciela biznesowego, nie tylko technicznego.

Jak dobrać sposób wymiany do przepływu

Z mapy wynika też technika. Nie każdy przepływ wymaga tej samej:

• zdarzenia i webhooki – gdy odbiorca musi zareagować szybko, np. nowe zamówienie, zmiana statusu, nadanie przesyłki,
• synchronizacja przyrostowa co kilka minut – gdy danych jest dużo, a zmieniają się często, np. stany magazynowe,
• pełne uzgodnienie cykliczne (np. nocne) – jako zabezpieczenie, które wyłapuje rozbieżności po przerwach i błędach,
• zapytanie na żądanie – gdy dana jest potrzebna rzadko i musi być aktualna w momencie odczytu, np. szczegóły limitu kredytowego przy składaniu zamówienia,
• wymiana plików – gdy partner lub starszy system nie ma API; to wciąż integracja, byle była zautomatyzowana i monitorowana.

W praktyce jeden typ danych często korzysta z dwóch technik naraz, np. stany przyrostowo w dzień i pełne uzgodnienie w nocy.

Warstwa pośrednia czy połączenia bezpośrednie

Przy dwóch–trzech systemach połączenia bezpośrednie bywają wystarczające. Gdy systemów jest więcej, lepiej sprawdza się warstwa pośrednia: jeden serwis integracyjny, który zna mapę, pilnuje kolejności, loguje każdą operację i tłumaczy formaty. Dzięki temu wymiana jednego systemu (np. ERP) oznacza zmianę jednego adaptera, a nie wszystkich połączeń. Czym jest taka warstwa i jak wyjaśnić ją osobom nietechnicznym, opisujemy w tekście o warstwie API w systemie firmowym.

Najczęstsze błędy w mapowaniu przepływów

• mapa opisuje systemy, ale nie dane – „ERP łączy się z portalem” niczego nie wyjaśnia,
• brak rozróżnienia między stanem fizycznym a dostępnym,
• pominięcie danych „pobocznych”: dokumentów, reklamacji, zgód marketingowych,
• dwustronna synchronizacja wszystkich pól „na wszelki wypadek”,
• brak właściciela po stronie biznesu – błędy danych trafiają wtedy do programistów, którzy nie mają wiedzy, jak je poprawić.

Konkretne pułapki przy połączeniu portalu z ERP opisujemy w artykule Integracja ERP z platformą B2B – najczęstsze pułapki, a przepływ danych produktowych przez PIM – w tekście o połączeniu ERP, PIM i DPPC.

Od czego zacząć

Zbierz w jednym pokoju osoby z handlu, magazynu, obsługi klienta i IT, weź listę z tego artykułu i dla każdej pozycji wpisz źródło, odbiorców, częstotliwość i właściciela. Wystarczy arkusz. Z gotową mapą można rozmawiać o zakresie i kolejności prac. Jeśli chcesz, żebyśmy poprowadzili taki warsztat, zobacz naszą ofertę integracji B2B z ERP i skontaktuj się z nami.