创建销售订单

使用 CRM 客户引用创建销售订单草稿。重试时必须复用同一个 Idempotency-Key。

Authorization

AuthorizationRequiredBearer <token>

在 Authorization header 中发送服务端 API Key；不要在浏览器或日志中保存完整凭证。

In: header

Request Body

application/jsonRequired

customer_idRequiredstring

warehouse_idRequiredstring

currencyRequiredstring

Pattern: "^[A-Z]{3}$"

linesRequiredarray<object>

Header Parameters

Idempotency-KeyRequiredstring

调用方生成的唯一请求键。

Format: "uuid"

Response Body

销售订单草稿已创建

idRequiredstring

numberRequiredstring

statusRequiredstring

Value in: "draft" | "confirmed" | "partially_shipped" | "shipped" | "closed"

customer_idRequiredstring

currencyRequiredstring

total_amountRequiredstring

versionRequiredinteger

Minimum: 1

created_atRequiredstring

Format: "date-time"

export interface Response {
  id: string;
  number: string;
  status: "draft" | "confirmed" | "partially_shipped" | "shipped" | "closed";
  customer_id: string;
  currency: string;
  total_amount: string;
  version: number;
  created_at: string;
}

curl -X POST "https://sandbox-api.orion.example/v1/erp/sales-orders" \
  -H "Idempotency-Key: 8b4e42c1-c36f-47cf-9686-83a9cfb6c546" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_01JQ6A8MZ3Y1",
    "warehouse_id": "wh_01JQ6AKT0R22",
    "currency": "CNY",
    "lines": [
      {
        "sku": "SKU-ALPHA-01",
        "quantity": "12",
        "unit_price": "199.00"
      }
    ]
  }'

{
  "id": "so_01JQ6B1F9P0C",
  "number": "SO-20260801-0012",
  "status": "draft",
  "customer_id": "cus_01JQ6A8MZ3Y1",
  "currency": "CNY",
  "total_amount": "2388.00",
  "version": 1,
  "created_at": "2026-08-01T08:35:00Z"
}