检索单个SOP订单信息 | 大麦家礼品代发API

# 检索单个SOP订单信息

接口地址： http://www.damaijia168.com/vv/external/jdpoporderget

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

名称	类型	必须	示例值	描述
owner_id	String	是		店铺 ownerId
order_state	String	否	WAIT_SELLER_DELIVERY	多订单状态可以用英文逗号隔开请用英文逗号拼接英文状态传递给jos，而不是数字。1）WAIT_SELLER_STOCK_OUT 等待出库 2）WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货 3）WAIT_SELLER_DELIVERY等待发货（只适用于海外购商家，含义为“等待境内发货”标签下的订单,非海外购商家无需使用） 4) PAUSE 暂停（loc订单可通过此状态获取） 5）FINISHED_L 完成 6）TRADE_CANCELED 取消 7）LOCKED 已锁定 8）POP_ORDER_PAUSE pop业务暂停，如3c号卡/履约/黄金的业务，可传此状态。
optional_fields	String	是	venderId,orderType,payType	字段详见下述字段
order_id	Number	是	123456789	订单号
edition	string	否		版本默认:1(不传默认为1) 1:1.0,2:2.0

# 请求示例

{
owner_id:624092
order_id:233819152924
optional_fields：orderId,payType,orderTotalPrice,orderPayment,orderSellerPrice,freightPrice,sellerDiscount,orderState,orderStateRemark,deliveryType,invoiceInfo,orderRemark,orderStartTime,orderEndTime,consigneeInfo,itemInfoList,couponDetailList,returnOrder,venderRemark,pin,balanceUsed,modified,paymentConfirmTime,logisticsId,waybill,invoiceCode,orderSource,storeOrder
}

# 请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

Pyton请求代码示例

# 响应参数

