Ugrás a tartalomhoz
Ezen az oldalon▾

A rendelés akkor indul, amikor a vevő a konfigurátorban megerősít egy árajánlatot. Ettől a pillanattól tárolt, aláírt nyilvántartás, és a CutOptim két módon értesíti Önt róla.

Mi a rendelés

A rendelési dokumentum tartalmazza a darabjegyzéket, a felhasznált egész lapokat, a vasalatot, a ragasztott paneleket, a vágási tervet, valamint az árajánlatot a soraival és az összegeivel, egész másodlagos pénzegységekben. Alá van írva, így utólag nem módosítható. Ugyanazon rendelési kérés kétszeri elküldése ugyanazt a rendelést adja vissza, soha nem egy másodikat.

Mivel az ár az Ön közzétett szabályaiból, a szerveren keletkezett, a boltja nem bízik meg a böngészőben. Mielőtt a kosara elfogad egy sort, a szervere megkéri a CutOptimot, hogy a titkos kulcsával ellenőrizze az árajánlatot. A kész megoldás a WooCommerce bővítmény; más boltokhoz lásd az egyedi platformokat.

Webhook-kézbesítés

Adjon hozzá egy webhookot a konfigurációja channels.webhooks listájához (Advanced kategória, JSON-szerkesztő), és tegye közzé. Minden bejegyzésnek van id-ja, url-je és a kívánt events eseményei. Az URL-nek nyilvános HTTPS-címnek kell lennie; a privát, helyi és belső címeket mentéskor és küldéskor is elutasítja a rendszer. Két eseményt küld:

  • order.created, amikor egy vevő rendelést ad le.
  • order.status_changed, amikor Ön új állapotba viszi a rendelést.

Minden kézbesítés egy POST kanonikus JSON-törzzsel és ezekkel a fejlécekkel: CutOptim-Signature, CutOptim-Event-Id, CutOptim-Event-Type, CutOptim-Delivery-Attempt és CutOptim-Delivery-Id. Az aláírás t=<unix seconds>,v1=<hex>, a <t>.<raw body> HMAC-SHA256-ja a fogadótitokkal. A fogadónak:

  1. a nyers törzset kell olvasnia, mielőtt feldolgozza;
  2. ellenőriznie kell, hogy az időbélyeg néhány percen belül van, és az aláírást állandó idejű összehasonlítással kell összevetnie;
  3. el kell fogadnia bármelyik v1 értéket a többi közül, amelyek a titok forgatása közben jelennek meg;
  4. gyorsan 2xx állapotkóddal kell válaszolnia, és egy eseményazonosítót csak egyszer kell kezelnie.

A fogadótitkot a szervere a szolgáltatás POST /cfg/v1/admin/webhooks/<id>/secret hívásával kéri le a titkos kulcsával. A konzolban nem látható.

A nem 2xx válasz, az időtúllépés vagy az átirányítás hibának számít. Az újrapróbálkozások 1, 5, 25 és 125 percet, majd 6 órát várnak, és a hatodik sikertelen kísérlet holttá minősíti a kézbesítést. Az újrakézbesítés ugyanazt az eseményazonosítót ismétli, hogy a fogadó felismerhesse. A konfigurációban elfogadott egyéb eseménytípusokat, például az árajánlat- vagy projektesemények, a rendszer elfogadja, de soha nem küldi el.

E-mail

A konfigurációja channels.email szakaszában felsorolja a bolt címzettjeit (tenantRecipients), és bekapcsolhat egy másolatot a vevőnek (sendCustomerCopy). A bolt levele munkalapot és címke-PDF-et tartalmaz; a vevői másolat csak akkor megy ki, ha Ön engedélyezte, és a rendelés olyan vevőhivatkozást hordoz, amelyhez van tárolt cím, a válasz erre pedig az Ön első címzettjéhez érkezik. Az állapotlevél csak akkor megy ki, ha az állapot módosításakor Ön kéri. A küldés sikertelensége soha nem akadályozza a rendelést. A sandbox csak a tulajdonos megerősített címére küld, vevőnek soha.

A rendeléskonzol

A konzol Orders területe állapot és dátum szerint listázza a rendeléseket, és egy rendelést megnyitva mutatja a darabjegyzékét, az ársorait, az összegeit és az előzményeit. A tulajdonos és az adminisztrátor a webhook- és e-mail-kézbesítési naplókat is látja egy Redeliver gombbal, amely másolatot állít sorba egy lezárult, sikertelen vagy holt kézbesítésről. A még várakozó vagy futó kézbesítés nem kézbesíthető újra.

Az állapot módosításához kiválasztja a következő állapotot, megad egy opcionális megjegyzést, és eldönti, küldjön-e e-mailt a vevőnek. Az engedélyezett lépések:

Honnan Hová
beérkezett (received) megerősítve (confirmed), lemondva (cancelled)
megerősítve (confirmed) gyártásban (in production), lemondva (cancelled)
gyártásban (in production) kiszállítva (shipped), lemondva (cancelled)
kiszállítva (shipped) teljesítve (completed)

