API

Paieška

Visas iFurn.pro paslaugos funkcionalumas prieinamas per API. Veiksmus, kuriuos vadybininkas atlieka administravimo skydelyje — užsakymo sukūrimą, būsenos keitimą, detalės parengties žymėjimą, paletės perkėlimą, pamainos atidarymą, atlyginimo skaičiavimą, katalogo mainus su apskaitos sistema — galima iškviesti programiškai. Gamybos duomenys teka į išorę: į internetinę parduotuvę, mobiliąją programėlę, CRM, BI sistemą, partnerio sandėlio sistemą.

Dalis galimybių įgyvendinta tik API ir administravimo skydelyje nerodoma: paketinės operacijos, tiesioginiai mainai su apskaitos sistema, CNC staklių ataskaitos apie faktinį detalės apdorojimą, prieiga prie užsakymo timeline įvykių, tarpįmoniniai didmeninės prekybos srautai.

Tipiniai integracijos scenarijai

Apskaitos sistemos. Dvipusiai užsakymų, kainų, likučių, mokėjimų būsenų mainai.
Internetinė parduotuvė arba konfigūratorius. Užsakymas iš kliento naršyklės patenka į skydelį su parengtu pjovimo žemėlapiu, CNC programa ir apskaičiuota kaina.
Matininko mobilioji programėlė. Pas klientą sukurtas projektas patenka į skydelį be rankinio duomenų perkėlimo.
B2B portalas partneriams. Prekiautojas mato savo kainas, formuoja užsakymus galutinio kliento vardu, skaito gamybos būsenas.
Gamybos staklės ir QR portalas. CNC staklės ir etikečių spausdintuvai fiksuoja atliktas operacijas per API.
Analitika ir BI. Statistikos apie užsakymus, pardavimus, medžiagų sąnaudas, operacijas eksportas.
Pokalbių robotai ir pranešimai. Telegram, Viber, balso asistentai — kiekvienas kreipiasi į tą patį API.

Pagrindiniai API skyriai

Užsakymai — 28 metodai

Gavimas ir sukūrimas. Sukurti užsakymą, perskaityti sąrašą pagal įmonę / klientą / būseną / laikotarpį, gauti kortelę su detalėmis ir paslaugomis, apskaičiuoti kainą prieš išsaugant, importas iš apskaitos sistemos.
Būsenų valdymas. Į darbą, į gamybą, į redagavimą, atšaukimas, parengta išsiuntimui, išsiųsta, pristatoma, grąžinimas į ankstesnę būseną.
Įvykiai ir timeline. Užsakymo istorija: kas ir kada keitė būseną, dėjo žymą, perdavė pristatymui.
Papildomos paslaugos. Susieti savo paslaugas su užsakymu ar detale; užsakymo įtraukimas į CNC programų generavimo eilę.

Gamyba — 20 metodų

Detalių žymėjimas. Uždėti ir nuimti atliktos operacijos (pjovimo, briaunos, gręžimo, frezavimo) žymą detalei arba detalių grupei.
Pakavimas. Pažymėti detalę kaip supakuotą, nuimti žymą, išvalyti pakavimo žymas. Kai supakuojama paskutinė detalė, užsakymas pereina į būseną „parengta išsiuntimui".
CNC operacijų statistika. Pjovimo metrai, tiesioginiai briaunos metrai, gręžimų vienetai pagal laikotarpį, įmonę, medžiagą, storį.
Pjovimas, GL ir QR. Gauti pjovimo programą, konvertavimas į pjovimo žemėlapį, CNC ataskaita apie detalę, užsakymo QR kodas.

Prekės ir medžiagos — 17 metodų

Artikulai. Katalogo gavimas, paieška pagal kodą, pagal filtrą, pagal aplanką, parametrų atnaujinimas.
Prekių sandėlis. Pajamavimo sukūrimas, likučio atnaujinimas, prekės susiejimas su užsakymu, likučių gavimas užsakymo gamybos momentu.
Papildoma informacija ir medžiagų sąsajos. Laisvos poros „medžiaga — briauna", „medžiaga — gamintojas", „artikulas — klientas"; visa įmonės nomenklatūra.

Klientai ir naudotojai — 18 metodų

Klientai. Kliento paieška / sukūrimas / atnaujinimas, išorinio kodo susiejimas, paieška pagal telefoną, masinis kontaktų atnaujinimas.
Cecho darbuotojai. Operatorių ir sandėlininkų sąrašas, sukūrimas, vaidmens priskyrimas, slaptažodžio keitimas, QR kortelės išdavimas įėjimui į QR portalą.
Vadybininkai ir pardavėjai. Sąrašas, teisių tikrinimas, susiejimas su pardavimo taškais, naujo slaptažodžio generavimas.

Briaunos redaktorius — 28 metodai

Nuožula. CRUD parametrams ir sąsajoms su medžiagomis/briauna.
Radiusinis suapvalinimas. Frezos, užlaidos, kampo parametrai.
Pjūvis kampu. Frezos parametrai, medžiaga-briauna sąsajos kiekvienam variantui.
Įleidžiamos rankenos. J profilis, GOLA, taškinės; sąsajos su briaunos tipais ir dažymo parametrais.
Dažymas ir sąsajos. Dažymo priskyrimas rankenai, spalvos susiejimas su briauna.