名称	类型	示例值	描述
data	object	数据信息
order_detail_info	com.jd.open.api.sdk.domain.order.order_result		订单详细信息
api_result	com.jd.ac.domain.api.api_result		返回结果
-success	boolean	true	是否成功,true或者false
-english_err_code	string	system exception	英文错误原因(pls reduce the frequency and try again later；client validate does not pass or exist problem；system exception；order_id is not largger than 0 or is null；es exception)，如果成功，此字段为空。
-chinese_err_code	string	系统异常	中文错误原因(访问太频繁，请降低频率，稍后重试；客户端校验没通过或有问题；系统异常；订单ID不大于0或者为空；e_s查询异常),如果成功，此字段为空
-number_code	number	999999	数字错误(-110000；10500001；999999；10100002；13200004)
order_info	com.jd.open.api.sdk.domain.order.order_search_info		order_info
-order_id	string	67834311	订单id
-vender_id	string	177187	商家id，商家编号
-order_type	string	22	订单类型（22 s_op； 75 l_oc；21:f_bp，112:f_cs，142:i_bs）可选字段，需要在输入参数optional_fields中写入才能返回
-pay_type	string	4	支付方式（1货到付款, 2邮局汇款, 3自提, 4在线支付, 5公司转账, 6银行卡转账）
-order_total_price	string	100	订单总金额。总金额=订单金额（不减优惠，不加运费服务费税费）
-order_seller_price	string	80	订单货款金额（订单总金额-商家优惠金额）
-order_payment	string	90	用户应付金额。应付款=货款-用户优惠-余额+运费+税费+服务费
-freight_price	string	10	商品的运费
-seller_discount	string	20	商家优惠金额
-order_state	string	WAIT_SELLER_STOCK_OUT	订单状态（英文）；枚举值：1）WAIT_SELLER_STOCK_OUT 等待出库 2）WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货 3）WAIT_SELLER_DELIVERY等待发货（只适用于海外购商家，含义为“等待境内发货”标签下的订单,非海外购商家无需使用） 4) POP_ORDER_PAUSE POP暂停 5）FINISHED_L 完成 6）TRADE_CANCELED 取消 7）LOCKED 已锁定 8）WAIT_SEND_CODE 等待发码（LOC订单特有状态） 9）PAUSE 暂停（等待出库之前的状态） 10)DELIVERY_RETURN 配送退货 11）UN_KNOWN 未知请联系运营
-order_state_remark	string	等待出库	订单状态说明（中文）
-delivery_type	string	只工作日送货(双休日、假日不用送)	送货（日期）类型（1-只工作日送货(双休日、假日不用送);2-只双休日、假日送货(工作日不用送);3-工作日、双休日与假日均可送货;其他值-返回“任意时间”）
invoice_easy_info	com.jd.ac.domain.api.offline.invoice_easy_info		发票组装信息。电子发票从这里获取。可替代invoice_info
-invoice_type	string	3	发票类型，0=不开发票、1=普通发票、2=增值税发票(专票)、3=电子发票
-invoice_title	string	发票抬头	发票抬头。个人/公司名称
-invoice_content_id	string	发票内容	发票内容
-invoice_consignee_email	string	电子发票联系人邮箱	电子发票联系人邮箱
-invoice_consignee_phone	string	13222222222	电子发票联系人手机号
-invoice_code	string	1w_eu_o2384329s_d	发票纳税人识别号
-invoice_info	string	发票信息。电子发票请从invoice_easy_info里取 “invoice_info: 不需要开具发票”下无需开具发票；其它返回值请正常开具发票	发票信息。电子发票请从invoice_easy_info里取 “invoice_info: 不需要开具发票”下无需开具发票；其它返回值请正常开具发票
-invoice_code	string	普通发票纳税人识别码	普通发票纳税人识别码
-order_remark	string	尽快发货	买家下单时订单备注
-order_start_time	string	2019-01-01 12:21:32	下单时间
-order_end_time	string	2019-02-01 12:21:32	结单时间如返回信息为“0001-01-01 00:00:00”和“1970-01-01 00:00:00”，可认为此订单为未完成状态。
consignee_info	com.jd.open.api.sdk.domain.order.user_info		收货人基本信息
-fullname	string	张三	姓名
-telephone	string	0102553701	固定电话
-mobile	string	18222222222	手机
-full_address	string	河北廊坊市三河市齐心庄镇	详细地址
-province	string	河北省	省
-city	string	廊坊市	市
-county	string	三河市	县
-town	string	齐心庄镇	镇
-province_id	string	5	省id
-city_id	string	274	市id
-county_id	string	49707	县id
-town_id	string	49968	镇id
-desen_telephone	string	0102553701	固定电话
-desen_mobile	string	18222222222	手机
item_info_list	java.util.list		商品详细信息
---	com.jd.open.api.sdk.doamin.order.item_info
-sku_id	string	12389871	京东内部Sku的ID
-outer_sku_id	string	Sku外部ID（极端情况下不保证返回，建议从商品接口获取	Sku外部ID（极端情况下不保证返回，建议从商品接口获取
-sku_name	string	商品名称	商品的名称+Sku规格
-jd_price	string	23.11	Sku的京东价
-gift_point	string	1000	赠送积分
-ware_id	string	89112	京东内部商品ID（极端情况下不保证返回，建议从商品接口获取）
-item_total	string	2	数量
-product_no	string	891112345	货号
-service_name	string	服务项名称	服务项名称
-new_store_id	string	1	item维度的仓库id
-item_ext	string	tem维度的扩展信息；json；服务项数据、黄金珠宝订单标识、医疗器械,门店id等。黄金珠宝标识：zszs=1; 门店id对应的key:locShopId(只有门店服务的订单,扩展信息里面才有这个节点)	item维度的扩展信息；json；服务项数据、黄金珠宝订单标识、医疗器械,门店id等。黄金珠宝标识：zszs=1; 门店id对应的key:locShopId(只有门店服务的订单,扩展信息里面才有这个节点)
coupon_detail_list	java.util.list		优惠详细信息
---	com.jd.open.sdk.domain.order.coupon_detail
-order_id	string	91379271133	订单编号
-sku_id	string	1233321	京东sku编号。(只有30-单品促销优惠才有sku_id，其他时值为””)
-coupon_type	string	29	优惠类型: 20-套装优惠, 28-闪团优惠, 29-团购优惠, 30-单品促销优惠, 34-手机红包, 35-满返满送(返现), 39-京豆优惠,41-京东券优惠, 52-礼品卡优惠,100-店铺优惠
-coupon_price	string	1	优惠金额。isv请联系服务市场类目运营，商家请联系店铺运营。
-vender_remark	string	可发货	商家订单备注（不大于500字符）可选字段，需要在输入参数optional_fields中写入才能返回
-balance_used	string	1	余额支付金额可选字段，需要在输入参数optional_fields中写入才能返回
-pin	string	hys7975	买家的账号信息可选字段，需要在输入参数optional_fields中写入才能返回
-return_order	string	0	售后订单标记 0:不是换货订单 1返修发货,直接赔偿,客服补件 2售后调货可选字段，需要在输入参数optional_fields中写入才能返回
-payment_confirm_time	string	2019-02-02 12:21:32	付款确认时间如果没有付款时间默认返回0001-01-01 00:00:00 可选字段，需要在输入参数optional_fields中写入才能返回
-waybill	string	运单号(当厂家自送时运单号可为空，不同物流公司的运单号用	分隔，如果同一物流公司有多个运单号，则用英文逗号分隔) 可选字段，需要在输入参数optional_fields中写入才能返回
-logistics_id	string	21	物流公司ID 可选字段，需要在输入参数optional_fields中写入才能返回
vat_info	com.jd.open.api.domain.order.vat_incoice_info		增值税发票(专票),普通发票,普通电子发票可选字段，需要在输入参数optional_fields中写入才能返回(发票相关扩展字段)
-vat_no	string	1	纳税人识别号
-address_reg_istered	string	北京市海淀区	注册地址
-phone_reg_istered	string	15034342222	注册电话
-deposit_bank	string	中国人民银行	开户银行
-bank_account	string	银行账号	银行账户
-user_address	string	北京市大兴区科创十一街	收票人地址
-user_name	string	张三	收票人姓名
-user_phone	string	18312333333	收票人电话
-invoice_personal_name	string	李四	普通发票,电子普通发票的个人姓名
-modified	string	2019-01-01 11:11:11	订单更新时间
-direct_parent_order_id	string	1	直接父订单号可选字段，需要在输入参数optional_fields中写入才能返回
-parent_order_id	string	1	根父订单号可选字段，需要在输入参数optional_fields中写入才能返回
-customs	string	广州南沙保税区	保税区信息【广州南沙保税区，广州南沙保税区，杭州萧山保税区等】
-customs_model	string	直邮	保税模型：【直邮，保税集货，保税备货】
-order_source	string	移动端订单	订单来源。移动端订单、p_c端订单、手q订单、微信订单、拍拍订单、农村电商
-store_order	string	京仓订单	当ordertype为22的时候。京仓订单/云仓订单/空值“”；京仓、云仓订单，商家请勿发货。
-id_sop_shipmenttype	number	68	配送方式，是否京配。68=京配，69=京配自提。71=同城配送（当是71时请通过jingdong.pop.order.get_order_ext_info_by_order_id接口获取配送时效信息）
-sc_dt	string	2019-02-02 12:21:32	最早生产时间。预约出库时间
-service_fee	string	1	服务费。目前没有此值
pause_biz_info	com.jd.ac.domain.api.offline.OrderInfoResultPauseBizInfo		订单暂停业务数据
pause_biz_status_list	java.util.list		订单暂停业务处理状态集
---	com.jd.ac.domain.api.offline.order_info_result_pause_biz_info.pause_biz_status
-biz_type	number	1	业务类型
-biz_status	number	1	业务处理状态。0.未处理 1.处理成功
pause_biz_data_yy	com.jd.ac.domain.api.offline.order_info_result_pause_biz_info.pause_biz_data_yy		订单暂停业务数据（预约日历）
-cod_dt	string	2019-01-01 12:21:32	用户预约时间
-db_dt	string	2019-01-01 12:21:32	最晚出库时间
-lj_dt	string	2019-02-01 12:21:32	最晚揽件时间
-tax_fee	string	100	税价分离,保存税费,单位:分
-tui_huo_wu_you	string	退货无忧	退货无忧
-order_sign	string	sendpay(京东内部标识业务类型的字符串，一般为500位)	sendpay(京东内部标识业务类型的字符串，一般为500位)
-store_id	string	21	仓库id
-men_dian_id	string	32	门店id
-mdb_store_id	string	23900	门店帮id。
-sales_pin	string	jd_51b90fbbf3118	导购员pin。
original_consignee_info	com.jd.open.api.sdk.domain.order.user_info		集运订单客户真实收获地址(仅集运订单即sendpay第124位为7的订单有这个字段)
-fullname	string	张三	姓名
-telephone	string	0102553701	固定电话
-mobile	string	18222222222	手机
-full_address	string	河北廊坊市三河市齐心庄镇	详细地址
-province	string	河北省	省
-city	string	廊坊市	市
-county	string	三河市	县
-town	string	齐心庄镇	镇
-province_id	string	5	省id
-city_id	string	274	市id
-county_id	string	49707	县id
-town_id	string	49968	镇id
-desen_telephone	string	0102553701	固定电话
-desen_mobile	string	18222222222	手机
-order_ext	string	订单维度扩展字段,json;	订单维度扩展字段,json;
order_mark_desc	java.util.map		订单标注描述
-try_before_pay_later	string	1	京品试订单标注。1代表是京品试订单
-real_pin	string	hy_s7975	买家的账号信息真实p_in 可选字段，需要在输入参数optional_fields中写入才能返回
-sendpay_map	string	{“301”：“1,“501”：“1”,“509”:“1”,”688”:”2”,“559”:“2”,“599”:”7”}	包含sendpay所有打标逻辑，500位后的sendpay打标逻辑只有这个字段有。示例：{“301”：“1”，“501”：“1”，“509”:“1”,”688”:”2”,“559”:“2”，“599”:”7”}
-open_id_buyer	string	hys7975	买家的账号信息可选字段，需要在输入参数optional_fields中写入才能返回
-open_id_seller	string	jd_51b90fbbf3118	导购员pin。
deduct_money	int	1	消耗点券
status	int	0	状态码，0为成功

# 返回数据

{
"data": {
        "deduct_money":1,
     
    },
    "status": 0
}

# 响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API调用次数不足,请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权

← 8-i_京东-订单列表 8-k_京东-获取面单打印数据(可选) →