API

Szukaj

Cała funkcjonalność serwisu iFurn.pro jest dostępna przez API. Działania, które menedżer wykonuje w panelu administracyjnym — utworzenie zamówienia, zmiana statusu, oznaczenie gotowości detalu, przeniesienie palety, otwarcie zmiany, naliczenie wynagrodzenia, wymiana katalogu z systemem księgowym — można wywołać programowo. Dane z produkcji trafiają na zewnątrz: do sklepu internetowego, aplikacji mobilnej, CRM, systemu BI, systemu magazynowego partnera.

Część możliwości jest zrealizowana tylko w API i nie jest wyświetlana w panelu administracyjnym: operacje wsadowe, bezpośrednia wymiana z systemem księgowym, raporty z maszyn CNC dotyczące faktycznej obróbki detalu, dostęp do zdarzeń timeline zamówienia, międzyfirmowe przepływy hurtowe.

Typowe scenariusze integracji

Systemy księgowe. Dwukierunkowa wymiana zamówień, cen, stanów, statusów płatności.
Sklep internetowy lub konfigurator. Zamówienie z przeglądarki klienta trafia do panelu z gotową mapą rozkroju, programem CNC i wyliczonym kosztem.
Aplikacja mobilna pomiarowca. Projekt utworzony u klienta trafia do panelu bez ręcznego przenoszenia danych.
Portal B2B dla partnerów. Dealer widzi swoje ceny, składa zamówienia w imieniu klienta końcowego, odczytuje statusy produkcji.
Maszyny produkcyjne i portal QR. Maszyny CNC i drukarki etykiet rejestrują wykonane operacje przez API.
Analityka i BI. Eksport statystyk dotyczących zamówień, sprzedaży, zużycia materiałów, operacji.
Chatboty i powiadomienia. Telegram, Viber, asystenci głosowi — każdy odwołuje się do tego samego API.

Główne sekcje API

Zamówienia — 28 metod

Pobieranie i tworzenie. Utworzyć zamówienie, odczytać listę według firmy / klienta / statusu / okresu, pobrać kartę z detalami i usługami, obliczyć koszt przed zapisaniem, import z systemu księgowego.
Zarządzanie statusami. Do realizacji, do produkcji, do edycji, anulowanie, gotowe do wysyłki, wysłane, w dostawie, cofnięcie do poprzedniego statusu.
Zdarzenia i timeline. Historia zamówienia: kto i kiedy zmieniał status, stawiał oznaczenie, przekazywał do dostawy.
Usługi dodatkowe. Powiązać własne usługi z zamówieniem lub detalem; ustawienie zamówienia w kolejce generowania programów CNC.

Produkcja — 20 metod

Oznaczanie detali. Ustawić i zdjąć oznaczenie wykonanej operacji (cięcie, okleina, wiercenie, frezowanie) dla detalu lub grupy detali.
Pakowanie. Oznaczyć detal jako zapakowany, zdjąć oznaczenie, wyczyścić oznaczenia pakowania. Gdy ostatni detal zostanie zapakowany, zamówienie przechodzi w stan „gotowe do wysyłki".
Statystyka operacji CNC. Metry cięcia, mb okleiny, sztuki wierceń według okresu, firmy, materiału, grubości.
Rozkrój, GL i QR. Pobrać program cięcia, konwersja do mapy rozkroju, raport CNC dla detalu, kod QR zamówienia.

Towary i materiały — 17 metod

Indeksy. Pobieranie katalogu, wyszukiwanie według kodu, filtra, folderu, aktualizacja parametrów.
Magazyn towarów. Utworzenie przyjęcia, aktualizacja stanu, powiązanie towaru z zamówieniem, pobranie stanów na moment produkcji zamówienia.
Informacje dodatkowe i powiązania materiałów. Dowolne pary „materiał — okleina", „materiał — producent", „indeks — klient"; pełny asortyment firmy.

Klienci i użytkownicy — 18 metod

Klienci. Wyszukiwanie / tworzenie / aktualizacja klienta, powiązanie kodu zewnętrznego, wyszukiwanie po telefonie, masowa aktualizacja kontaktów.
Pracownicy zakładu. Lista operatorów i magazynierów, tworzenie, przypisanie roli, zmiana hasła, wydanie karty QR do logowania w portalu QR.
Menedżerowie i sprzedawcy. Lista, sprawdzenie uprawnień, powiązanie z punktami sprzedaży, generowanie nowego hasła.

Edytor obrzeża — 28 metod

Fazka. CRUD parametrów i powiązań z materiałami/obrzeżem.
Zaokrąglenie promieniowe. Parametry frezu, naddatku, kąta.
Cięcie pod kątem. Parametry frezu, powiązania materiał-obrzeże dla każdego wariantu.
Uchwyty wpuszczane. Profil J, GOLA, punktowe; powiązania z typami obrzeża i parametrami lakierowania.
Lakierowanie i powiązania. Przypisanie lakierowania do uchwytu, powiązanie koloru z obrzeżem.

