交易接口

添加新订单 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&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
  }
}

订单修改 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:

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
        ...
      }
    ]
  }
}

增量订单信息获取 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 商品详情