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/{id}/cancel
取消原始订单会一并取消其下全部请购单(级联询价单/比价单/报价单)与采购订单,并按子单结果聚合原始单状态:全部取消 → 3 已取消;已完成与已取消混合 → 4 部分取消。
执行口径:未发货的采购订单直接取消;部分发货或已发货未完成的采购订单由平台自动完结(无需审核,缺口按「接受缺口」结算),照常发出 purchase_order.completed 回调。
若存在已完成的采购订单,整个请求被拒绝(422「采购订单已完成,不允许取消」),不做部分执行、不修改任何数据。
返回 200 表示当代全部子单已取消/完结完成(终态可为 3/2/4,以 split_error 为空为准);未能全部完成时接口返回失败(非 200),message 给出受阻原因与已取消子单清单,已取消的子单不回滚,请重发本接口从断点继续(已处理的子单会跳过),不要改走创建接口。原始单已取消时幂等返回当前详情。若该单有一笔未完成的明细重建,取消会将其一并放弃。取消与拆分/重建互斥,正在处理时返回 422,稍后重发即可。

请求参数

Path 参数

Query 参数

Body 参数application/json

示例
{
    "reason": "外部平台退款",
    "raw_order_no": "EXT20250101001"
}

请求示例代码

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//cancel?raw_order_no=' \
--header 'Content-Type: application/json' \
--data '{
    "reason": "外部平台退款",
    "raw_order_no": "EXT20250101001"
}'

返回响应

🟢200
application/json
取消成功后的原始订单详情(当代子单全部达终态:3 已取消 / 2 已完成 / 4 部分取消;未能全部完成时本接口直接返回失败,不会返回 200)
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