Cesty, názvy polí, chybové kódy, názvy hlaviček a ukázky kódu zůstávají anglicky: jsou součástí kontraktu.
Pole
Tabulky níže jsou vygenerovány přímo z JSON Schema; totéž schéma je beze změny vloženo i do dokumentu OpenAPI.
Popisy v této tabulce pocházejí z anglického kontraktu (JSON Schema nebo dokumentu OpenAPI).
Order
| Pole | Typ | Povinné | Popis |
|---|
| schemaVersion | 1 | ano | — |
| idempotencyKey | string | ano | The caller's replay key for POST /cfg/v1/order (P2-09): the same key returns the same order. |
| tenantId | string | ano | — |
| configVersion | integer | ano | 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 | ano | — |
| 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" | ano | — |
| unit | "mm" | "cm" | "in" | ano | Display unit at ordering time; every length in this document is millimetres. |
| currency | string | ano | — |
| pricingMode | "platform" | "external" | ano | — |
| createdAt | string | ano | — |
| expiresAt | string | ano | Quote validity; equals the token's exp. |
| source | Source | ano | — |
| cutList | CutPart[] | ano | MODE-DISCRIMINATED by workflow.mode (Order.allOf). One branch today: panel2d CutPart. |
| fullSheets | FullSheetItem[] | ano | Full stock units bought uncut. MODE-DISCRIMINATED; panel2d: whole sheets. |
| hardware | HardwareLine[] | ano | 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 | ano | MODE-DISCRIMINATED; the plan carries its own `mode` tag (= workflow.mode), covered by planHash. |
| quote | Quote | ano | — |
| 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`.
| Pole | Typ | Povinné | Popis |
|---|
| id | string | ano | — |
| mode | "panel2d" | ano | A BUILT mode (x-cfg-modes.built). Reserved ⇒ `mode_unavailable`; unknown ⇒ `enum`. |
| profile | "furniture" | ano | — |
Source
Provenance: which embed build collected the list, which engine version produced the plan, which config snapshot priced it.
| Pole | Typ | Povinné | Popis |
|---|
| embedVersion | string | ano | — |
| engineVersion | string | ano | = plan.engineVersion (the Engine API's engineVersion). |
| configVersion | integer | ano | = $.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).
| Pole | Typ | Povinné | Popis |
|---|
| id | string | ano | — |
| name | string | ano | No C0/C1 control characters (audit P7-01 F1: a newline in a name wrote DXF entities). |
| w | number | ano | The size the engine was given (after the tenant's dimension convention / edging deduction were applied). |
| h | number | ano | — |
| qty | integer | ano | — |
| material | string | ano | 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).
| Pole | Typ | Povinné | Popis |
|---|
| 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).
| Pole | Typ | Povinné | Popis |
|---|
| typeId | string | ano | — |
| qty | integer | ano | — |
| 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
| Pole | Typ | Povinné | Popis |
|---|
| materialId | string | ano | — |
| w | number | ano | — |
| h | number | ano | — |
| qty | integer | ano | — |
HardwareLine
| Pole | Typ | Povinné | Popis |
|---|
| hardwareId | string | ano | — |
| qty | integer | ano | — |
BondedPanel
| Pole | Typ | Povinné | Popis |
|---|
| id | string | ano | — |
| w | number | ano | — |
| h | number | ano | — |
| qty | integer | ano | — |
| layers | BondedLayer[] | ano | — |
| name | string | ne | — |
BondedLayer
| Pole | Typ | Povinné | Popis |
|---|
| materialId | string | ano | — |
| thicknessMm | number | ano | — |
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`).
| Pole | Typ | Povinné | Popis |
|---|
| mode | "panel2d" | ano | The mode tag — INSIDE the plan so planHash covers it; must equal $.workflow.mode (D15). |
| engine | "heuristic" | "balanced" | "max" | ano | — |
| engineVersion | string | ano | — |
| deterministic | boolean | ano | — |
| sheets | Sheet[] | ano | — |
| metrics | Metrics2D | ano | — |
| cutPlan | array | null | ano | null when the layout is not guillotine. |
| unplaced | Unplaced2D[] | ano | — |
| warnings | string[] | ano | — |
| guillotineValid | boolean | ano | — |
| planHash | string | ano | sha256 hex of canonicalize(plan without planHash) — RFC 8785; covers `mode`. |
Sheet
= ApiSheet (types.ts).
| Pole | Typ | Povinné | Popis |
|---|
| w | number | ano | — |
| h | number | ano | — |
| price | number | null | ano | The engine's unit-less per-sheet price; the issuer passes null. |
| parts | PlacedPart2D[] | ano | — |
| offcuts | Rect[] | ne | — |
| material | string | ne | — |
| grain | "w" | "h" | ne | — |
| meta | object | ne | — |
PlacedPart2D
= ApiPlacedPart2D (types.ts).
| Pole | Typ | Povinné | Popis |
|---|
| name | string | ano | — |
| x | number | ano | — |
| y | number | ano | — |
| w | number | ano | — |
| h | number | ano | — |
| rotated | boolean | ano | — |
| meta | object | ne | — |
Rect
= ApiRect (types.ts).
| Pole | Typ | Povinné | Popis |
|---|
| x | number | ano | — |
| y | number | ano | — |
| w | number | ano | — |
| h | number | ano | — |
Metrics2D
= ApiMetrics2D (types.ts), unchanged: cutLines (collinear cuts merged), sawPasses (every strip crossed), cutLength (mm, convention-independent).
| Pole | Typ | Povinné | Popis |
|---|
| sheetCount | integer | ano | — |
| yieldPct | number | ano | — |
| placed | integer | ano | — |
| total | integer | ano | — |
| cutLines | integer | ano | — |
| sawPasses | integer | ano | — |
| cutLength | number | ano | — |
| totalPrice | number | ano | — |
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.
| Pole | Typ | Povinné | Popis |
|---|
| sheet | integer | ano | — |
| step | integer | ano | — |
| axis | "h" | "v" | ano | — |
| pos | number | ano | — |
| length | number | ano | — |
| stage | integer | ano | — |
Unplaced2D
= ApiUnplaced2D (types.ts).
| Pole | Typ | Povinné | Popis |
|---|
| name | string | ano | — |
| w | number | ano | — |
| h | number | ano | — |
| qty | integer | ano | — |
Quote
| Pole | Typ | Povinné | Popis |
|---|
| priced | boolean | ano | false under pricingMode = external: lines carry quantities, every amount is 0. |
| lines | QuoteLine[] | ano | — |
| totals | Totals | ano | — |
| quoteToken | string | ano | See x-cfg-quote-token. The merchant's server verifies it with the tenant's key (P4-02 /quote/verify). |
QuoteLine
| Pole | Typ | Povinné | Popis |
|---|
| id | string | ano | — |
| type | "cutPart" | "fullSheet" | "hardware" | "machining" | "bondedPanel" | "edging" | "surcharge" | "shipping" | "tax" | ano | — |
| label | string | ano | — |
| qty | number | ano | Pieces, sheets, metres (edging) — the line's own unit. |
| unitAmount | Money | ano | — |
| amount | Money | ano | 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.
| Pole | Typ | Povinné | Popis |
|---|
| partId | string | ne | — |
| materialId | string | ne | — |
| edgingId | string | ne | — |
| hardwareId | string | ne | — |
| machiningId | string | ne | — |
| zoneId | string | ne | — |
| ruleId | string | ne | — |
| bondedPanelId | string | ne | — |
Money
| Pole | Typ | Povinné | Popis |
|---|
| amountMinor | integer | ano | — |
| currency | string | ano | — |
OrderShipping
Ids only — the delivery address is the merchant shop's data, not the contract's.
| Pole | Typ | Povinné | Popis |
|---|
| method | "delivery" | "pickup" | ano | — |
| zoneId | string | ne | — |
| pickupLocationId | string | ne | — |
FileRef
| Pole | Typ | Povinné | Popis |
|---|
| kind | "pdf" | "labels" | "csv" | "dxf" | "svg" | "xlsx" | "json" | ano | — |
| url | string | ano | — |
| 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).
| Pole | Typ | Povinné | Popis |
|---|
| alg | "HMAC-SHA256" | ano | — |
| keyId | string | ano | — |
| value | string | ano | — |