Przejdź do treści

Eksport zamówień B2B do ERP bez ręcznego przepisywania

Zamówienie partnera samo trafia do ERP, BaseLinkera, pliku CSV/XLSX albo API, w formacie, który przyjmuje Twój system. Handlowiec nie przepisuje pozycji, brakujący kod trafia do raportu, a ponowny eksport nie tworzy drugiego dokumentu.

RealizacjaZamówienia partnerów same trafiają do BaseLinkera, 936 testów przed wdrożeniemSportina B2B · Magento
Zamówienie ZAM-1001 i pola jego eksportu przykład · dane demonstracyjne
  • order_id, status ZAM-1001 · 4 pozycje, zaakceptowane eksportujemy tylko wybrane statusy, np. zaakceptowane przez handlowca do eksportu
  • customer_id, tax_id Partner A → kontrahent K-0187 w ERP identyfikator kontrahenta i NIP z konta partnera zmapowane
  • sku, qty, price 4 × SKU sklepu → kod towaru w ERP ilość i cena partnera po rabacie; brak kodu ERP trafia do raportu błędów zmapowane
  • eksport pliku Wiersze w CSV/XLSX do importu w ERP szybki start: sklep zapisuje datę eksportu, ERP importuje plik sklep → ERP
  • synchronizacja statusów ERP zwraca external_id i status realizacji przez API: partner widzi w sklepie, co dzieje się z zamówieniem ERP → sklep
Przykładowe zamówienie i kody, nie dane klienta.

Trzy zamówienia w drodze do ERP: mapowanie, eksport, status

Eksport nie może działać „na ślepo”. Zamówienie bez kodu ERP trafia do raportu błędów, wersja robocza nie wychodzi wcale, a zapisany identyfikator z systemu docelowego blokuje drugi dokument.

  1. wyeksportowaneZAM-1001 · 4/4 kody ERP → DOK-0001

    Identyfikator zewnętrzny i data eksportu zapisane. Ponowne kliknięcie albo cron nie utworzy drugiego dokumentu.

  2. raport błędówZAM-1002 · 6/7: brak kodu

    Eksport nie zgaduje kodów; zamówienie czeka w raporcie, aż ktoś uzupełni mapowanie.

  3. do ponowieniaZAM-1002 · 7/7 po poprawce

    Po uzupełnieniu mapowania eksport idzie ponownie i kończy się dokumentem DOK-0002.

Zamówienie B2B → mapowanie → eksport → status i log demo · dane przykładowe

W sklepie są trzy zamówienia: pozycje, SKU, EAN, ilości, ceny, rabaty, dane kontrahenta i NIP. Eksportujemy tylko wybrane statusy, np. nowe lub zaakceptowane przez handlowca.

ZamówienieKody ERPW ERP Stan
ZAM-1001 · 4 poz. — — nowe
ZAM-1002 · 7 poz. — — nowe
ZAM-1003 · 2 poz. — — wersja robocza

Pola sklepu mapujemy na format ERP, pliku CSV/XLSX albo API: SKU sklepu na kod ERP, kontrahent na jego identyfikator. Eksport nie zgaduje kodów; brak mapowania trafia do raportu błędów.

ZamówienieKody ERPW ERP Stan
ZAM-1001 · 4 poz. 4/4 — gotowe
ZAM-1002 · 7 poz. 6/7: brak kodu — raport błędów
ZAM-1003 · 2 poz. — — robocza: pominięta

Eksport do ERP, BaseLinkera, pliku albo własnego endpointu idzie kolejką. Zamówienie z błędem czeka w raporcie, aż ktoś uzupełni mapowanie.

ZamówienieKody ERPW ERP Stan
ZAM-1001 · 4 poz. 4/4 wysłane w kolejce
ZAM-1002 · 7 poz. 7/7 po poprawce — do ponowienia
ZAM-1003 · 2 poz. — — robocza: pominięta

Status zmienia się z „nowe” na „wyeksportowane”, a identyfikator zewnętrzny i data eksportu zostają zapisane. Ponowne kliknięcie albo cron nie utworzy drugiego dokumentu.

ZamówienieKody ERPW ERP Stan
ZAM-1001 · 4 poz. 4/4 DOK-0001 wyeksportowane
ZAM-1002 · 7 poz. 7/7 po poprawce DOK-0002 wyeksportowane
ZAM-1003 · 2 poz. — — robocza: pominięta
Demonstracja na danych przykładowych: numery zamówień i dokumentów są wymyślone, bez danych klienta.

Plik na szybki start, API z powrotem statusu

W B2B często najlepszym MVP jest stabilny CSV/XLSX zgodny z procesem firmy.