Didmeninė prekyba — 31 metodas

Partneriai. Partnerių sąrašas, savybės (antkainis, valiuta, kredito limitas), kliento susiejimas su partneriu.
Didmeninės prekės. Paieška partnerio kataloge, informacija apie prekę, katalogo išimtys, prieinami medžiagų tipai.
Nustatymai ir kainos. Individualūs prekės nustatymai partneriui, mažmeninės kainos virš didmeninių.
Sandėlis ir mažmena. Prekės mažmeninio šaltinio taškų susiejimas.
Didmeniniai užsakymai. Užsakymo sukūrimas prekiautojo pusėje, filtravimas, pavertimas vidiniu tiekėjo įmonės užsakymu.
Tiekimai. Tiekimo sukūrimas iš didmeninio užsakymo, tiekimų sąrašas, pozicijų susiejimas.

Atlyginimas ir planai — 22 metodai

Pamainos. Atidarymas, uždarymas, atnaujinimas, šalinimas, atvirų sąrašas; koeficientai šventinėms, naktinėms, įprastoms pamainoms.
Papildomi dokumentai. Priedai, baudos, korekcijos, susietos su pamaina ir darbuotoju; CRUD.
Tarifai ir ataskaitos. Tarifo paslaugai pridėjimas, tarifai pagal įmonę, suvestinė ataskaita apie darbuotojus per laikotarpį.
Planai. Numatytasis paslaugos planas, planas konkrečiai pamainai, atnaujinimas pagal paslaugos tipą.

Klientų pardavimo taškai — 4 metodai

Kliento susiejimas su filialu/salonu, kad užsakymas automatiškai patektų reikiamam vadybininkui: gauti, gauti visą sąrašą, nustatyti, pašalinti.

Žinynai ir kita — 25 metodai

Žinynai. Platformos įmonės, naudotojų vaidmenys, matavimo vienetai, pardavėjų tipai, medžiagų gamintojai, valiutos.
Tipai ir būsenos. Gamybos paslaugos, paslaugų tipai, prekių tipai, užsakymų būsenos.
Valiutos. Kurso pridėjimas, pokyčių statistika per laikotarpį.
Specialios pozicijos (SP). Taškinės apdorojimai/paslaugos — CRUD pozicijai ir jos tipui.
Kita. Darbuotojų brigados, sandėlio ląstelės, etiketės, 3D objektų biblioteka, prekių vaizdai, projektų importas/eksportas.

Galimybės, neprieinamos administravimo skydelyje

Paketinės operacijos. Šimtų užsakymų sukūrimas vienu iškvietimu, masinis partijos perkėlimas į gamybą, masinis kainoraščio atnaujinimas.
Neapdorotų įvykių skaitymas. Visas užsakymo timeline su kiekvieno pakeitimo laiko žymomis. Sąsajoje rodoma tik suvestinė istorija.
Mašininės ataskaitos iš CNC. Metodą cut_part_report iškviečia staklių programinė įranga baigus detalę — tai duomenų srautas iš cecho realiuoju laiku.
Mainai su apskaitos sistema. Metodas 1c_make_order ir susiję — apskaitos sistemos formatas vienas su vienu, be pereinamųjų lentelių.
Lygiagretūs didmeninės prekybos srautai. Skyriaus „Didmeninė prekyba" 31 metodas skirtas prekiautojų integracijoms.
Pritaikymas partneriui. Individualios kainos, katalogo išimtys, susiejimas su filialais — programinis konfigūravimas be redagavimo skydelyje.

Pilna dokumentacija — administravimo skydelyje

Administravimo skydelyje atidarytas skyrius API dokumentacija: interaktyvi dokumentacija Swagger stiliumi. Kiekvienam metodui nurodyta:

HTTP metodas ir endpoint;
privalomi ir neprivalomi užklausos parametrai, jų tipai ir leistinos reikšmės;
JSON užklausos pavyzdys;
atsakymo pavyzdys su laukų paaiškinimu;
galimi klaidų kodai;
smėlio dėžė — testinės užklausos siuntimas iš naršyklės.

Dokumentacija automatiškai atnaujinama išleidžiant platformos versijas.

Autorizacija ir prieiga

Užklausa pasirašoma įmonės API raktu. Raktas saugomas įmonės kortelėje ir jį išduoda palaikymo tarnyba. Vienas raktas naudojamas visai įmonei vienu metu iš bet kokio klientų skaičiaus: mainai su apskaitos sistema, mobilioji programėlė, pokalbių robotas, BI skydelis.

Integracija su apskaitos sistema

Administravimo skydelyje yra skyrius „Smėlio dėžė integracijai su apskaitos sistema": taškų, kuriuose paslauga kreipiasi į apskaitos sistemą (kainos, likučiai, medžiaga-briauna sąsajos), sąrašas. Kiekvieną tašką galima išbandyti su realia užklausa ir pamatyti apskaitos sistemos atsakymą. Sukonfigūravus mainai vyksta automatiškai.

Tarifikacija

API prijungimas neturi atskiro mokesčio. API raktas išduodamas pagal bendrą įmonės palaikymo tarifą. Griežtų užklausų skaičiaus limitų nėra.