1. 原始订单
OpenApi
  • API 说明文档
  • 基础档案
    • 游戏列表
      GET
    • 平台列表
      GET
    • 产品列表
      GET
    • 批量设置产品阶梯销售价
      POST
    • 区服列表(树形)
      GET
    • 渠道列表
      GET
    • 批量设置产品毛利率
      POST
    • 产品分类列表(树形)
      GET
    • 添加产品
      POST
    • 添加产品库产品
      POST
    • 游戏档案全量拉取(增量同步)
      GET
    • 平台档案全量拉取(增量同步)
      GET
    • 区服档案全量拉取(增量同步)
      GET
    • 当前租户币种设置
      GET
    • 获取销售价格管理列表
      GET
  • 采购商
    • 原始订单
      • 创建原始订单
        POST
      • 修改原始订单
        PUT
      • 修改原始订单交易信息
        PUT
      • 取消原始订单
        POST
      • 暂停原始订单
        POST
      • 恢复原始订单
        POST
    • 请购单
      • 订单列表
      • 订单详情
      • 更新订单
      • 删除订单
      • 创建订单
      • 暂停订单
      • 恢复订单
      • 取消订单
      • 放弃剩余数量
      • 创建询价
      • 追加询价
      • 重新派单
    • 询价
      • 询价单列表
      • 询价单详情
      • 发布询价单
      • 取消询价单
      • 手动添加供应商
      • 移除供应商
    • 报价
      • 报价列表
      • 报价详情
    • 比价
      • 比价单列表
      • 比价单详情
      • 从询价单创建比价单
      • 选标(分配中标+生成PO)
      • 取消比价单
    • 采购订单
      • 采购订单列表
      • 采购订单详情
      • 暂停采购订单
      • 恢复采购订单
      • 取消采购订单
      • 处理问题单
      • 完结申请审核
      • 催单采购订单
    • 订单变更
      • 变更列表
      • 变更详情
      • 发起变更
    • 对账单
      • 对账单列表
      • 对账单详情
      • 采购商确认对账
      • 采购商发起争议
      • 解决争议
      • 作废对账单
      • 重新生成对账单
    • 付款
      • 付款列表
      • 付款详情
      • 发起付款申请
      • 审批通过
      • 审批驳回
      • 重新提交
      • 登记付款
  • 供应商
    • 询价
      • 询价单列表
      • 询价单详情
    • 报价
      • 报价列表
      • 报价详情
      • 提交报价
      • 作废报价
      • 报价结果列表(含报价明细)
      • 报价结果详情
    • 客户订单
      • 客户订单列表
      • 客户订单详情
      • 开始发货
      • 提交发货(支持分批发货)
      • 申请完结(部分发货订单)
      • 上报问题
    • 订单变更
      • 变更列表
      • 变更详情
      • 确认变更
      • 拒绝变更
    • 对账单
      • 对账单列表
      • 对账单详情
      • 供应商确认对账
      • 供应商发起争议
    • 收款
      • 收款列表
      • 收款详情
      • 关联对账单
  1. 原始订单

创建原始订单

POST
/open-api/v1/buyer/raw-order
一张外部订单可同时包含多个游戏/平台/区服的产品:平台按「游戏 + 平台 + 区服」分组,同步拆成多张整单模式请购单(每张自动创建并发布询价单),响应返回原始订单主体与其下子请购单列表。
请求要点:订单头不接受 game_id / platform_id / server_id / allow_split_supplier,传入即 422;明细的 external_product_icon / external_product_code / external_product_name 均必填,会原值快照到子请购单明细;其余长度与取值限制见字段说明。
结果判定:返回 200 表示已受理,不表示全部拆完;请按响应 status(5=拆分失败)、split_error、rebuild_stage、deduplicated 判断是否需要重试及该走哪个接口。
重试与幂等:同一 raw_order_no 原样重发(含相同请求体)即从断点续跑,只补未建出的分组;已拆完时直接返回当前详情(deduplicated=true);重发内容与已存在的单不一致时返回 422,不会改写。子请购单号 = raw_order_no + -01/-02…。
派生限制与回调:拆出的子请购单不可再经 /buyer/order 创建、修改、取消或重新派单;一张外部单会按子单数量成倍发出 order.created 等回调,接收方需按事件 + 单号做幂等。

