API

Hľadať

Celá funkcionalita služby iFurn.pro je dostupná cez API. Akcie, ktoré manažér vykonáva v admin paneli — vytvorenie objednávky, zmena stavu, označenie hotovosti dielca, presun palety, otvorenie zmeny, výpočet miezd, výmena katalógu s účtovným systémom — možno vyvolať programovo. Údaje z výroby prúdia von: do internetového obchodu, mobilnej aplikácie, CRM, BI systému, skladového systému partnera.

Časť možností je realizovaná iba v API a v admin paneli sa nezobrazuje: dávkové operácie, priama výmena s účtovným systémom, hlásenia z CNC strojov o skutočnom obrobení dielca, prístup k timeline udalostiam objednávky, medzifiremné veľkoobchodné toky.

Typické scenáre integrácie

Účtovné systémy. Obojsmerná výmena objednávok, cien, zásob, stavov platieb.
Internetový obchod alebo konfigurátor. Objednávka z prehliadača zákazníka prichádza do admin panelu s hotovou nárezovou mapou, CNC programom a vypočítanou cenou.
Mobilná aplikácia zameriavača. Projekt vytvorený u zákazníka sa dostane do admin panelu bez ručného prenosu údajov.
B2B portál pre partnerov. Díler vidí svoje ceny, zadáva objednávky za koncového zákazníka, číta stavy výroby.
Výrobné stroje a QR portál. CNC stroje a etiketovacie tlačiarne zaznamenávajú vykonané operácie cez API.
Analytika a BI. Export štatistík o objednávkach, predajoch, spotrebe materiálov, operáciách.
Chatboty a notifikácie. Telegram, Viber, hlasoví asistenti — každý sa obracia na to isté API.

Hlavné sekcie API

Objednávky — 28 metód

Získanie a vytvorenie. Vytvoriť objednávku, prečítať zoznam podľa firmy / zákazníka / stavu / obdobia, získať kartu s dielcami a službami, vypočítať cenu pred uložením, import z účtovného systému.
Správa stavov. Do práce, do výroby, do úprav, zrušenie, pripravené na expedíciu, expedované, v doručovaní, návrat na predchádzajúci stav.
Udalosti a timeline. História objednávky: kto a kedy menil stav, dával označenie, odovzdával na doručenie.
Doplnkové služby. Priradiť vlastné služby k objednávke alebo dielcu; zaradenie objednávky do fronty generovania CNC programov.

Výroba — 20 metód

Označovanie dielcov. Nastaviť a zrušiť označenie vykonanej operácie (rezanie, hrana, vŕtanie, frézovanie) pre dielec alebo skupinu dielcov.
Balenie. Označiť dielec ako zabalený, zrušiť označenie, vymazať baliace značky. Keď je posledný dielec zabalený, objednávka prechádza do stavu „pripravené na expedíciu".
Štatistika CNC operácií. Metre rezania, bežné metre hrany, kusy vŕtaní podľa obdobia, firmy, materiálu, hrúbky.
Nárez, GL a QR. Získať program rezania, konverzia na nárezovú mapu, CNC hlásenie pre dielec, QR kód objednávky.

Tovar a materiály — 17 metód

Artikle. Získanie katalógu, vyhľadávanie podľa kódu, podľa filtra, podľa priečinka, aktualizácia parametrov.
Sklad tovaru. Vytvorenie príjmu, aktualizácia zásoby, priradenie tovaru k objednávke, získanie zásob k momentu výroby objednávky.
Doplnkové informácie a väzby materiálov. Ľubovoľné dvojice „materiál — hrana", „materiál — výrobca", „artikel — zákazník"; kompletný sortiment firmy.

Zákazníci a používatelia — 18 metód

Zákazníci. Vyhľadávanie / vytvorenie / aktualizácia zákazníka, priradenie externého kódu, vyhľadávanie podľa telefónu, hromadná aktualizácia kontaktov.
Pracovníci dielne. Zoznam operátorov a skladníkov, vytvorenie, priradenie roly, zmena hesla, vydanie QR karty na prihlásenie do QR portálu.
Manažéri a predajcovia. Zoznam, kontrola práv, priradenie k predajným miestam, generovanie nového hesla.

Editor hrany — 28 metód

Skosenie. CRUD nad parametrami a väzbami s materiálmi/hranou.
Rádiusové zaoblenie. Parametre frézy, prídavku, uhla.
Rez pod uhlom. Parametre frézy, väzby materiál-hrana pre každý variant.
Zapustené úchytky. J-profil, GOLA, bodové; väzby s typmi hrany a parametrami lakovania.
Lakovanie a väzby. Priradenie lakovania k úchytke, priradenie farby k hrane.

