API

Otsing

Kogu teenuse iFurn.pro funktsionaalsus on saadaval API kaudu. Toiminguid, mida haldur teeb administraatoripaneelis — tellimuse loomine, oleku muutmine, detaili valmisoleku märkimine, alusaluse teisaldamine, vahetuse avamine, palga arvestamine, kataloogi vahetus raamatupidamissüsteemiga — saab kutsuda programmiliselt. Tootmisandmed liiguvad väljapoole: veebipoodi, mobiilirakendusse, CRM-i, BI-süsteemi, partneri laosüsteemi.

Osa võimalusi on realiseeritud ainult API-s ega kuvata administraatoripaneelis: hulgioperatsioonid, otsevahetus raamatupidamissüsteemiga, CNC-pinkide aruanded detaili tegeliku töötlemise kohta, juurdepääs tellimuse timeline-sündmustele, ettevõtetevahelised hulgimüügivood.

Tüüpilised integratsioonistsenaariumid

  • Raamatupidamissüsteemid. Kahesuunaline tellimuste, hindade, jääkide, maksestaatuste vahetus.
  • Veebipood või konfigureerija. Tellimus kliendi brauserist jõuab paneeli koos valmis lõikekaardi, CNC-programmi ja arvutatud maksumusega.
  • Mõõtja mobiilirakendus. Kliendi juures loodud projekt jõuab paneeli ilma andmete käsitsi ülekandmiseta.
  • B2B-portaal partneritele. Edasimüüja näeb oma hindu, vormistab tellimusi lõppkliendi eest, loeb tootmise staatusi.
  • Tootmispingid ja QR-portaal. CNC-pingid ja etiketiprinterid fikseerivad tehtud toimingud API kaudu.
  • Analüütika ja BI. Statistika eksport tellimuste, müügi, materjalikulu, toimingute kohta.
  • Vestlusrobotid ja teavitused. Telegram, Viber, häälassistendid — igaüks pöördub sama API poole.

API põhijaotised

Tellimused — 28 meetodit

  • Hankimine ja loomine. Luua tellimus, lugeda loend ettevõtte / kliendi / oleku / perioodi järgi, saada kaart detailide ja teenustega, arvutada maksumus enne salvestamist, import raamatupidamissüsteemist.
  • Olekute haldus. Töösse, tootmisse, redigeerimisse, tühistamine, saatmiseks valmis, saadetud, kohaletoimetamisel, taastamine eelmisesse olekusse.
  • Sündmused ja timeline. Tellimuse ajalugu: kes ja millal muutis olekut, pani märke, andis kohaletoimetamiseks.
  • Lisateenused. Siduda oma teenused tellimuse või detailiga; tellimuse lisamine CNC-programmide genereerimise järjekorda.

Tootmine — 20 meetodit

  • Detailide märgistamine. Panna ja eemaldada tehtud toimingu (saagimine, serv, puurimine, freesimine) märge detailile või detailide rühmale.
  • Pakkimine. Märkida detail pakituks, eemaldada märge, tühjendada pakkimismärked. Kui viimane detail on pakitud, läheb tellimus olekusse „saatmiseks valmis".
  • CNC-toimingute statistika. Saagimismeetrid, servajooksmeetrid, puurimiste tükid perioodi, ettevõtte, materjali, paksuse järgi.
  • Lõikus, GL ja QR. Saada lõikeprogramm, teisendus lõikekaardiks, CNC-aruanne detaili kohta, tellimuse QR-kood.

Kaubad ja materjalid — 17 meetodit

  • Artiklid. Kataloogi hankimine, otsing koodi, filtri, kausta järgi, parameetrite värskendamine.
  • Kaubaladu. Laekumise loomine, jäägi värskendamine, kauba sidumine tellimusega, jääkide hankimine tellimuse tootmise hetkel.
  • Lisateave ja materjalide seosed. Suvalised paarid „materjal — serv", „materjal — tootja", „artikkel — klient"; ettevõtte täielik nomenklatuur.

Kliendid ja kasutajad — 18 meetodit

  • Kliendid. Kliendi otsing / loomine / värskendamine, välise koodi sidumine, otsing telefoni järgi, kontaktide masuuendus.
  • Töökoja töötajad. Operaatorite ja laohoidjate loend, loomine, rolli määramine, parooli muutmine, QR-kaardi väljastamine QR-portaali sisenemiseks.
  • Haldurid ja müügiinimesed. Loend, õiguste kontroll, sidumine müügipunktidega, uue parooli genereerimine.

Servaredaktor — 28 meetodit

  • Faas. CRUD parameetrite ja seoste üle materjalide/servaga.
  • Raadiusega ümardus. Freesi, lisandi, nurga parameetrid.
  • Nurga all lõige. Freesi parameetrid, materjal-serv seosed iga variandi jaoks.
  • Süvistatud käepidemed. J-profiil, GOLA, punktikujulised; seosed servatüüpide ja värvimisparameetritega.
  • Värvimine ja seosed. Värvimise määramine käepidemele, värvi sidumine servaga.

