Appearance
订单导入同步(网商)
订单导入同步并生成对应的网商结算单进行上报结算处理
| 请求路径 | /mall/order |
|---|---|
| 请求方法 | POST |
请求参数
公共参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| key | 标识 | string | 是 | 开发者唯一标识 |
| time | 时间戳 | string | 是 | 当前unix时间戳,精确到秒 |
| sign | 数据签名 | string | 是 | 数据签名,详见 签名算法 |
| data | 业务参数 | JSON string | 是 | 业务参数,详见下例表格 |
业务参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| holder_code | 分账方编号 | string | 是 | 订单归属分账方编号 |
| sku_name | 商品名称 | string | 是 | 商品名称 |
| order_no | 订单号 | string | 是 | 订单号全局唯一标识 |
| quantity | 数量 | int | 否 | 数量 |
| sku_id | 商品唯一标识 | int | 否 | 商品唯一标识 |
| valid_time | 有效结算时间 | string | 是 | 有效结算时间(用于批次处理)格式为yyyy-MM-dd HH:mm::ss |
| settle_amount | 结算金额 | float | 是 | 结算金额(含总部抽取金额) |
| remark | 备注 | string | 否 | 备注 |
请求示例
json
{
"key": "d787d45a68b486b2e93",
"time": 1668492908,
"sign": "ab2db27c6f80a8291871b5af373998...",
"data": "{\"holder_code\":\"H6449996\",\"sku_name\":\"xxxx\",\"order_no\":\"O202611130001\",\"valid_time\":\"2026-11-13 11:15:33\",\"settle_amount\":20.00,}",
}返回数据
公共数据
| 数据 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| code | 状态码 | int | 是 | 结果状态码 |
| text | 操作结果 | string | 否 | 操作结果,为空时不返回此字段 |
| time | 时间戳 | int | 是 | 服务器当前unix时间戳,精确到秒 |
| data | 业务数据 | JSON string | 是 | 业务数据,详见下例表格 |
| sign | 数据签名 | string | 是 | 数据签名 |
业务数据
| 数据 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| serial | 订单全平台唯一标识 | string | 是 | 订单全平台唯一标识 |
| order_serial | 订单编号 | string | 是 | 参数对应的订单编号 |
| original_amount | 原始金额 | float | 是 | 原始金额 |
| remark | 备注 | string | 否 | 备注 |
| discount_amount | 优惠金额 | float | 是 | 优惠金额 |
| receive_amount | 订单实收 | float | 是 | 订单实收 |
| settle_amount | 结算金额 | float | 是 | 结算金额 |
| fee_amount | 费用 | float | 是 | 费用 |
| state | 状态 | string | 是 | 状态详见下面表格 |
| order_state | 订单状态 | string | 是 | 订单状态详见下面表格 |
| valid | 生效时间 | string | 是 | 生效时间 |
状态
| 标识 | 说明 |
|---|---|
| pending | 待结算 |
| valid | 有效 |
| cancel | 已取消 |
| without | 无需处理 |
| filter | 已过滤 |
订单状态
| 标识 | 说明 |
|---|---|
| paying | 待支付 |
| cancel | 支付取消 |
| success | 已支付 |
| refund_apply | 退款申请中 |
| refund | 已退款 |
返回状态
| 状态 | 说明 |
|---|---|
| 0 | 查询成功 |