Definitions deep dive

entity: manufacturer
fields:
  name: { type: string, required: true, unique: true }

entity: product
traits: [auditable, stockable]
fields:
  sku:              { type: string, required: true, unique: true }   # internal article number
  name:             { type: string, required: true }
  unit:             { type: enum, values: [pcs, box, pallet], default: pcs }
  taxRate:         { type: enum, values: [standard, reduced], default: standard }
  manufacturer:     { type: ref, to: manufacturer, required: true }
  manufacturerSku: { type: string }
unique: [[manufacturer, manufacturerSku]]
relations:                                   # reverse references, readable via expand
  offers:      { entity: supplierProduct, by: product }
  salesPrices: { entity: salesPrice, by: product }
views:
  full: { expand: [manufacturer, offers.supplier, offers.purchasePrices, salesPrices] }

entity: supplierProduct                     # one product, many suppliers
fields:
  product:       { type: ref, to: product, required: true }
  supplier:      { type: ref, to: supplier, required: true }
  supplierSku:  { type: string, required: true }
  packSize:     { type: quantity }
  leadTimeDays: { type: integer }
  preferred:     { type: boolean, default: false }
unique: [[product, supplier], [supplier, supplierSku]]
relations:
  purchasePrices: { entity: purchasePrice, by: supplierProduct }

entity: purchasePrice
traits: [auditable, effectiveDated: { key: [supplierProduct, minQty] }]
fields:
  supplierProduct: { type: ref, to: supplierProduct, required: true }
  minQty:          { type: quantity, required: true }   # quantity break
  price:            { type: money, required: true }      # net, in the supplier's currency

entity: salesChannel
fields:
  code:        { type: string, required: true, unique: true }   # shop, b2b, marketplace
  priceBasis: { type: enum, values: [net, gross], default: net }
  currencies:  { type: list, of: currency, default: [EUR] }   # e.g. [EUR, CHF, GBP]

entity: salesPrice                          # price list per channel and currency
traits: [auditable, effectiveDated: { key: [product, channel, price.currency, minQty] }]
fields:
  product: { type: ref, to: product, required: true }
  channel: { type: ref, to: salesChannel, required: true }
  minQty: { type: quantity, required: true, default: 1 }
  price:   { type: money, required: true }        # amount and ISO currency

entity: customerGroup                       # retail, wholesale, keyAccount
fields:
  code: { type: string, required: true, unique: true }

entity: discount
traits: [auditable, effectiveDated: { key: [customerGroup, appliesTo, target, minQty] }]
fields:
  customerGroup: { type: ref, to: customerGroup, required: true }
  channel:        { type: ref, to: salesChannel }            # empty = all channels
  appliesTo:     { type: enum, values: [product, manufacturer, all] }
  target:         { type: ref, to: [product, manufacturer] }  # empty when appliesTo = all
  minQty:        { type: quantity, default: 1 }
  percent:        { type: decimal, required: true }

entity: exchangeRate                        # for reporting, never to derive prices
traits: [effectiveDated: { key: [currency] }]
fields:
  currency: { type: string, required: true }  # ISO 4217, against the base currency
  rate:     { type: decimal, required: true }

GET /api/v1/sales-orders/019a2f3b-1d22-7c40-8a77-3e9b0c5d2f18?view=full
# same as ?expand=customer,lines.item.manufacturer

HTTP/1.1 200
{ "id": "019a2f3b-1d22-7c40-8a77-3e9b0c5d2f18", "number": "SO-2026-00128",
  "status": "confirmed", "version": 4,
  "customer": { "id": "019a2e77-...", "number": "C000042",
                "name": "Weber Bürobedarf" },
  "lines": [
    { "id": "019a2f3b-5e10-...", "qty": 4, "delivered": 0,
      "price": "89.00 EUR", "net": "356.00 EUR",
      "item": { "id": "019a1c02-...", "sku": "SKU-100",
                "name": "Desk lamp Arco",
                "manufacturer": { "id": "019a0b9d-...", "name": "Lumen GmbH" } } } ],
  "totals": { "net": "356.00 EUR", "tax": "67.64 EUR", "gross": "423.64 EUR" } }

POST /api/v1/sales-orders
Idempotency-Key: 4b1e9a0c
{ "customer": { "number": "C000042" },
  "lines": [ { "item": { "sku": "SKU-100" }, "qty": 4 },
             { "item": { "sku": "SKU-200" }, "qty": 1 } ] }

HTTP/1.1 201
# the server resolved customer and products by their business keys,
# took prices from the price list, copied sku, name and unit into each line,
# calculated tax and totals, assigned id and number, set status "received"

HTTP/1.1 422   (if something is wrong)
{ "type": "/problems/validation", "title": "Order is not valid",
  "errors": [ { "pointer": "/lines/1/item", "detail": "Unknown sku SKU-200" } ] }