Documentul order.v1

Fiecare comandă înregistrată de Configurator este un document order.v1 semnat: fluxul în care a fost făcută, lista de tăiere, planul de producție, oferta cu preț și tokenul ei și de unde provine. Nu conține date personale, doar customerRef-ul dumneavoastră opac.

Căile, numele câmpurilor, codurile de eroare, numele anteturilor și exemplele de cod rămân în engleză: ele sunt contractul.

Reguli valabile pentru fiecare comandă

Fiecare lungime este în milimetri; unit este doar unitatea de afișare.
Fiecare sumă este Money în unități minore întregi, iar fiecare monedă este egală cu currency a comenzii.
O comandă înseamnă un singur flux: workflow.mode alege forma listei de tăiere și a planului (astăzi panel2d).
plan.planHash este SHA-256 al planului canonic; tokenul ofertei îl leagă, astfel că un plan modificat este detectat.
Documentul este închis și doar aditiv în v1: câmpurile noi sunt opționale, nimic nu este eliminat sau redenumit.

Câmpuri

Tabelele de mai jos sunt generate chiar din schema JSON; aceeași schemă este încorporată, neschimbată, în documentul OpenAPI.

Descrierile din acest tabel provin din contractul în engleză (schema JSON sau documentul OpenAPI).

Order

Câmp	Tip	Obligatoriu	Descriere
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	nu	Opaque reference into the merchant's own customer records. Never a name or an address.
customerGroup	string	nu	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[]	nu	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	nu	—
files	FileRef[]	nu	—
signature	Signature	nu	—

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`.

Câmp	Tip	Obligatoriu	Descriere
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.

Câmp	Tip	Obligatoriu	Descriere
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).

Câmp	Tip	Obligatoriu	Descriere
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	nu	—
grain	"w" \| "h"	nu	—
grainGroup	string	nu	—
priority	boolean	nu	—
edgeBanding	EdgeBanding	nu	—
meta	object	nu	Opaque passthrough (= ApiPart2D.meta), ≤ 2048 bytes canonical.
group	string	nu	Room / cabinet / project the customer assigned; printed on labels and exports.
machining	MachiningOp[]	nu	—

EdgeBanding

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

Câmp	Tip	Obligatoriu	Descriere
top	string	nu	—
right	string	nu	—
bottom	string	nu	—
left	string	nu	—

MachiningOp

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

Câmp	Tip	Obligatoriu	Descriere
typeId	string	da	—
qty	integer	da	—
params	object	nu	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

Câmp	Tip	Obligatoriu	Descriere
materialId	string	da	—
w	number	da	—
h	number	da	—
qty	integer	da	—

HardwareLine

Câmp	Tip	Obligatoriu	Descriere
hardwareId	string	da	—
qty	integer	da	—

BondedPanel

Câmp	Tip	Obligatoriu	Descriere
id	string	da	—
w	number	da	—
h	number	da	—
qty	integer	da	—
layers	BondedLayer[]	da	—
name	string	nu	—

BondedLayer

Câmp	Tip	Obligatoriu	Descriere
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`).

Câmp	Tip	Obligatoriu	Descriere
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).

Câmp	Tip	Obligatoriu	Descriere
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[]	nu	—
material	string	nu	—
grain	"w" \| "h"	nu	—
meta	object	nu	—

PlacedPart2D

= ApiPlacedPart2D (types.ts).

Câmp	Tip	Obligatoriu	Descriere
name	string	da	—
x	number	da	—
y	number	da	—
w	number	da	—
h	number	da	—
rotated	boolean	da	—
meta	object	nu	—

Rect

= ApiRect (types.ts).

Câmp	Tip	Obligatoriu	Descriere
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).

Câmp	Tip	Obligatoriu	Descriere
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.

Câmp	Tip	Obligatoriu	Descriere
sheet	integer	da	—
step	integer	da	—
axis	"h" \| "v"	da	—
pos	number	da	—
length	number	da	—
stage	integer	da	—

Unplaced2D

= ApiUnplaced2D (types.ts).

Câmp	Tip	Obligatoriu	Descriere
name	string	da	—
w	number	da	—
h	number	da	—
qty	integer	da	—

Quote

Câmp	Tip	Obligatoriu	Descriere
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

Câmp	Tip	Obligatoriu	Descriere
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	nu	—
meta	object	nu	—

LineRef

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

Câmp	Tip	Obligatoriu	Descriere
partId	string	nu	—
materialId	string	nu	—
edgingId	string	nu	—
hardwareId	string	nu	—
machiningId	string	nu	—
zoneId	string	nu	—
ruleId	string	nu	—
bondedPanelId	string	nu	—

Totals

Câmp	Tip	Obligatoriu	Descriere
net	Money	da	—
tax	Money	da	—
gross	Money	da	—

Money

Câmp	Tip	Obligatoriu	Descriere
amountMinor	integer	da	—
currency	string	da	—

OrderShipping

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

Câmp	Tip	Obligatoriu	Descriere
method	"delivery" \| "pickup"	da	—
zoneId	string	nu	—
pickupLocationId	string	nu	—

FileRef

Câmp	Tip	Obligatoriu	Descriere
kind	"pdf" \| "labels" \| "csv" \| "dxf" \| "svg" \| "xlsx" \| "json"	da	—
url	string	da	—
sha256	string	nu	—
bytes	integer	nu	—

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).

Câmp	Tip	Obligatoriu	Descriere
alg	"HMAC-SHA256"	da	—
keyId	string	da	—
value	string	da	—

Aici nu există intenționat un buton „încearcă”: cheia secretă aparține serverului dumneavoastră, niciodată unui browser. Magazinul demo arată integrarea și predarea comenzii funcționând de la cap la coadă.

Deschideți magazinul demo CutOptim Configurator

JuridicTermenii configuratorului (EN) ·Acord de prelucrare a datelor (EN) ·Notă de confidențialitate pentru cumpărători ·Licențe terțe (EN)