VulCode

Integracja BaseLinker przez API

BaseLinker zbiera zamówienia z marketplace'ów i sklepów. Gdy Twój sklep, panel albo ERP nie ma z nim gotowego połączenia, piszemy je przez API BaseLinkera, w jego limitach i z kontrolą każdego zamówienia.

Sprzedaż wielokanałowa
Panel sklepu, integracja z BaseLinkerem: zapytania na minutę z ostatnich 30 minut pod limitem 100, ostatnie 60 sekund na limicie, kolejka zadań ze stanami z dokumentu PZ w trzech paczkach i procesy na wspólnym liczniku

Gotowe połączenie czy własna integracja

BaseLinker ma setki gotowych połączeń. Najpierw sprawdzamy, czy Twój przypadek już tam jest.

Wystarczą gotowe połączenia

  • Sklep działa na popularnej platformie, z którą BaseLinker łączy się sam.
  • ERP to Subiekt GT albo nexo, dla których jest bezpłatny integrator.
  • Przepływ jest standardowy: zamówienie, etykieta, dokument.
Wniosek: Konfigurujemy gotowe połączenie w panelu BaseLinkera, bez kodu, którego nie potrzebujesz.

Potrzebna własna integracja

  • Sklep, panel albo system magazynowy są napisane na zamówienie.
  • Faktura powstaje w ERP i ma zastąpić fakturę z BaseLinkera przy zamówieniu.
  • Statusy, pola dodatkowe albo reguły wychodzą poza możliwości gotowego połączenia.
Wniosek: Piszemy integrację po stronie Twojego systemu, z kolejką, która zawsze mieści się w limicie BaseLinkera.

Liczby, które wyznaczają projekt

API BaseLinkera ma proste zasady i twarde limity. Projektujemy integrację pod nie od początku.

Cała integracja mieści się w 100 zapytań na minutę1, także przy kilku sklepach.

Jedno pobranie zamówień oddaje do 100 zamówień2, a stany i ceny idą paczkami do 1000 produktów3.

Dziennik zdarzeń pamięta 3 dni4, więc dłuższa przerwa wraca do pobierania po dacie.

  1. 100 zapytań na minutę

    Wszystkie zadania idą przez jedną kolejkę z licznikiem, także przy kilku sklepach.

  2. 100 zamówień

    Stronicujemy po dacie potwierdzenia, przesuniętej o sekundę.

  3. 1000 produktów

    Zmiany zbieramy w paczki, zamiast wysyłać każdą osobno.

  4. 3 dni

    Dłuższa przerwa wymaga pobrania zamówień po dacie, więc oba sposoby są w kodzie.

Pobieranie nowych zamówień w limicie

Pobieramy tylko zamówienia potwierdzone, od ostatniej daty potwierdzenia plus sekunda, tak jak zaleca dokumentacja. Na ekranie pierwszy import z tygodnia i kilka minut dziennika zdarzeń.

Zamówienia z BaseLinkera w panelu sklepu: dziennik zdarzeń włączony, kursor daty potwierdzenia, niepotwierdzone pominięte, pierwszy import w pięciu paczkach po 100 zamówień z ostatnią 47 i dziennik zdarzeń czytany co 10 sekund
  • Pobieranie od daty potwierdzenia

    Zamówienie nie może pojawić się z wcześniejszą datą potwierdzenia, więc pobieranie od ostatniej zapisanej daty gwarantuje, że nic nie zginie.

  • Paczki po 100 zamówień

    Paczka mniejsza niż 100 zamówień oznacza, że nie ma już nic do pobrania.

  • Dziennik zdarzeń włączony

    Bez włączenia w ustawieniach API dziennik zwraca puste odpowiedzi, a integracja wygląda na zepsutą.

BaseLinker, Apilo czy Sellasist

Trzy systemy do sprzedaży wielokanałowej. Porównujemy je od strony integracji, nie cennika.

