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 |