cart.assign_customer

Attach a cart to a customer’s account on their behalf, without their session — the telesales/agent/ERP step. The order then closes in that customer’s account, with the same pricing, promotions and stock any shopper would get (there is no draft-order path). Requires the purchase.on_behalf scope; it grants NO extra visibility of the customer’s data.

• Scope: purchase.on_behalf
• System: no
• Reachable from: POST /v1/commands/cart.assign_customer (tenant credential) · MCP tool cart.assign_customer · SDK client.call('cart.assign_customer', …)
• Events: none — Session state: it binds the cart to a customer for pricing and checkout, and the recognition event covers what a consumer would want to hear.

Input (JSON Schema)

{
  "properties": {
    "cart_id": {
      "minLength": 1,
      "type": "string"
    },
    "customer_id": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "cart_id",
    "customer_id"
  ],
  "type": "object"
}

Result (200)

{
  "additionalProperties": false,
  "properties": {
    "cart_id": {
      "type": "string"
    },
    "customer_id": {
      "type": "string"
    }
  },
  "required": [
    "cart_id",
    "customer_id"
  ],
  "type": "object"
}

Errors

validation_failed (400) · unauthorized (401) · forbidden (403) · conflict (409) · internal (500)