Symfonia i BaseLinker (Base) oraz Apilo: integracja, WebAPI, dokumenty i KSeF

BaseLinker (Base) i Apilo łączą się z Symfonią przez integrator, który rozmawia z ich API z jednej strony i z WebAPI Symfonii z drugiej. Base nie tworzy własnych integratorów z programami ERP, więc w jego katalogu są integracje partnerów: od 2 500 zł netto jednorazowo do 3 228 zł netto rocznie, a integracja budowana pod proces od 4 900 zł netto. Apilo ma integrację z Symfonią w swoim katalogu. W obu przypadkach potrzebujesz licencji WebAPI Symfonii i musisz ustalić, który system wysyła faktury do KSeF.

Stan stron Base, Apilo i Symfonii na 8 listopada 2026 r.

Źródła: katalog Base, Symfonia Handel i Symfonia ERP Handel; katalog Apilo, Symfonia i Symfonia ERP Handel.

Trzy drogi połączenia Symfonii ze sprzedażą

Zanim wybierzesz integrator, sprawdź, czy w ogóle potrzebujesz systemu do zamówień między sklepem a Symfonią.

Droga	Kiedy pasuje	Na co uważać
Integrator z katalogu Base	Sprzedajesz w kilku kanałach (Allegro, sklep, Amazon, Erli) i wysyłki obsługujesz w Base	Koszt integratora płacisz partnerowi, licencję WebAPI Symfonii osobno
Integracja w katalogu Apilo	Pracujesz w Apilo albo planujesz zmianę systemu i chcesz mieć integrację w katalogu operatora	Przy zmianie z Base na Apilo integrację konfiguruje się od nowa
Integrator Symfonia Handel z e-Commerce	Masz jeden sklep i konto na Allegro, a wysyłki i zwroty obsługujesz w samym sklepie	Symfonia wymienia z nazwy Allegro, Shoper, PrestaShop, WooCommerce, IdoSell i Magento; Base i Apilo nie są wymienione

Integrator Symfonii jest produktem producenta Symfonii. Według jego strony łączy Symfonię Handel (linię uniwersalną i profesjonalną) ze sklepem przez API, pobiera zamówienia, wiąże towary po kodzie SKU, rezerwuje albo zdejmuje towar ze stanu i obsługuje warianty (Symfonia, Integrator Symfonia Handel z e-Commerce).

Czwarta droga to integracja budowana pod proces na WebAPI Symfonii i API Base albo Apilo. Taką integrację budujemy w Syntropic w ramach integracji e-commerce, gdy gotowy integrator nie obsługuje Twoich dokumentów, magazynów albo reguł.

WebAPI Symfonii: licencja, o którą trzeba zapytać

Integratory z katalogów Base i Apilo łączą się z Symfonią przez WebAPI. To osobny produkt Symfonii z własnym instalatorem, który działa jako usługa Windows, uruchamia w tle Symfonię ERP Handel na własnej licencji i udostępnia jej funkcje przez REST (Symfonia, WebAPI).

Licencję WebAPI Symfonia sprzedaje w rocznej subskrypcji wycenianej według zakresu integracji (pomoc Symfonii, licencjonowanie WebAPI). Składa się z modułów:

Moduł WebAPI	Do czego służy przy integracji z Base albo Apilo
Main	Obowiązkowy; bez niego nie kupisz żadnego innego modułu
Towary	Odczyt i zakładanie kartotek towarów
Kontrahenci	Zakładanie kartotek klientów z zamówień
Stany magazynowe	Odczyt stanów, które integrator wysyła do kanałów
Zamówienia obce	Tworzenie zamówień od klientów i dokumentów do nich (WZ, faktura)
Dokumenty sprzedaży	Tworzenie faktur i paragonów, wydruki
Rezerwacje	Rezerwowanie towaru i zdejmowanie rezerwacji

