元数标准接口
  1. 单据追踪系统-BTS
元数标准接口
  • 签名说明
  • 订单
    • 订单信息同步接口
      POST
    • 订单取消同步接口
      POST
    • 订单发货同步接口-单包裹
      POST
    • 订单发货同步接口-多包裹
      POST
    • 修改收货地址同步接口
      POST
  • 售后
    • 售后信息同步接口
      POST
    • 退单支付回调(非全款支付)
      POST
    • 售后入库接口【入参结构调整】
      POST
  • 库存
    • erp库存同步
      POST
  • 单据追踪系统-BTS
    • 东北虎说明
    • 查询订单物流流水信息
      GET
    • 查询订单综合流水信息(含包裹商品信息)
      GET
    • 流水上报接口
      GET
    • 追加包裹单
      GET
    • 物流单变更
      GET
    • 物流单变更V2
      GET
  1. 单据追踪系统-BTS

流水上报接口

开发中
GET
/bts-web/saas/ifs/upload.do
请求方式:GET
入参 param={}&_platform_num=租户号
文档中选了post是为了将入参param的json中的字段含义罗列清楚。
signKey需要重新申请
入参示例:
param={"code":"12147653919436257","codeType":"01","currentNode":"1203","optTime":1695124849,"platformCode":"01","relativeCodes":[{"contains":[{"goodsId":"005165","goodsName":"全链路自动化测试专用勿动01","goodsNum":"50000.0"}],"expressCmpCode":"0030","expressCompany":"顺丰速运","mobileTelephone":"15850653116","relativeCode":"20230919200049","relativeCodeType":"01","uploadMessage":"包裹通过顺丰速运配送,运单号:20230919200049,请注意查收!"}],"signKey":"NFE3MUUxRTI4cnJvbXMxNDkxOTA2MzkzMDcx","source":"7start","uploadTime":1695124849}&_platform_num=租户号
param={"code":73371567,"codeType":"02","currentNode":"9006","optTime":1695124517,"platformCode":"01","source":"refund","uploadMessage":"您的售后退款单已经生成,退款将在1-7个工作日到账,请注意查收。","uploadTime":1695124517}&_platform_num=租户号
param={"code":"12002913919407943","codeType":"01","currentNode":"0109","optTime":1695124517,"platformCode":"01","source":"oms","uploadMessage":"您的订单取消申请已受理,待商户审核","uploadTime":1695124517}&_platform_num=租户号
param={"code":"12014183919505322","codeType":"01","currentNode":"3001","optTime":1695124514393,"platformCode":"01","signKey":"NTc5NHExNzUxMnByczE0OTE5MDYzOTMwNzE=","source":"prs","uploadMessage":"您的订单准备拣货!","uploadTime":1695124514413}&_platform_num=租户号
出参示例:
{"msg":"成功","code":"1","data":1}

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
code
string 
单据号
必需
codeType
string 
必需
单据类型,01-订单,02-退单
currentNode
string 
节点编码
必需
optTime
number 
必需
上报时间,时间戳,秒级
platformCode
string 
平台编码,默认01
必需
relativeCodes
array [object {7}] 
可选
包裹单号,发货的节点需要上报包裹单信息
contains
array [object {3}] 
包含商品信息
可选
expressCmpCode
string 
快递公司编码
可选
expressCompany
string 
快递公司名称
可选
mobileTelephone
string 
收件人手机号
可选
relativeCode
string 
运单号
可选
relativeCodeType
string 
运单类型 01
可选
uploadMessage
string 
包裹的上报流水信息
必需
uploadMessage
string 
上报流水信息
可选
signKey
string 
密钥
必需
source
string 
上报来源
必需
uploadTime
number 
必需
上报时间,时间戳,秒级
示例
{
  "code": "string",
  "codeType": "string",
  "currentNode": "string",
  "optTime": 0,
  "platformCode": "string",
  "relativeCodes": [
    {
      "contains": [
        {
          "goodsId": "string",
          "goodsName": "string",
          "goodsNum": "string"
        }
      ],
      "expressCmpCode": "string",
      "expressCompany": "string",
      "mobileTelephone": "string",
      "relativeCode": "string",
      "relativeCodeType": "string",
      "uploadMessage": "string"
    }
  ],
  "uploadMessage": "string",
  "signKey": "string",
  "source": "string",
  "uploadTime": 0
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/bts-web/saas/ifs/upload.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "string",
    "codeType": "string",
    "currentNode": "string",
    "optTime": 0,
    "platformCode": "string",
    "relativeCodes": [
        {
            "contains": [
                {
                    "goodsId": "string",
                    "goodsName": "string",
                    "goodsNum": "string"
                }
            ],
            "expressCmpCode": "string",
            "expressCompany": "string",
            "mobileTelephone": "string",
            "relativeCode": "string",
            "relativeCodeType": "string",
            "uploadMessage": "string"
        }
    ],
    "uploadMessage": "string",
    "signKey": "string",
    "source": "string",
    "uploadTime": 0
}'

返回响应

🟢200成功
application/json
Body
msg
string 
成功,失败
可选
code
string 
1-成功
可选
data
number 
可选
示例
{
  "msg": "string",
  "code": "string",
  "data": 0
}
上一页
查询订单综合流水信息(含包裹商品信息)
下一页
追加包裹单
Built with