Plik CSV/XLSXsklep → ERP
  • Kiedy: Dobry jako szybki start, gdy ERP importuje pliki lub handlowiec potrzebuje kontrolowanego arkusza.
  • Kierunek: Sklep → ERP. Sklep zapisuje datę eksportu, a dalszą obsługę prowadzi ERP.
APIsklep ⇄ ERP
  • Kiedy: Sprawdza się, gdy wolumen rośnie, zamówienia muszą trafiać do ERP automatycznie, a statusy powinny wracać do sklepu.
  • Kierunek: Sklep → ERP i ERP → sklep: ERP zwraca external_id i status realizacji, więc partner widzi postęp zamówienia w sklepie.
  • Wymaga: REST API, tokeny, status odpowiedzi, retry, timeouty, klucz idempotencji (numer zamówienia, po którym ERP rozpozna ponowienie, gdy przyjął zamówienie, a odpowiedź nie dotarła do sklepu) i log techniczny odróżniający błąd ERP od błędu sklepu.
  • BaseLinker może działać jako pośrednik, jeśli firma już obsługuje tam zamówienia i magazyny,
  • przy każdym wariancie potrzebne są logi, statusy i zasady ponowienia błędnego eksportu,
  • format eksportu powinien być testowany na realnych produktach, wariantach i danych kontrahenta.

Eksport staje się pilny, gdy B2B generuje realny wolumen

Na początku zamówienia można obsłużyć ręcznie. Problem pojawia się, gdy partnerzy składają większe koszyki, handlowcy przepisują pozycje do ERP, a jeden błąd w SKU, EAN albo adresie blokuje realizację.

Sześć sygnałów, że eksport jest pilny
  • zamówienia z platformy są ręcznie przepisywane do ERP lub arkusza,
  • brakuje stałego formatu dla SKU, EAN, ilości, cen, rabatów i adresów,
  • nie wiadomo, które zamówienie zostało już wyeksportowane, a które wymaga poprawki,
  • statusy w sklepie nie odpowiadają etapom obsługi po stronie firmy,
  • ERP wymaga kodów produktów, kontrahentów lub magazynów innych niż sklep,
  • eksport pliku działa ręcznie, ale brakuje logów, walidacji i ponowienia błędnych pozycji.

Co zawiera rekord eksportu zamówienia B2B

Format wynika z procesu po stronie firmy. Inaczej przygotowujemy plik CSV dla handlowca, inaczej integrację API z ERP, a jeszcze inaczej przekazanie zamówienia do BaseLinkera. Cel: ERP przez jego import plikowy lub API, BaseLinker, plik CSV/XLSX albo własny endpoint API.

Jeden rekord od eksportu do wyniku w ERP: ZAM-1001

dane przykładowe
  1. sklepZAM-1001 · 4 pozycje, zaakceptowanePartner A → kontrahent K-0187 w ERP; 4 × SKU sklepu → kod towaru w ERP.
  2. eksportPlik albo API, kolejkąWiersze w CSV/XLSX do importu w ERP albo wysyłka przez API; brak kodu ERP trafia do raportu błędów.
  3. ERPDOK-0001 · wyeksportowaneIdentyfikator zewnętrzny i data eksportu zapisane. Ponowne kliknięcie albo cron nie utworzy drugiego dokumentu.
eksport-zamowien.csv · ZAM-1001dane przykładowe
KolumnaZAM-1001Co zawiera
order_idZAM-1001numer zamówienia w sklepie
customer_idK-0187identyfikator kontrahenta
tax_idNIP z konta partneraNIP kontrahenta
sku, ean4 pozycje, kod towaru w ERPkod produktu i EAN pozycji
qty, pricecena partnera po rabacieilość i cena jednostkowa
export_statuswyeksportowanestatus eksportu, np. wyeksportowane
external_idDOK-0001numer dokumentu w systemie docelowym
exported_atzapisane przy eksporciedata i godzina eksportu
Przykładowy układ rekordu eksportu, bez danych klienta. Ostateczne kolumny wynikają z formatu ERP; po zapisaniu external_id ponowny eksport tego zamówienia jest blokowany.

Pełny opis rekordu: pola, format pliku i zachowanie przy błędzie

