read.internal.routing_suggestion

Which warehouse would serve qty of a SKU, and whether it would be a backorder — the same deterministic rule the reserve path routes with (lowest priority with stock; the default breaks ties; a warehouse that sells past zero is the fallback). Returns nothing when no active warehouse can serve the line. Internal face only.

• Surface: GET /v1/read/internal/routing_suggestion · MCP tool read.internal.routing_suggestion
• Auth: ★ Internal read (operator) — a tenant credential is REQUIRED; requires the logistics.read scope. The tenant is resolved from the CALLER’s identity, never from store. Personal fields come back MASKED for an actor without pii.read (the shape is unchanged).

Params (JSON Schema)

{
  "properties": {
    "qty": {
      "default": 1,
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "type": "integer"
    },
    "sku_id": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "sku_id"
  ],
  "type": "object"
}

Result (200)

Open (unknown) — this capability does not declare an output schema.

Errors

validation_failed (400) · not_found (404) · unauthorized (401) · forbidden (403)