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- 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
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.
- wyeksportowaneZAM-1001 · 4/4 kody ERP → DOK-0001
Identyfikator zewnętrzny i data eksportu zapisane. Ponowne kliknięcie albo cron nie utworzy drugiego dokumentu.
- raport błędówZAM-1002 · 6/7: brak kodu
Eksport nie zgaduje kodów; zamówienie czeka w raporcie, aż ktoś uzupełni mapowanie.
- do ponowieniaZAM-1002 · 7/7 po poprawce
Po uzupełnieniu mapowania eksport idzie ponownie i kończy się dokumentem DOK-0002.
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ówienie | Kody ERP | W 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ówienie | Kody ERP | W 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ówienie | Kody ERP | W 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ówienie | Kody ERP | W 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 |
Plik na szybki start, API z powrotem statusu
W B2B często najlepszym MVP jest stabilny CSV/XLSX zgodny z procesem firmy.
- 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.
- 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ę.
- 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- ZAM-1001 · 4 pozycje, zaakceptowanePartner A → kontrahent K-0187 w ERP; 4 × SKU sklepu → kod towaru w ERP.
- Plik 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.
- DOK-0001 · wyeksportowaneIdentyfikator zewnętrzny i data eksportu zapisane. Ponowne kliknięcie albo cron nie utworzy drugiego dokumentu.
| Kolumna | ZAM-1001 | Co zawiera |
|---|---|---|
| order_id | ZAM-1001 | numer zamówienia w sklepie |
| customer_id | K-0187 | identyfikator kontrahenta |
| tax_id | NIP z konta partnera | NIP kontrahenta |
| sku, ean | 4 pozycje, kod towaru w ERP | kod produktu i EAN pozycji |
| qty, price | cena partnera po rabacie | ilość i cena jednostkowa |
| export_status | wyeksportowane | status eksportu, np. wyeksportowane |
| external_id | DOK-0001 | numer dokumentu w systemie docelowym |
| exported_at | zapisane przy eksporcie | data i godzina eksportu |
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
Najpierw format docelowy, na końcu automatyczna wysyłka
- Format ERP lub plikuWymagane kolumny, separatory, kodowanie, pola klienta, statusy, identyfikatory produktów i obsługa zamówień z wieloma pozycjami.
- Mapowanie danychPola sklepu łączymy z formatem docelowym: order ID, SKU, EAN, wariant, ilość, cena, rabat, NIP, adresy, metoda dostawy i komentarze.
- Testowe zamówieniaZamówienia z realnymi produktami, wieloma wariantami, różnymi klientami, adresami i scenariuszami błędów, zanim eksport dotknie produkcji.
- 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.
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.