A teljesített és a lemondott rendelések nem lépnek tovább. A rendeléseket a konzolból soha nem törli a rendszer; üzleti nyilvántartások.

A követőoldal

A vevő követési hivatkozása mutatja a rendelésszámot, a bolt nevét, az állapotlépéseket mindegyik időpontjával, az alkatrészek számát és a végösszeget, tíz nyelv egyikén. Nem mutat címet vagy e-mail-címet, darabjegyzéket, és soha nem az Ön jegyzeteit, és nincsenek benne scriptek. A hivatkozás nem találgatható, egy rendeléshez tartozik, és a rendeléstől számított 365 nap után lejár. Ha telefonhíváshoz szüksége van a hivatkozásra, a szervere lekérheti a titkos kulccsal; a konzol nem mutatja.

Gyártási fájlok

Minden rendelés hét fájlként tölthető le a rendelés részleteiből:

Fájl Felhasználás
Alkatrészlista (CSV) az alkatrészek méretekkel és mennyiségekkel
Elhelyezések (CSV) hol helyezkedik el az egyes alkatrész az egyes lapokon
Rajz (SVG) a terv megtekintéshez vagy nyomtatáshoz
CNC-rajz (DXF) CNC-szoftverhez
Címkék (PDF) alkatrészcímkék
Munkalap (PDF) lap a műhelynek
ERP-kivonat (JSON) az Ön ERP-rendszeréhez

A PDF-eket a rendelésből építi újra a rendszer, és elutasítja, ha a terv nem reprodukálható pontosan; ebben az esetben a többi fájl továbbra is elérhető. A PDF-ek angol nyelvűek. A rendeléshez nincs Excel-export, az 1D vagy fűrészáru rendelések pedig még nem léteznek, így azokhoz semmi sem exportálódik.

Mi nem tartozik ide

  • A konfigurátor nem fogad fizetést; a fizetés és a teljesítés az Ön boltjában marad.
  • Nincs tömeges állapotmódosítás.
  • A követési hivatkozás nem vonható vissza egyenként; magától lejár.

FAQ

Hogyan kapom meg a rendelést?
Két módon egyszerre, ahogyan beállítja: aláírt webhookkal a szerverére, és e-mailben az Ön által felsorolt címekre. Az e-mail munkalapot és címkéket tartalmaz PDF-fájlként. Minden rendelés tárolódik és látható a konzolban is, így egy elmaradt webhook soha nem veszít el rendelést.
Honnan tudom, hogy egy webhook tényleg a CutOptimtól jön?
Minden kézbesítés hordoz egy CutOptim-Signature fejlécet: a törzs pontos bájtjai fölött számított HMAC-SHA256-ot időbélyeggel. A szervere újraszámolja a fogadótitokkal, amelyet a szervere a titkos kulcsával kér le a CutOptimtól, és elutasítja a hibás aláírást vagy a régi időbélyeget. A nyers törzset ellenőrizze, mielőtt feldolgozza, és hagyjon figyelmen kívül egy már kezelt eseményazonosítót, mert a kézbesítés legalább egyszeri.
Mi történik, ha a szerverem nem elérhető, amikor a rendelés megérkezik?
A rendelés előbb tárolódik, a kézbesítést pedig újrapróbálja a rendszer: 1, 5, 25 és 125 perc, majd 6 óra elteltével. A hatodik sikertelen kísérlet után a kézbesítés holtnak minősül. A tulajdonosok és az adminisztrátorok látják a kézbesítési naplót a konzolban, és egy kattintással sorba állíthatják ugyanazon esemény újrakézbesítését.
Mik a rendelési állapotok?
Beérkezett, megerősítve, gyártásban, kiszállítva és teljesítve, valamint lemondva. A rendelés egyszerre egy lépést halad előre, és a kiszállításig lemondható; a teljesített és a lemondott végleges. Ezt az adatbázis kényszeríti ki, így semmilyen útvonalon nem léptethető vissza a rendelés. Minden változást rögzít a rendszer, azzal együtt, hogy ki végezte.
Követheti a vevőm a rendelést?
Igen. Az állapot módosításakor egy jelölőnégyzettel e-mailt küldhet a vevőnek, és ez a levél követési hivatkozást tartalmaz. Az oldal mutatja a rendelésszámot, a bolt nevét, az állapotlépéseket és mindegyik időpontját, az alkatrészek számát és a végösszeget. Nem mutat címet, darabjegyzéket és az Ön jegyzeteit sem. A hivatkozás a rendeléstől számított 365 nap után megszűnik működni.
Mely gyártási fájlokat tölthetem le?
Hetet rendelésenként: az alkatrészlistát (CSV), az elhelyezéseket (CSV), a terv rajzát (SVG), egy CNC-rajzot (DXF), egy címke-PDF-et, egy munkalap-PDF-et és egy ERP-kivonatot (JSON). Az SVG, a DXF és az elhelyezések fájlja ugyanaz, mint amit az Engine API állít elő ugyanahhoz a tervhez.

Frissítve: 2026. október 19.