dane zamówienia, pozycje i warianty, dane kontrahenta, format pliku, statusy, logi i duplikaty
Dane zamówieniaNumer zamówienia, data, status, źródło, waluta, komentarz klienta, metoda dostawy, wartość netto/brutto, koszt dostawy i informacja, czy zamówienie było już eksportowane.
Pozycje i wariantySKU, EAN/GTIN, nazwa, wariant, rozmiar, kolor, ilość, cena jednostkowa, rabat, VAT, magazyn, identyfikator produktu i ewentualny kod wymagany przez ERP, aby system docelowy poprawnie utworzył dokument.
Dane kontrahentaFirma, NIP, adres faktury, adres dostawy, kraj, uwagi, osoba kontaktowa, e-mail, telefon, grupa klienta i identyfikator kontrahenta w systemie docelowym.
Format plikuCSV, XLSX lub XML z ustalonym separatorem, kodowaniem, kolejnością kolumn, nazwami pól i obsługą znaków specjalnych w nazwach produktów oraz adresach.
Statusy, logi i duplikatyStatusy, timestampy, identyfikator eksportu, raport błędów. Po udanym eksporcie zapisujemy identyfikator systemu zewnętrznego i status, aby ponowne kliknięcie lub cron nie utworzył drugiego zamówienia.

Case study Sportina B2B

Najpierw format docelowy, na końcu automatyczna wysyłka

  1. Format ERP lub plikuWymagane kolumny, separatory, kodowanie, pola klienta, statusy, identyfikatory produktów i obsługa zamówień z wieloma pozycjami.
  2. Mapowanie danychPola sklepu łączymy z formatem docelowym: order ID, SKU, EAN, wariant, ilość, cena, rabat, NIP, adresy, metoda dostawy i komentarze.
  3. Testowe zamówieniaZamówienia z realnymi produktami, wieloma wariantami, różnymi klientami, adresami i scenariuszami błędów, zanim eksport dotknie produkcji.
  4. Logi i automatyzacjaStatus eksportu, raport błędów, blokada duplikatów i ponowienie; wysyłka ręczna albo cykliczna przez cron, API lub panel administratora.
BaseLinker przyjmuje ok. 100 zapytań na minutę, dlatego wysyłka idzie kolejką, także przy eksporcie uruchomionym ręcznie z panelu. Co robić, gdy limit dzielony z ERP kończy się blokadą tokenu, opisuje poradnik o ERROR_BLOCKED_TOKEN.

Eksport zamówień — pytania

Nie ma tu Twojego pytania? Napisz

Nie. MVP często zaczyna się od CSV lub XLSX, bo szybciej da się dopasować format do pracy handlowców i ERP. API ma sens przy większej skali, potrzebie automatycznego tworzenia zamówień i dwukierunkowej synchronizacji statusów.
Tak. To podstawowy warunek kontroli procesu. Można eksportować tylko zamówienia nowe, opłacone, zaakceptowane przez handlowca albo oznaczone konkretnym statusem. Dzięki temu wersje robocze i błędne zamówienia nie trafiają do ERP.
Po udanym eksporcie zapisujemy status, datę i identyfikator z systemu docelowego. Kolejna próba eksportu powinna zostać zablokowana albo wymagać świadomego ponowienia. Zapisany identyfikator blokuje ponowne wysłanie po stronie sklepu. Gdy ERP przyjął zamówienie, a odpowiedź nie dotarła, sklep nie ma identyfikatora; wtedy drugi dokument blokuje dopiero odbiorca, który rozpoznaje numer zamówienia jako klucz idempotencji. Do tego log odpowiedzi z ERP.
Tak, jeśli te dane znajdują się w zamówieniu lub profilu klienta i są potrzebne w ERP. W B2B zwykle eksportujemy firmę, NIP, adres faktury, adres dostawy, e-mail, telefon, osobę kontaktową i grupę klienta.
Trzeba przygotować mapowanie identyfikatorów: SKU sklepu, EAN, kod ERP, wariant i ewentualnie magazyn. Eksport nie powinien zgadywać kodów w locie. Brak mapowania musi trafić do raportu błędów, a nie do cichego pominięcia pozycji.
Może, jeśli firma już obsługuje tam zamówienia, statusy lub logistykę. Wtedy sklep wysyła zamówienie do BaseLinkera, a dalszy proces może odbywać się przez istniejący integrator. Tak działa platforma Sportina B2B, którą rozwijamy na Magento 2.4.8: bieżące zamówienia idą do BaseLinkera, a produkty, ceny i stany (własny i dostawcy) przychodzą z BaseLinkera. Trzeba pilnować mapowania produktów, statusów i ochrony przed duplikacją.
Tworzymy testowe zamówienia z różnymi klientami, wariantami, ilościami, adresami, rabatami i brakującymi polami. Następnie porównujemy plik lub payload API z wymaganiami ERP i sprawdzamy, czy błędy są logowane, a statusy zmieniają się poprawnie.

Chcesz przestać przepisywać zamówienia B2B ręcznie?

Opisz, gdzie dziś trafiają zamówienia, jakiego formatu wymaga ERP i jakie pola są obowiązkowe. Przygotujemy eksport CSV/XLSX/API z dopasowaniem pól do ERP i ochroną przed podwójnym dokumentem.