Az elérési utak, mezőnevek, hibakódok, fejlécnevek és kódpéldák angolul maradnak: ezek jelentik a szerződést.
Mezők
Az alábbi táblázatokat magából a JSON Schemából generáljuk; ugyanez a séma változatlanul be van ágyazva az OpenAPI dokumentumba.
A táblázat leírásai az angol szerződésből származnak (a JSON Schemából vagy az OpenAPI dokumentumból).
Order
| Mező | Típus | Kötelező | Leírás |
|---|
| schemaVersion | 1 | igen | — |
| idempotencyKey | string | igen | The caller's replay key for POST /cfg/v1/order (P2-09): the same key returns the same order. |
| tenantId | string | igen | — |
| configVersion | integer | igen | 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 | igen | — |
| customerRef | string | nem | Opaque reference into the merchant's own customer records. Never a name or an address. |
| customerGroup | string | nem | The tenant-config customer group the price list was chosen for. |
| locale | "en" | "de" | "it" | "fr" | "pl" | "cs" | "ro" | "hu" | "es" | "hr" | igen | — |
| unit | "mm" | "cm" | "in" | igen | Display unit at ordering time; every length in this document is millimetres. |
| currency | string | igen | — |
| pricingMode | "platform" | "external" | igen | — |
| createdAt | string | igen | — |
| expiresAt | string | igen | Quote validity; equals the token's exp. |
| source | Source | igen | — |
| cutList | CutPart[] | igen | MODE-DISCRIMINATED by workflow.mode (Order.allOf). One branch today: panel2d CutPart. |
| fullSheets | FullSheetItem[] | igen | Full stock units bought uncut. MODE-DISCRIMINATED; panel2d: whole sheets. |
| hardware | HardwareLine[] | igen | Mode-independent (catalogue hardware). |
| bondedPanels | BondedPanel[] | nem | Glued multi-layer panels (P5-05). MODE-DISCRIMINATED; panel2d only today. Shape may gain optional fields there; this is the v1 minimum. |
| plan | Plan | igen | MODE-DISCRIMINATED; the plan carries its own `mode` tag (= workflow.mode), covered by planHash. |
| quote | Quote | igen | — |
| shipping | OrderShipping | nem | — |
| files | FileRef[] | nem | — |
| signature | Signature | nem | — |
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`.
| Mező | Típus | Kötelező | Leírás |
|---|
| id | string | igen | — |
| mode | "panel2d" | igen | A BUILT mode (x-cfg-modes.built). Reserved ⇒ `mode_unavailable`; unknown ⇒ `enum`. |
| profile | "furniture" | igen | — |
Source
Provenance: which embed build collected the list, which engine version produced the plan, which config snapshot priced it.
| Mező | Típus | Kötelező | Leírás |
|---|
| embedVersion | string | igen | — |
| engineVersion | string | igen | = plan.engineVersion (the Engine API's engineVersion). |
| configVersion | integer | igen | = $.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).
| Mező | Típus | Kötelező | Leírás |
|---|
| id | string | igen | — |
| name | string | igen | No C0/C1 control characters (audit P7-01 F1: a newline in a name wrote DXF entities). |
| w | number | igen | The size the engine was given (after the tenant's dimension convention / edging deduction were applied). |
| h | number | igen | — |
| qty | integer | igen | — |
| material | string | igen | Catalogue MaterialItem.id (the API's material partition key). |
| rotatable | boolean | nem | — |
| grain | "w" | "h" | nem | — |
| grainGroup | string | nem | — |
| priority | boolean | nem | — |
| edgeBanding | EdgeBanding | nem | — |
| meta | object | nem | Opaque passthrough (= ApiPart2D.meta), ≤ 2048 bytes canonical. |
| group | string | nem | Room / cabinet / project the customer assigned; printed on labels and exports. |
| machining | MachiningOp[] | nem | — |
EdgeBanding
Per-edge banding TYPE references (catalogue EdgingItem.id); an absent side is not banded (= ApiPart2D.edgeBanding).
| Mező | Típus | Kötelező | Leírás |
|---|
| top | string | nem | — |
| right | string | nem | — |
| bottom | string | nem | — |
| left | string | nem | — |
MachiningOp
A machining operation on the part (catalogue MachiningType.id). `params` stays open in v1; P5-04 types its known keys additively (see params).
| Mező | Típus | Kötelező | Leírás |
|---|
| typeId | string | igen | — |
| qty | integer | igen | — |
| params | object | nem | 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
| Mező | Típus | Kötelező | Leírás |
|---|
| materialId | string | igen | — |
| w | number | igen | — |
| h | number | igen | — |
| qty | integer | igen | — |
HardwareLine
| Mező | Típus | Kötelező | Leírás |
|---|
| hardwareId | string | igen | — |
| qty | integer | igen | — |
BondedPanel
| Mező | Típus | Kötelező | Leírás |
|---|
| id | string | igen | — |
| w | number | igen | — |
| h | number | igen | — |
| qty | integer | igen | — |
| layers | BondedLayer[] | igen | — |
| name | string | nem | — |
BondedLayer
| Mező | Típus | Kötelező | Leírás |
|---|
| materialId | string | igen | — |
| thicknessMm | number | igen | — |
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`).
| Mező | Típus | Kötelező | Leírás |
|---|
| mode | "panel2d" | igen | The mode tag — INSIDE the plan so planHash covers it; must equal $.workflow.mode (D15). |
| engine | "heuristic" | "balanced" | "max" | igen | — |
| engineVersion | string | igen | — |
| deterministic | boolean | igen | — |
| sheets | Sheet[] | igen | — |
| metrics | Metrics2D | igen | — |
| cutPlan | array | null | igen | null when the layout is not guillotine. |
| unplaced | Unplaced2D[] | igen | — |
| warnings | string[] | igen | — |
| guillotineValid | boolean | igen | — |
| planHash | string | igen | sha256 hex of canonicalize(plan without planHash) — RFC 8785; covers `mode`. |
Sheet
= ApiSheet (types.ts).
| Mező | Típus | Kötelező | Leírás |
|---|
| w | number | igen | — |
| h | number | igen | — |
| price | number | null | igen | The engine's unit-less per-sheet price; the issuer passes null. |
| parts | PlacedPart2D[] | igen | — |
| offcuts | Rect[] | nem | — |
| material | string | nem | — |
| grain | "w" | "h" | nem | — |
| meta | object | nem | — |
PlacedPart2D
= ApiPlacedPart2D (types.ts).
| Mező | Típus | Kötelező | Leírás |
|---|
| name | string | igen | — |
| x | number | igen | — |
| y | number | igen | — |
| w | number | igen | — |
| h | number | igen | — |
| rotated | boolean | igen | — |
| meta | object | nem | — |
Rect
= ApiRect (types.ts).
| Mező | Típus | Kötelező | Leírás |
|---|
| x | number | igen | — |
| y | number | igen | — |
| w | number | igen | — |
| h | number | igen | — |
Metrics2D
= ApiMetrics2D (types.ts), unchanged: cutLines (collinear cuts merged), sawPasses (every strip crossed), cutLength (mm, convention-independent).
| Mező | Típus | Kötelező | Leírás |
|---|
| sheetCount | integer | igen | — |
| yieldPct | number | igen | — |
| placed | integer | igen | — |
| total | integer | igen | — |
| cutLines | integer | igen | — |
| sawPasses | integer | igen | — |
| cutLength | number | igen | — |
| totalPrice | number | igen | — |
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.
| Mező | Típus | Kötelező | Leírás |
|---|
| sheet | integer | igen | — |
| step | integer | igen | — |
| axis | "h" | "v" | igen | — |
| pos | number | igen | — |
| length | number | igen | — |
| stage | integer | igen | — |
Unplaced2D
= ApiUnplaced2D (types.ts).
| Mező | Típus | Kötelező | Leírás |
|---|
| name | string | igen | — |
| w | number | igen | — |
| h | number | igen | — |
| qty | integer | igen | — |
Quote
| Mező | Típus | Kötelező | Leírás |
|---|
| priced | boolean | igen | false under pricingMode = external: lines carry quantities, every amount is 0. |
| lines | QuoteLine[] | igen | — |
| totals | Totals | igen | — |
| quoteToken | string | igen | See x-cfg-quote-token. The merchant's server verifies it with the tenant's key (P4-02 /quote/verify). |
QuoteLine
| Mező | Típus | Kötelező | Leírás |
|---|
| id | string | igen | — |
| type | "cutPart" | "fullSheet" | "hardware" | "machining" | "bondedPanel" | "edging" | "surcharge" | "shipping" | "tax" | igen | — |
| label | string | igen | — |
| qty | number | igen | Pieces, sheets, metres (edging) — the line's own unit. |
| unitAmount | Money | igen | — |
| amount | Money | igen | Line total after the tenant's rounding. Σ non-tax amounts = totals.net. |
| ref | LineRef | nem | — |
| meta | object | nem | — |
LineRef
What the line prices. At least one id when present.
| Mező | Típus | Kötelező | Leírás |
|---|
| partId | string | nem | — |
| materialId | string | nem | — |
| edgingId | string | nem | — |
| hardwareId | string | nem | — |
| machiningId | string | nem | — |
| zoneId | string | nem | — |
| ruleId | string | nem | — |
| bondedPanelId | string | nem | — |
Money
| Mező | Típus | Kötelező | Leírás |
|---|
| amountMinor | integer | igen | — |
| currency | string | igen | — |
OrderShipping
Ids only — the delivery address is the merchant shop's data, not the contract's.
| Mező | Típus | Kötelező | Leírás |
|---|
| method | "delivery" | "pickup" | igen | — |
| zoneId | string | nem | — |
| pickupLocationId | string | nem | — |
FileRef
| Mező | Típus | Kötelező | Leírás |
|---|
| kind | "pdf" | "labels" | "csv" | "dxf" | "svg" | "xlsx" | "json" | igen | — |
| url | string | igen | — |
| sha256 | string | nem | — |
| bytes | integer | nem | — |
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).
| Mező | Típus | Kötelező | Leírás |
|---|
| alg | "HMAC-SHA256" | igen | — |
| keyId | string | igen | — |
| value | string | igen | — |