Tulinski it

Amazon, eMAG, Temu i BaseLinker połączone z Twoim ERP.

Zamówienia, faktury, raporty VAT i rozliczenia z marketplace'ów trafiają do Twojej bazy i do ERP same – każdej nocy i co kilka minut w ciągu dnia. Księgowość zaczyna dzień od gotowych danych i listy rozbieżności, a nie od pobierania plików z pięciu paneli.

Umów rozmowę
Harmonogram integracji · serwer zadań klienta
BaseLinker → pakownia, SKU, B2Bklasyfikacja paczek, powiązanie SKU, stany do sklepu hurtowego
OK
BaseLinker → baza danychzmiany zamówień z dziennika zdarzeń, z historią
OK
Amazon SP-API → raporty VATtransakcje i faktury z rynków UE, FBA i MFN
OK
Kontrola sprzedaży FBAraport VAT Amazona kontra dokumenty w ERP
OK
Amazon → ERP, poprawki nocneatrybuty, numery KSeF, rejestr VAT
OK
eMAG API → faktury i zamówieniaRumunia, Bułgaria, Węgry
OK
Tak wygląda noc w firmie z wdrożonymi integracjami – każde zadanie monitorowane, każdy błąd zgłaszany mailem.
Co integruję

Platformy i systemy z wdrożeń

Poniżej to, co działa produkcyjnie u klientów – nie lista logotypów. Każda platforma ma swoje limity, formaty i pułapki, a integracja jest dobra dopiero wtedy, gdy je obsługuje.

Amazon SP-APIFBA · MFN

  • raporty VAT i faktur (VIDR) z rynków UE: DE, FR, IT, ES, NL, PL, SE, BE
  • zamówienia, adresy, kanał FBA lub MFN
  • rozliczenia i transakcje z Finances API
  • faktury XML i PDF z Seller Central tam, gdzie API ich nie udostępnia

Amazon → baza → ERP + pliki dla księgowości

eMAG Marketplace APIFBE

  • trzy rynki: Rumunia, Bułgaria, Węgry
  • faktury klienckie, pozycje zamówień, płatności i zwroty
  • faktury eMAG dla sprzedawcy: prowizje, opłaty FBE, vouchery
  • waluty RON, HUF, BGN i EUR – z uwzględnieniem przejścia Bułgarii na euro

eMAG → baza → rozliczenie wypłat + ERP

Temu Open API EU

  • zamówienia, kwoty i zwroty pobierane przyrostowo
  • raporty rozliczeń i płatności
  • podpisywanie zapytań i obsługa limitów platformy
  • szyfrowanie danych kupujących i automatyczne ich usuwanie

Temu → baza → BaseLinker → ERP

BaseLinker API

  • stała kopia zamówień w bazie z historią każdej zmiany
  • automaty uzupełniające pola, statusy i powiązania SKU
  • synchronizacja stanów i cen do sklepu hurtowego (np. IdoSell)
  • dokumenty magazynowe, masowe korekty, eksporty ofert

BaseLinker ↔ baza, sklepy B2B, ERP

Comarch ERP XL XLAPISQL

  • faktury i korekty sprzedaży z Amazona, eMAG i Temu
  • zamówienia i przesunięcia magazynowe z BaseLinkera
  • numery KSeF z raportów Amazona, rejestr VAT, atrybuty
  • praca najpierw na kopii bazy, z dziennikiem zmian

marketplace / BaseLinker → ERP, bez przepisywania

Pozostałe platformy pliki · API

  • zwroty z wielu marketplace'ów (Allegro, Kaufland, Empik, Erli, eBay, AliExpress…) w jednej bazie
  • Subiekt GT i nexo, IdeaERP
  • kursy NBP i EBC, taryfa celna (kody CN)
  • zestawienia od kurierów InPost, DPD, DHL

pliki i API → jedna baza do raportów

Dla księgowości i podatków

Sprzedaż zagraniczna bez ręcznego składania danych

Przy sprzedaży na kilku rynkach UE najwięcej pracy nie jest w zamówieniach, tylko w dokumentach: VAT, OSS, przesunięcia magazynów FBA, Intrastat. Integracje przygotowują te dane same i codziennie je sprawdzają.

  • faktury FBA i MFN w ERP z poprawną klasą: krajowa, WDT lub OSS
  • kursy NBP z dnia poprzedzającego sprzedaż, liczone jak w księgach
  • numery KSeF przypisane do faktur Amazona
  • faktury wewnętrzne WNT/WDT dla przesunięć FBA między krajami
  • dane do Intrastatu PL, CZ i RO oraz do raportu OSS
  • codzienna kontrola: raport VAT Amazona kontra dokumenty w ERP
  • rozliczenie wypłat eMAG: inkaso minus zwroty i opłaty
  • pliki dla biura rachunkowego w formacie, który przyjmuje

Zobacz też: deklaracje INTRASTAT i import faktur Amazon do Subiekta.

Jak to jest zbudowane

