Integracja sklepu z SAP S/4HANA i Business One - co warto wiedzieć przed startem

W skrócie

• 1. SAP to dwa różne produkty: S/4HANA (Enterprise, dla dużych korporacji) i Business One (segment średni). Integracje mają inne API i inną filozofię.
• 2. API S/4HANA: OData REST (preferowane od 2019+), IDoc (klasyka, EDIFACT-podobne), SAP PI/PO jako middleware integracyjne.
• 3. Cykl decyzyjny po stronie klienta SAP to często 6-12 miesięcy. Realne wdrożenie integracji - 4-8 miesięcy.
• 4. Koszt wdrożenia 150-500 tys. zł (bez kosztów SAP-owych po stronie klienta).
• 5. Charakterystyka: wysoka stabilność po wdrożeniu, niskie ryzyko awarii, ale każdą zmianę robisz tygodniami przez change management.

S/4HANA vs. Business One

SAP S/4HANA. Enterprise, dla korporacji i dużych firm. W Polsce klient zaczyna od ~50 M zł obrotu rocznego - wcześniej nikt nie kupuje, bo licencje + wdrożenie idą w miliony. Architektura kolumnowa (HANA), nowoczesny stack, ale ekosystem konsultantów drogi i niewielki.

SAP Business One. Średni segment, hurtownie i producenci 5-50 M zł. Inny stack technologiczny (MSSQL lub HANA dla nowszych instalacji), inne API (Service Layer - REST), inny ekosystem. Tańszy w licencji, łatwiejszy w integracji.

SAP ECC (klasyczny R/3). Schyłkowy - SAP wypycha klientów na S/4HANA do 2027. Wciąż spotykany. API: BAPI, IDoc, RFC. Integracja możliwa, ale to projekt na schyłku.

API SAP S/4HANA - co realnie używać

OData (REST). SAP wystawia tysiące endpointów OData dla typowych operacji (produkty, zamówienia, kontrahenci, ceny). Preferowane od 2019+. Standardowy REST, można konsumować z dowolnego stacka (Magento, Shopware, Node, Java).

IDoc. Klasyczny format wymiany dokumentów SAP, batch-owy. EDIFACT-podobny, ASCII z polami stałej długości. Używany dla zamówień, faktur, dostaw. Wymaga middleware umiejącego go parsować (lub konwertera w SAP PI/PO).

SAP PI/PO (Process Integration / Process Orchestration). SAP-owy ESB. Konwertuje formaty, mapuje pola, routuje wiadomości. Jeśli klient ma PI/PO - wymuszają, żeby integracja szła przez niego (politycznie, bo PI/PO to ich pole odpowiedzialności).

SAP CPI (Cloud Platform Integration). Następca PI/PO w chmurze SAP-owej. Coraz częściej spotykany.

Praktyczna decyzja: dla nowych wdrożeń S/4HANA - OData wprost (lub przez CPI). Dla starszych instalacji - IDoc + PI/PO. Najczęściej dostajesz mix.

API SAP Business One

Service Layer. REST API od B1. Pokrywa większość operacji. Dokumentacja przyzwoita, działa stabilnie.

DI API (Data Interface API). Klasyczne API B1, .NET-owe (COM). Używane historycznie, dziś - Service Layer wszędzie gdzie się da.

Integration Framework (B1if). Wbudowany w B1 mini-ESB. Przydatny dla mniej technicznych klientów, ograniczony.

Integracja sklep ↔ Business One jest dużo prostsza niż S/4HANA. Bliżej do integracji z Comarch XL niż do prawdziwej korporacyjnej.

Architektura wdrożenia

Dla S/4HANA wzorzec sprawdzony:

[Sklep Magento/Shopware]
        |
        | REST (sklep wystawia API)
        v
[Middleware - Symfony / Node.js / Java]
        |
        +--- OData REST do S/4HANA
        +--- IDoc (przez SAP PI/PO lub CPI)
        +--- Redis / RabbitMQ

Dla Business One:

[Sklep]
        |
        v
[Middleware (lżejsze)]
        |
        +--- Service Layer REST do B1
        +--- Redis

W obu przypadkach middleware między sklepem a SAP jest must-have. Bezpośrednie połączenie sklep ↔ SAP widziałem w jednym projekcie. Skutek: każda zmiana w S/4HANA wymagała release sklepu. Skutek skutku: projekt po roku w utrzymaniu kosztował klienta 80 tys. zł miesięcznie.

Co synchronizujemy i jak

Produkty (Material Master):

• S/4HANA → sklep, batch w nocy + delta co 30-60 min
• Pola: SKU, nazwa, opis, jednostka, EAN, klasa towaru
• Atrybuty filtrowalne - często z PIM (Akeneo), nie z SAP

Ceny i cenniki:

• S/4HANA: condition records, definitywnie potężny silnik cenowy
• Sklep wywołuje OData lub funkcję BAPI „daj cenę dla klienta X, produktu Y, ilości Z"
• Cache 5-15 min, klucz (customer_id, sku, qty)

Stany magazynowe:

• S/4HANA: tabela MARD (per material per plant)
• Synchronizacja jak dla XL: delta + pull on-demand
• Realtime dla top-100 produktów (webhook z SAP do middleware)

Zamówienia (Sales Order):

• Sklep → SAP przez IDoc ORDERS05 (klasycznie) lub OData (nowocześnie)
• Idempotencja przez external_reference
• SAP zwraca SalesOrderNumber, sklep zapisuje