Domyślnie licencja obsługuje 10 jednocześnie otwartych sesji. Jedna instancja WebAPI pracuje z jedną firmą w Symfonii, więc dwie spółki z osobnymi bazami to dwie instancje i dwie licencje.

W katalogu Base pełny integrator za 3 228 zł netto rocznie ma WebAPI w nazwie oferty. Zanim zamówisz, zapytaj dostawcę na piśmie, czy licencja WebAPI jest w tej cenie i które moduły obejmuje. Jeśli nie wiesz, o które moduły pytać przy Twoim układzie dokumentów, napisz nam, którą Symfonię masz i co ma powstawać z zamówienia. Odpiszemy z listą modułów i pytaniami do dostawcy.

Dokumenty, towary i stany

Pierwsza decyzja przy konfiguracji to dokument, który ma powstać w Symfonii z zamówienia. Integrator z katalogu Base importuje zamówienia do Symfonii i może od razu wystawić fakturę albo paragon (FS/PA). Integracja w Apilo importuje zamówienie jako zamówienie obce albo dokument sprzedaży.

• Zamówienie bez dokumentu sprzedaży pasuje, gdy fakturę wystawia Base albo Apilo, a Symfonia ma tylko zdjąć towar ze stanu i zaksięgować sprzedaż.
• Zamówienie z FS albo PA pasuje, gdy faktury wystawia Symfonia i ona wysyła je do KSeF.

Funkcje integratora Symfonii ERP Handel w katalogu Base; nazwę programu i dostawcy pominęliśmy. 1 Import zamówień do Symfonii, także z dokumentem FS/PA. 2 Wiązanie towarów z Base po EAN lub SKU z kodem towaru w Symfonii, z rezerwacją albo zdjęciem ze stanu. 3 Status zamówienia wraca do Base. 4 Integrator działa jako usługa systemowa według harmonogramu.

Źródłem cen i stanów jest zwykle Symfonia, a Base albo Apilo rozsyła je do kanałów. Integrator z Base łączy produkt po EAN albo SKU z kodem towaru w Symfonii, Apilo po kodzie towaru albo kodzie kreskowym. Jeśli w Base masz SKU inne niż kody towarów w Symfonii, a część produktów nie ma EAN, ustal jedną regułę i popraw kartoteki przed pierwszą synchronizacją. Inaczej zamówienie spłynie, a stan w Symfonii się nie zmieni.

Integracja Symfonii w katalogu Apilo. 1 Ceny, stany, nazwy, kody EAN i aktywność towaru idą z Symfonii do Apilo. 2 Integrator pracuje według harmonogramu jako usługa systemowa. 3 Zamówienia trafiają do Symfonii, także z dokumentem sprzedaży.

Apilo pokazuje też osobną wtyczkę partnera do Symfonii ERP Handel z ustawieniami dla dokumentów krajowych i zagranicznych, mapowaniem form płatności i wyborem zamówień po statusie. Sprzedaje ją i utrzymuje partner, więc warunki ustalasz z nim.

Kto wysyła faktury do KSeF

Faktura trafia do KSeF z systemu, w którym powstała. W układzie Symfonii z Base albo Apilo wybierasz jedną drogę dla każdej serii faktur.

1. Fakturę wystawia Symfonia Handel. Do KSeF wysyła ją w tle Symfonia KSeF Plus, a użytkownik Symfonii Handel nie musi otwierać osobnej aplikacji. Każda wysyłka i każdy odbiór faktury to operacja z pakietu. Darmowy pakiet ma 60 operacji rocznie, płatne kosztują 690 zł netto rocznie (Basic, do 2 000 operacji), 1 900 zł (Standard, do 10 000) i 3 400 zł (Optimum, do 20 000) (Symfonia, KSeF).
2. Fakturę wystawia Base albo Apilo. Wysyła ją ich moduł KSeF w abonamencie, a Symfonia dostaje z zamówienia tylko zamówienie albo dokument magazynowy. Base wysyła do KSeF wyłącznie faktury wystawione w swoim panelu; konfigurację opisujemy w poradnikach dla Base i Apilo.

