VulCode

Integracja IdoSell z ERP, magazynem i hurtowniami

IdoSell ma kilka API i webhooki na zamówienia, produkty, zwroty i reklamacje. Łączymy je z Twoim ERP, programem fakturowym i hurtowniami, tak żeby stany, ceny i dokumenty zgadzały się bez ręcznego przepisywania.

Platformy sklepowe
Panel integracji: zamówienie 4812 z IdoSell od webhooka orderPaid przez zamówienie w ERP, stany i fakturę z numerem KSeF do numeru przesyłki, z historią zdarzeń i pozycjami z mapy produktów

Jeden system dla wszystkich sklepów

IdoSell działa w modelu SaaS: każdy sprzedawca ma tę samą wersję, a API różni się tylko adresem panelu i kluczem.

Panel Demo

  • bezpłatny dla developera
  • ten sam przebieg co w sklepie
  • zmiana adresu i klucza

To ułatwia integrację: przebieg sprawdzony na panelu Demo działa w Twoim sklepie po zmianie adresu i klucza.

Aktualizacje

  • poprawki niemal codziennie
  • jedna wersja dla wszystkich
  • najwyżej dwa tygodnie do sklepu

IdoSell wydaje poprawki niemal codziennie i w ciągu najwyżej dwóch tygodni trafiają one do wszystkich sklepów.

IdoSell
SaaS, ta sama wersja u każdego sprzedawcy

Wersje API

  • poboczne zgodne wstecz
  • główna w adresie URL
  • główna przez rok do dwóch lat

Główna wersja API jest dostępna od roku do dwóch lat, więc integrację trzeba przeglądać co najmniej raz w roku.

Dostęp

  • klucz w nagłówku X-API-KEY
  • albo token OAuth 2.0
  • osobny klucz na aplikację

IdoSell zaleca osobny klucz API dla każdej aplikacji, z uprawnieniami tylko do potrzebnych zasobów.

Nie wszystko, co da się zrobić w panelu, ma swoją bramkę w Admin API, dlatego zakres sprawdzamy przed wyceną.

Które API IdoSell do czego

IdoSell dzieli API według zastosowań. Dobór API to pierwsza decyzja w projekcie.

APIDo czego według IdoSellKiedy po nie sięgamy
Adminzarządzanie sklepem i automatyzacja procesówERP, magazyn, faktury, stany i ceny
Marketplacepołączenie sklepu z platformą sprzedażowąkanał sprzedaży, którego IdoSell nie obsługuje
Fulfillmentwysyłki i magazyn zewnętrznyoperator logistyczny albo własny magazyn
Customerhurtownie i dropshippingprodukty i zamówienia u dostawców
Storefrontwłasny front sklepu na danych IdoSellfront, którego nie da się zrobić szablonem
IdoSell ma też API Printer do obsługi wydruków.

Stany do IdoSell, z obsługą częściowych błędów

Bramka products/stocks przyjmuje wiele produktów naraz i może odpowiedzieć 207: część się zapisała, część nie.

Panel integracji: paczka stanów z ERP wysłana do IdoSell bramką products/stocks, odpowiedź 207 Multi-Status, rozmiary zapisane, jeden rozmiar czekający na mapę produktów i jeden produkt zapisany przy ponowieniu

  1. Produkt i rozmiar po id z mapy

    Produkt i rozmiar wskazujemy po identyfikatorze z mapy produktów. API przyjmuje też index, codeExtern i codeProducer.

  2. Pełny stan, operacja set

    set ustawia stan, a add i substract go zmieniają. Ze źródła prawdy wysyłamy pełny stan, więc ponowienie niczego nie zdubluje.

  3. Odpowiedź 207 nie przerywa paczki

    Odpowiedź z błędami części produktów nie przerywa paczki. Nieudane wracają do kolejki z powodem błędu.

    PUT products/stocks
    207 Multi-Status
    zapisanebez ponowienia
    wraca do kolejkiz powodem błęduerror.faultCodeisSizesErrors

Jak łączymy produkty IdoSell z ERP i hurtownią

Bramki produktów przyjmują kilka rodzajów identyfikatora. Wybór klucza decyduje, czy synchronizacja trafi w dobry towar.

  1. IdoSellcodeExternkod systemu zewnętrznegoERP, kartoteka towarusymbol towaru w ERPklucz, gdy kartoteka powstaje w ERP
  2. IdoSellcodeProducerkod producentaHurtownia, plik z produktamiEAN w pliku hurtowniIdoSell zna m.in. GTIN-13 (EAN-13)
  3. IdoSellrozmiarERP, kartoteka towaruwariant albo osobna kartotekakody zewnętrzne i producenta są też na poziomie rozmiaru
  4. IdoSellstock_idmagazynERP, kartoteka towarumagazyn w ERPstan ustawiany osobno dla każdego magazynu
  5. Mapa produktów w integracjiid produktu i rozmiaru: nadaje IdoSell, używamy go przy zapisie

Gdy Twój serwer nie odbierze webhooka

IdoSell ponawia wysyłkę przy braku odpowiedzi, błędzie sieci albo kodzie spoza zakresu 2xx. Wartości są przybliżone.

Panel integracji: ustawienia webhooka IdoSell z adresem, wersją API, tokenem Bearer i nagłówkiem, włączone i pominięte zdarzenia, przerwa w odbiorze z ponowieniami i uzgodnienie przez API
Od pierwszego błędu
  1. błądok. 10 min po błędzie, potem co ok. 10 min przez godzinę
  2. 1 hco ok. godzinę przez kolejne 23 godziny
  3. 24 hkoniec prób dla tego zdarzenia
  4. 48 hpowiadomienie, gdy wszystkie zdarzenia kończą się błędem
  5. 7 dniwebhook wyłączony, zdarzeń z przerwy już nie będzie

  • Tylko potrzebne zdarzenia

    Każdy webhook uruchamia bramkę API i jest liczony do limitów i rozliczeń tak samo jak zwykłe zapytanie. Wybieramy tylko potrzebne zdarzenia.

  • Ponowienia przez dobę

    Przez dobę od pierwszego błędu IdoSell ponawia wysyłkę sam, najpierw co ok. 10 minut, potem co ok. godzinę. Później brakujące zdarzenie trzeba odzyskać przez API.

  • Zadanie uzgadniające

    Dlatego integracja codziennie porównuje zamówienia i stany przez API, zamiast polegać tylko na webhookach.

Od panelu Demo do Twojego sklepu

Kolejność prac przy integracji IdoSell.

lista bramek i zdarzeń

Zakres w API

Sprawdzamy, czy każda czynność z Twojego procesu ma bramkę w Admin API, i wybieramy webhooki.

integracja działająca na Demo
lista bramek i zdarzeń

Panel Demo

Budujemy i testujemy na bezpłatnym panelu Demo, bez dotykania Twojego sklepu.

mapa z listą braków
integracja działająca na Demo
lista bramek i zdarzeń

Mapa produktów

Łączymy produkty i rozmiary IdoSell z kartoteką ERP albo hurtowni po kodzie.

integracja w Twoim sklepie
mapa z listą braków
integracja działająca na Demo
lista bramek i zdarzeń

Produkcja

Zmieniamy adres panelu i klucz. Pierwsze dni śledzimy w dzienniku i w nagraniach żądań.

Najczęstsze pytania o IdoSell

API, webhooki i wdrożenie IdoSell

Czytaj dalej

Inne platformy i systemy, z którymi łączymy sklep.

Masz sklep na IdoSell?

Napisz, co chcesz połączyć: ERP, hurtownię, magazyn albo faktury. Odpowiemy w godzinę z pytaniami i wyceną.