Eksport danych z Base.com (BaseLinker): produkty, zamówienia, klienci

Dwie drogi do danych w Base

Base.com (dawniej BaseLinker) udostępnia dane na dwa sposoby. Eksport do pliku uruchamiasz w panelu i dostajesz plik według gotowego albo własnego szablonu. API to interfejs, przez który program pobiera dane partiami, z limitem zapytań na minutę. Do jednorazowej kopii katalogu zwykle wystarczy panel. Do pełnej historii zamówień, regularnej kopii albo przeniesienia danych do innego systemu wygodniejsze jest API.

Obie drogi tylko czytają dane. Eksport ani zapytanie do API niczego w Base nie zmieniają, więc możesz je robić w trakcie normalnej pracy.

Eksport produktów z panelu

W panelu Base wybierz Produkty, Import/Eksport, Eksport. Pomoc Base wymienia formaty CSV, HTML, PDF, TXT i XML oraz gotowe szablony (nazwy skracamy):

• BL Produkty, domyślny CSV: dane produktów bez spisu wariantów i parametrów. Plik otworzysz w Excelu, a po zmianach zaimportujesz z powrotem.
• BL Produkty, domyślny XML: wszystkie dostępne informacje o produktach. Pomoc Base poleca go jako kopię zapasową katalogu.
• BL Produkty, uproszczony CSV: ID, SKU, stan i cena, wygodny do szybkiej zmiany stanów i cen.
• BL Produkty, spis w PDF: wydruk A4 z SKU, EAN, stanem i ceną.
• BL Kategorie i BL Producenci: proste spisy w CSV.

Przed eksportem warto znać kilka ograniczeń:

1. Dziennie zrobisz najwyżej 20 pełnych eksportów katalogu do pliku, a przy dużym katalogu jeden eksport trwa nawet kilka minut.
2. Plik zawiera zdjęcia tylko wtedy, gdy są zapisane jako linki URL na zewnętrznym serwerze. Zdjęcia dodane z dysku sprawdź osobno.
3. Na liście formatów nie ma XLSX. CSV otworzysz w Excelu, a przy otwieraniu wybierz kodowanie UTF-8, żeby polskie litery wyglądały poprawnie.
4. Każdy domyślny szablon zduplikujesz i zmienisz: kolejność kolumn, nazwy pól, dodatkowe informacje. Pomoc Base zaleca zaczynać od kopii istniejącego szablonu.
5. Do eksportu wygenerujesz link przyciskiem „Utwórz link eksportu” i udostępnisz go partnerowi, który potrzebuje Twojej bazy produktów.

Eksport zamówień z panelu

Zamówienia eksportujesz w module Zamówienia, Wydruki i eksporty. Są tam dwie tabele: używane wydruki i eksporty, które wywołasz z listy zamówień, oraz dostępne, które dodajesz przyciskiem „Subskrybuj”. Wśród gotowych pozycji pomoc Base wymienia listę wysyłkową, kartę zamówienia, spis produktów, raport sprzedaży, „Eksport zamówień do CSV” i eksport e-maili kupujących. Wybrane wydruki pojawiają się na liście zamówień pod ikoną drukarki.

Własny format zrobisz przyciskiem „+Nowy wydruk/eksport”, a prościej przez duplikat istniejącego szablonu i zmianę pól. Edytor tworzy pliki CSV, XML, HTML i PDF. Przy długiej historii eksportuj zamówienia partiami, miesiąc po miesiącu, i porównuj liczbę wierszy w pliku z liczbą zamówień w panelu.

Eksport przez API Base

API Base przyjmuje zapytania POST pod adresem https://api.baselinker.com/connector.php. Każde zapytanie ma nazwę metody, parametry w formacie JSON i token w nagłówku X-BLToken. Token wygenerujesz w panelu Base w ustawieniach konta, w zakładce API. Daje on dostęp do całego konta, więc nie wysyłaj go mailem ani komunikatorem. Limit to 100 zapytań na minutę.

Jak pobrać wszystkie zamówienia

Metoda getOrders zwraca najwyżej 100 zamówień naraz. Dokumentacja Base opisuje pobieranie partiami:

1. Ustaw parametr date_confirmed_from na początek okresu i pobierz zamówienia.
2. Jeśli dostałeś 100 zamówień, pobierz kolejną partię od daty potwierdzenia ostatniego zamówienia plus 1 sekunda.
3. Zakończ, gdy partia ma mniej niż 100 zamówień.
4. Zapisz datę ostatniego zamówienia jako punkt startowy następnej kopii.

