常见问题

API文档 > 订单API > 查询增量订单列表信息

yougou.order.increment.query 查询增量订单列表信息
1. 一次只能查询时间跨度为一天的增量订单信息,即end_modified - start_modified <= 1天。
2. 返回的数据结果是以订单的最后修改开始时间倒序排列的,通过从后往前翻页的方式可以避免漏单问题。

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

应用级输入参数:

参数名称 参数类型 是否必填 参数说明 取值说明 默认值
start_modified
Date
订单最后修改开始时间(时间跨度不能大于一天)。格式:yyyy-MM-dd HH:mm:ss
end_modified
Date
订单最后修改结束时间,必须大于开始时间(时间跨度不能大于一天),格式:yyyy-MM-dd HH:mm:ss。
order_status
Number
销售订单状态(1=待发货、2=已完成、3=申请拦截、4=异常订单) 关于申请拦截状态的订单,该类型订单也可以继续发货。如果同意被优购拦截,需要调用yougou.order.intercept.update回写状态
page_index
Number
指定页码。有效取值范围:>=1
>=1
page_size
Number
是 指定页大小。有效取值范围:1至50
[1-50]
order_sub_no
String
子订单号
logistics_code
String
物流公司编码
consignee_name
String
收货人姓名
payment
String
支付方式

返回结果:

参数名称 参数类型 取值说明 参数说明
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
Date
创建日期
items.modify_time
Date
修改日期
items.online_pay_time
Date
订单在线支付时间
items.ship_time
Date
发货时间
items.item_details
Array
订单明细列表
items.item_details.prod_no
String
货品编码
items.item_details.prod_name
String
货品名称
items.item_details.prod_unit_price
Number
货品单价
items.item_details.prod_discount_amount
Number
货品优惠总价
items.item_details.prod_total_amt
Number
货品结算总金额
items.item_details.level_code
String
商家货品条码
items.item_details.commodity_no
String
商品编码
items.item_details.commodity_image
String
商品图片URL
items.item_details.commodity_num
Number
商品数量
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_increment_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",
        "member_name": "1111@111.com",
        "coupon_pref_amount": 50,
        "coupon_pref_amount5": 0,
		"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_increment_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_increment_query_response>

错误码:

错误码 错误描述 解决方案
暂无数据
返回顶部