Integracje IdoSell warto projektować od procesu, mimo że platforma oferuje wiele gotowych połączeń. Najpierw trzeba ustalić, które funkcje obsłuży konfiguracja systemu, a które naprawdę wymagają własnego kodu. Dublowanie istniejącego mechanizmu zwiększa koszt i liczbę miejsc, w których może pojawić się błąd.
Zacznij od gotowych integracji
IdoSell opisuje połączenia z systemami płatności, dostaw, marketplace oraz narzędziami wspierającymi sprzedaż w katalogu integracji IdoSell. Jeżeli standardowa integracja pokrywa wymagania, zwykle łatwiej ją utrzymać niż własny konektor.
Trzeba jednak przejść cały scenariusz. Sama obecność logo dostawcy nie odpowiada na pytanie o korekty dokumentów, wiele magazynów, niestandardowe statusy czy automatyczny wybór usługi kurierskiej.
Kiedy potrzebne jest API IdoSell
Własna integracja ma sens, gdy firma korzysta z niestandardowego ERP, centralnego PIM lub procesu, którego nie obsługuje gotowy moduł. IdoSell udostępnia narzędzia dla deweloperów, między innymi API i webhooki do wymiany danych.
Przed rozpoczęciem prac należy spisać zasoby i operacje: produkty, warianty, ceny, zapasy, zamówienia, płatności oraz statusy wysyłki. Dla każdego pola wskazuje się system nadrzędny i kierunek synchronizacji.
Połączenie IdoSell z ERP lub WMS
ERP zwykle odpowiada za dokumenty handlowe, ceny i dane księgowe, a WMS za fizyczny stan oraz kompletację. IdoSell prowadzi sprzedaż i przekazuje zamówienia. To ogólny model, który trzeba dopasować do faktycznej organizacji firmy.
Najtrudniejsze są nie zwykłe zamówienia, lecz wyjątki: częściowa wysyłka, anulowanie po przekazaniu do magazynu, brak jednego produktu i zwrot. Każdy z tych przypadków wymaga mapy statusów oraz określenia, który system może cofnąć decyzję innego.
Faktury bez ręcznego przepisywania
Integracja z fakturownią powinna otrzymać dane nabywcy, pozycje, stawki podatku, płatność i walutę w uzgodnionym momencie. Po utworzeniu dokumentu jego identyfikator wraca do zamówienia. Dzięki temu ponowne zdarzenie nie tworzy kolejnego numeru.
Osobno trzeba opisać korekty, faktury zaliczkowe, wysyłkę dokumentu oraz zmianę danych. Są to różne operacje i nie powinny być ukryte za jednym przyciskiem „synchronizuj”.
Kurierzy i status przesyłki
Najpierw warto wykorzystać gotową obsługę przewoźnika w platformie. Własna warstwa jest potrzebna, jeśli zamówienia rozdziela kilka magazynów albo reguła wyboru kuriera zależy od warunków niewspieranych przez standardowy moduł.
Numer przesyłki powinien wrócić do zamówienia, a zmiana statusu służyć obsłudze klienta, nie tylko raportowaniu. Nie należy jednak mapować każdej technicznej aktualizacji przewoźnika na wiadomość do kupującego.
Monitoring ważniejszy niż jednorazowy test
Integracja IdoSell potrzebuje dziennika operacji, kolejki ponowień i alertów. Operator powinien zobaczyć zamówienie, przyczynę błędu i bezpieczną akcję naprawczą. Warto również uruchamiać okresowe uzgadnianie produktów, stanów i zamówień.
Test końcowy powinien obejmować duplikat zdarzenia, niepoprawne dane, chwilową niedostępność ERP oraz częściową realizację. Dopiero wtedy wiadomo, czy połączenie działa także poza idealną ścieżką.