Podłączenie do katalogu platformy i przypisanie własnych towarów przez API

#373

Platforma udostępnia własny gotowy katalog — około 100 000 pozycji towarowych od czołowych producentów płyt, obrzeży i okuć. Twoja fabryka podłącza się do katalogu przez API, przypisuje swoje towary do naszych i pracuje z gotową bazą zamiast prowadzić ją od zera.

Co to daje waszej fabryce

  • Gotowa baza ~100 000 pozycji — płyty (wiórowa, MDF, pilśniowa, akryl, szkło), obrzeża (PVC, ABS, melaminowe), okucia od głównych producentów. Aktualizowana centralnie.
  • Nie trzeba wprowadzać ręcznie — większa część asortymentu jest już opisana: wymiary arkusza, grubość, dekor, producent, artykuł, obrazy. Fabryka tylko przypisuje własne ceny i stany.
  • Jednolity słownik dekorów — klient widzi znajome nazwy i kody producenta; łatwo wyszukiwać przez wyszukiwarkę katalogu.
  • Zgodności obrzeża i płyty są już opisane w platformie dla większości kombinacji — nie trzeba konfigurować ręcznie.

Jak fabryka przypisuje swoje towary do katalogu

Po podłączeniu przez API wasz system księgowy widzi nasz katalog. Dla każdego waszego towaru wskazujecie:

  • Odpowiednik naszej pozycji — wasza „Płyta wiórowa Egger H1180" jest przypisywana do naszej karty z tym samym artykułem / dekorem. Mapowanie po artykule, kodzie kreskowym, wewnętrznym ID — wasz wybór.
  • Własne ceny — za m², za arkusz, krój łączony itd. Można ustawić kilka typów ceny dla jednej pozycji (zob. 4 typy sprzedaży).
  • Własne stany — pobierane z waszego systemu księgowego w czasie rzeczywistym. Klient w panelu widzi „dostępny w magazynie" tylko przy faktycznej dostępności.
  • Własne parametry — indywidualne ustawienia materiału: obcięcia, kierunek cięcia, wyłączenia usług, zakaz kroju łączonego — indywidualnie dla waszej pozycji (zob. Indywidualne ustawienia materiału).
  • Własne obrzeże w parze — jeśli tradycyjnie stosujecie określone obrzeże do określonej płyty, powiązanie jest zachowane i proponowane klientowi jako pierwsze.

Jeśli potrzebnej pozycji nie ma w naszym katalogu

Katalog jest duży, ale nie pokrywa wszystkiego (rzadki dekor, lokalny producent, niestandardowy wymiar). W takim przypadku pozycję dodaje się w panelu admina fabryki — sekcja Katalog. Pozycje dodaje się masowym importem towarów z pliku XLSX — ręcznego tworzenia pojedynczej pozycji w panelu admina nie ma.

Obsługiwane systemy

Podłączenie przez API to standardowy mechanizm platformy. Co można podłączyć:

  • Dowolny system z otwartym API (JSON / XML / SOAP) — podłączany zgodnie z dokumentacją platformy, zwykle 1–3 dni pracy.
  • Typowe systemy księgowe i magazynowe — wymiana konfigurowana jest tak samo, osobny konektor nie jest potrzebny.
  • Autorski system ewidencji — platforma nie jest przywiązana do konkretnego programu: wystarczy, aby system potrafił wysyłać żądania HTTP i przetwarzać JSON.

Co potrzebne do podłączenia

Platforma udostępnia fabryce uniwersalne HTTP API. Z punktu widzenia fabryki podłączenie składa się z trzech części:

  • Klucz dostępu do API — wydawany fabryce na żądanie w wsparciu technicznym platformy. Używany do autoryzacji każdego wywołania.
  • Dokumentacja dostępnych metod — lista akcji, które można wywołać (pobranie słowników, wyszukiwanie towarów, odczyt i aktualizacja stanów, praca z zamówieniami, klientami, produkcją). Przekazywana razem z kluczem.
  • Implementacja po stronie fabryki — osobny moduł lub usługa, która z waszego systemu księgowego formuje żądania HTTP do API platformy. Rozwój wykonuje wasz zespół IT lub zewnętrzny wykonawca. Platforma nie jest związana z konkretnym stackiem — pasuje dowolne środowisko obsługujące żądania HTTP i pracę z JSON.

Mapowanie towarów, format cen, częstotliwość synchronizacji, obsługa błędów i polityka retry to fabryka określa sama — to część implementacji handlera po jej stronie. Platforma odpowiada za stabilne API i jego dokumentację.

Żądanie podłączenia składa fabryka przez wsparcie techniczne — po uzgodnieniu formatu pracy zespół platformy udostępnia klucz, dokumentację i pomaga z pilotażowymi żądaniami.

Powiązane tematy