BaseLinkerjedno wejście dla wszystkich danychApiloosobne wejście dla każdego rodzaju danychSellasistosobne wejścia pod adresem Twojego konta
Stały klucz dostępu z paneluTakNieTak
Limit zapytań na minutę w dokumentacjiTakTakZ zastrzeżeniem
Zmiany zamówień czytane z dziennikaZ zastrzeżeniemNieTak
Statusy z listy konta, nie wpisane na sztywnoTakTakTak
Faktura z programu księgowego przy zamówieniuTakTakTak
  1. Stały klucz dostępu z panelu (BaseLinker): klucz z ustawień konta BaseLinkera
  2. Stały klucz dostępu z panelu (Apilo): dostęp przez logowanie w Apilo, odnawiany automatycznie
  3. Stały klucz dostępu z panelu (Sellasist): klucz z zakładki Integracje, Klucze API
  4. Limit zapytań na minutę w dokumentacji (BaseLinker): 100 na minutę
  5. Limit zapytań na minutę w dokumentacji (Apilo): 150 na minutę
  6. Limit zapytań na minutę w dokumentacji (Sellasist): według dokumentacji konta
  7. Zmiany zamówień czytane z dziennika (BaseLinker): zdarzenia z ostatnich 3 dni, po włączeniu w ustawieniach API
  8. Zmiany zamówień czytane z dziennika (Apilo): zmiany pobierane filtrem daty z listy zamówień
  9. Zmiany zamówień czytane z dziennika (Sellasist): historia zmian z tagiem operacji przy każdym wpisie
  10. Faktura z programu księgowego przy zamówieniu (BaseLinker): plik faktury z ERP zamiast faktury z BaseLinkera
  11. Faktura z programu księgowego przy zamówieniu (Apilo): dokument zewnętrzny podpięty w dokumentach sprzedaży
  12. Faktura z programu księgowego przy zamówieniu (Sellasist): wystawiona w Sellasist albo w podpiętym programie
Od strony integracjiTakZ zastrzeżeniemNie
Wybór systemu wielokanałowego to decyzja handlowa. Pomagamy ją podjąć, pokazując, co każdy z nich oznacza dla Twojej sprzedaży i integracji. Integrujemy wszystkie trzy, a szczegóły są na stronach Apilo i Sellasist.

Zamówienie ze sklepu jako zamówienie w BaseLinkerze

Tak przekazujemy zamówienie ze sklepu do BaseLinkera: każde pole trafia na swoje miejsce według reguły ustalonej z Tobą. Na ekranie zamówienie po przekazaniu do BaseLinkera i jego historia.

Zamówienie w panelu sklepu po przekazaniu do BaseLinkera: pola wysłane metodą addOrder z wartościami, numer nadany przez BaseLinkera, faktura z ERP z numerem KSeF, która zastępuje fakturę z BaseLinkera, i historia zamówienia od złożenia do nadania przesyłki

Twój sklepBaseLinker

  • Numer i status

    • numer zamówieniaidentyfikator zewnętrzny

      żeby nie dodać zamówienia dwa razy

    • status w sklepiestatus z listy BaseLinkera

      mapa statusów ustalona z Tobą

  • Koszyk, dostawa i płatność

    • pozycje koszykaprodukty zamówienia

      po SKU albo EAN

    • dostawa i punkt odbiorumetoda i adres dostawy

      punkt odbioru jako osobne pole

    • płatnośćzapłacono i metoda płatności

      kwota opłacona, nie tylko zamówiona

    • pola własnepola dodatkowe zamówienia

      np. numer zamówienia B2B klienta

  • Faktura z ERP

    • Faktury z ERPplik faktury przy zamówieniu

      wystawienie w ERP: plik dołączony do zamówienia zamiast faktury z BaseLinkera

Najczęstsze pytania o integrację z BaseLinkerem

Odpowiedzi o gotowych połączeniach, stanach, fakturach z ERP i wycenie.

Gdzie dziś trafiają Twoje zamówienia?

Napisz, jaki masz sklep albo system i co ma trafiać do BaseLinkera. Odpowiemy w godzinę z wyceną.