创建订单

在当前企业创建 LTC 订单，可保存草稿或创建后立即提交审批。

幂等规则

幂等键为 corp_id + operation(order_create) + request_id。

网络超时或未收到响应时，使用完全相同的 request_id 和业务参数重试。

成功重放返回原订单且 idempotent_replay=true；同 request_id 改变业务参数返回 22408。

product_list、returned_money、custom_fields 的数组顺序属于幂等摘要的一部分。

购买方规则

buyer_type=contact：必须传 buyer_id，禁止传 buyer_ext_id。

buyer_type=external_user：必须传 buyer_ext_id；buyer_id 可不传。

通用错误码

错误码	含义
10001	access_token 未设置、错误或过期
10045	limit 超过最大值 50
10046	offset 非法或超出范围
10047	limit 不是正整数
10048	时间参数不是 10 位秒级或 13 位毫秒级时间戳
10049	参数格式、组合、枚举或请求体校验失败
22401	企业未开通对应的 LTC OpenAPI 能力
22403	订单、商品、回款等资源不存在或不属于当前企业
22414	LTC 服务暂不可用
22415	LTC 内部处理异常或响应不符合契约
22416	LTC 服务契约版本不受支持

创建专用错误码

错误码	含义
22402	操作员工无效或没有 LTC 席位
22408	同一 operation + request_id 已成功，但本次业务参数不同
22409	相同幂等请求正在处理中，可稍后使用原请求重试
22410	订单参数未通过 LTC 权威校验
22411	商品/SKU 已变化、下架、库存不足或其他状态无效
22412	员工、部门、客户、组织、商机、自定义字段或回款关联无效
22413	权威商品价格、折扣、订单总额或回款金额校验失败

请求参数

Query 参数

Body 参数application/json必填

示例

创建 contact 草稿创建 external_user 并提交审批

{
  "request_id": "ltc-order-create-20260730-001",
  "operator_staff_id": "SuMao",
  "submit_for_approval": false,
  "order_number": "OPENAPI-ORDER-001",
  "buyer_type": "contact",
  "buyer_id": "100136400",
  "staff_ext_id": "SuMao",
  "department_ext_id": "9",
  "organization_id": "100105842",
  "source": "WTRWE",
  "remark": "OpenAPI 创建订单示例",
  "address": {
    "province": "广东省",
    "municipality": "深圳市",
    "district": "南山区",
    "info": "示例地址"
  },
  "receiver_name": "示例收货人",
  "receiver_mobile": "13800000000",
  "receiver_address": "广东省深圳市南山区示例地址",
  "product_list": [
    {
      "name": "示例商品",
      "sku_id": "100096943",
      "spec_param": {
        "default": "ltc_default_spec"
      },
      "count": 1,
      "discount": 100,
      "fix_price": "1.00",
      "amount": "1.00"
    }
  ],
  "contract_list": [],
  "returned_money": [],
  "custom_fields": []
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

HTTP 状态通常为 200，请以 errcode 判断业务结果。errcode=0 表示成功。

Bodyapplication/json

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "request_id": "ltc-order-create-20260730-001",
        "order_id": "240052097",
        "order_number": "OPENAPI-ORDER-001",
        "order_status": "unpaid",
        "audit_status": "unsubmitted",
        "audit_node_number": null,
        "idempotent_replay": false
    }
}

幂等规则#

购买方规则#

通用错误码#