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. 原始订单

修改原始订单

PUT
/open-api/v1/buyer/raw-order/{id}
请求体与创建接口同结构,字段均可选,未显式传入视为不变;显式传入 items 视为整体替换明细(差异比对与行序无关)。
可修改:trade_info(交易信息,长文本) / character_name(角色名,最长 255) / attachments / out_buyer_id / out_buyer_email(交易信息,同步到其下全部请购单与采购订单,不触发回调);items(产品明细,传时每行的外部产品图标/编码/名称必填)。
不可修改:raw_order_no / currency / base_exchange_rate / channel_code(创建时必传、创建后锁定),以及本期不支持的 remark / pay_time / deadline_at,传入不同值返回 422。
明细变更会作废其下请购单并按新明细重建,成倍发出 order.cancelled / order.created 回调;响应 rebuild_stage > 0 表示该次重建未完,请用**完全相同的请求体(含 items)**重发本接口续跑,不带明细的请求或其他接口均无法续跑。
明细变更时,其下任一采购订单已提交发货或已完成、或原始单已完成/已取消时整体拒绝 422(已发货请改走采购订单变更流程),本次不修改任何数据;仅同步交易信息(请求不含 items 变更)时不受已发货限制,即使其下采购订单已发货也允许直接同步,只刷新子单与采购订单的交易快照、不改流程与状态。该单正在被处理时同样返回 422,稍后原样重发即可。

请求参数

Path 参数

Query 参数

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 --request PUT 'https://api.gamescm.com/open-api/v1/buyer/raw-order/?raw_order_no=' \
--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
修改后的原始订单详情
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