Domyślnie getOrders pomija zamówienia niepotwierdzone. Dołączysz je parametrem get_unconfirmed_orders, ale dokumentacja ostrzega, że mogą nie mieć jeszcze metody i kosztu dostawy. Prowizje, rabaty i pola dodatkowe zamówień dostaniesz po włączeniu parametrów include_commissions, include_discounts_data i include_custom_extra_fields.

Czas pobrania łatwo oszacować. Przy limicie 100 zapytań na minutę i 100 zamówieniach w odpowiedzi jedna minuta to najwyżej 10 000 zamówień w samych wywołaniach getOrders. Katalog z 20 000 produktami to 20 stron listy, a do tego zapytania o pełne dane produktów.

Klienci: skąd wziąć dane

Dane klientów są w Base w dwóch miejscach. Każde zamówienie z getOrders ma e-mail, telefon, adres dostawy i dane do faktury z NIP. Jeśli korzystasz z modułu klientów, getCrmClients zwraca kartoteki po 100 na stronę, bez notatek i pól dodatkowych, które pobierasz osobno metodą getCrmClientData. W panelu zamówień jest też gotowy eksport e-maili kupujących.

Dwie uwagi praktyczne. Adresy e-mail kupujących z Allegro to adresy zastępcze w domenie allegromail, więc nie zbudujesz z nich listy mailingowej. Plik z danymi klientów to zbiór danych osobowych: trzymaj go w miejscu z kontrolą dostępu, nie wysyłaj mailem i usuń kopie robocze po imporcie.

Czego nie wyeksportujesz

• Akcji automatycznych. Na liście metod API Base nie ma akcji automatycznych, a eksport z panelu ich nie obejmuje. To samo piszemy na stronie Migracja z BaseLinkera: przed migracją spisujemy je z Tobą i odtwarzamy w Integratorze.
• Szablonów e-maili i SMS. API zwraca szablony wydruków, ale nie treści wiadomości do klientów. Skopiuj je ręcznie do dokumentu.
• Dostępów do kanałów i kurierów. Klucze API marketplace'ów, hasła i dane umów kurierskich generujesz od nowa w panelach kanałów i u przewoźników.
• Historii starszej niż okres przechowywania. Cennik Base podaje przechowywanie danych przez 6 miesięcy w planie Freemium i przez 24 miesiące w planie Business (stan na 23.10.2026). Jeśli potrzebujesz starszych zamówień do raportów albo reklamacji, eksportuj je regularnie.

Jest też ograniczenie po stronie importu. API zwraca nazwy i opisy w językach katalogu oraz pola dodatkowe, ale import katalogu do Integratora nie przenosi tłumaczeń ani pól dodatkowych produktów. Ustalamy je z Tobą na wdrożeniu.

Krok po kroku: pełna kopia przed migracją

1. Zrób eksport katalogu szablonem domyślnym XML i zapisz plik poza Base.
2. Zrób eksport produktów do CSV, jeśli chcesz przejrzeć dane w arkuszu.
3. Pobierz spisy kategorii i producentów.
4. Wyeksportuj zamówienia do CSV partiami, za cały okres, który chcesz zachować.
5. Zapisz listę statusów zamówień w kolejności, w jakiej pracuje zespół.
6. Spisz akcje automatyczne: zdarzenie, warunki i akcje każdej z nich.
7. Skopiuj treści szablonów e-maili i SMS.
8. Spisz kanały, kurierów i hurtownie razem z danymi logowania do ich paneli, przechowywanymi poza plikiem eksportu.
9. Porównaj liczby z plików z licznikami w panelu Base.

Lista kontrolna eksportu

Jak eksport łączy się z migracją do Integratora

Do migracji nie musisz niczego eksportować ręcznie. Import do Commerce OS Integrator korzysta z tokenu API z Twojego konta Base i tylko czyta dane: produkty z wariantami, ceny, stany i zdjęcia, a w pełnej migracji także statusy i zamówienia. Katalog łączymy po SKU, a zamówienia po numerze z Base, więc ponowny import aktualizuje dane zamiast tworzyć duplikaty. Własna kopia z panelu przydaje się jako punkt odniesienia przy sprawdzaniu importu na próbce produktów.

Wdrożenie Start za 2 490 zł netto obejmuje przeniesienie produktów z Base, a Wdrożenie Biznes za 5 490 zł netto pełną migrację: produkty, statusy i zamówienia. Abonamenty po przejściu są w cenniku Integratora, a to, po ilu miesiącach zwróci się wdrożenie, pokaże kalkulator zwrotu z migracji. Cały proces opisujemy w artykule Jak przenieść się z BaseLinkera bez przestoju.