七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
在线系统订单绩效对接

批量上传订单信息

批量上传企业订单信息,请求体为使用应用密钥 AES 加密后的订单 JSON 数组。解密后每条订单需包含 orderId(1-255 字符)、uid(1-128 字符)、payTime(>0),可选字段:status(0-4)、orderTime、amount、price、refundNo、refundTime。单次最多上传 1000 条。

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey
timeint64是请求时间戳(秒)
checksumstring是请求签名校验和
checksumAlgorithmint32否签名算法:0 - 默认(SHA1),1 - SHA256
shopIdstring否平台店铺 ID(仅平台企业需传)

请求体

名称类型必填描述示例值
encryptedDatastring否AES 加密后的订单列表,解密后为 OrderItem 数组[{"orderId":"ORD001","uid":"user123","payTime":1700000000,"status":1}]

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
messagestring响应消息,成功时格式为 "upload order info success, total = N"upload order info success, total = 10

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求体 JSON 格式错误;订单参数缺失或格式错误;超过单次上传上限
14300请求体 AES 解密失败(应用密钥变更或加密格式错误)
14301shopId 无效
14500服务内部异常;无权限;系统繁忙
postEndpoint
/openapi/order/upload
POST
/openapi/order/upload
curl -X POST "https://qiyukf.com/openapi/order/upload?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "code": 200,
  "message": "upload order info success, total = 10"
}
{
  "code": 14001,
  "message": "AppKey 不存在"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "请求体 JSON 格式错误;订单参数缺失或格式错误;超过单次上传上限"
}
{
  "code": 14300,
  "message": "请求体 AES 解密失败(应用密钥变更或加密格式错误)"
}
{
  "code": 14301,
  "message": "shopId 无效"
}
{
  "code": 14500,
  "message": "服务内部异常;无权限;系统繁忙"
}

这篇文档有帮助吗?