Trade API
add new order -wjb.trade.add
Description
you can not delete it after adding an order
input params
trade.orer detail information
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | trade | Trade | whole trade message | Y |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
Example:
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
}
}
order modify -wjb.trade.modify
Description
modify the basic information of order,if oder consists children order,the children will be modified too.If you only want to update children orders information,we recommord call API : wjb.trade.order.modify. Trade is not allowed to update when t closed.
input params
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | trade | Trade | whole trade information | Y |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
Example:
Http body:
{
"trade": {
"tid": 245244667,
"buyer_nick": "东方不败",
"status": "5"
}
}
Response body:
{
"response": {
"code": 81002,
"error_msg": "buyer_nick must be null"
}
}
children order modify -wjb.trade.order.modify
Description
modify children order basic information.not allowed modification after order closed.
input params
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | tid | String | order number | Y |
1 | order | Order | whole children order information | Y |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
Example:
HTTP url:
same to above
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
}
}
order infomation get -wjb.trade.list
Description
get the order detail (use the patted time)
input params
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | start_time | Date | begin time,format:yyyy-MM-dd hh:mm:ss | Y |
2 | end_time | Date | end time,format:yyyy-MM-dd hh:mm:ss | Y |
3 | status | Number | order status (1:trade success,3:to be payed,4:buyer has payed,5:seller has deliver goods,7:trade close) | N |
4 | page_no | Number | page number (>0) | Y |
5 | page_size | Number | page size <= 50 | Y |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
3 | trades | Trade[] | |
4 | has_next | Boolean | has next page or not |
Example:
Http request:
Response body:
{
"response": {
"code": 0,
"trades": [
{
"tid": 32479234
...
}
]
}
}
increase order information get -wjb.trade.increase.list
Description
query order detail information(according the lastest modified time)
input params
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | start_time | Date | begin time,format:yyyy-MM-dd hh:mm:ss | Y |
2 | end_time | Date | end time,format:yyyy-MM-dd hh:mm:ss | Y |
3 | status | Number | order status (1:trade success,3:to be payed,4:buyer has payed,5:seller has deliver goods,7:trade close) | N |
4 | page_no | Number | page number (>0) | Y |
5 | page_size | Number | page size <=50 | Y |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
3 | trades | Trade[] | |
4 | has_next | Boolean | has next page or not |
get one order detail -wjb.trade.get
Description
query one certain order detail information
input params
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | tid | String | order number | Y |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
3 | trade | Trade | whole trade information |
item add -wjb.item.add
Description
add an item
input params
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | item | Item | item information | Y |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
item update -wjb.item.update
Description
update item information
input params
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | item | Item | item information | Y |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
item query -wjb.item.list
Description
query item information
input params
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | start_time | Date | create begin time,yyyy-MM-dd hh:mm:ss | N |
2 | end_time | Date | create end time,yyyy-MM-dd hh:mm:ss,(end_time-start_time)<30days | N |
3 | page_no | Number | page number (>0),default1 | N |
4 | page_size | Number | page size <= 50,default10 | N |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
3 | items | Item[] | item list |
4 | Total_result | Number | record total count |
single item query -wjb.item.get
Description
query one item detail
input params
ID | Name | Type | Description | Required |
---|---|---|---|---|
1 | item_id | String | item ID | Y |
return
ID | Name | Type | Description |
---|---|---|---|
1 | code | Number | result code:0 success |
2 | error_message | String | error message |
3 | item | Item | item detail |