API

Căutare

Întreaga funcționalitate a serviciului iFurn.pro este disponibilă prin API. Acțiunile pe care managerul le efectuează în panoul de administrare — crearea unei comenzi, schimbarea unui status, marcarea unei piese ca gata, mutarea unui palet, deschiderea unei ture, calcularea salariilor, schimbul de catalog cu sistemul de contabilitate — pot fi apelate programatic. Datele din producție ies în exterior: către un magazin online, o aplicație mobilă, un CRM, un sistem BI, sistemul de depozit al unui partener.

O parte dintre posibilități este implementată doar în API și nu se afișează în panoul de administrare: operațiuni în lot, schimb direct cu sistemul de contabilitate, rapoarte de la mașinile CNC privind prelucrarea efectivă a piesei, acces la evenimentele timeline ale comenzii, fluxuri en-gros între firme.

Scenarii tipice de integrare

Sisteme de contabilitate. Schimb bidirecțional de comenzi, prețuri, stocuri, statusuri de plată.
Magazin online sau configurator. O comandă din browserul clientului ajunge în panou cu harta de debitare gata, program CNC și cost calculat.
Aplicație mobilă a măsurătorului. Un proiect creat la client ajunge în panou fără transfer manual de date.
Portal B2B pentru parteneri. Un dealer își vede propriile prețuri, plasează comenzi în numele clientului final, citește statusurile de producție.
Mașini de producție și portal QR. Mașinile CNC și imprimantele de etichete înregistrează operațiunile efectuate prin API.
Analitică și BI. Export de statistici privind comenzile, vânzările, consumul de materiale, operațiunile.
Chatboți și notificări. Telegram, Viber, asistenți vocali — fiecare accesează același API.

Secțiunile principale ale API

Comenzi — 28 de metode

Obținere și creare. Crearea unei comenzi, citirea unei liste după firmă / client / status / perioadă, obținerea unei fișe cu piese și servicii, calcularea costului înainte de salvare, import din sistemul de contabilitate.
Gestionarea statusurilor. În lucru, în producție, în editare, anulare, gata de expediere, expediat, în livrare, revenire la statusul anterior.
Evenimente și timeline. Istoricul comenzii: cine și când a schimbat statusul, a pus o marcare, a predat spre livrare.
Servicii suplimentare. Atașarea propriilor servicii la o comandă sau o piesă; punerea comenzii în coada de generare a programelor CNC.

Producție — 20 de metode

Marcarea pieselor. Setarea și eliminarea marcării unei operațiuni efectuate (debitare, cant, găurire, frezare) pentru o piesă sau un grup de piese.
Ambalare. Marcarea unei piese ca ambalată, eliminarea marcării, ștergerea marcărilor de ambalare. Când ultima piesă este ambalată, comanda trece în „gata de expediere".
Statistica operațiunilor CNC. Metri de debitare, metri liniari de cant, bucăți de găuriri pe perioadă, firmă, material, grosime.
Debitare, GL și QR. Obținerea programului de tăiere, conversia în hartă de debitare, raport CNC pe piesă, cod QR al comenzii.

Produse și materiale — 17 metode

Articole. Obținerea catalogului, căutare după cod, după filtru, după folder, actualizarea parametrilor.
Depozit de produse. Crearea unei intrări, actualizarea stocului, atașarea unui produs la o comandă, obținerea stocurilor la momentul producției comenzii.
Informații suplimentare și legături de materiale. Perechi arbitrare „material — cant", „material — producător", „articol — client"; nomenclatorul complet al firmei.

Clienți și utilizatori — 18 metode

Clienți. Căutare / creare / actualizare client, atașarea unui cod extern, căutare după telefon, actualizare în masă a contactelor.
Muncitori de atelier. Lista operatorilor și magazionerilor, creare, atribuirea rolului, schimbarea parolei, emiterea unei carduri QR pentru acces în portalul QR.
Manageri și vânzători. Listă, verificarea drepturilor, asocierea la puncte de vânzare, generarea unei parole noi.

Editor de cant — 28 de metode

Teșitură. CRUD pe parametri și legături cu materialele/cantul.
Rotunjire pe rază. Parametrii frezei, adaosului, unghiului.
Tăiere în unghi. Parametrii frezei, legături material-cant pentru fiecare variantă.
Mânere îngropate. Profil J, GOLA, punctuale; legături cu tipurile de cant și parametrii de vopsire.
Vopsire și legături. Atribuirea vopsirii la un mâner, asocierea unei culori la un cant.

Comerț en-gros — 31 de metode

