交易接口
添加新订单 wjb.trade.add
描述
订单一旦添加无法删除
输入参数
交易,订单详细信息
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | trade | Trade | 完整的交易信息 | Y |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
示例:
HTTP url:
http://localhost//rest/trade?app_key=120055111&sign_method=md5&format=json×tamp=2015-08-17 13:27:15&v=1.0&access_token=MTIwMDU1MTExOTk1MTRBOTlGMDIwRUI1MDcxMkQ0NjM1M0UzOERFMDQyNzg0OTAzNjQ&method=wjb.trade.add&sign=B9851840CD46C52EC35E9BCCBAA97045
Http body:
{
"trade": {
"adjust_fee": 0,
"buyer_alipay_no": "40092343@qq.com",
"buyer_email": "xyz@163.com",
"buyer_memo": "发顺丰",
"buyer_nick": "ramon",
"consign_time": "2015-08-20 17:00:04",
"cost_price": 0,
"created": "2015-08-20 12:00:04",
"item_num": 2,
"modified": "2015-08-20 18:00:04",
"order_num": 1,
"orders": [
{
"created": "2015-08-20 12:00:04",
"item_id": 354657643245,
"item_meal_id": 3465484315,
"item_meal_name": "满100减30",
"modified": "2015-08-20 18:00:04",
"num": 2,
"oid": "98324543545",
"outer_id": "860345A01",
"pay_time": "2015-08-20 18:10:04",
"payment": 120,
"price": 60,
"sku_id": "23943254325",
"sku_prop_name": "蓝色180",
"title": "2015款宝宝摇椅"
}
],
"pay_time": "2015-08-20 18:10:04",
"payment": 120,
"post_fee": 0,
"receiver_address": "松涛路489号2楼",
"receiver_city": "上海市",
"receiver_district": "浦东新区",
"receiver_state": "上海",
"receiver_mobile": "13800000900",
"reciever_name": "张三",
"tid": "932763442501"
}
}
Response body:
{
"response": {
"code": 0
}
}
订单修改 wjb.trade.modify
描述
修改订单基本信息,如果包括子订单信息,相应子订单信息也会修改。如果只需要更新子订单信息,建议调用wjb.trade.order.modify。订单关闭后,不允许改动
输入参数
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | trade | Trade | 完整的交易信息 | Y |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
示例:
Http body:
{
"trade": {
"tid": 245244667,
"buyer_nick": "东方不败",
"status": "5"
}
}
Response body:
{
"response": {
"code": 81002,
"error_msg": "buyer_nick must be null"
}
}
子订单修改 wjb.trade.order.modify
描述
修改子订单基本信息。订单关闭后,不允许改动
输入参数
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | tid | String | 订单编号 | Y |
1 | order | Order | 完整的子订单信息 | Y |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
示例:
HTTP url:
同上
HTTP body:
{
"order": {
"item_meal_id": 3465484315,
"item_meal_name": "满100减30",
"modified": "2015-08-20 18:00:04",
"oid": "98324543545",
"outer_id": "860345A01",
"pay_time": "2015-08-20 18:10:04",
"payment": 120,
"price": 60,
"sku_id": "23943254325",
"sku_prop_name": "蓝色180"
},
"tid": "2340342570132545"
}
Response body:
{
"response": {
"code": 0
}
}
订单信息获取wjb.trade.list
描述
获取订单详细信息 (按拍下时间)
输入参数
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | start_time | Date | 开始时间,格式yyyy-MM-dd hh:mm:ss | Y |
2 | end_time | Date | 结束时间,格式yyyy-MM-dd hh:mm:ss | Y |
3 | status | Number | 订单状态 (1:交易成功,3:等待付款,4:买家已付款,5:卖家已发货,7:交易关闭) | N |
4 | page_no | Number | 页码 (>0) | Y |
5 | page_size | Number | 每页条数 <= 50 | Y |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
3 | trades | Trade[] | |
4 | has_next | Boolean | 是否有下一页 |
示例:
Http request:
Response body:
{
"response": {
"code": 0,
"trades": [
{
"tid": 32479234
...
}
]
}
}
增量订单信息获取 wjb.trade.increase.list
描述
获取订单详细信息(按最后修改时间)
输入参数
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | start_time | Date | 开始时间,格式yyyy-MM-dd hh:mm:ss | Y |
2 | end_time | Date | 结束时间,格式yyyy-MM-dd hh:mm:ss | Y |
3 | status | Number | 订单状态 (1:交易成功,3:等待付款,4:买家已付款,5:卖家已发货,7:交易关闭) | N |
4 | page_no | Number | 页码 (>0) | Y |
5 | page_size | Number | 每页条数 <=50 | Y |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
3 | trades | Trade[] | |
4 | has_next | Boolean | 是否有下一页 |
获取单笔订单的详细信息wjb.trade.get
描述
获取单笔订单详细信息
输入参数
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | tid | String | 订单编号 | Y |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
3 | trade | Trade | 完整的交易信息 |
商品添加接口wjb.item.add
描述
添加商品
输入参数
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | item | Item | 商品信息 | Y |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
商品修改接口wjb.item.update
描述
修改商品信息
输入参数
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | item | Item | 商品信息 | Y |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
商品查询接口wjb.item.list
描述
查询商品信息
输入参数
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | start_time | Date | 创建起始时间,yyyy-MM-dd hh:mm:ss | N |
2 | end_time | Date | 创建结束时间,yyyy-MM-dd hh:mm:ss,(end_time-start_time)小于30天 | N |
3 | page_no | Number | 页码 (>0),默认1 | N |
4 | page_size | Number | 每页条数 <= 50,默认10 | N |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
3 | items | Item[] | 商品列表 |
4 | Total_result | Number | 总记录数 |
单个商品查询接口wjb.item.get
描述
获取单个商品详情
输入参数
ID | 字段名 | 类型 | 描述 | 必填 |
---|---|---|---|---|
1 | item_id | String | 商品ID | Y |
返回结果
ID | 字段名 | 类型 | 描述 |
---|---|---|---|
1 | code | Number | 结果代码:0 成功 |
2 | error_message | String | 错误信息 |
3 | item | Item | 商品详情 |