Veľkoobchod — 31 metód

Partneri. Zoznam partnerov, vlastnosti (prirážka, mena, kreditný limit), priradenie zákazníka k partnerovi.
Veľkoobchodný tovar. Vyhľadávanie v katalógu partnera, informácie o tovare, výnimky katalógu, dostupné typy materiálov.
Nastavenia a ceny. Individuálne nastavenia tovaru pre partnera, maloobchodné ceny nad veľkoobchodnými.
Sklad a maloobchod. Priradenie miest maloobchodného zdroja tovaru.
Veľkoobchodné objednávky. Vytvorenie objednávky na strane dílera, filtrovanie, prevod na internú objednávku dodávateľskej firmy.
Dodávky. Vytvorenie dodávky z veľkoobchodnej objednávky, zoznam dodávok, priradenie položiek.

Mzdy a plány — 22 metód

Zmeny. Otvorenie, zatvorenie, aktualizácia, vymazanie, zoznam otvorených; koeficienty pre sviatočné, nočné, bežné zmeny.
Doplnkové doklady. Bonusy, pokuty, korekcie viazané na zmenu a pracovníka; CRUD.
Tarify a hlásenia. Pridanie tarify za službu, tarify podľa firmy, súhrnné hlásenie o pracovníkoch za obdobie.
Plány. Predvolený plán pre službu, plán pre konkrétnu zmenu, aktualizácia podľa typu služby.

Predajné miesta zákazníkov — 4 metódy

Priradenie zákazníka k pobočke/showroomu, aby objednávka automaticky prišla k správnemu manažérovi: získať, získať kompletný zoznam, nastaviť, vymazať.

Číselníky a ostatné — 25 metód

Číselníky. Firmy platformy, roly používateľov, merné jednotky, typy predajcov, výrobcovia materiálov, meny.
Typy a stavy. Výrobné služby, typy služieb, typy tovaru, stavy objednávok.
Meny. Pridanie kurzu, štatistika zmien za obdobie.
Špeciálne položky (SP). Bodové obrábania/služby — CRUD nad položkou a jej typom.
Ostatné. Brigády pracovníkov, bunky skladu, štítky, knižnica 3D objektov, obrázky tovaru, import/export projektov.

Možnosti nedostupné v admin paneli

Dávkové operácie. Vytvorenie stoviek objednávok jedným volaním, hromadný prevod dávky do výroby, hromadná aktualizácia cenníka.
Čítanie surových udalostí. Kompletný timeline objednávky s časovými značkami každej zmeny. V UI sa zobrazuje iba súhrnná história.
Strojové hlásenia z CNC. Metóda cut_part_report je volaná softvérom stroja po dokončení dielca — je to tok údajov z dielne v reálnom čase.
Výmena s účtovným systémom. Metóda 1c_make_order a súvisiace — formát účtovného systému jedna k jednej, bez prechodných tabuliek.
Paralelné toky veľkoobchodu. 31 metód sekcie „Veľkoobchod" je určených pre dílerske integrácie.
Prispôsobenie pre partnera. Individuálne ceny, výnimky katalógu, priradenie k pobočkám — programové nastavenie bez úprav v admin paneli.

Kompletná dokumentácia — v admin paneli

V admin paneli je otvorená sekcia Dokumentácia API: interaktívna dokumentácia v štýle Swagger. Pri každej metóde je uvedené:

HTTP metóda a endpoint;
povinné a voliteľné parametre požiadavky, ich typy a prípustné hodnoty;
príklad JSON požiadavky;
príklad odpovede s popisom polí;
možné chybové kódy;
sandbox — odoslanie testovacej požiadavky z prehliadača.

Dokumentácia sa pri vydaniach platformy aktualizuje automaticky.

Autorizácia a prístup

Požiadavka sa podpisuje API kľúčom firmy. Kľúč je uložený v karte firmy a vydáva ho podporná služba. Jeden kľúč sa používa pre celú firmu súčasne z ľubovoľného počtu klientov: výmena s účtovným systémom, mobilná aplikácia, chatbot, BI dashboard.

Integrácia s účtovným systémom

V admin paneli je sekcia „Sandbox pre integráciu s účtovným systémom": zoznam bodov, v ktorých sa služba obracia na účtovný systém (ceny, zásoby, väzby materiál-hrana). Každý bod možno otestovať reálnou požiadavkou a vidieť odpoveď účtovného systému. Po nastavení prebieha výmena automaticky.

Tarifikácia

Pripojenie API nemá samostatný poplatok. API kľúč sa vydáva v rámci všeobecného tarifu podpory firmy. Neexistujú tvrdé limity na počet požiadaviek.