Parteneri. Lista partenerilor, proprietăți (adaos, valută, limită de credit), asocierea unui client la un partener.
Produse en-gros. Căutare în catalogul partenerului, informații despre produs, excluderi de catalog, tipuri de materiale disponibile.
Setări și prețuri. Setări individuale ale produsului pentru partener, prețuri de vânzare cu amănuntul peste cele en-gros.
Depozit și retail. Asocierea punctelor sursei de retail a produsului.
Comenzi en-gros. Crearea unei comenzi de partea dealerului, filtrare, transformare în comandă internă a firmei-furnizor.
Livrări. Crearea unei livrări dintr-o comandă en-gros, lista livrărilor, asocierea pozițiilor.

Salarizare și planuri — 22 de metode

Ture. Deschidere, închidere, actualizare, ștergere, lista celor deschise; coeficienți pentru turele de sărbători, de noapte, obișnuite.
Documente suplimentare. Bonusuri, penalizări, corecții legate de o tură și un lucrător; CRUD.
Tarife și rapoarte. Adăugarea unui tarif pentru un serviciu, tarife pe firmă, raport centralizat privind lucrătorii pe o perioadă.
Planuri. Plan implicit pentru un serviciu, plan pentru o tură anume, actualizare după tipul de serviciu.

Puncte de vânzare ale clienților — 4 metode

Asocierea unui client la o filială/showroom, astfel încât comanda să ajungă automat la managerul potrivit: obținere, obținerea listei complete, setare, ștergere.

Nomenclatoare și diverse — 25 de metode

Nomenclatoare. Firmele platformei, rolurile utilizatorilor, unitățile de măsură, tipurile de vânzători, producătorii de materiale, valutele.
Tipuri și statusuri. Servicii de producție, tipuri de servicii, tipuri de produse, statusuri de comenzi.
Valute. Adăugarea unui curs, statistica modificărilor pe o perioadă.
Poziții speciale (SP). Prelucrări/servicii punctuale — CRUD pe o poziție și tipul ei.
Diverse. Brigăzi de lucrători, celule de depozit, etichete, o bibliotecă de obiecte 3D, imagini de produse, import/export de proiecte.

Posibilități indisponibile în panoul de administrare

Operațiuni în lot. Crearea a sute de comenzi printr-un singur apel, transferul în masă al unui lot în producție, actualizarea în masă a listei de prețuri.
Citirea evenimentelor brute. Timeline-ul complet al comenzii cu marcaje temporale ale fiecărei modificări. În UI se afișează doar istoricul rezumat.
Rapoarte de mașină de la CNC. Metoda cut_part_report este apelată de software-ul mașinii după finalizarea piesei — este un flux de date din atelier în timp real.
Schimb cu sistemul de contabilitate. Metoda 1c_make_order și cele conexe — formatul sistemului de contabilitate unu la unu, fără tabele intermediare.
Fluxuri paralele de comerț en-gros. Cele 31 de metode ale secțiunii „Comerț en-gros" sunt destinate integrărilor de dealer.
Personalizare pentru partener. Prețuri individuale, excluderi de catalog, asociere la filiale — configurare programatică fără editare în panou.

Documentație completă — în panoul de administrare

În panoul de administrare este deschisă secțiunea Documentația API: documentație interactivă în stil Swagger. Pentru fiecare metodă se indică:

metoda HTTP și endpoint-ul;
parametrii obligatorii și opționali ai cererii, tipurile lor și valorile admise;
un exemplu de cerere JSON;
un exemplu de răspuns cu descrierea câmpurilor;
codurile de eroare posibile;
un sandbox — trimiterea unei cereri de test din browser.

Documentația se actualizează automat la lansările platformei.

Autorizare și acces

O cerere este semnată cu cheia API a firmei. Cheia este stocată în fișa firmei și emisă de serviciul de suport. O singură cheie este folosită pentru întreaga firmă simultan de la orice număr de clienți: schimb cu sistemul de contabilitate, aplicație mobilă, chatbot, dashboard BI.

Integrare cu sistemul de contabilitate

În panoul de administrare există secțiunea „Sandbox pentru integrarea cu sistemul de contabilitate": o listă a punctelor în care serviciul apelează sistemul de contabilitate (prețuri, stocuri, legături material-cant). Fiecare punct poate fi testat cu o cerere reală și se poate vedea răspunsul sistemului de contabilitate. După configurare, schimbul are loc automat.

Tarifare

Conectarea API nu are o taxă separată. Cheia API este emisă în cadrul tarifului general de suport al firmei. Nu există limite stricte privind numărul de cereri.