Handel hurtowy — 31 metod

Partnerzy. Lista partnerów, właściwości (narzut, waluta, limit kredytowy), powiązanie klienta z partnerem.
Towary hurtowe. Wyszukiwanie w katalogu partnera, informacje o towarze, wykluczenia katalogu, dostępne typy materiałów.
Ustawienia i ceny. Indywidualne ustawienia towaru pod partnera, ceny detaliczne ponad hurtowymi.
Magazyn i detal. Powiązanie punktów detalicznego źródła towaru.
Zamówienia hurtowe. Utworzenie zamówienia po stronie dealera, filtrowanie, przekształcenie w wewnętrzne zamówienie firmy-dostawcy.
Dostawy. Utworzenie dostawy z zamówienia hurtowego, lista dostaw, powiązanie pozycji.

Wynagrodzenia i plany — 22 metody

Zmiany. Otwarcie, zamknięcie, aktualizacja, usunięcie, lista otwartych; współczynniki dla zmian świątecznych, nocnych, zwykłych.
Dokumenty dodatkowe. Premie, kary, korekty powiązane ze zmianą i pracownikiem; CRUD.
Stawki i raporty. Dodanie stawki za usługę, stawki według firmy, zbiorczy raport o pracownikach za okres.
Plany. Plan domyślny dla usługi, plan na konkretną zmianę, aktualizacja według typu usługi.

Punkty sprzedaży klientów — 4 metody

Powiązanie klienta z oddziałem/salonem, aby zamówienie automatycznie trafiało do właściwego menedżera: pobrać, pobrać pełną listę, ustawić, usunąć.

Słowniki i pozostałe — 25 metod

Słowniki. Firmy platformy, role użytkowników, jednostki miary, typy sprzedawców, producenci materiałów, waluty.
Typy i statusy. Usługi produkcyjne, typy usług, typy towarów, statusy zamówień.
Waluty. Dodanie kursu, statystyka zmian za okres.
Pozycje specjalne (SP). Punktowe obróbki/usługi — CRUD pozycji i jej typu.
Pozostałe. Brygady pracowników, komórki magazynu, etykiety, biblioteka obiektów 3D, obrazy towarów, import/eksport projektów.

Możliwości niedostępne w panelu administracyjnym

Operacje wsadowe. Tworzenie setek zamówień jednym wywołaniem, masowe przekazanie partii do produkcji, masowa aktualizacja cennika.
Odczyt surowych zdarzeń. Pełny timeline zamówienia ze znacznikami czasu każdej zmiany. W UI wyświetlana jest tylko historia zbiorcza.
Raporty maszynowe z CNC. Metoda cut_part_report jest wywoływana przez oprogramowanie maszyny po ukończeniu detalu — to strumień danych z zakładu w czasie rzeczywistym.
Wymiana z systemem księgowym. Metoda 1c_make_order i pokrewne — format systemu księgowego jeden do jednego, bez tabel przejściowych.
Równoległe przepływy handlu hurtowego. 31 metod sekcji „Handel hurtowy" jest przeznaczonych do integracji dealerskich.
Personalizacja pod partnera. Indywidualne ceny, wykluczenia katalogu, powiązanie z oddziałami — konfiguracja programowa bez edycji w panelu.

Pełna dokumentacja — w panelu administracyjnym

W panelu administracyjnym otwarta jest sekcja Dokumentacja API: interaktywna dokumentacja w stylu Swagger. Dla każdej metody wskazano:

metodę HTTP i endpoint;
obowiązkowe i opcjonalne parametry żądania, ich typy i dopuszczalne wartości;
przykład żądania JSON;
przykład odpowiedzi z opisem pól;
możliwe kody błędów;
piaskownica — wysłanie żądania testowego z przeglądarki.

Dokumentacja jest aktualizowana automatycznie przy wydaniach platformy.

Autoryzacja i dostęp

Żądanie jest podpisywane kluczem API firmy. Klucz jest przechowywany w karcie firmy i wydawany przez służbę wsparcia. Jeden klucz jest używany dla całej firmy jednocześnie z dowolnej liczby klientów: wymiana z systemem księgowym, aplikacja mobilna, chatbot, dashboard BI.

Integracja z systemem księgowym

W panelu administracyjnym jest sekcja „Piaskownica integracji z systemem księgowym": lista punktów, w których serwis odwołuje się do systemu księgowego (ceny, stany, powiązania materiał-obrzeże). Każdy punkt można przetestować rzeczywistym żądaniem i zobaczyć odpowiedź systemu księgowego. Po skonfigurowaniu wymiana przebiega automatycznie.

Taryfikacja

Podłączenie API nie ma osobnej opłaty. Klucz API jest wydawany w ramach ogólnego taryfu wsparcia firmy. Nie ma sztywnych limitów liczby żądań.