Pakiet Basic Symfonii KSeF Plus na stronie Symfonii. 1 Do 2 000 operacji rocznie. 2 Bez automatycznego wysyłania według harmonogramu klienta. 3 Do 31 grudnia 2026 r. wszystkie funkcje są we wszystkich pakietach, od 1 stycznia 2027 r. według tabeli.

Przy sklepie to ważne z dwóch powodów. Pierwszy to limit: 300 faktur sprzedaży miesięcznie to 3 600 wysyłek rocznie, do tego odbiór faktur kosztowych, czyli więcej niż pakiet Basic. Drugi to automatyczne wysyłanie według harmonogramu, którego od 1 stycznia 2027 r. pakiet Basic nie ma. Jeśli faktury za zamówienia mają same trafiać do KSeF, policz pakiet przed końcem roku.

Symfonia zaznacza też, że jeśli korzystasz z jej oprogramowania, nie musisz kupować Symfonii KSeF API (opcja za 2 340 zł netto dla innych systemów). Największe ryzyko to dwie drogi naraz: faktura wysłana przez Symfonię i jej kopia wystawiona w Base dla tego samego zamówienia.

Co sprawdzić przed startem

Wymagania integracji Symfonii na stronie Apilo. 1 Symfonia ERP Handel albo Symfonia Handel w pakiecie Uniwersalnym, aktualna w dniu instalacji. 2 Windows 10 albo Windows Server 2016.

1. Wersja i pakiet Symfonii. Base podaje dla Symfonii ERP Handel wersję od 2020.2, dla Symfonii Handel pakiet Uniwersalny. Apilo wymaga wersji aktualnej na dzień instalacji integratora.
2. Licencja WebAPI. Moduł Main i moduły dla towarów, kontrahentów, stanów, zamówień i dokumentów, które ma tworzyć integrator.
3. Komputer, który nie śpi. WebAPI i integrator działają jako usługi Windows. Gdy serwer jest wyłączony, zamówienia nie spływają, a stany w kanałach stoją.
4. Dokument z zamówienia. Zamówienie, zamówienie z FS albo PA, sam dokument sprzedaży; sprawdź go na zamówieniu z NIP, bez NIP, z wysyłką za granicę i ze zwrotem.
5. Reguła powiązania towarów. EAN, SKU, kod towaru czy kod kreskowy: jedna zasada dla całego katalogu.
6. Seria faktur i KSeF. Jedna droga do KSeF dla każdej serii i pakiet Symfonii KSeF Plus dobrany do liczby faktur.
7. Test. Base daje 14 dni testu, Apilo 21 dni. Puść przez cały łańcuch zamówienia z ostatniego tygodnia, zanim przełączysz produkcję.

Jeśli porównujesz jeszcze same systemy do zamówień, zacznij od porównania Apilo i BaseLinkera (Base). Łączniki Apilo dla innych programów (Subiekt, Optima, enova365, WAPRO Mag) opisujemy w poradniku integracja ERP z Apilo i BaseLinkerem (Base), a koszty integracji Base z ERP w artykule o kosztach wdrożenia BaseLinkera (Base) z ERP.

Jak to robimy w Syntropic

Przy integracjach Base i Apilo z ERP zaczynamy od mapy przepływu danych: który system prowadzi stany, ceny i dokumenty, i którędy faktury idą do KSeF. Potem dobieramy drogę: integrator z katalogu, integrację w Apilo albo połączenie budowane na WebAPI Symfonii. Ustawiamy dokumenty, magazyny, statusy i powiązanie towarów i przepuszczamy przez cały łańcuch zamówienia testowe. Jeśli integracja już działa, ale stany albo faktury się nie zgadzają, sprawdzamy ją w ramach audytu w stałej cenie. Firmę z Podkarpacia albo Małopolski możemy odwiedzić na miejscu; więcej na stronie integracje e-commerce i AI w Rzeszowie.