¶ Sage Symfonia - integracja ERP przez REST API

Integracja Hummerce z Sage Symfonia łączy sklep z ERP przez REST API platformy: Symfonia przekazuje do sklepu towary, ceny i stany magazynowe, a z niego pobiera zamówienia i aktualizuje ich statusy. Dzięki temu dział handlowy pracuje w ERP, a sklep pokazuje klientom aktualną ofertę i dostępność bez ręcznego przepisywania danych.

Stan na: aktualizacja 2026-10-16.

¶ Korzyści i zastosowania

Towary i ceny prosto z ERP - kartoteka, ceny w kilku typach (np. regularna i hurtowa) i w różnych walutach są prowadzone w Symfonii i trafiają do sklepu.
Aktualne stany magazynowe - ERP przesyła stan per magazyn, a sklep pokazuje klientowi dostępność zgodną z magazynem.
Zamówienia w ERP bez przepisywania - Symfonia pobiera nowe i zmienione zamówienia ze sklepu razem z danymi klienta i dostawy.
Statusy wracają do sklepu - ERP zmienia status zamówienia, płatności i dostawy, a klient widzi zmianę w sklepie.
Jedno API dla wielu zadań - ten sam interfejs obsługuje towary, zamówienia i stany, więc nie ma osobnych kanałów wymiany dla każdego rodzaju danych.
Wspólny model dla ERP bez gotowego modułu - Symfonia łączy się tak samo jak inne systemy korzystające z REST API Hummerce.

¶ Zasady działania

¶ Kto co robi

Hummerce nie wywołuje Symfonii samodzielnie. To ERP jest stroną aktywną: aplikacja po stronie Symfonii odpytuje REST API sklepu i wysyła do niego zmiany. Integrację po stronie Symfonii wykonuje partner wdrożeniowy ERP - po stronie Hummerce konfigurujemy dostęp do API i zakres widocznych danych.

¶ Co się wymienia

Dane	Kierunek	Jak działa
Towary i warianty	ERP -> sklep	Symfonia zakłada i aktualizuje towary, w tym warianty, producenta, parametry i ceny z grupą podatkową
Ceny	ERP -> sklep	Ceny w kilku typach i walutach przekazywane jako parametry towaru
Stany magazynowe	ERP -> sklep	Symfonia przesyła aktualny stan per magazyn, nie zmianę stanu, przez API magazynów i wpisów magazynowych
Zamówienia	sklep -> ERP	Symfonia pobiera zamówienia, także przyrostowo - tylko zmienione od wskazanej daty i godziny
Statusy zamówień, płatności i dostaw	ERP -> sklep	Symfonia zmienia statusy, a sklep reaguje jak przy zmianie ręcznej w panelu, np. wysyła powiadomienie do klienta

¶ Częstotliwość

Częstotliwość wymiany zależy od harmonogramu aplikacji po stronie Symfonii. Stany magazynowe są widoczne w sklepie od kilku sekund do kilkudziesięciu minut po przesłaniu, zależnie od zadań cyklicznych sklepu - dostępność towaru aktualizuje się po przejściu zadania, nie natychmiast.

¶ Które dane widzi ERP

Zakres danych, które sklep udostępnia przez API, ustala się w panelu - osobno dla towarów i dla zamówień. Parametr, który nie został wskazany, nie jest widoczny dla ERP. W zamówieniu można udostępnić m.in. dane klienta i adres dostawy.

¶ Starsza wymiana plikami XML

Hummerce ma też starszą integrację z Symfonią przez wymianę plików XML (towary, magazyn, zamówienia i statusy). Pozostaje dostępna dla istniejących wdrożeń, a nowe wdrożenia opieramy na REST API.

¶ Wersja

REST API towarów i zamówień jest dostępne od wersji Hummerce 2.29, API magazynów i wpisów magazynowych - od wersji 2.32.

¶ Zależności

Włączone REST API w sklepie, z dedykowaną rolą i kontem użytkownika API z dostępem do widoków sklepu.
Aplikacja integracyjna po stronie Symfonii - wykonuje ją partner wdrożeniowy ERP, nie jest częścią Hummerce.
Zgodne symbole towarów - symbol towaru w sklepie musi odpowiadać kartotece Symfonii, bo po nim łączone są dane.
Magazyny i grupy podatkowe założone w sklepie, do których ERP się odwołuje.

¶ Wdrożenie

Integracja wymaga wdrożenia - nie działa po samej aktualizacji sklepu.
Po stronie Hummerce:
- włączenie REST API i założenie roli oraz konta API,
- wskazanie parametrów towaru i zamówienia widocznych w API,
- przygotowanie magazynów i grup podatkowych,
- testy pełnego cyklu: towar, cena, stan, zamówienie i zmiana statusu.
Po stronie ERP: aplikacja integracyjna partnera wdrożeniowego Symfonii, uzgadniana z jego zakresem prac.
Czas wdrożenia ustalamy indywidualnie po analizie zakresu - zależy od liczby wymienianych danych, od typów i walut cen oraz od gotowości aplikacji po stronie ERP.

