kdp open api
  1. 退换货
kdp open api
  • 使用须知
  • 访问凭证
    • 获取token
      POST
  • SAP
    • 分销商
      • 客户物料关系接收状态更新
      • 获取分销商staff-废弃
      • 获取dealer主数据(用这个)
      • 回传分销商dealer code和store code
      • 客户物料关系列表
    • 商品
      • 获取国家产品发布类型(寄售/非寄售)
      • 获取商品信息-废弃
      • 寄售商品主数据回传
      • 商品彩盒信息回传
      • 产品物料信息回传
    • 订单
      • 寄售商品
        • 销售订单列表(consignment issue)
        • 销售订单接收状态更新
        • 补货订单列表
        • 补货单接收状态更新
        • iot设备激活数据回传
        • sap-寄售结算订单库存回传上报
        • sap寄售订单延迟发货原因同步
      • 非寄售商品
        • 非寄售订单列表
        • 非寄售订单接收状态更新
        • sap非寄售订单延迟发货原因同步
    • 物流
      • 寄售商品补货订单发货信息回传
      • 寄售补货订单发货单DN回传
      • 非寄售商品订单发货信息回传
      • 非寄售补货订单发货单DN回传
    • 库存
      • dummy库存导入
      • SAP同步大库数据
      • RDC_STOCK库存信息回传
      • 库存在途信息回传(RDC intransit)
      • 获取所有取消中的补货发货单信息
      • 取消补货发货单回传
    • 发票
      • 发票信息回传
      • 订单发票文件上传
      • 上报AR open balance
    • 售后
      • 获取Warranty claim列表
      • Warranty 凭证信息回传接口
      • 报销凭证文件上传
      • 上报AP open balance
      • 配件历史数据更新Excel
    • 退换货
      • 销售订单列表(退换货)
        POST
      • 销售订单接收状态更新(退换货)
        POST
      • 补货订单列表(退换货)
        POST
      • 补货单接收状态更新(退换货)
        POST
      • 非寄售订单列表(退换货)
        POST
      • 非寄售订单接收状态更新(退换货)
        POST
  • QDS安装包上传
    • 美国正式环境
      POST
    • 欧洲正式环境
      POST
  • dealer邮件通知
    • dealer批量发送邮件
      POST
  • SSO
    • 获取code
      GET
    • 获取token
      POST
    • 刷新token
      POST
  • pds
    • (测试环境)获取PDS产品主数据_自有品牌
      POST
    • (测试环境)获取PDS产品主数据_客户品牌
      POST
    • (正式环境)获取PDS产品主数据_自有品牌
      POST
    • (正式环境)获取PDS产品主数据_客户品牌
      POST
    • (正式环境)获取PDS产品主数据_自有品牌 (内网)
      POST
  • onpage
    • onpage- category
    • onpage- image
    • onpage- key_feature
    • onpage- product
    • onpage- in the box
    • onpage- articles & bullet points
    • onpage- markets
    • onpage- article country
    • onpage- schema
    • onpage- technical_specification
    • onpage数据同步
    • onpage-拉取subcategories
    • onpage-拉取banners
    • onpage-拉取PDF
  • 注册平台
    • (开发环境)同步销售数据接口
    • 产品注册接口
    • 检查是否在质保期接口
  1. 退换货

补货订单列表(退换货)

开发中
POST
return-server/api/sap/replenishment/listReplenishment
获取补货订单列表

请求参数

Header 参数
Content-Type
string 
必需
消息体类型;取值:application/json;charset=utf-8
示例值:
application/json;charset=utf-8
sys
string 
必需
系统类型,取值:pp
示例值:
pp
token
string 
必需
访问凭证token;通过获取token接口获取
traceId
string 
必需
本次请求id,uuid
deviceType
integer 
取值:1
必需
示例值:
1
lang
string 
取值:en
必需
示例值:
en
uid
integer 
取值:1
必需
示例值:
1
Body 参数application/json
pageSize
integer 
必需
每页数据条数;服务端限制最大条数,大于限制值后,默认限制值
typeId
string 
业务类型id
必需
示例
{
  "pageSize": 10,
  "pageNumber": 1,
  "typeId": 1
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'return-server/api/sap/replenishment/listReplenishment' \
--header 'sys: pp' \
--header 'token;' \
--header 'traceId;' \
--header 'deviceType: 1' \
--header 'lang: en' \
--header 'uid: 1' \
--header 'Content-Type: application/json;charset=utf-8' \
--data-raw '{
  "pageSize": 10,
  "pageNumber": 1,
  "typeId": 1
}'

返回响应

🟢200成功
application/json
Body
code
integer 
操状态作码
必需
msg
string 
操作描述
必需
data
array [object {24}] 
必需
typeId
string 
必需
业务类型id,参考清单页
orderType
integer 
1、正向 2、反向
必需
mergedOrderNo
string 
合并单号
必需
orderId
string 
退换货不传
必需
dealerId
number 
必需
分销商id,long型
sapDealerCode
string 
必需
sap生成的dealer id
storeId
string 
送达方门店id
必需
sapStoreCode
string 
sap门店code
必需
countryCode
string 
国家代码(CN)
必需
stateCode
string 
州或省编码
必需
cityName
string 
城市名称
必需
address
string 
具体地址
必需
contactPhone
string 
联系方式电话
必需
marketUnit
string 
市场单元
必需
deliveryTime
string 
必需
预计发货时间(格式化后的字符串)
receivingTime
string 
可选
预计到达时间(格式化后的字符串)
orderNote
string 
订单备注
可选
createTime
string 
必需
订单生成时间,long型
orderDate
string 
必需
销售时间(格式化后)
virtualOrder
boolean 
必需
true: 虚拟订单, false:真实订单(退换货是真实订单)
optStatus
integer 
必需
状态,1:新增,2:修改,3:删除
orderReason
string 
必需
订单原因code,退货单必须有
stockCountingAuditStatus
integer 
可选
盘点审核状态 1;通过 2 待定
items
array [object {10}] 
必需
示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "dealerId": "ssss",
                "sapDealerCode": "sssss",
                "sapStoreCode": "sssss",
                "countryCode": "sssss",
                "stateCode": "sssss",
                "storeId": "1111",
                "optStatus": 1,
                "cityName": "北京",
                "address": "海淀区学院路37号",
                "postCode ": "100083",
                "contactPhone": "123456",
                "marketUnit": "ss",
                "deliveryTime": "20231017",
                "receivingTime": "20231023",
                "orderDate": "20231011",
                "mergedOrderNo": "NAK2023101700001",
                "orderNote": "qqq",
                "orderType": 1,
                "virtualOrder": true,
                "items": [
                    {
                        "itemNumber": "111",
                        "article": "as",
                        "modelId": "m",
                        "unit": "台",
                        "plant": "pa",
                        "warehouseId": "6654",
                        "quantity": 23
                    }
                ]
            }
        ]
    }
}
修改于 2025-04-15 06:42:33
上一页
销售订单接收状态更新(退换货)
下一页
补货单接收状态更新(退换货)
Built with