Dokument order.v1

Svaka narudžba koju konfigurator zabilježi jedan je potpisani dokument order.v1: workflow u kojem je nastala, popis rezanja, plan proizvodnje, ponuda s cijenom i njezin token te odakle dolazi. Ne sadrži osobne podatke, samo vaš neprozirni customerRef.

Putanje, nazivi polja, kodovi pogrešaka, nazivi zaglavlja i primjeri kôda ostaju na engleskom: oni su ugovor.

Pravila koja vrijede za svaku narudžbu

Svaka duljina je u milimetrima; unit je samo prikazna jedinica.
Svaki iznos je Money u cijelim najmanjim jedinicama i svaka valuta jednaka je currency narudžbe.
Jedna narudžba je jedan workflow: workflow.mode određuje oblik popisa rezanja i plana (danas panel2d).
plan.planHash je SHA-256 kanonskog plana; token ponude ga veže, pa se promijenjeni plan otkriva.
Dokument je zatvoren i unutar v1 samo aditivan: nova polja su neobvezna, ništa se ne uklanja niti preimenuje.

Polja

Tablice ispod generirane su iz same JSON Schema; ista shema ugrađena je, nepromijenjena, i u dokument OpenAPI.

Opisi u ovoj tablici potječu iz engleskog ugovora (JSON Schema ili dokumenta OpenAPI).

Order

Polje	Tip	Obvezno	Opis
schemaVersion	1	da	—
idempotencyKey	string	da	The caller's replay key for POST /cfg/v1/order (P2-09): the same key returns the same order.
tenantId	string	da	—
configVersion	integer	da	The tenant-config snapshot this order was priced against. Capped at 2^53−1 (one JSON text per integer, so one hash / token claim per version).
workflow	Workflow	da	—
customerRef	string	ne	Opaque reference into the merchant's own customer records. Never a name or an address.
customerGroup	string	ne	The tenant-config customer group the price list was chosen for.
locale	"en" \| "de" \| "it" \| "fr" \| "pl" \| "cs" \| "ro" \| "hu" \| "es" \| "hr"	da	—
unit	"mm" \| "cm" \| "in"	da	Display unit at ordering time; every length in this document is millimetres.
currency	string	da	—
pricingMode	"platform" \| "external"	da	—
createdAt	string	da	—
expiresAt	string	da	Quote validity; equals the token's exp.
source	Source	da	—
cutList	CutPart[]	da	MODE-DISCRIMINATED by workflow.mode (Order.allOf). One branch today: panel2d CutPart.
fullSheets	FullSheetItem[]	da	Full stock units bought uncut. MODE-DISCRIMINATED; panel2d: whole sheets.
hardware	HardwareLine[]	da	Mode-independent (catalogue hardware).
bondedPanels	BondedPanel[]	ne	Glued multi-layer panels (P5-05). MODE-DISCRIMINATED; panel2d only today. Shape may gain optional fields there; this is the v1 minimum.
plan	Plan	da	MODE-DISCRIMINATED; the plan carries its own `mode` tag (= workflow.mode), covered by planHash.
quote	Quote	da	—
shipping	OrderShipping	ne	—
files	FileRef[]	ne	—
signature	Signature	ne	—

Workflow

The tenant workflow this order was made in (tenant-config.v1 workflows[].id, or `default` for the implicit workflow). `mode` and `profile` are repeated so a consumer can dispatch without fetching the config; the quote token binds `id` and `mode`.

Polje	Tip	Obvezno	Opis
id	string	da	—
mode	"panel2d"	da	A BUILT mode (x-cfg-modes.built). Reserved ⇒ `mode_unavailable`; unknown ⇒ `enum`.
profile	"furniture"	da	—

Source

Provenance: which embed build collected the list, which engine version produced the plan, which config snapshot priced it.

