<!-- Extension API v0 — pre-1.0. Interfaces may change without notice until P2 seals the custom-code format. First-party extensions track HEAD. -->

# `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`](/reference/commands/channel.package.upsert), [`order.cancel`](/reference/commands/order.cancel), [`order.shipment.track`](/reference/commands/order.shipment.track), [`catalog.stock.adjust`](/reference/commands/catalog.stock.adjust)

Machine-readable body schema: [/schemas/routes/channel.package.op.json](/schemas/routes/channel.package.op.json).

## Body

```json
{
  "$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
}
```