Objednávka vzniká ve chvíli, kdy zákazník v konfigurátoru potvrdí nabídku. Od tohoto okamžiku je to uložený, podepsaný záznam a CutOptim vás o ní informuje dvěma způsoby.
Co je objednávka
Dokument objednávky obsahuje seznam řezů, použité celé desky, kování, lepené panely, plán řezání a nabídku s jejími řádky a součty v celých nejmenších jednotkách měny. Je podepsán, takže ho nelze dodatečně změnit. Odeslání téhož požadavku na objednávku dvakrát vrátí tutéž objednávku, nikdy druhou.
Protože cena pochází z vašich publikovaných pravidel na serveru, váš obchod se v ní nespoléhá na prohlížeč. Než váš košík řádek přijme, váš server požádá CutOptim o ověření nabídky pomocí vašeho tajného klíče. Hotovým způsobem je plug-in pro WooCommerce; pro jiné obchody viz vlastní platformy.
Doručení webhookem
Přidejte webhook do seznamu channels.webhooks ve své konfiguraci (kategorie Advanced, editor JSON) a publikujte. Každá položka má id, url a požadované events. Adresa URL musí být veřejná adresa HTTPS; soukromé, lokální a interní adresy jsou odmítnuty při ukládání i znovu při odesílání. Odesílají se dvě události:
- order.created, když zákazník zadá objednávku.
- order.status_changed, když objednávku přesunete do nového stavu.
Každé doručení je požadavek POST s kanonickým tělem JSON a těmito hlavičkami: CutOptim-Signature, CutOptim-Event-Id, CutOptim-Event-Type, CutOptim-Delivery-Attempt a CutOptim-Delivery-Id. Podpis má tvar t=<unix seconds>,v1=<hex>, což je HMAC-SHA256 z <t>.<raw body> s tajemstvím příjemce. Váš příjemce by měl:
- přečíst surové tělo dříve, než ho zpracuje;
- zkontrolovat, že časové razítko je v rozmezí několika minut, a porovnat podpis v konstantním čase;
- přijmout kteroukoli z několika hodnot
v1, které se objevují během obměny tajemství; - rychle odpovědět stavem 2xx a každé id události zpracovat jen jednou.
Tajemství příjemce vašemu serveru odhalí POST /cfg/v1/admin/webhooks/<id>/secret na službě s vaším tajným klíčem. V konzoli se nezobrazuje.
Odpověď jiná než 2xx, vypršení časového limitu nebo přesměrování se počítá jako selhání. Opakování čekají 1, 5, 25 a 125 minut, poté 6 hodin, a šestý neúspěšný pokus označí doručení jako mrtvé. Opětovné doručení opakuje stejné id události, aby ho váš příjemce poznal. Jiné typy událostí v konfiguraci, například události nabídek nebo projektů, jsou přijaty, ale nikdy se neodesílají.
V sekci channels.email své konfigurace uvedete adresy příjemců obchodu (tenantRecipients) a můžete zapnout kopii zákazníkovi (sendCustomerCopy). E-mail obchodu nese pracovní list a PDF se štítky; kopie zákazníkovi odejde, jen když jste ji zapnuli a objednávka nese referenci na zákazníka s adresou v evidenci, a odpověď na ni dorazí na vaši první adresu příjemce. E-mail o stavu odejde, jen když o něj požádáte při změně stavu. Selhání odeslání nikdy objednávku neblokuje. Sandbox posílá e-maily jen na potvrzenou adresu vlastníka a zákazníkovi nikdy.
Konzole objednávek
Oblast Orders v konzoli vypisuje objednávky podle stavu a data a po otevření objednávky ukáže její seznam řezů, cenové řádky, součty a historii. Vlastník a správce vidí také protokoly doručení webhooků a e-mailů s tlačítkem Redeliver, které zařadí kopii dokončeného, neúspěšného nebo mrtvého doručení. Doručení, které ještě čeká nebo běží, nelze doručit znovu.
Pro změnu stavu zvolíte další stav, přidáte volitelnou poznámku a rozhodnete, zda zákazníkovi poslat e-mail. Povolené přesuny jsou:
| Z | Do |
|---|---|
| přijatá (received) | potvrzená (confirmed), zrušená (cancelled) |
| potvrzená (confirmed) | ve výrobě (in production), zrušená (cancelled) |
| ve výrobě (in production) | odeslaná (shipped), zrušená (cancelled) |
| odeslaná (shipped) | dokončená (completed) |
Dokončené a zrušené objednávky se již nepohybují. Objednávky se z konzole nikdy nemažou; jsou to obchodní záznamy.
Stránka sledování
Odkaz na sledování pro zákazníka ukazuje číslo objednávky, název vašeho obchodu, kroky stavu s časem každého, počet dílů a celkovou částku, v jednom z deseti jazyků. Neukazuje adresu ani e-mail, seznam řezů a nikdy vaše poznámky a neobsahuje žádné skripty. Odkaz nelze uhodnout, patří k jediné objednávce a vyprší 365 dní po objednávce. Pokud odkaz potřebujete pro telefonát, váš server si ho může vyžádat tajným klíčem; konzole ho nezobrazuje.
Výrobní soubory
Každou objednávku lze z jejího detailu stáhnout jako sedm souborů:
| Soubor | Použití |
|---|---|
| Part list (CSV) | díly s rozměry a množstvím |
| Placements (CSV) | kde který díl leží na které desce |
| Drawing (SVG) | plán k zobrazení nebo tisku |
| CNC drawing (DXF) | pro software CNC |
| Labels (PDF) | štítky dílů |
| Worksheet (PDF) | list pro dílnu |
| ERP extract (JSON) | pro váš systém ERP |
Soubory PDF se sestavují znovu z objednávky a jsou odmítnuty, pokud plán nelze přesně reprodukovat; ostatní soubory jsou v takovém případě stále k dispozici. Soubory PDF jsou v angličtině. Pro objednávku neexistuje export do Excelu a objednávky 1D ani řeziva zatím neexistují, takže se pro ně nic neexportuje.
Co není pokryto
- Konfigurátor nepřijímá platby; platba a vyřízení zůstávají ve vašem obchodě.
- Neexistuje hromadná změna stavu.
- Odkaz na sledování nelze zrušit jednotlivě; vyprší sám.