yougou.order.query 查询商家订单列表信息
查询商家订单列表信息
API用户授权:需要
系统级输入参数 | 应用级输入参数 | 返回结果 | 返回实例 | 错误码
系统级输入参数:
参数名称 | 参数类型 | 是否必填 | 参数说明 | 取值说明 | 默认值 |
---|---|---|---|---|---|
method |
String | 是 | API接口名称 |
||
timestamp |
String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss允许与优购系统时间误差正负6分钟,例如:2012-03-25 20:00:00 |
||
app_key |
String | 是 | 优购分配给商家应用的APP_KEY |
||
sign |
String | 是 | API输入参数签名结果 |
||
sign_method |
String | 否 | 可选,指定签名方式。系统默认md5,支持方式有:md5、sha-1 |
md5、sha-1 |
md5 |
app_version |
String | 否 | 可选,指定API版本。系统默认1.0,支持版本有:1.0 |
1.0 |
1.0 |
format |
String | 否 | 可选,指定响应格式。系统默认xml,支持响应格式有:xml、json |
应用级输入参数:
参数名称 | 参数类型 | 是否必填 | 参数说明 | 取值说明 | 默认值 |
---|---|---|---|---|---|
original_order_no |
String | 否 | 原始订单号 |
||
order_sub_no |
String | 否 | 子订单号 |
||
commodity_no |
String | 否 | 商品编码 |
||
commodity_keywords |
String | 否 | 商品关键字(暂时不适用,后继支持) |
||
product_no |
String | 否 | 货品编码 |
||
order_status |
String | 是 | 销售订单状态(1=待发货、2=已完成、3=申请拦截 4=异常订单)
关于申请拦截状态的订单,该类型订单也可以继续发货。如果同意被优购拦截,需要调用yougou.order.intercept.update回写状态 |
||
logistics_code |
String | 否 | 物流公司编码 |
||
payment |
String | 否 | 支付方式 |
||
consignee_name |
String | 否 | 收货人姓名 |
||
start_created |
Date | 否 | 下单起始时间 |
||
end_created |
Date | 否 | 下单结束时间 |
||
start_posted |
Date | 否 | 发货起始时间 |
||
end_posted |
Date | 否 | 发货结货时间 |
||
page_index |
Number | 是 | 指定页码。有效取值范围:>=1 |
>=1 |
|
page_size |
Number | 是 | 指定页大小。有效取值范围:1至50 |
[1-50] |
返回结果:
参数名称 | 参数类型 | 取值说明 | 参数说明 |
---|---|---|---|
code |
String | 业务结果代码(200=成功|500=系统异常|XXX=业务异常) |
|
message |
String | 业务结果消息(异常消息|true|false) |
|
items |
Array | 订单列表 |
|
items.order_sub_no |
String | 子订单号 |
|
items.original_order_no |
String | 原始订单号 |
|
items.product_total_quantity |
Number | 商品总数 |
|
items.message |
String | 订单留言 |
|
items.payment |
String | 支付方式 |
|
items.order_status |
Number | 订单状态 |
|
items.order_status_name |
String | 订单状态名称 |
|
items.logistics_code |
String | 快递公司编号 |
|
items.logistics_name |
String | 快递公司名称 |
|
items.province |
String | 省 |
|
items.city |
String | 市 |
|
items.area |
String | 区 |
|
items.consignee_address |
String | 收货人详细地址 |
|
items.consignee_name |
String | 收货人姓名 |
|
items.constact_phone |
String | 收货人电话 |
|
items.email |
String | 收货人邮箱 |
|
items.mobile_phone |
String | 收货人手机号码 |
|
items.zipcode |
String | 收货人邮编 |
|
items.buyer_name |
String | 购买人 |
|
items.member_name |
String | 会员号 |
|
items.order_pay_total_amont |
Number | 订单支付金额 |
|
items.actual_postage |
Number | 实际运费 |
|
items.discount_amount |
Number | 总优惠金额 |
|
items.create_time |
String | 创建日期 |
|
items.modify_time |
String | 修改日期 |
|
items.online_pay_time |
String | 订单在线支付时间 |
|
items.ship_time |
String | 发货时间 |
|
items.item_details |
Array | 订单明细列表 |
|
items.item_details.prod_no |
String | 货品编码 |
|
items.item_details.prod_name |
String | 货品名称 |
|
items.item_details.prod_unit_price |
String | 货品单价 |
|
items.item_details.prod_discount_amount |
String | 货品优惠总价 |
|
items.item_details.prod_total_amt |
String | 货品结算总金额 |
|
items.item_details.level_code |
String | 商家货品条码 |
|
items.item_details.commodity_no |
String | 商品编码 |
|
items.item_details.commodity_image |
String | 商品图片URL |
|
items.item_details.commodity_num |
String | 商品数量 |
|
items.item_details.commodity_specification_str |
String | 商品颜色尺码,以逗号劈开 |
|
items.province_name |
String | 省(中文名称) |
|
items.city_name |
String | 市(中文名称) |
|
items.area_name |
String | 区(中文名称) |
|
items.coupon_pref_amount |
Number | 优惠券优惠金额 |
|
items.coupon_pref_amount5 |
Number | 礼品卡优惠金额 |
|
items.item_details.commodityType |
Number | 0:普通商品 1:赠品 2:换购 3:从商品 |
商品类型 |
style_no |
String | 商品款号 |
|
supplier_code |
String | 商品款色编码(供应商) |
返回实例:
JSON
{ "yougou_order_query_response": { "message": "", "page_size": 20, "page_index": 1, "items": [ { "product_total_quantity": 1, "online_pay_time": "", "order_status_name": "已作废", "city": "root-17-1", "city_name": "深圳市", "mobile_phone": "13007799555", "area": "root-17-1-1", "area_name": "南山区", "consignee_name": "111", "province": "root-17", "province_name": "广东省", "actual_postage": 0, "modify_time": "2011-07-16 04:00:00", "logistics_name": "", "ship_time": "2012-02-02 00:00:00", "logistics_code": "WL001", "payment": "CASH_ON_DELIVERY", "original_order_no": "A14231654163", "zipcode": "111111", "constact_phone": "", "buyer_name": "", "order_pay_total_amont": 218, "discount_amount": 100, "order_status": 5, "message": "", "email": "", "order_sub_no": "A14231654163_1", "payment_name": "货到付款", "create_time": "2011-07-14 23:16:54", "consignee_address": "111", "coupon_pref_amount": 50, "coupon_pref_amount5": 0, "member_name": "1111@111.com", "item_details": [ { "commodity_image": "http://img.yougou.com/pics/teenmix/2012/99821179/99821179_01_t.jpg", "prod_discount_amount": 14, "commodity_specification_str": "白色,38", "commodity_num": 1, "prod_no": "99828275002", "level_code": "BRX666-2BD1A38", "commodity_no": "99828275", "prod_total_amt": 687, "prod_unit_price": 701, "commodity_weight": 0, "prod_name": "BELLE/百丽2017辣妈米色羊皮女单鞋 666-2B 白色 38", "supplier_code":"TL31SL004600", "style_no":"TL31SL004" } ] } ], "code": "200", "total_count": 100 } }
XML
<?xml version="1.0" encoding="UTF-8"?> <yougou_order_query_response> <code>200</code> <message></message> <page_index>1</page_index> <page_size>20</page_size> <total_count>100</total_count> <items> <item> <product_total_quantity>1</product_total_quantity> <online_pay_time></online_pay_time> <order_status_name>已作废</order_status_name> <city>root-17-1</city> <city_name>深圳市</city_name> <mobile_phone>13007799555</mobile_phone> <area>root-17-1-1</area> <area_name>南山区</area_name> <consignee_name>111</consignee_name> <province>root-17</province> <province_name>广东省</province_name> <actual_postage>0.0</actual_postage> <modify_time>2011-07-16 04:00:00</modify_time> <logistics_name></logistics_name> <ship_time>2012-02-02 00:00:00</ship_time> <logistics_code>WL001</logistics_code> <payment>CASH_ON_DELIVERY</payment> <payment_name>货到付款</payment_name> <original_order_no>A14231654163</original_order_no> <zipcode>111111</zipcode> <constact_phone></constact_phone> <buyer_name></buyer_name> <order_pay_total_amont>218.0</order_pay_total_amont> <discount_amount>100.0</discount_amount> <order_status>5</order_status> <message></message> <email></email> <order_sub_no>A14231654163_1</order_sub_no> <create_time>2011-07-14 23:16:54</create_time> <consignee_address>111</consignee_address> <member_name>1111@111.com</member_name> <coupon_pref_amount>50</coupon_pref_amount> <coupon_pref_amount5>0</coupon_pref_amount5> <item_details> <item> <supplier_code>TL31SL004600</supplier_code> <style_no>TL31SL004</style_no> <commodity_image>http://img.yougou.com/pics/teenmix/2012/99821179/99821179_01_t.jpg</commodity_image> <prod_discount_amount>14.0</prod_discount_amount> <commodity_specification_str>白色,38</commodity_specification_str> <prod_no>99828275002</prod_no> <commodity_num>1</commodity_num> <level_code>BRX666-2BD1A38</level_code> <commodity_no>99828275</commodity_no> <prod_total_amt>687.0</prod_total_amt> <prod_unit_price>701.0</prod_unit_price> <commodity_weight>0.0</commodity_weight> <prod_name>BELLE/百丽2017辣妈米色羊皮女单鞋 666-2B 白色 38</prod_name> </item> </item_details> </item> </items> </yougou_order_query_response>
错误码:
错误码 | 错误描述 | 解决方案 |
暂无数据 |