Integracje, które nie psują danych

Integracja, która raz na miesiąc zdubluje fakturę albo wyzeruje stany, kosztuje więcej, niż oszczędza. Dlatego każda z nich ma te same zasady.

Limity API obsłużone, nie ignorowane

Amazon pozwala na niektóre zapytania raz na minutę, Temu odrzuca zbyt duże okna czasowe, BaseLinker ma limit na token. Integracja dzieli pracę tak, żeby się w nich zmieścić, i ponawia zapytania po przerwie.

Każdy dokument tylko raz

Zanim cokolwiek powstanie w ERP, integracja sprawdza po numerze faktury z marketplace'u, czy dokument już istnieje – także wśród anulowanych. Powtórzony przebieg niczego nie zdubluje.

Najpierw kopia bazy

Zapis do ERP startuje na kopii bazy. Na produkcję przechodzi po porównaniu wyników i dopiero po świadomej zgodzie.

Zaksięgowane zostaje nietknięte

Dokumentów zaksięgowanych, fiskalnych i wysłanych do KSeF integracja nie zmienia. Każda inna zmiana ma wpis „było / jest”, więc da się ją cofnąć.

Hamulce bezpieczeństwa

Jeśli przebieg miałby nagle wyzerować dużą część oferty albo źródło zwróciło podejrzanie mało danych, integracja zatrzymuje się bez zmian i zgłasza problem.

Monitoring i alarmy

Każde zadanie jest pilnowane. Alarm przychodzi, gdy przebieg się nie uda albo w ogóle się nie odbędzie – także wtedy, gdy skrypt formalnie skończył się „sukcesem”.

Więcej o tym podejściu: 7 zasad niezawodnej automatyzacji.

Przebieg współpracy

Od kont marketplace'ów do działającej integracji

  1. Rozpoznanie

    Na jakich rynkach sprzedajesz, jakie masz ERP i bazę, co dziś księgowość robi ręcznie i gdzie są rozbieżności.

  2. Dostępy i plan

    Pomagam założyć dostępy do API (np. aplikację SP-API z właściwymi rolami) i ustalamy kolejność integracji według zysku.

  3. Pilotaż na kopii

    Pierwsza integracja działa na Twoich prawdziwych danych, ale zapisuje do kopii bazy. Porównujemy wynik z tym, co robicie ręcznie.

  4. Produkcja i opieka

    Harmonogram, monitoring, dokumentacja. Gdy marketplace zmienia API, dostosowuję integrację, zanim przestanie działać.

Część integracji buduję jako workflow w n8n – zobacz automatyzacje n8n. Integracje samego BaseLinkera opisuję na stronie BaseLinker i e-commerce.

Najczęstsze pytania

Czy do integracji z Amazonem potrzebuję konta deweloperskiego SP-API?

Tak. Aplikację rejestruje się w Seller Central na koncie sprzedawcy, a dostęp do części danych wymaga osobnych ról, na przykład do raportów podatkowych lub danych FBA. Pomagam przejść rejestrację i dobrać role do tego, co ma robić integracja.

Z jakim ERP łączysz marketplace'y?

Najwięcej wdrożeń dotyczy Comarch ERP XL przez XLAPI: faktury, korekty, zamówienia i przesunięcia magazynowe. Robię też import do Subiekta GT i nexo oraz zapis do baz MSSQL, MySQL i PostgreSQL, z których korzystają raporty i inne systemy.

Co z danymi osobowymi kupujących?

Pobieram tylko to, co jest potrzebne do faktury i wysyłki. Dane osobowe mogą być szyfrowane w bazie i automatycznie usuwane po ustalonym czasie. Klucze i hasła są w osobnej konfiguracji, nigdy w kodzie ani w raportach.

Co się dzieje, gdy marketplace zmieni API albo integracja się zatrzyma?

Każde zadanie jest monitorowane. Gdy przebieg się nie uda albo nie odbędzie, przychodzi alarm. W ramach opieki śledzę zmiany w API Amazona, eMAG, Temu i BaseLinkera i dostosowuję integracje, zanim przestaną działać.

Czy integracja może coś zepsuć w ERP?

Każda integracja zapisująca do ERP najpierw działa na kopii bazy. Na produkcję przechodzi dopiero po porównaniu wyników. Dokumentów zaksięgowanych i wysłanych do KSeF nie zmienia, a każda zmiana zostawia wpis, który pozwala ją cofnąć.

Obsługujesz Kaufland, Empik, Erli i inne platformy?

Tak, w zakresie, na jaki pozwala dana platforma: przez API, przez BaseLinkera albo przez automatyczny import plików, na przykład zwrotów z kilku marketplace'ów do jednej bazy. Na rozpoznaniu sprawdzam, która droga jest najpewniejsza.

Sprzedajesz na kilku marketplace'ach?

Opowiedz, jak dziś dane trafiają do ERP i księgowości. Powiem, co da się zautomatyzować i od czego zacząć.