Polje	Tip	Obvezno	Opis
embedVersion	string	da	—
engineVersion	string	da	= plan.engineVersion (the Engine API's engineVersion).
configVersion	integer	da	= $.configVersion.

CutPart

panel2d cut-list row = Engine API ApiPart2D (name, w, h, qty, rotatable, grain, grainGroup, priority, edgeBanding, material, meta) + the order's own id, group and machining. name/qty/material are REQUIRED here (optional on the API).

Polje	Tip	Obvezno	Opis
id	string	da	—
name	string	da	No C0/C1 control characters (audit P7-01 F1: a newline in a name wrote DXF entities).
w	number	da	The size the engine was given (after the tenant's dimension convention / edging deduction were applied).
h	number	da	—
qty	integer	da	—
material	string	da	Catalogue MaterialItem.id (the API's material partition key).
rotatable	boolean	ne	—
grain	"w" \| "h"	ne	—
grainGroup	string	ne	—
priority	boolean	ne	—
edgeBanding	EdgeBanding	ne	—
meta	object	ne	Opaque passthrough (= ApiPart2D.meta), ≤ 2048 bytes canonical.
group	string	ne	Room / cabinet / project the customer assigned; printed on labels and exports.
machining	MachiningOp[]	ne	—

EdgeBanding

Per-edge banding TYPE references (catalogue EdgingItem.id); an absent side is not banded (= ApiPart2D.edgeBanding).

Polje	Tip	Obvezno	Opis
top	string	ne	—
right	string	ne	—
bottom	string	ne	—
left	string	ne	—

MachiningOp

A machining operation on the part (catalogue MachiningType.id). `params` stays open in v1; P5-04 types its known keys additively (see params).

Polje	Tip	Obvezno	Opis
typeId	string	da	—
qty	integer	da	—
params	object	ne	Open object; the KNOWN keys are typed (P5-04, additive): corner, measure, xMm, yMm, diameterMm, radiusMm, lengthMm, widthMm, depthMm. Per catalogue kind: hole/hinge = corner+measure+xMm+yMm+diameterMm[+depthMm]; groove = corner(top-left\|top-right)+xMm+lengthMm[+widthMm+depthMm]; radius = corner+radiusMm. Any other key stays valid.

FullSheetItem

Polje	Tip	Obvezno	Opis
materialId	string	da	—
w	number	da	—
h	number	da	—
qty	integer	da	—

HardwareLine

Polje	Tip	Obvezno	Opis
hardwareId	string	da	—
qty	integer	da	—

BondedPanel

Polje	Tip	Obvezno	Opis
id	string	da	—
w	number	da	—
h	number	da	—
qty	integer	da	—
layers	BondedLayer[]	da	—
name	string	ne	—

BondedLayer

Polje	Tip	Obvezno	Opis
materialId	string	da	—
thicknessMm	number	da	—

Plan

The panel2d production plan as the Engine API returned it (ApiOptimize2DResponse fields), plus the `mode` tag and planHash. Numbers are the engine's own, in millimetres; sheets[].price / metrics.totalPrice are the engine's unit-less price fields, NOT money (prices live in `quote`).

Polje	Tip	Obvezno	Opis
mode	"panel2d"	da	The mode tag — INSIDE the plan so planHash covers it; must equal $.workflow.mode (D15).
engine	"heuristic" \| "balanced" \| "max"	da	—
engineVersion	string	da	—
deterministic	boolean	da	—
sheets	Sheet[]	da	—
metrics	Metrics2D	da	—
cutPlan	array \| null	da	null when the layout is not guillotine.
unplaced	Unplaced2D[]	da	—
warnings	string[]	da	—
guillotineValid	boolean	da	—
planHash	string	da	sha256 hex of canonicalize(plan without planHash) — RFC 8785; covers `mode`.

Sheet

= ApiSheet (types.ts).

Polje	Tip	Obvezno	Opis
w	number	da	—
h	number	da	—
price	number \| null	da	The engine's unit-less per-sheet price; the issuer passes null.
parts	PlacedPart2D[]	da	—
offcuts	Rect[]	ne	—
material	string	ne	—
grain	"w" \| "h"	ne	—
meta	object	ne	—

PlacedPart2D

= ApiPlacedPart2D (types.ts).

Polje	Tip	Obvezno	Opis
name	string	da	—
x	number	da	—
y	number	da	—
w	number	da	—
h	number	da	—
rotated	boolean	da	—
meta	object	ne	—

Rect

= ApiRect (types.ts).

Polje	Tip	Obvezno	Opis
x	number	da	—
y	number	da	—
w	number	da	—
h	number	da	—

Metrics2D

= ApiMetrics2D (types.ts), unchanged: cutLines (collinear cuts merged), sawPasses (every strip crossed), cutLength (mm, convention-independent).

Polje	Tip	Obvezno	Opis
sheetCount	integer	da	—
yieldPct	number	da	—
placed	integer	da	—
total	integer	da	—
cutLines	integer	da	—
sawPasses	integer	da	—
cutLength	number	da	—
totalPrice	number	da	—

CutStep

= ApiCutStep (types.ts): sheet is the 0-based index into plan.sheets, step restarts at 1 per sheet, stage is the 1-based machine pass.

Polje	Tip	Obvezno	Opis
sheet	integer	da	—
step	integer	da	—
axis	"h" \| "v"	da	—
pos	number	da	—
length	number	da	—
stage	integer	da	—

Unplaced2D

= ApiUnplaced2D (types.ts).

Polje	Tip	Obvezno	Opis
name	string	da	—
w	number	da	—
h	number	da	—
qty	integer	da	—

Quote

Polje	Tip	Obvezno	Opis
priced	boolean	da	false under pricingMode = external: lines carry quantities, every amount is 0.
lines	QuoteLine[]	da	—
totals	Totals	da	—
quoteToken	string	da	See x-cfg-quote-token. The merchant's server verifies it with the tenant's key (P4-02 /quote/verify).

QuoteLine

Polje	Tip	Obvezno	Opis
id	string	da	—
type	"cutPart" \| "fullSheet" \| "hardware" \| "machining" \| "bondedPanel" \| "edging" \| "surcharge" \| "shipping" \| "tax"	da	—
label	string	da	—
qty	number	da	Pieces, sheets, metres (edging) — the line's own unit.
unitAmount	Money	da	—
amount	Money	da	Line total after the tenant's rounding. Σ non-tax amounts = totals.net.
ref	LineRef	ne	—
meta	object	ne	—

LineRef

What the line prices. At least one id when present.

Polje	Tip	Obvezno	Opis
partId	string	ne	—
materialId	string	ne	—
edgingId	string	ne	—
hardwareId	string	ne	—
machiningId	string	ne	—
zoneId	string	ne	—
ruleId	string	ne	—
bondedPanelId	string	ne	—

Totals

Polje	Tip	Obvezno	Opis
net	Money	da	—
tax	Money	da	—
gross	Money	da	—

Money

Polje	Tip	Obvezno	Opis
amountMinor	integer	da	—
currency	string	da	—

OrderShipping

Ids only — the delivery address is the merchant shop's data, not the contract's.

Polje	Tip	Obvezno	Opis
method	"delivery" \| "pickup"	da	—
zoneId	string	ne	—
pickupLocationId	string	ne	—

FileRef

Polje	Tip	Obvezno	Opis
kind	"pdf" \| "labels" \| "csv" \| "dxf" \| "svg" \| "xlsx" \| "json"	da	—
url	string	da	—
sha256	string	ne	—
bytes	integer	ne	—

Signature

HMAC-SHA256 over canonicalize(order without signature). keyId names the tenant key (P2-07: derived from a master, the DB holds only the id).

Polje	Tip	Obvezno	Opis
alg	"HMAC-SHA256"	da	—
keyId	string	da	—
value	string	da	—

Gumba „isprobaj“ ovdje namjerno nema: tajni ključ pripada vašem poslužitelju, nikad pregledniku. Demo web shop prikazuje ugradnju i predaju narudžbe u radu od početka do kraja.

Otvori demo web shop uživo CutOptim Konfigurator

Pravne informacijeUvjeti konfiguratora (EN) ·Ugovor o obradi podataka (EN) ·Obavijest o privatnosti za kupce ·Licencije trećih strana (EN)