Studio WMS.net wymienia dane z ERP przez API (HTTP POST z JSON), import plików XLSX, CSV, TXT, DAT i XML oraz eksport CSV i XLSX. Połączenia z konkretnymi systemami, takimi jak SAP, enova365 czy WAPRO WF-MAG, powstawały w projektach: integrację buduje się we wdrożeniu, a jej zakres ustala analiza.
Jak Studio WMS.net wymienia dane z ERP
Studio WMS.net przyjmuje zlecenia przyjęcia i wydania z zewnętrznego systemu i oddaje mu do odczytu stany oraz dokumenty magazynowe. Zlecenie przekazane z ERP jest zwykłym zleceniem ZPZ albo ZWZ: kierownik obsługuje je w tych samych rejestrach co zlecenia wpisane w formularzu. Wybór kanału zależy od tego, co potrafi system po drugiej stronie.
| Kanał | Jak działa | Kiedy się sprawdza |
|---|---|---|
| API integracyjne | Żądania HTTP POST z dokumentem JSON, odpowiedź także w JSON | Zlecenia przekazywane pojedynczo w ciągu dnia |
| Import plików XLSX, CSV, TXT, DAT i XML | Schemat importu mapuje kolumny na pola, tryb kontroli sprawdza plik bez zapisu | Start magazynu, kartoteki i zlecenia przysyłane w arkuszu |
| Eksport CSV i XLSX | Zestawienia zdefiniowane w programie zapisują się do plików | System, który czyta stany z plików |
| Metody pisane pod klienta | Dodatkowe operacje API budowane jako akcje SQL wywoływane jednym punktem wejścia | Gdy standardowe operacje nie wystarczają |
Gdy ERP zapisuje dane w bazie SQL Server, wymianę przez tabele pośrednie i procedury składowane projektuje się osobno we wdrożeniu; nie jest to gotowa funkcja programu. Opis operacji i kodów błędów jest w instrukcji API Studio WMS.net.
Co przekazuje API
Standardowe API obejmuje zlecenia, kartoteki, stany i dokumenty. Uwierzytelnia się osobne konto techniczne integracji, a nie konto pracownika magazynu. Operacje uruchamia system zewnętrzny, więc o wydaniu towaru ERP dowiaduje się, odczytując zlecenie z realizacją albo dokumenty; częstotliwość odczytów trzeba zaplanować w projekcie.
| Operacja | Kierunek | Zakres |
|---|---|---|
| Utworzenie zlecenia przyjęcia ZPZ lub wydania ZWZ | Do magazynu | Nagłówek i od 1 do 999 pozycji wskazanych przez SKU; razem ze zleceniem zakłada się kartotekę odbiorcy lub dostawcy |
| Odczyt zlecenia | Z magazynu | Po numerze zamówienia, numerze awizacji albo numerze referencyjnym; ilość zamówiona, dostępna i zrealizowana |
| Założenie kartoteki asortymentu i kontrahenta | Do magazynu | Nowy towar klienta i nowy kontrahent |
| Odczyt asortymentu i stanów | Z magazynu | Stan ogólny lub szczegółowy, także na wskazany dzień; wynik dzielony na strony |
| Odczyt dokumentów | Z magazynu | Po numerze awizacji: PZ i WZ do zlecenia. Po kliencie i okresie także PZB, WZB, PW i RW |
Stan na wskazany dzień pozwala uzgodnić ewidencję magazynu z systemem księgowym na koniec miesiąca bez ręcznego eksportu. Standardowe API nie obsługuje dokumentów MM ani inwentaryzacji.
Kolejność synchronizacji i reguły walidacji
Zlecenie z towarem, którego magazyn jeszcze nie zna, zostanie odrzucone w całości. Integracja wysyła więc najpierw kartoteki asortymentu, a dopiero potem zlecenia.
Przed zapisem Studio WMS.net sprawdza zlecenie według czterech reguł. Zlecenie, które nie spełnia którejkolwiek, nie zostaje zapisane, a odpowiedź zawiera kod błędu i komunikat.
- Liczba pozycji: od 1 do 999 w jednym zleceniu; większe zamówienie trzeba podzielić.
- Termin realizacji: nie wcześniejszy niż chwila wysłania żądania, więc zlecenie ponawiane po awarii połączenia potrzebuje aktualnego terminu.
- Klient: kontrahent musi istnieć w kartotece kontrahentów magazynu przed pierwszym zleceniem.
- SKU: każda pozycja musi wskazywać towar z kartoteką asortymentu.
Błędy wracają jako kod HTTP 400 przy nieprawidłowych danych albo 401 przy nieprawidłowym uwierzytelnieniu, z komunikatem w JSON. Zapis zlecenia nie jest jedną transakcją, więc po błędzie w trakcie żądania trzeba najpierw odczytem sprawdzić, czy zlecenie nie zapisało się częściowo, a dopiero potem wysłać je ponownie.
Systemy, z którymi łączyliśmy WMS w projektach
Poza standardowym API w rozwiązaniach wdrożeniowych są połączenia zbudowane pod konkretnych klientów. Nie są to przyciski gotowe po instalacji: każde wymaga konfiguracji i danych dostępowych po stronie systemu docelowego, dlatego jego zakres ustala się we wdrożeniu.
| System | Co obejmowało połączenie |
|---|---|
| enova365 | Import kartotek towarów i kontrahentów z enova365 do Studio WMS.net |
| SAP | Zapis dokumentów wydania WZ do SAP przez interfejs BAPI |
| Asseco WAPRO WF-MAG | Odczyt zleceń z bazy WF-MAG i przypisanie ich użytkownikowi kolektora |
| Kurierzy | Zamawianie kuriera z kolejki zleceń; w projektach DHL, DPD, InPost, Raben i SUUS |
Z pozostałymi systemami ERP, na przykład Comarch, łączymy WMS przez API, pliki albo bazę danych; zakres ustala analiza przed uruchomieniem systemu. Opisy konkretnych wdrożeń: integracja z enova365 i WMS z Wapro MAG w magazynie oleju.
Integracja awizacji z WMS
Studio VSS.net, system awizacji dostaw, działa w tej samej aplikacji i bazie co magazyn. Powiązanie z WMS idzie po numerze awizacji: numer można podać w zleceniu przekazanym przez API, a potem odczytać go przy zleceniu i przy dokumentach. Awizacje nie mają osobnego API. Strona integracja VSS.net z WMS.net opisuje tę współpracę od strony awizacji.
Jak wygląda projekt integracji
Dokumentację techniczną API w formacie OpenAPI dostaje zespół, który buduje połączenie po stronie ERP: programiści Twojej firmy albo dostawca systemu. Zawiera adresy operacji, strukturę żądań i nazwy pól, czyli to, czego publiczna instrukcja nie podaje. Reguły walidacji sprawdza się na danych testowych, a nie na pierwszym prawdziwym zamówieniu. Zakres prac ustala analiza przedwdrożeniowa, a zapytanie o integrację z konkretnym systemem przyjmuje formularz wyceny Studio WMS.net.