{
  "title": "Dsco Order",
  "description": "Structure documentation for the Rithum Dsco platform order object",
  "type": "object",
  "fields": [
    { "name": "orderId", "type": "string", "required": true, "description": "Unique order identifier" },
    { "name": "orderType", "type": "enum", "values": ["Dropship", "Marketplace"], "required": true, "description": "Order integration type" },
    { "name": "status", "type": "enum", "values": ["pending", "acknowledged", "shipped", "cancelled", "returned", "invoiced"], "required": true, "description": "Order lifecycle status" },
    { "name": "createdAt", "type": "datetime", "required": false, "description": "Creation timestamp" },
    { "name": "updatedAt", "type": "datetime", "required": false, "description": "Last update timestamp" },
    { "name": "retailerId", "type": "string", "required": false, "description": "Retailer identifier" },
    { "name": "supplierId", "type": "string", "required": false, "description": "Supplier identifier" },
    { "name": "items", "type": "array", "required": false, "description": "Line items",
      "items": [
        { "name": "lineItemId", "type": "string", "required": true },
        { "name": "sku", "type": "string", "required": true, "description": "Supplier SKU" },
        { "name": "quantity", "type": "integer", "required": true },
        { "name": "cost", "type": "float", "required": false, "description": "Wholesale cost (required for dropship)" },
        { "name": "price", "type": "float", "required": false, "description": "Retail price" }
      ]
    },
    { "name": "shippingAddress", "type": "object", "required": false, "description": "Delivery address",
      "fields": [
        { "name": "name", "type": "string", "required": true },
        { "name": "street1", "type": "string", "required": true },
        { "name": "street2", "type": "string", "required": false },
        { "name": "city", "type": "string", "required": true },
        { "name": "state", "type": "string", "required": true },
        { "name": "postalCode", "type": "string", "required": true },
        { "name": "country", "type": "string", "required": true },
        { "name": "phone", "type": "string", "required": false }
      ]
    }
  ]
}