¶ Ograniczenia

Sklep nie wysyła niczego do Symfonii sam - brak aplikacji po stronie ERP albo przerwa w dostępie do API oznacza brak zamówień i stanów w ERP.
Parametry niewskazane w konfiguracji API nie są widoczne dla ERP.
Zapis towaru przez API obejmuje komplet pól, które mają zostać - pole przesłane jako puste usuwa wartość, np. producenta.
ERP przesyła stan magazynowy, nie jego zmianę. Wpisom magazynowym nie można nadawać własnych symboli.
Zamówienie bez kompletnych danych adresowych klienta lub dostawy może nie zostać pobrane przez ERP.
Każda edycja zamówienia, także przez API, może wysłać do klienta powiadomienie, jeśli parametru nie wyłączono z powiadomień.
Wymiana nie działa w czasie rzeczywistym - zależy od harmonogramu po stronie ERP i zadań cyklicznych sklepu.
Nie weryfikujemy zadania pod kątem zgodności z prawem (np. księgowość i VAT w ERP, regulamin sklepu).

¶ Najczęstsze pytania

Czy Hummerce ma gotowy moduł do Sage Symfonia?
Częściowo. Hummerce łączy się z Symfonią przez REST API, a aplikację po stronie ERP wykonuje partner wdrożeniowy Symfonii. Istnieje też starsza wymiana plikami XML dla istniejących wdrożeń.

Czy sklep sam wysyła zamówienia do Symfonii?
Nie. To Symfonia pobiera zamówienia z REST API sklepu, także przyrostowo, tylko te zmienione od wskazanej daty.

Czy ERP może zmieniać stany magazynowe i statusy zamówień?
Tak. Symfonia przesyła stan per magazyn oraz zmienia statusy zamówienia, płatności i dostawy, a sklep reaguje tak jak przy zmianie w panelu.

Jak szybko zmiany z Symfonii są widoczne w sklepie?
Od kilku sekund do kilkudziesięciu minut - zależy od harmonogramu po stronie ERP i zadań cyklicznych sklepu. Dostępność towaru aktualizuje się po przejściu zadania.

Ile trwa uruchomienie integracji z Symfonią?
Czas ustalamy indywidualnie po analizie zakresu. Zależy od liczby wymienianych danych, typów cen i walut oraz od gotowości aplikacji po stronie ERP.

Na co trzeba uważać przy łączeniu towarów?
Symbol towaru w sklepie musi odpowiadać kartotece w Symfonii. Zmiana symbolu w panelu sklepu przerywa powiązanie danych.

¶ Powiązane

REST API - integracja z zewnętrznymi systemami - zakres danych, uprawnienia i diagnostyka API.
Integracje - katalog - pozostałe integracje ERP, płatności, dostaw i marketplace.
Subiekt GT - integracja przez konektor e-mo - inny przykład ERP połączonego przez REST API.
Comarch ERP XL - integracja ERP z gotowym modułem.
B2B i B2C w jednym sklepie - sprzedaż do firm i klientów indywidualnych na jednej platformie.
Na hummerce.com: Integracja z Sage Symfonia, Integracje.

Chcecie sprawdzić, jak integracja z Sage Symfonia może działać w Waszym sklepie? Umówcie bezpłatną prezentację.

¶ Szczegóły konfiguracji

¶ Dostęp w panelu

Rola i użytkownik API - konto z uprawnieniami do towarów, zamówień i widoków, z dostępem do wszystkich widoków, z których ERP ma pobierać dane. Moduł REST API trzeba włączyć w sklepie.
Lokacje parametrów - parametry towaru widoczne w API przypisujemy do lokacji itemApi, a parametry zamówienia - do lokacji orderApi (Parametry i lokacje).
Magazyny - stany z ERP trafiają do magazynów założonych w sklepie (Magazyny).
Diagnostyka - ekran Status -> Diagnostyka REST API pokazuje, co przysłało ERP i co odpowiedział sklep.

¶ REST API i MCP

Integracja korzysta z REST API. Pobieranie przyrostowe zamówień opiera się na filtrze daty modyfikacji, a wynik można filtrować po dowolnym parametrze. Adres API sklepu i dane dostępowe ustala się przy wdrożeniu.

¶ Parametry

Rodzaj danych	Obiekt	Przeznaczenie
Ceny w kilku typach i walutach	Towar	Typy cen z ERP przekazywane jako parametry cenowe towaru
Producent	Towar	Producent przypisany przez ERP; pusta wartość usuwa producenta
Dane klienta i dostawy	Zamówienie	E-mail, adres, kraj i dane dostawy udostępniane ERP razem z zamówieniem
Dodatkowe informacje	Zamówienie	Uwagi sprzedawcy przekazywane do ERP