Faktury, dostawy:

• SAP → sklep, najczęściej przez IDoc INVOIC02 i DESADV01
• PDF generowany przez SAP-owy adapter (SmartForms, Adobe Forms)

Kontrahenci (Business Partner):

• Master data po stronie SAP
• Sklep konsumuje, nie tworzy (nowych kontrahentów rejestruje się w SAP, w sklepie aktywuje)

SAP Ariba i procurement

Klient korporacyjny często ma własny system zakupowy - najczęściej SAP Ariba (rzadziej Coupa, Jaggaer). Z perspektywy sklepu B2B to oznacza:

• Klient nie wchodzi do twojego sklepu w przeglądarce „normalnie"
• Klient w Aribie klika „przeglądaj katalog dostawcy X" → ląduje w twoim sklepie przez PunchOut (OCI lub cXML)
• Wybiera produkty, klika „transfer to cart" → koszyk wraca jako XML do Ariby
• Klient zatwierdza, Ariba generuje zamówienie i wysyła do twojego sklepu (cXML PurchaseOrder)
• Twój sklep konwertuje to na wewnętrzne zamówienie i wysyła do SAP

To inny przepływ niż klasyczny sklep B2B. PunchOut: OCI i cXML - pełny przewodnik.

W SAP-owych klientach Ariba i PunchOut to częsty wymóg. Pomijając to przy wdrożeniu = wyrzucenie projektu po pół roku.

Najczęstsze problemy

1. Change management. W korporacji SAP-owej każda zmiana w SAP wymaga ticketu, approvalu, testowania w środowisku QA. Naprawienie literówki w polu mapowania = 2 tygodnie. Planowanie sprintu wokół SAP zakłada bufor czasowy.

2. Środowiska deweloperskie. Klient SAP-owy zazwyczaj ma DEV, QA, PROD. Twoje wdrożenie sklepu też musi mieć trzy środowiska podpięte do trzech SAP-ów. Konfiguracja, klucze, certyfikaty mTLS - trzy razy.

3. Mapowanie kontrahentów. W SAP są partnerzy biznesowi z rolami (Sold-To, Ship-To, Bill-To, Payer). Sklep ma „klient" + „adres dostawy". Mapowanie 1:wiele nie jest oczywiste i klient SAP-owy ma na to mocne zdanie.

4. Ceny - kto liczy. SAP ma własny silnik cenowy (pricing procedure z condition types). Próba zreplikowania tego w sklepie skończy się rozjazdem. Zasada: SAP liczy, sklep wyświetla.

5. Polityka korporacyjna. Dostęp do API S/4HANA wymaga zgody działu bezpieczeństwa IT klienta. Audyt, dokumentacja, MFA, IP whitelisting. To zazwyczaj 4-8 tygodni samej biurokracji.

Czas i koszt

Czas:

• Audyt + projekt + uzgodnienia po stronie klienta SAP: 2-3 miesiące
• Wdrożenie integracji: 4-6 miesięcy
• Stabilizacja i hypercare: 2-3 miesiące
• Łącznie: 8-12 miesięcy do pełnej produkcji

Business One - odjmij 30-40%.

Koszt:

• S/4HANA: 200-500 tys. zł wdrożenie po stronie integracji sklep-middleware
• Plus koszty SAP-owe (konsultanci klienta, ewentualne licencje na PI/PO/CPI) - 100-300 tys. zł
• Utrzymanie: 30-60 tys. zł / miesiąc dla średniego projektu

Business One: 80-200 tys. zł wdrożenie, 5-15 tys. zł / miesiąc utrzymanie.

FAQ

Czy mogę zintegrować Magento z SAP bez konsultantów SAP? Nie. Realnie potrzebujesz po stronie klienta osoby która zna ich konkretną konfigurację SAP (mapowania, custom fields, partner roles). Bez tej osoby wymyślasz koło, każde mapowanie odbije się o ścianę.

Czy SAP Business One nadaje się do sklepu hurtowego z 50k SKU? Funkcjonalnie tak, ale przy 50k+ SKU rozważ alternatywy (Comarch XL, S/4HANA jeśli budżet, dedykowany OMS+ERP). B1 ma sufity wydajnościowe.

Czy w SAP-ie mogę trzymać sklep i ERP w jednym DB (HANA)? Technicznie możliwe, biznesowo nie polecam. Sklep ma inny cykl deployment, inne wymagania wydajnościowe, inny stack. Separacja jest tańsza w utrzymaniu.

Czy SAP Hybris / SAP Commerce nadaje się do B2B? Tak, ale to osobna platforma e-commerce (kupisz licencję SAP-owego sklepu). Ma sens głównie dla klientów, którzy już mają SAP w innych obszarach i chcą jednego dostawcę. Większość polskich klientów tym nie zarządza.

Czy IDoc jest jeszcze używany w 2026? Tak, masowo. SAP wciąż go nie deprecjonuje. Dla niektórych przepływów (faktury, awizo dostaw) IDoc jest wręcz wymagany przez procesy księgowe.

Co dalej

• Inne ERP-y polskie: Comarch ERP XL, Subiekt GT, enova365
• PunchOut do Ariby: OCI i cXML
• Architektura integracji: Middleware vs. bezpośrednio
• Platforma sklepu: Magento dla B2B
• Pełny przegląd integracji: pillar /integracje