channel.package.op

Act on a marketplace package: status (preparing/invoiced), unsupplied (penalty acknowledged), split, invoice hand-off, cargo (carrier/box/warehouse/extend/own-carrier).

• method + path: POST /v1/orders/{ord}/channel/{chop}
• TR label: Pazaryeri paketi güncellendi
• auth: authenticated · scope gates: any of admin, orders:read, orders:write — “Siparişleri yalnızca mağaza sahibi görebilir”; then any of admin, orders:write — “Bu işlem için yetki yok”
• agentPolicy: propose — a live mutation — an Ajan token's call is recorded into its open proposal (202 proposed: true); a Geliştirici token executes it directly.
• effects: provider, db
• idempotency: server — the platform derives the key
• wraps: channel.package.upsert, order.cancel, order.shipment.track, catalog.stock.adjust

Machine-readable body schema: /schemas/routes/channel.package.op.json.

Body

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "packageId": {
      "type": "string",
      "pattern": "^pkg_[0-9A-HJKMNP-TV-Z]{26}$"
    },
    "status": {
      "type": "string",
      "enum": [
        "preparing",
        "invoiced",
        "shipped",
        "delivered",
        "returned"
      ]
    },
    "invoiceNumber": {
      "type": "string",
      "maxLength": 32
    },
    "lines": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "orderLineId": {
            "type": "string",
            "pattern": "^oln_[a-zA-Z0-9]{1,32}$"
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 99
          }
        },
        "required": [
          "orderLineId",
          "qty"
        ],
        "additionalProperties": false
      }
    },
    "reason": {
      "type": "string",
      "maxLength": 16
    },
    "acknowledgePenalty": {
      "type": "boolean",
      "const": true
    },
    "groups": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "minItems": 1,
        "maxItems": 50,
        "type": "array",
        "items": {
          "type": "string",
          "pattern": "^oln_[a-zA-Z0-9]{1,32}$"
        }
      }
    },
    "invoiceLink": {
      "type": "string",
      "maxLength": 300,
      "format": "uri"
    },
    "invoiceDateTime": {
      "type": "string",
      "maxLength": 40
    },
    "carrier": {
      "type": "string",
      "maxLength": 24
    },
    "boxQuantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 99
    },
    "deci": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000
    },
    "warehouseId": {
      "type": "string",
      "maxLength": 24
    },
    "extendDays": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3
    },
    "trackingInfo": {
      "type": "string",
      "maxLength": 300
    },
    "trackingIsPhone": {
      "type": "boolean"
    },
    "manual": {
      "type": "string",
      "enum": [
        "delivered",
        "returned"
      ]
    }
  },
  "additionalProperties": false
}