Narudžba počinje kad vaš kupac u konfiguratoru potvrdi ponudu. Od tog trenutka ona je pohranjen, potpisan zapis, a CutOptim vas o njoj obavještava na dva načina.
Što je narudžba
Dokument narudžbe sadrži popis rezanja, upotrijebljene cijele ploče, okov, lijepljene ploče, plan rezanja i ponudu s njezinim stavkama i ukupnim iznosima u cijelim manjim jedinicama valute. Potpisan je, pa se poslije ne može mijenjati. Slanje istog zahtjeva za narudžbu dvaput vraća istu narudžbu, nikada drugu.
Budući da je cijena došla iz vaših objavljenih pravila na poslužitelju, vaša trgovina za nju ne vjeruje pregledniku. Prije nego što vaša košarica prihvati stavku, vaš poslužitelj traži od CutOptima da provjeri ponudu vašim tajnim ključem. Gotov način je WooCommerce dodatak; za druge trgovine pogledajte vlastite platforme.
Isporuka webhookom
Dodajte webhook na popis channels.webhooks svoje konfiguracije (kategorija Advanced, JSON uređivač) i objavite. Svaki unos ima id, url i events koje želite. URL mora biti javna HTTPS adresa; privatne, lokalne i interne adrese odbijaju se pri spremanju i ponovno pri slanju. Šalju se dva događaja:
- order.created kad kupac zaprimi narudžbu.
- order.status_changed kad narudžbi promijenite status.
Svaka isporuka je POST s kanonskim JSON tijelom i ovim zaglavljima: CutOptim-Signature, CutOptim-Event-Id, CutOptim-Event-Type, CutOptim-Delivery-Attempt i CutOptim-Delivery-Id. Potpis je t=<unix seconds>,v1=<hex>, HMAC-SHA256 od <t>.<raw body> tajnom primatelja. Vaš primatelj treba:
- pročitati sirovo tijelo prije parsiranja;
- provjeriti da je vremenska oznaka unutar nekoliko minuta i usporediti potpis u konstantnom vremenu;
- prihvatiti bilo koju od nekoliko vrijednosti
v1, koje se pojavljuju dok se tajna rotira; - brzo odgovoriti statusom 2xx i svaki id događaja obraditi samo jednom.
Tajnu primatelja vašem poslužitelju otkriva POST /cfg/v1/admin/webhooks/<id>/secret na usluzi, vašim tajnim ključem. Ne prikazuje se u konzoli.
Odgovor koji nije 2xx, istek vremena ili preusmjeravanje računaju se kao neuspjeh. Ponovni pokušaji čekaju 1, 5, 25 i 125 minuta, zatim 6 sati, a šesti neuspjeli pokušaj označava isporuku mrtvom. Ponovna isporuka ponavlja isti id događaja kako bi ga vaš primatelj mogao prepoznati. Ostale vrste događaja u konfiguraciji, poput događaja ponude ili projekta, prihvaćaju se, ali se nikada ne šalju.
E-pošta
U odjeljku channels.email svoje konfiguracije navodite adrese primatelja trgovine (tenantRecipients) i možete uključiti kopiju kupcu (sendCustomerCopy). E-pošta trgovini nosi radni nalog i PDF naljepnica; kopija kupcu šalje se samo ako ste je omogućili i ako narudžba nosi oznaku kupca s adresom u evidenciji, a odgovor na nju stiže na vašu prvu adresu primatelja. E-pošta o statusu šalje se samo kad to zatražite pri promjeni statusa. Neuspjeh slanja nikada ne blokira narudžbu. Sandbox šalje e-poštu samo potvrđenoj adresi vlasnika i nikada kupcu.
Konzola narudžbi
Područje Orders u konzoli prikazuje narudžbe po statusu i datumu te otvara narudžbu radi prikaza njezina popisa rezanja, stavki cijene, ukupnih iznosa i povijesti. Vlasnik i administrator vide i dnevnike isporuke webhookom i e-poštom, s gumbom Redeliver koji stavlja u red kopiju završene, neuspjele ili mrtve isporuke. Isporuka koja još čeka ili se izvodi ne može se ponovno isporučiti.
Za promjenu statusa odabirete sljedeći status, dodajete neobaveznu bilješku i odlučujete hoćete li kupcu poslati e-poštu. Dopušteni prijelazi su:
| Iz | U |
|---|---|
| primljena (received) | potvrđena (confirmed), otkazana (cancelled) |
| potvrđena (confirmed) | u proizvodnji (in production), otkazana (cancelled) |
| u proizvodnji (in production) | poslana (shipped), otkazana (cancelled) |
| poslana (shipped) | dovršena (completed) |
Dovršene i otkazane narudžbe se ne mijenjaju. Narudžbe se nikada ne brišu iz konzole; to su poslovni zapisi.
Stranica za praćenje
Kupčeva poveznica za praćenje prikazuje broj narudžbe, naziv vaše trgovine, korake statusa s vremenom svakog, broj dijelova i ukupan iznos, na jednom od deset jezika. Ne prikazuje adresu ni e-poštu, popis rezanja niti ikada vaše bilješke, a nema skripti. Poveznicu nije moguće pogoditi, pripada jednoj narudžbi i istječe 365 dana nakon narudžbe. Ako vam poveznica treba za telefonski razgovor, vaš je poslužitelj može zatražiti tajnim ključem; konzola je ne prikazuje.
Proizvodne datoteke
Svaka se narudžba iz detalja narudžbe može preuzeti kao sedam datoteka:
| Datoteka | Namjena |
|---|---|
| Popis dijelova (CSV) | dijelovi s dimenzijama i količinama |
| Razmještaji (CSV) | gdje svaki dio leži na svakoj ploči |
| Crtež (SVG) | plan, za pregled ili ispis |
| CNC crtež (DXF) | za CNC softver |
| Naljepnice (PDF) | naljepnice dijelova |
| Radni nalog (PDF) | list za radionicu |
| ERP izvadak (JSON) | za vaš ERP sustav |
PDF-ovi se ponovno grade iz narudžbe i odbijaju se kad se plan ne može točno reproducirati; tada ostale datoteke i dalje ostaju dostupne. PDF-ovi su na engleskom. Za narudžbu ne postoji Excel izvoz, a narudžbe 1D ili drva još ne postoje, pa se za njih ništa ne izvozi.
Što nije pokriveno
- Konfigurator ne naplaćuje plaćanje; plaćanje i ispunjenje narudžbi ostaju u vašoj trgovini.
- Ne postoji skupna promjena statusa.
- Poveznica za praćenje ne može se opozvati pojedinačno; istječe sama.