VulCode

Integracja Sellasist z marketplace'ami i ERP

Sellasist ma gotowe połączenia z Allegro, Amazonem, Temu, Erli, sklepami i programami księgowymi. Twój system łączymy z nim przez REST API, gdy żadne z gotowych połączeń go nie obejmuje.

Sprzedaż wielokanałowa
Panel sklepu, historia zmian zamówień z Sellasist: odczyt od kursora date_from, 12 wpisów historii, 7 zamówień pobranych po jednym razie i zapisanych bez duplikatów, nowy kursor po zapisie i lista odświeżonych zamówień z tagami operacji

Co Sellasist łączy sam

Według producenta. Te połączenia konfiguruje się w panelu, bez pisania kodu.

  1. Sellasist

    Konfiguracja gotowych połączeń. Możemy pomóc ją ustawić.

    • Zamówienia
    • Magazyn
    • Faktury
    • Wysyłka

  2. Marketplace'y

  3. Sklepy i programy

  4. Poza gotowymi połączeniami

    Twój system: przez REST API, gdy nie ma go na liście

    • Sklep albo system jest napisany na zamówienie.
    • Dane mają trafić do panelu klienta albo hurtowni.
    • Potrzebujesz reguł, których panel nie ustawi.

Zmiany od ostatniego razu

W specyfikacji API nie ma webhooków, więc zmiany odczytujemy z historii. Rysunek pokazuje jeden taki odczyt z wartościami z przykładowego ekranu.

Kursor przed odczytem
date_from2026-10-08 09:39:57
odczyt o 09:42:00
12 wpisów historiiGET /orders_logs
7 zamówień, każde pobrane i zapisane razGET /orders/{id}
  • 512312 wpisy
    • 09:40:02order_create
    • 09:40:02order_status_change

    #20531 założone w sklepie, status Nowe

  • 512072 wpisy
    • 09:40:19order_edit
    • 09:40:19order_edit

    #20507 nowy adres i pozycje po połączeniu z #20509

  • 512192 wpisy
    • 09:40:44order_status_change
    • 09:41:48order_edit

    #20519 status W realizacji, poprawiony telefon

  • 512091 wpis
    • 09:41:03order_merge

    #20509 połączone z #20507, zamknięte z odnośnikiem

  • 511982 wpisy
    • 09:41:10invoice_create
    • 09:41:10order_status_change

    #20498 faktura w panelu klienta, status Wysłane

  • 512322 wpisy
    • 09:41:27order_create
    • 09:41:27order_status_change

    #20532 założone w sklepie, status Nowe

  • 512261 wpis
    • 09:41:40receipt_create

    #20526 paragon dołączony do zamówienia

Kursor po zapisie
2026-10-08 09:41:48
następny odczyt o 09:44:00

  1. Adres konta i klucz

    Każde konto ma własny adres API, a klucz idzie w nagłówku apiKey.

  2. Wiele zmian, jedno pobranie

    Kilka zmian jednego zamówienia daje jedno pobranie. Zapis jest idempotentny.

  3. Kursor po zapisie

    Kursor przesuwamy po zapisie, żeby przerwa niczego nie zgubiła.

Co mówi historia zmian zamówień

Każdy wpis ma tag operacji. Po nim integracja wie, co zrobić, bez zgadywania. Na ekranie dwa zamówienia tego samego kupującego połączone w Sellasist.

Zamówienie w panelu sklepu po połączeniu w Sellasist: dwa zamówienia tego samego kupującego, zamówienie po połączeniu z jedną wysyłką i obiema wpłatami, historia obu z Sellasist z tagami operacji i wyjaśnienie, dlaczego połączone zamówienie nie znika

  1. Połączenie zamówień

    Połączenie zamówień. Powiązany identyfikator wskazuje, co z czym połączono.

    order_merge

  2. Zmiana danych zamówienia

    Zmiana danych zamówienia, np. adresu. Aktualizujemy tylko to, co się zmieniło.

    order_edit

  3. Zamknięte, nie skasowane

    Zamówienie połączone albo usunięte w Sellasist zamykamy u Ciebie zamiast kasować historię. Zostaje jego wpłata i wpisy, z których wiadomo, co się stało.

    order_delete

Co płynie w którą stronę

Sellasist trzyma kanały sprzedaży, Twój system to, czego Sellasist nie widzi.

Skąd przychodzą zmiany
Historia zmian

W specyfikacji API nie ma webhooków, więc to, co zmieniło się w Sellasist, odczytujemy z historii w stałym odstępie.

  • Zamówienia z marketplace'ów
    /orders

    Nowe zamówienie z Allegro, Amazonu czy Temu, gdy w historii zmian pojawi się wpis.

  • Stany
    /products_stock

    Po sprzedaży albo dostawie, w obie strony.

    W obie strony: zgodnie z ustalonym źródłem prawdy

  • Faktury
    /invoices

    Faktura wystawiona w Sellasist albo w programie trafia do zamówienia i panelu klienta.

  • Przesyłki
    /ordersshipments

    Przesyłka przypisana do zamówienia po nadaniu paczki.

Co płynie w drugą stronę i czego pilnujemy

Zamówienia ze sklepu na zamówienie

Płyną odwrotnie: Twój system zapisuje je w Sellasist po przyjęciu albo opłaceniu.

Słowniki statusów i źródeł

Statusy i źródła zamówień są różne na każdym koncie. Integracja pobiera je z API, zamiast wpisywać na sztywno.

Osobny klucz API dla integracji

Własny klucz pozwala go wyłączyć bez zatrzymywania innych integracji konta.

Gdy stany się rozjeżdżają

Gdy stan zmienia się po obu stronach, decyduje ustalone źródło prawdy. Na ekranie i pod nim jedna taka rozbieżność, krok po kroku.

Stany w Sellasist w panelu sklepu: źródło prawdy to magazyn sklepu, reguła przy rozbieżności, wysyłka stanów w paczkach i cztery rozbieżności z dnia ze zmianą w Sellasist, stanem magazynu i wysłanym stanem

  1. Zmiana w Sellasist

    z 4 na 5 szt.
    ręcznie w panelu, 09:41

    Zmianę widać w historii zmian produktów, którą odczytujemy jak zamówienia.

  2. Magazyn sklepu

    3 szt.
    po sprzedaży #20531, 09:40

    Magazyn sklepu zmienia sprzedaż albo dostawa, tu sprzedaż z marketplace'u.

  3. Reguła

    wygrywa magazyn sklepu

    Gdy stany zmienia i Sellasist, i Twój system, ustalamy, który wygrywa przy konflikcie.

  4. Wysłany stan

    3 szt.
    09:42:00

    Sellasist dostaje stan magazynu w paczce zmian stanów.

Najczęstsze pytania o Sellasist

Odpowiedzi o marketplace'ach, czasie odczytu, wyborze systemu i wycenie.

Czytaj dalej

Kanały i systemy obok Sellasist.

Gdzie sprzedajesz przez Sellasist?

Napisz, jakie kanały masz w Sellasist i jaki system ma się z nim łączyć. Odpowiemy w godzinę z pytaniami i wyceną.