Integracja WMS z Symfonią Handel i ERP: co potwierdza dokumentacja producenta oraz jak magazyn wymienia dokumenty i obsługuje błędy w wymianie danych z ERP.
Symfonia prowadzi w firmie sprzedaż i ewidencję towarów. Magazyn dokłada informację, której ERP zwykle nie ma: na którym regale leży partia i kto ją tam odłożył. Integracja ma sprawić, że żadna z tych informacji nie jest wpisywana dwa razy.
Strona dotyczy Symfonii ERP, Symfonii Handel i eBiura, czyli produktów, w których powstają dokumenty sprzedaży i ewidencja magazynowa. Na liście produktów na symfonia.pl nie ma osobnej pozycji Fakturowanie, więc faktury traktujemy jako część Handlu albo eBiura. Opis interfejsów pochodzi z dokumentacji producenta, stan na 6.10.2026.
Które produkty Symfonii można połączyć z magazynem
Cztery pozycje z oferty i to, co producent mówi o ich interfejsach.
Dla magazynu liczą się dwa obszary oferty: Handel, który prowadzi dokumenty sprzedaży i ewidencję stanów, oraz Finanse i Księgowość, które rozliczają to, co magazyn przyjął lub wydał. Symfonia ERP działa w wersji desktopowej i w chmurze. Interfejs integracyjny nosi w dokumentacji nazwę WebAPI.
| Produkt | Rola przy magazynie | Interfejs według producenta | Do ustalenia w analizie |
|---|---|---|---|
| Symfonia ERP Handel | Dokumenty sprzedaży i zakupu, ewidencja stanów | WebAPI Handel: REST, JSON, HTTPS | Wersja programu i moduły WebAPI w licencji |
| Symfonia Handel | Ta sama rola w linii bez przedrostka ERP | WebAPI ma tryb pracy Symfonia Handel | Czy wersja programu pozwala uruchomić usługę |
| Symfonia ERP Finanse i Księgowość | Rozrachunki i księgowanie dokumentów z Handlu | WebAPI FK, osobna usługa | Magazyn nie rozmawia z FK, dane idą przez Handel |
| Symfonia eBiuro | Faktury, księgowość i magazyn online w chmurze | Osobny artykuł pomocy o API eBiura | Dostępność API dla posiadanego planu |
Zanim zaczniemy projekt, sprawdzamy linię i wersję Symfonii. Według dokumentacji WebAPI wymaga odpowiedniej wersji programu, więc starsza instalacja może potrzebować aktualizacji przed integracją.
Kiedy Symfonia przestaje wystarczać magazynowo
Cztery sygnały z hali, nie z listy funkcji.
Handel prowadzi dokumenty przyjęcia i wydania towaru, a producent ma też aplikację Mobilny Magazyn na Androida. Dla magazynu o stałych miejscach i niewielu zamówieniach to wystarcza. Granica zależy od wersji i konfiguracji, dlatego opisujemy sygnały z hali, a nie braki produktu.
- Adres miejsca - ewidencja podaje, ile towaru jest w magazynie, ale nie, na którym regale leży. Przy kilkuset lokalizacjach pomaga adresacja lokalizacji.
- Partie i terminy - wydanie według FEFO i blokadę wadliwej partii jednym ruchem opisuje strona o partiach i datach ważności.
- Trasa kompletacji - przy wielu zamówieniach dziennie kompletacja zamówień po trasie skraca dojścia magazyniera.
- Okna dostaw - awizacja dostaw pozwala przygotować rampę przed przyjazdem auta.
Jeśli biuro co tydzień koryguje stan po fizycznym przeliczeniu, a korekt przybywa wraz z obrotem, zysk z adresacji i skanu da się policzyć. Porównanie w dziewięciu kryteriach znajdziesz na stronie WMS a ERP, a skaner magazyniera opisuje terminal Android.
Dokumenty i dane w obu kierunkach
Co płynie z Symfonii do magazynu, co wraca i co zostaje tylko na hali.
Podział jest prosty: kartoteka i faktury zostają w Symfonii, a miejsce składowania i partia w Studio WMS.net. Zamówienie z Symfonii staje się w magazynie zleceniem, a po wykonaniu na terminalu wraca jako potwierdzenie z ilościami rzeczywistymi.
| Dane | Kierunek | W Symfonii | W Studio WMS.net |
|---|---|---|---|
| Kartoteka towarowa | Symfonia do WMS | Pozycja towarowa z jednostką | Asortyment z SKU i EAN oraz parametrami składowania |
| Kontrahenci | Symfonia do WMS | Dostawcy i odbiorcy | Kontrahent na zleceniu |
| Zamówienie zakupu | Symfonia do WMS | Zamówienie do dostawcy | Zlecenie przyjęcia ZPZ |
| Przyjęcie towaru | WMS do Symfonii | Dokument PZ z ilościami rzeczywistymi | PZ po skanie na terminalu |
| Zamówienie sprzedaży | Symfonia do WMS | Zamówienie odbiorcy | Zlecenie wydania ZWZ |
| Wydanie towaru | WMS do Symfonii | Dokument WZ | WZ po kompletacji według lokalizacji |
| Wynik inwentaryzacji | WMS do Symfonii | Dokumenty różnic IN+ i IN- | Spis z terminala |
| Przesunięcie między lokalizacjami | Tylko WMS | Zwykle bez zapisu, MM dotyczy przesunięć między magazynami | Ruch zapisany na terminalu |
Dokumentacja WebAPI dzieli ofertę na moduły. Kontrahenci i Towary odpowiadają pierwszym dwóm wierszom tabeli, a Zamówienia i Dokumenty wierszom z dokumentami. Czy moduł Dokumenty obejmuje każdy typ z tabeli, potwierdzamy dla konkretnej wersji w analizie przedwdrożeniowej.
Wydanie biegnie w odwrotnej kolejności: dokument WZ wraca do Symfonii z tym, co faktycznie wyjechało z hali.
Drogi integracji ze Studio WMS.net
Cztery kanały wymiany i to, czego każdy wymaga po stronie Symfonii.
Studio WMS.net wymienia dane z ERP czterema kanałami: plikami Excel, przez WebService, komunikatami API w formatach XML i JSON oraz importem z serwera FTPS. Kanały opisuje strona o komunikacji z systemami zewnętrznymi, a wybór zapada w analizie. Dla Symfonii nowym elementem jest WebAPI producenta.
Usługa WebAPI działa po stronie Symfonii jako usługa systemu Windows z własnym instalatorem. Obsługuje jedną bazę danych, więc firmy prowadzone w kilku bazach potrzebują kilku usług, a szyfrowanie HTTPS wymaga certyfikatu z kluczem prywatnym. Według FAQ WebAPI licencja domyślnie obsługuje 10 jednocześnie otwartych sesji, a oferta jest sprzedawana w subskrypcji rocznej.
| Droga | Jak przenosi dane | Co musi stać po stronie Symfonii | Kiedy ma sens |
|---|---|---|---|
| WebAPI Symfonii | Studio WMS.net wywołuje usługę REST w formacie JSON przez HTTPS | Usługa WebAPI, licencja z potrzebnymi modułami, użytkownik z uprawnieniami | Wymiana ciągła, gdy dokument ma trafić do Symfonii zaraz po skanie |
| Komunikaty API w XML lub JSON | Studio WMS.net przyjmuje i wysyła komunikaty przez własne interfejsy | Program lub integrator, który wysyła dokument do WMS i odbiera potwierdzenie | Gdy po stronie Symfonii pracuje zewnętrzny integrator |
| Pliki Excel | Eksport z Symfonii i import arkusza do WMS, w drugą stronę analogicznie | Eksport w układzie kolumn uzgodnionym z działem ERP | Pierwszy załadunek kartotek i instalacje bez WebAPI |
| Serwer FTPS | Studio WMS.net importuje pliki odłożone na serwerze | Proces, który odkłada pliki w uzgodnionym formacie | Wymiana okresowa bez dostępu sieciowego do usługi |
Studio WMS.net ma konektor do danej wersji Symfonii, a integracje wykonuje usługa SSService.exe. Drogę z tabeli i zakres dla wersji programu potwierdza analiza przedwdrożeniowa, po sprawdzeniu wersji programu i zakresu licencji WebAPI.
Moduł integracji ERP wchodzi do licencji od wersji STANDARD, a aktualne warunki pokazuje cennik. Pierwszy załadunek kartotek można zrobić importem z Excela, zanim ruszy wymiana ciągła. Schemat pokazuje jedno wydanie razem z torem awaryjnym.
Kto wykonuje integracje po stronie Studio WMS.net
Za wymianę z Symfonią odpowiada usługa Windows na serwerze.
Studio WMS.net ma konektor do danej wersji ERP, a integracje wykonuje SSService.exe. To usługa Windows instalowana na serwerze, która realizuje zadania systemu, w tym wymianę dokumentów z Symfonią.
WebAPI z tabeli wyżej to usługa producenta po stronie Symfonii. SSService.exe jest wykonawcą integracji po stronie Studio WMS.net. Które drogi z tabeli obsługuje konektor dla Twojej wersji Symfonii, potwierdza analiza przedwdrożeniowa. Dla magazynu liczy się więc jedno pytanie: czy konektor obejmuje Twoją linię Symfonii. Odpowiedź zależy od wersji programu i licencji WebAPI.
Obsługa błędów wymiany
Cztery rodzaje błędów i to, kto je rozwiązuje.
Zerwane łącze mija samo, brakujący towar w kartotece nie minie nigdy, więc każda przyczyna wymaga innej reakcji. Studio WMS.net zapisuje dokument i wpis do kolejki wyjściowej w jednej transakcji bazy, a kolejka FIFO wysyła je w kolejności zatwierdzenia. Mechanizm opisuje strona o integracji magazynu online z ERP.
| Rodzaj błędu | Przykład | Reakcja | Kto interweniuje |
|---|---|---|---|
| Przejściowy | Usługa WebAPI jest wyłączona albo wszystkie sesje są zajęte | Ponowienie z rosnącym odstępem | Nikt, do wyczerpania prób |
| Trwały | Towar lub kontrahent z dokumentu nie istnieje w kartotece Symfonii | Pozycja trafia do kolejki błędów | Administrator poprawia kartotekę lub dokument |
| Duplikat | Łącze zerwało się po wysłaniu, a próba powtórzyła ten sam dokument | Rozpoznanie dokumentu i pominięcie | Nikt |
| Przerwa ERP | Aktualizacja Symfonii albo restart usługi | Tryb awaryjny, kolejka rośnie, magazyn pracuje | Nikt, po powrocie usługi zaległość wysyła się sama |
Przy duplikatach jest zastrzeżenie. Mechanizm z klucza idempotentności w nagłówku żądania nie występuje w przejrzanych stronach dokumentacji WebAPI Symfonii. Rozpoznawanie dokumentu opieramy więc na numerze nadanym w WMS i zapisanym przy dokumencie w Symfonii, a pole wybieramy w analizie.
Wdrożenie integracji z Symfonią
Cztery etapy od inwentaryzacji wersji do pracy na produkcji.
Integrację planuje się razem z wdrożeniem WMS, bo adresacja i zasady przyjęcia wpływają na układ dokumentów. Przebieg prac opisuje analiza przedwdrożeniowa oraz strona o wdrożeniu programu magazynowego.
- Inwentaryzacja Symfonii - linia i wersja programu oraz zakres licencji WebAPI.
- Źródło prawdy - ustalenie, który system prowadzi kartotekę towarową i które pola dopisuje magazyn.
- Test na kopii bazy - wymiana na środowisku testowym, potem jedna strefa magazynu na produkcji.
- Nadzór nad kolejką - podgląd kolejki błędów i alerty dla administratora w pierwszych tygodniach pracy.
Przejście z samej Symfonii na WMS nie wymaga zatrzymania magazynu. Najpierw przenosi się kartoteki, potem adresy lokalizacji, a pierwsze tygodnie obejmują jedną strefę. Wycenę dla Twojego magazynu przygotujemy po rozmowie na stronie wyceny.
Inne systemy ERP
Gdzie szukać opisu integracji z pozostałymi programami.
Symfonia nie jest jedynym systemem, z którym magazyn wymienia dokumenty. Pozostałe opisujemy osobno:
- WAPRO WF-Mag - opis integracji na stronie integracja WF-Mag z WMS, wersja modułowa w module WF-Mag. Korzyści zestawia strona o zaletach integracji, a ofertę program magazynowy z modułem WF-Mag.
- enova - integracja WMS z enova.
- SAP - integracja SAP ERP z WMS.
- Pozostałe systemy - ogólny opis na stronie integracja z systemem ERP oraz w dziale Integracje.