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

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 bywa próbowane i główny koszt jest ukryty: każda zmiana w S/4HANA wymaga wtedy release'u sklepu, więc utrzymanie rośnie z każdym kwartałem.

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.

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

Najczęstsze pytania