Pripojenie ku katalógu platformy a naviazanie vlastných tovarov cez API

#373

Platforma poskytuje vlastný hotový katalóg — približne 100 000 tovarových položiek od popredných výrobcov dosiek, hrán a kovaní. Vaša fabrika sa pripája ku katalógu cez API, viaže k nemu vlastné tovary a pracuje s hotovou bázou namiesto toho, aby ju viedla od nuly.

Čo to dáva vašej fabrike

  • Hotová báza ~100 000 položiek — dosky (DTD, MDF, drevovláknitá, akryl, sklo), hrany (PVC, ABS, melamín), kovanie od hlavných výrobcov. Aktualizovaná centrálne.
  • Netreba zadávať ručne — väčšia časť sortimentu je už opísaná: rozmery dosky, hrúbka, dekor, výrobca, kód, obrázky. Fabrika len viaže vlastné ceny a sklady.
  • Jednotný slovník dekorov — klient vidí známe názvy a kódy výrobcu; ľahko sa hľadá vyhľadávaním v katalógu.
  • Kompatibility hrana-doska sú v platforme už opísané pre väčšinu kombinácií — netreba ich nastavovať ručne.

Ako fabrika viaže svoje tovary ku katalógu

Po pripojení cez API vidí váš účtovný systém náš katalóg. Pre každý váš tovar uvádzate:

  • Zhodu s našou položkou — vaše „DTD Egger H1180" sa viaže na našu kartu s rovnakým kódom / dekorom. Mapovanie podľa kódu, čiarového kódu, interného ID — podľa vašej voľby.
  • Vlastné ceny — za m², za dosku, kombinovaný rez atď. Pre jednu položku možno nastaviť viacero typov cien (pozri 4 typy predaja).
  • Vlastné zostatky — preberajú sa z vášho účtovného systému v reálnom čase. Klient v paneli vidí „je na sklade" iba pri skutočnej dostupnosti.
  • Vlastné parametre — individuálne nastavenia materiálu: orezy, smer rezu, vypnutia služieb, zákaz kombinovaného rezu — individuálne pre vašu položku (pozri Individuálne nastavenia materiálu).
  • Vlastná hrana v páre — ak tradične dávate určitú hranu k určitej doske, väzba sa zachová a klientovi sa ponúkne ako prvá.

Ak požadovaná položka v našom katalógu nie je

Katalóg je veľký, ale nepokrýva všetko (vzácny dekor, lokálny výrobca, neštandardný rozmer). V takom prípade sa položka pridá v admin paneli fabriky — sekcia Katalóg. Položky sa pridávajú hromadným importom tovarov z XLSX súboru — ručné vytvorenie samostatnej položky v admin paneli neexistuje.

Podporované systémy

Pripojenie cez API je štandardný mechanizmus platformy. Čo je možné pripojiť:

  • Ľubovoľný systém s otvoreným API (JSON / XML / SOAP) — pripája sa podľa dokumentácie platformy, zvyčajne 1–3 dni práce.
  • Bežné účtovné a skladové systémy — výmena sa nastavuje rovnako, samostatný konektor nie je potrebný.
  • Vlastná evidencia — platforma nie je viazaná na konkrétny program: stačí, aby systém dokázal odosielať HTTP požiadavky a spracovať JSON.

Čo je potrebné na pripojenie

Platforma poskytuje fabrike univerzálne HTTP API. Z pohľadu fabriky sa pripojenie skladá z troch častí:

  • Prístupový kľúč k API — vydáva sa fabrike na žiadosť technickej podpore platformy. Používa sa na autorizáciu každého volania.
  • Dokumentácia dostupných metód — zoznam akcií, ktoré možno volať (získanie číselníkov, vyhľadávanie tovarov, čítanie a aktualizácia zostatkov, práca s objednávkami, klientmi, výrobou). Odovzdáva sa spolu s kľúčom.
  • Implementácia na strane fabriky — samostatný modul alebo služba, ktorá z vášho účtovného systému formuje HTTP požiadavky na API platformy. Vývoj realizuje váš IT tím alebo externý dodávateľ. Platforma nie je viazaná na konkrétny stack — vyhovuje akékoľvek prostredie podporujúce HTTP požiadavky a prácu s JSON.

Mapovanie tovarov, formát cien, frekvenciu synchronizácie, spracovanie chýb a retry politiku určuje fabrika sama — je to súčasť implementácie handleru na jej strane. Platforma zodpovedá za stabilné API a jeho dokumentáciu.

Žiadosť o pripojenie podáva fabrika cez technickú podporu — po dohodnutí formátu spolupráce tím platformy poskytne kľúč, dokumentáciu a pomôže s pilotnými požiadavkami.

Súvisiace témy