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&timestamp=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:

http://wop.wangjubao.com/rest/trade?sign=F2DFA99A06C15A84CDA94BEC0CCB0CFA&sign_method=md5&timestamp=2015-08-24+17:04:11&page_size=2&v=1.0&end_time=2015-1-22+10:10:01&status=1%2C4%2C5%2C6%2C7&start_time=2014-10-10+10:10:01&method=wjb.trade.list&app_key=120055111&format=json&access_token=MTIwMDU1MTExOTk1MTRBOTlGMDIwRUI1MDcxMkQ0NjM1M0UzOERFMDQyNzg0OTAzNjQ

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