请求参数

Body 参数application/json必填

示例
{
    "raw_order_no": "EXT20250101001",
    "character_name": "角色A",
    "trade_info": "区服1,外部订单号 12345",
    "attachments": [
        "string"
    ],
    "channel_code": "dd373",
    "out_buyer_id": "88001234",
    "out_buyer_email": "buyer@example.com",
    "order_source": "douyin-shop",
    "deadline_at": "2025-01-02 10:00:00",
    "pay_time": "2025-01-01 10:00:00",
    "remark": "尽快发货",
    "items": [
        {
            "product_id": 101,
            "product_code": "MHXY",
            "external_product_name": "高级号10亿金币",
            "external_product_icon": "https://cdn.example.com/p/1.jpg",
            "external_product_code": "SKU-001",
            "external_product_description": "满级账号",
            "quantity": "2.0000",
            "unit_price": "100.000000",
            "total_price": "200.00"
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.gamescm.com/open-api/v1/buyer/raw-order' \
--header 'Content-Type: application/json' \
--data-raw '{
    "raw_order_no": "EXT20250101001",
    "character_name": "角色A",
    "trade_info": "区服1,外部订单号 12345",
    "attachments": [
        "string"
    ],
    "channel_code": "dd373",
    "out_buyer_id": "88001234",
    "out_buyer_email": "buyer@example.com",
    "order_source": "douyin-shop",
    "deadline_at": "2025-01-02 10:00:00",
    "pay_time": "2025-01-01 10:00:00",
    "remark": "尽快发货",
    "items": [
        {
            "product_id": 101,
            "product_code": "MHXY",
            "external_product_name": "高级号10亿金币",
            "external_product_icon": "https://cdn.example.com/p/1.jpg",
            "external_product_code": "SKU-001",
            "external_product_description": "满级账号",
            "quantity": "2.0000",
            "unit_price": "100.000000",
            "total_price": "200.00"
        }
    ]
}'

返回响应

🟢200
application/json
拆分结果(含 raw_order_id 与子请购单列表;status=5 表示需重试续跑)
Bodyapplication/json

示例
{
    "code": 200,
    "message": "success",
    "data": {
        "raw_order_id": 10,
        "raw_order_no": "EXT20250101001",
        "status": 1,
        "status_text": "进行中",
        "split_error": "",
        "rebuild_stage": 0,
        "deduplicated": false,
        "channel_code": "dd373",
        "out_buyer_id": "88001234",
        "out_buyer_email": "buyer@example.com",
        "order_source": "douyin-shop",
        "currency": "USD",
        "base_currency": "USD",
        "base_exchange_rate": "1.000000000000",
        "total_quantity": "4.0000",
        "total_amount": "400.00",
        "base_total_amount": "400.00",
        "orders": [
            {
                "out_order_id": 21,
                "out_order_no": "EXT20250101001-01",
                "out_order_status": 0,
                "game_name": "梦幻西游",
                "platform_name": "官方",
                "server_name": "一区",
                "total_quantity": "2.0000",
                "total_amount": "200.00",
                "currency": "USD",
                "item_count": 2
            },
            {
                "out_order_id": 22,
                "out_order_no": "EXT20250101001-02",
                "out_order_status": 0,
                "game_name": "梦幻西游",
                "platform_name": "官方",
                "server_name": "二区",
                "total_quantity": "2.0000",
                "total_amount": "200.00",
                "currency": "USD",
                "item_count": 2
            }
        ]
    }
}
修改于 2026-10-23 05:20:17
上一页
获取销售价格管理列表
下一页
修改原始订单
Built with