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

提交发货(支持分批发货)

POST
/open-api/v1/supplier/order/{id}/complete-shipping
可多次调用,每次只提交本批发货明细;未发完订单保持 status=7(部分发货),全部发完自动转 status=2(ship_type=1)。建议每次传 request_no 以保证幂等(同一 request_no 重试返回首次处理结果快照且 duplicated=true,不重复入账、不重发回调;快照里的 status / ship_type / shipped_* / total_* / settle_* / last_ship_time 均为该批首次处理完成时的时点值,不会因后续发货或完结审核而改变;settle_base_amount 直接回放首次落库的快照值,不重新换汇,与首次响应逐字相同)。向后兼容:完全未传 items 字段视为旧契约的「按剩余量全量发货」;显式传 [] 或 null 返回 422。

请求参数

Path 参数

Body 参数application/json

示例
{
    "items": [
        {
            "item_id": 1001,
            "quantity": "20.0000"
        }
    ],
    "request_no": "api-20250801-0001",
    "ship_images": [
        "https://cdn.example.com/ship1.jpg"
    ],
    "ship_remark": "第一批交付"
}

请求示例代码

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/supplier/order//complete-shipping' \
--header 'Content-Type: application/json' \
--data '{
    "items": [
        {
            "item_id": 1001,
            "quantity": "20.0000"
        }
    ],
    "request_no": "api-20250801-0001",
    "ship_images": [
        "https://cdn.example.com/ship1.jpg"
    ],
    "ship_remark": "第一批交付"
}'

返回响应

🟢200
application/json
操作成功
Bodyapplication/json

示例
{
    "code": 200,
    "message": "success",
    "data": {
        "duplicated": false,
        "purchase_order_id": 501,
        "purchase_order_no": "PO202507310001",
        "status": 7,
        "status_text": "部分发货",
        "shipment_no": "SH202508010001",
        "request_no": "api-20250801-0001",
        "batch_quantity": "20.0000",
        "batch_amount": "1000.00",
        "is_final": 0,
        "ship_time": "2025-08-01 10:00:00",
        "last_ship_time": "2025-08-01 10:00:00",
        "currency": "USD",
        "total_quantity": "100.0000",
        "total_amount": "5000.00",
        "shipped_quantity": "60.0000",
        "shipped_amount": "3000.00",
        "settle_quantity": "100.0000",
        "settle_amount": "5000.00",
        "ship_type": 0,
        "ship_type_text": "未完结"
    }
}
修改于 2026-10-29 05:12:54
上一页
开始发货
下一页
申请完结(部分发货订单)
Built with