Hulgimüük — 31 meetodit

  • Partnerid. Partnerite loend, omadused (juurdehindlus, valuuta, krediidilimiit), kliendi sidumine partneriga.
  • Hulgikaubad. Otsing partneri kataloogis, kaubateave, kataloogi erandid, saadaolevad materjalitüübid.
  • Seaded ja hinnad. Individuaalsed kauba seaded partneri jaoks, jaehinnad hulgihindade peal.
  • Ladu ja jaemüük. Kauba jaemüügi allika punktide sidumine.
  • Hulgitellimused. Tellimuse loomine edasimüüja poolelt, filtreerimine, teisendamine tarnijaettevõtte sisemiseks tellimuseks.
  • Tarned. Tarne loomine hulgitellimusest, tarnete loend, positsioonide sidumine.

Palk ja plaanid — 22 meetodit

  • Vahetused. Avamine, sulgemine, värskendamine, kustutamine, avatute loend; koefitsiendid püha-, öö- ja tavavahetuste jaoks.
  • Lisadokumendid. Boonused, trahvid, korrektuurid, seotud vahetuse ja töötajaga; CRUD.
  • Tariifid ja aruanded. Teenuse tariifi lisamine, tariifid ettevõtte järgi, koondaruanne töötajate kohta perioodi eest.
  • Plaanid. Teenuse vaikeplaan, plaan konkreetsele vahetusele, värskendus teenuse tüübi järgi.

Klientide müügipunktid — 4 meetodit

Kliendi sidumine filiaali/salongiga, et tellimus jõuaks automaatselt õige halduri juurde: hankida, hankida täielik loend, määrata, kustutada.

Klassifikaatorid ja muu — 25 meetodit

  • Klassifikaatorid. Platvormi ettevõtted, kasutajarollid, mõõtühikud, müügiinimeste tüübid, materjalitootjad, valuutad.
  • Tüübid ja staatused. Tootmisteenused, teenusetüübid, kaubatüübid, tellimuste staatused.
  • Valuutad. Kursi lisamine, muutuste statistika perioodi eest.
  • Eripositsioonid (SP). Punktitöötlused/teenused — CRUD positsiooni ja selle tüübi üle.
  • Muu. Töötajate brigaadid, laopesad, sildid, 3D-objektide teek, kaubapildid, projektide import/eksport.

Administraatoripaneelis mittesaadaolevad võimalused

  • Hulgioperatsioonid. Sadade tellimuste loomine ühe kutsega, partii masstootmisse üleandmine, hinnakirja massuuendus.
  • Toorsündmuste lugemine. Tellimuse täielik timeline iga muudatuse ajatemplitega. Kasutajaliideses kuvatakse ainult koondajalugu.
  • Masinaaruanded CNC-st. Meetodit cut_part_report kutsub pingi tarkvara pärast detaili valmimist — see on reaalajas andmevoog töökojast.
  • Vahetus raamatupidamissüsteemiga. Meetod 1c_make_order ja sellega seotud — raamatupidamissüsteemi formaat üks ühele, ilma üleminekutabeliteta.
  • Paralleelsed hulgimüügivood. Jaotise „Hulgimüük" 31 meetodit on mõeldud edasimüüjate integratsioonideks.
  • Kohandamine partneri jaoks. Individuaalsed hinnad, kataloogi erandid, sidumine filiaalidega — programmiline seadistamine ilma paneelis muutmata.

Täielik dokumentatsioon — administraatoripaneelis

Administraatoripaneelis on avatud jaotis API dokumentatsioon: interaktiivne dokumentatsioon Swaggeri stiilis. Iga meetodi kohta on märgitud:

  • HTTP-meetod ja endpoint;
  • kohustuslikud ja valikulised päringu parameetrid, nende tüübid ja lubatud väärtused;
  • JSON-päringu näide;
  • vastuse näide väljade seletusega;
  • võimalikud veakoodid;
  • liivakast — testpäringu saatmine brauserist.

Dokumentatsiooni uuendatakse automaatselt platvormi väljalasetel.

Autoriseerimine ja juurdepääs

Päring allkirjastatakse ettevõtte API-võtmega. Võti hoitakse ettevõtte kaardil ja selle väljastab tugiteenus. Üht võtit kasutatakse kogu ettevõtte jaoks korraga suvalisest arvust klientidest: vahetus raamatupidamissüsteemiga, mobiilirakendus, vestlusrobot, BI-armatuurlaud.

Integratsioon raamatupidamissüsteemiga

Administraatoripaneelis on jaotis „Raamatupidamissüsteemiga integreerimise liivakast": loend punktidest, kus teenus pöördub raamatupidamissüsteemi poole (hinnad, jäägid, materjal-serv seosed). Iga punkti saab testida reaalse päringuga ja näha raamatupidamissüsteemi vastust. Pärast seadistamist toimub vahetus automaatselt.

Tariifistamine

API ühendamisel puudub eraldi tasu. API-võti väljastatakse ettevõtte üldise tugiteenuse tariifi raames. Päringute arvule rangeid piiranguid ei ole.