<JD-API对接[]>帮助文档文档版本号:1.6.2文档编号:文档密级:归属部门/项目:大客户部产品名:JD-API对接【】帮助文档子系统名:编写人:武文编写日期:2014/08/28京东商城版权所有内部资料注意保密产品帮助文档修订记录:版本号修订人修订日期修订描述1.0武文2014/03/241.1武文2014/05/041.2武文2014/05/151.3武文2014/05/281.4武文2014/06/281.5武文2014/07/251.6武文2014/07/291.6.1武文2014/08/051.6.2武文2014/08/28内部资料第2页注意保密产品帮助文档目录<JD-API对接[]>........................................................................................................................1帮助文档.........................................................................................................................................1一、需求背景及概述........................................................................................................6二、API系统对接流程及过程描述.................................................................................71、API系统对接流程图...................................................................................................................72、对接过程描述..............................................................................................................................82.1业务谈判.......................................................................................................................................82.2需求调研.......................................................................................................................................82.3需求确认.......................................................................................................................................82.4系统对接.......................................................................................................................................8三、系统对接帮助文档(实物)....................................................................................91、授权服务......................................................................................................................................91.1获取AccessToken......................................................................................................................91.2使用RefreshToken刷新AccessToken...............................................................................122、API调用流程图.........................................................................................................................143、商品API接口............................................................................................................................153.1获取商品池编号接口..................................................................................................................153.2获取池内商品编号接口..............................................................................................................153.3获取商品详细信息接口..............................................................................................................163.4获取商品上下架状态接口..........................................................................................................183.5获取所有图片信息......................................................................................................................193.6商品好评度查询..........................................................................................................................204、地址api接口.............................................................................................................................214.1获取一级地址..............................................................................................................................214.2获取二级地址..............................................................................................................................214.3获取三级地址..............................................................................................................................224.4获取四级地址..............................................................................................................................235、价格API接口............................................................................................................................245.1批量查询京东价价格..................................................................................................................245.2批量查询协议价价格..................................................................................................................246、库存API接口............................................................................................................................256.1批量获取库存接口......................................................................................................................257、订单API接口............................................................................................................................26内部资料第3页注意保密产品帮助文档7.1(预存款)京东价余额实物下单接口......................................................................................267.2(预存款)协议价余额实物下单接口......................................................................................297.3(货到付款)京东价货到付款实物下单接口..........................................................................327.4(货到付款)协议价货到付款实物下单接口..........................................................................347.5(金采)金融支付京东价实物下单接口(金融支付,京东价,预占库存,发票是否随货【可选】)........................................................................................................................................377.6(金采)金融支付协议价下单接口(金融支付,预占库存,发票是否随货【可选】)...407.7(公司转账)京东价实物下单接口(京东价,预占库存,发票是否随货【可选】).......437.8(公司转账)协议价下单接口(预占库存,发票是否随货【可选】)..............................457.9查询用户余额接口......................................................................................................................487.10确认预占库存订单接口...........................................................................................................497.11取消未确认预留库存订单接口................................................................................................497.12取消确认订单接口...................................................................................................................507.13查询京东订单信息接口...........................................................................................................507.14订单反查接口...........................................................................................................................547.15查询配送信息接口...................................................................................................................558、企销API对账接口....................................................................................................................568.1新建订单查询接口......................................................................................................................568.2获取妥投订单接口......................................................................................................................578.3获取拒收消息接口......................................................................................................................599、信息推送api接口.....................................................................................................................609.1信息推送接口..............................................................................................................................609.2根据推送id,删除推送信息接口.............................................................................................61内部资料第4页注意保密产品帮助文档一、需求背景及概述API(ApplicationProgrammingInterface,应用编程接口),简单说就是预先把客户可能使用到的功能以接口的方式提供出来,就像电源插座一样,只要是两向或者三向插头都可以直接插上,而不用管插头的另一边连的是电脑还是洗衣机。API对接方式的优点有三:客户接入速度极快下面我们来看一个更贴近我们工作场景的例子:有一个客户,现在想跟京东合作,让他们系统可以卖京东的商品。回到以前,客户的业务人员需要与京东进行专门的谈判,签订相关约束条款并且客户的研发团队,与京东的研发团队要日以继夜的开发好几个月,如果发生需求变更(比如增加个审批流)时间会更长。而现在呢,客户只要一个工程师30分钟就可以搞定。客户发展速度极快同样通过举例来说明:相同的研发资源下,联通正在与京东对接时,这时有另外一个客户也要与京东对接,业务模式上只是少了订单审批步骤。回到以前,这样的客户只能等待联通与京东对接完成后,再开始根据需求进行开发。等这些完成以后,客户已经投入国美的怀抱了。现在通过API可以同时与两个客户进行对接,互不影响。极大降低研发成本由于不同客户的对于数据的要求基本不会变,例如商品信息、订单信息等。不会受到展现方式等条条框框的约束。可以真正做到一次开发,不断复用。通过以上两个极快和一个极大降低可以把原来制约业务发展的两个因素:业务扩展能力和系统研发能力减少到一个因素:业务发展速度只受业务扩展能力的制约。所以大力发展API对接客户模式是极为重要的。内部资料第5页注意保密产品帮助文档二、API系统对接流程及过程描述1、API系统对接流程图内部资料第6页注意保密产品帮助文档内部资料第7页注意保密产品帮助文档2、对接过程描述2.1业务谈判1)确定客户类型2)确定下单方式3)确定结算方式4)确定发票处理方式5)确定支付方式6)确认是否还有其它需求2.2需求调研1)产品经理与业务了解业务需求2)判断现有接口是否可以满足,如果满足则开始编写PRD。如果有不能满足的部分,需要确认可行性(与相关系统产品确认)如果可行则开始编写PRD。2.3需求确认1)编写PRD2)与业务方确认PRD里所描述的需求是否与业务需求相符。如果相符,业务方填写需求确认函,如果不相符,产品经理进行PRD修改。2.4系统对接1)如果目前接口可以满足现有业务:业务给客户提供账号及密码客户提供回调地址(必须是线上生产环境的)如果需要技术支持我的QQ:57046445技术给客户提供client_id和client_secret开始对接2)如果目前接口不能满足现有业务:研发进行评估并排期。其它满足业务的部分按上述操作进行。内部资料第8页注意保密产品帮助文档三、系统对接帮助文档(实物)1、授权服务1.1获取AccessTokenURL:https://bizapi.jd.com/oauth2/access_tokenHTTPS请求方式:POST请求参数参数参数选项意义grant_type必须该值固定为access_tokenclient_id必须即创建应用时的client_id(由京东人员提供)timestamp必须当前调用时间,格式为“2014-01-0101:01:01”与京东服务器时差不能相差半小时以上,京东服务器时间为北京时间(年月日和时分秒中间有空格)username必须京东的用户名(注意:在调用我们接口时,如果username是中文,在url参数里面,需要将username使用urf-8格式进行UrlEncode编码,在生成sign签名串时,不需要进行编码,使用原文!)password必须京东的用户密码,必须是md5加密后的字符串,不要使用原文!scope非必须申请权限。(目前推荐为空。为以后扩展用)sign必须签名,生成规则如下:1.按照以下顺序将字符串拼接起来client_secret+timestamp+client_id+username+password+grant_type+scope+client_secret其中client_secret的值是京东分配的username使用原文,password需要md5加密后的2.将上述拼接的字符串使用MD5加密,加密后的值再转为大写返回结果:类型JSON参数意义UIDAccess_tokenRefresh_tokentime当前时间expires_inAccess_token的过期时间,秒级别,有效期24小时refresh_token_expiresrefresh_token的过期时间,毫秒级别内部资料第9页注意保密产品帮助文档示例代码:输入参数:1.grant_type=access_token2.client_id=yourclientid3.username=yourpin4.password=yourpassword5.timestamp=2014-01-0101:01:016.scope=京东分配的client_secret=yourclientsecret把所有参数按照顺序拼接起来,结果如下:yourclientsecret2014-01-0101:01:01yourclientidyourpinyourpasswordaccess_tokenyourclientsecretsign值为上述字符串进行MD5加密后转为大写,结果如下:sign=00C29BAAB23BBCE20C9BBD9C180E8330具体生成的访问url为:https://bizapi.jd.com/oauth2/access_token?grant_type=access_token&client_id=yourclientid&scope=&username=yourpin&password=yourpassword×tamp=2014-01-0101:01:01&sign=00C29BAAB23BBCE20C9BBD9C180E8330如果username是中文的话,在url中,需要进行UrlEncode.encode(“中文”,”utf-8”);返回示例如下(包括AccessToken和RefreshToken等信息):{"uid":"111111","access_token":"access_token","refresh_token":"refresh_token","time":1381480688147,"expires_in":86400,"refresh_token_expires":1397205488147}其中time为当前时间expire_in为access_token的过期时间,秒级别,代表86400秒后过期,即24小时有效期refresh_token_expires为refresh_token的过期时间1.2使用RefreshToken刷新AccessTokenURL:https://bizapi.jd.com/oauth2/refresh_tokenHTTPS请求方式:POST请求参数参数名称参数选项意义refresh_token必须授权时获取的refresh_token内部资料第10页注意保密产品帮助文档client_id必须京东提供的client_idclient_secret必须京东提供的client_secret返回结果:类型JSON参数意义UIDAccess_tokenRefresh_tokentime当前时间expires_inAccess_token的过期时间,秒级别,有效期24小时refresh_token_expiresrefresh_token的过期时间,秒级别返回示例{"uid":"111111","access_token":"access_token","refresh_token":"refresh_token","time":1381480688147,"expires_in":86400,"refresh_token_expires":1397205488147}time为当前时间expire_in为access_token的过期时间,秒级别,代表86400秒后过期,即24小时有效期refresh_token_expires为refresh_token的过期时间注意事项:请将access_token和refresh_token进行数据库保存,access_token的有效期为24小时,如果access_token过期,请使用refresh_token进行刷新。推荐的方式是,利用定时器,每天凌晨调用刷新接口,使用refresh_token刷新一个新的access_token。内部资料第11页注意保密产品帮助文档2、API调用流程图内部资料第12页注意保密产品帮助文档3、商品API接口3.1获取商品池编号接口URL:https://bizapi.jd.com/api/product/getPageNumHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstoken返回结果{"result":[{"name":"池子名称","page_num":1},{"name":"池子名称2","page_num":2}]}3.2获取池内商品编号接口URL:https://bizapi.jd.com/api/product/getSkuHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstokenpageNum必须池子编号返回结果{"result":"123123,152352"}3.3获取商品详细信息接口URL:https://bizapi.jd.com/api/product/getDetailHTTPS请求方式:POST请求参数内部资料第13页注意保密产品帮助文档参数名称参数选项意义token必须授权时获取的accesstokensku必须商品编号,只支持单个查询返回结果{"result":{"sku":商品编号,"weight":"重量","imagePath":"主图地址","state":上下架状态,"brandName":"品牌","name":"商品名称","productArea":产地,"upc":条形码,"saleUnit":销售单位,"category":类别,"introduction":"<divclass='content_tpl'><divclass='formwork_bt'><divclass='formwork_bt_it'><span>产品信息</span><spanclass='s2'>ProductInformation</span></div></div><divclass='formwork'><divclass='formwork_img'><imgsrc='http://img20.360buyimg.com/vc/g12/M00/06/08/rBEQYVGTRrMIAAAAAAF59yhoUI4AABOYQOudsQAAXoP109.jpg'alt=''/></div></div><divclass='formwork_bt'><divclass='formwork_bt_it'><span>产品特色</span><spanclass='s2'>SellingPoint</span></div></div><divclass='formwork'><divclass='formwork_img'><imgsrc='http://img20.360buyimg.com/vc/g12/M00/06/08/rBEQYVGTRtEIAAAAAAKREgbm5fkAABOYwF1DeAAApEq566.jpg'alt=''/></div></div></div>","param":"<tablewidth='100%'cellspacing='1'cellpadding='0'border='0'class='Ptable'><tbody><tr><thcolspan='2'class='tdTitle'>主体</th></tr><tr></tr><tr><tdclass='tdTitle'>品牌</td><td>雷蛇Razer</td></tr><tr><tdclass='tdTitle'>类型</td><td>有线鼠标</td></tr><tr><tdclass='tdTitle'>型号</td><td>地狱狂蛇镜面特别版</td></tr><tr><tdclass='tdTitle'>颜色</td><td>黑色</td></tr><tr><thcolspan='2'class='tdTitle'>规格</th></tr><tr></tr><tr><tdclass='tdTitle'>传输方式</td><td>线缆</td></tr><tr><tdclass='tdTitle'>人体工学</td><td>否</td></tr><tr><tdclass='tdTitle'>鼠标工作方式</td><td>光电</td></tr><tr><tdclass='tdTitle'>鼠标分辨率</td><td>3500dpi</td></tr><tr><tdclass='tdTitle'>接口</td><td>USB</td></tr><tr><tdclass='tdTitle'>鼠标尺寸</td><td>115(L)x63(W)x40(H)mm</td></tr><tr><tdclass='tdTitle'>重量</td><td>0.09kg</td></tr></tbody></table>","wareQD":"笔记本主机x1电池x1电源适配器x1"内部资料第14页注意保密产品帮助文档}}注意事项其中:param返回的是规格参数Introduction详细介绍提供了demo页面分别是规格参数.html,详细介绍.html,样式在demo页面中imagePath为商品的主图片地址。需要在前面添加http://img13.360buyimg.com/n0/其中n0(最大图)、n1(350*350px)、n2(160*160px)、n3(130*130px)、n4(100*100px)为图片大小。例如接口返回imagePath为g8/M03/0E/06/rBEHaFCg5wQIAAAAAAGhG73oiLUAACxswH4MBwAAaEz619.jpg拼接后的url为:http://img13.360buyimg.com/n0/g8/M03/0E/06/rBEHaFCg5wQIAAAAAAGhG73oiLUAACxswH4MBwAAaEz619.jpg3.4获取商品上下架状态接口URL:https://bizapi.jd.com/api/product/skuStateHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstokensku必须商品编号,支持批量,以,分隔(最高支持100个商品)1为上架,0为下架返回结果{"result”:[{"skuId”:111111,”state”:1},{"skuId”:111111,”state”:0}]}3.5获取所有图片信息URL:https://bizapi.jd.com/api/product/skuImageHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstoken内部资料第15页注意保密产品帮助文档sku必须商品编号,支持批量,以,分隔(最高支持100个商品)返回结果{"result:["100012”:[{"path":”7393/ca49c783-e1bb-418f-8063-47a6d20158ca.jpg”,”isPrimary”:1,”orderSort”:0},{"path":”7393/ca49c783-e1bb-418f-8063-47a6d20158ca.jpg”,”isPrimary”,0,”orderSort”:1}]]}其中path是地址,isPrimary为是否是主图,1为主图,0为附图。orderSort为排序图片路径,如上面商品详情页面返回的图片地址一致。3.6商品好评度查询URL:https://bizapi.jd.com/api/product/getCommentSummarysHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstokensku必须商品编号,支持批量,以,分隔(最高支持50个商品)返回结果参数名称意义averageScore商品评分(5颗星,4颗星)goodRate好评度generalRate中评度poorRate差评度{"result":[{"averageScore":5,"generalRate":0.0,"goodRate":1.0,"skuId":800020,"poorRate":0.0},{"averageScore":5,"generalRate":0.0,"goodRate":1.0,"skuId":800035,"poorRate":0.0}]}内部资料第16页注意保密产品帮助文档4、地址api接口4.1获取一级地址URL:https://bizapi.jd.com/api/area/getProvinceHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstoken返回结果{"result":{"北京":1,"黑龙江":10}"resultCode":null,"success":true,"resultMessage":""}4.2获取二级地址URL:https://bizapi.jd.com/api/area/getCityHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstokenid必须一级地址返回结果{"result":{"顺义区":2812,"海淀区":2800,"通州区":2809内部资料第17页注意保密产品帮助文档}"resultCode":null,"success":true,"resultMessage":""}4.3获取三级地址URL:https://bizapi.jd.com/api/area/getCountyHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstokenid必须二级地址返回结果{"result":{"顺义区":2812,"海淀区":2800,"通州区":2809}"resultCode":null,"success":true,"resultMessage":""}4.4获取四级地址URL:https://bizapi.jd.com/api/area/getTownHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstokenid必须三级地址返回结果{"result":内部资料第18页注意保密产品帮助文档{"红莲街道":2812,"魏公村街道":2800,"广外街道":2809}"resultCode":null,"success":true,"resultMessage":""}5、价格API接口5.1批量查询京东价价格URL:https://bizapi.jd.com/api/price/getJdPriceHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstokensku必须商品编号,请以,分割。例如:J_129408,J_129409(最高支持100个商品)返回结果{"result":[{"skuId":111111,"jdPrice":京东价格},{"skuId":111111,"jdPrice":京东价格}]}5.2批量查询协议价价格URL:https://bizapi.jd.com/api/price/getPriceHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstokensku必须商品编号,请以,分割。例如:J_129408,J_129409内部资料第19页注意保密产品帮助文档(最高支持100个商品)返回结果{"result":[{"skuId":111111,"price":协议价格,"jdPrice":京东价格},{"skuId":111111,"price":协议价格,"jdPrice":京东价格}]}6、库存API接口6.1批量获取库存接口URL:https://bizapi.jd.com/api/stock/getStockByIdHTTPS请求方式:POST请求参数参数名称参数选项意义token必须授权时获取的accesstokensku必须商品编号批量以逗号分隔(最高支持100个商品)area必须格式:1_0_0(分别代表1、2、3级地址)返回结果参数名称意义area地址desc描述sku商品编号state33有货现货-下单立即发货39有货在途-正在内部配货,预计2~6天到达本仓库40有货可配货-下单后从有货仓库配货36预订34无货{"result":[{内部资料第20页注意保密产品帮助文档"area":"1_0_0","desc":"有货","sku":"981268""state":33}]}7、订单API接口7.1(预存款)京东价余额实物下单接口URL:https://bizapi.jd.com/api/order/jdPriceSubmitHTTPS请求方式:POST请求参数参数名称类型参数选项描述tokenString必须授权时获取的accesstokenthirdOrderString必须第三方的订单单号skuString必须[{"skuId":商品编号,"num":商品数量}](最高支持50种商品)nameString必须收货人provinceint必须一级地址cityint必须二级地址countyint必须三级地址townint非必须四级地址(如果该地区有四级地址,则必须传递四级地址)addressStirng必须详细地址zipStirng必须邮编phoneStirng必须座机号(与mobile其中一个有值即可)mobileStirng必须手机号(与phone其中一个有值即可)emailStirng必须邮箱remarkStirng非必须备注(少于100字)invoiceStateint必须开票方式(1为随货开票,0为订单预借,2为集中开票)invoiceTypeint必须1普通发票2增值税发票selectedInvoiceTitleint必须4个人,5单位companyNameString必须发票抬头(如果selectedInvoiceTitle=5则此字段必须)内部资料第21页注意保密产品帮助文档invoiceContentint必须1:明细,3:电脑配件,19:耗材,22:办公用品备注:若增值发票则只能选1明细paymentTypeint必须4:在线支付1:货到付款(如果选择货到付款,则不要传isUseBalance参数)isUseBalanceint必须此值固定是1使用余额submitStateInt必须是否预占库存,0是预占库存(需要调用确认订单接口),1是不预占库存invoiceNameString非必须增值票收票人姓名备注:当invoiceType=2时则此字段必填invoicePhoneString非必须增值票收票人电话备注:当invoiceType=2时则此字段必填invoiceProviceInt非必须增值票收票人所在省备注:当invoiceType=2时则此字段必填invoiceCityInt非必须增值票收票人所在市备注:当invoiceType=2时则此字段必填invoiceCountyInt非必须增值票收票人所在区/县备注:当invoiceType=2时则此字段必填invoiceAddressString非必须增值票收票人所在地址备注:当invoiceType=2时则此字段必填返回结果{"result":{"jdOrderId":京东订单编号,"sku":[{"skuId":商品编号,"num":商品数量,"price":商品单价}],"orderPrice":商品总价}}7.2(预存款)协议价余额实物下单接口URL:https://bizapi.jd.com/api/order/submitHTTPS请求方式:POST请求参数内部资料第22页注意保密产品帮助文档参数名称类型参数选项描述tokenString必须授权时获取的accesstokenthirdOrderString必须第三方的订单单号skuString必须[{"skuId":商品编号,"num":商品数量}](最高支持50种商品)nameString必须收货人provinceint必须一级地址cityint必须二级地址countyint必须三级地址townint非必须四级地址(如果该地区有四级地址,则必须传递四级地址)addressStirng必须详细地址zipStirng必须邮编phoneStirng必须座机号(与mobile其中一个有值即可)mobileStirng必须手机号(与phone其中一个有值即可)emailStirng必须邮箱remarkStirng非必须备注(少于100字)invoiceStateint必须开票方式(1为随货开票,0为订单预借,2为集中开票)invoiceTypeint必须1普通发票2增值税发票selectedInvoiceTitleint必须4个人,5单位companyNameString必须发票抬头(如果selectedInvoiceTitle=5则此字段必须)invoiceContentint必须1:明细,3:电脑配件,19:耗材,22:办公用品备注:若增值发票则只能选1明细paymentTypeint必须4:在线支付1:货到付款(如果选择货到付款,则不要传isUseBalance参数)isUseBalanceint必须此值固定是1使用余额submitStateInt必须是否预占库存,0是预占库存(需要调用确认订单接口),1是不预占库存invoiceNameString非必须增值票收票人姓名备注:当invoiceType=2时则此字段必填invoicePhoneString非必须增值票收票人电话备注:当invoiceType=2时则此字段必填invoiceProviceInt非必须增值票收票人所在省备注:当invoiceType=2时则此字段必填invoiceCityInt非必须增值票收票人所在市备注:当invoiceType=2时则此字段必填内部资料第23页注意保密产品帮助文档invoiceCountyInt非必须增值票收票人所在区/县备注:当invoiceType=2时则此字段必填invoiceAddressString非必须增值票收票人所在地址备注:当invoiceType=2时则此字段必填返回结果{"result":{"jdOrderId":京东订单编号,"sku":[{"skuId":商品编号,"num":商品数量,"price":商品单价}],"orderPrice":商品总价}}7.3(货到付款)京东价货到付款实物下单接口URL:https://bizapi.jd.com/api/order/jdPriceSubmitHTTPS请求方式:POST请求参数参数名称类型参数选项描述tokenString必须授权时获取的accesstokenthirdOrderString必须第三方的订单单号skuString必须[{"skuId":商品编号,"num":商品数量}](最高支持50种商品)nameString必须收货人provinceint必须一级地址cityint必须二级地址countyint必须三级地址townint非必须四级地址(如果该地区有四级地址,则必须传递四级地址)addressStirng必须详细地址zipStirng必须邮编内部资料第24页注意保密产品帮助文档phoneStirng必须座机号(与mobile其中一个有值即可)mobileStirng必须手机号(与phone其中一个有值即可)emailStirng必须邮箱remarkStirng非必须备注(少于100字)invoiceStateint必须开票方式(1为随货开票,0为订单预借,2为集中开票)invoiceTypeint必须1普通发票2增值税发票selectedInvoiceTitleint必须4个人,5单位companyNameString必须发票抬头(如果selectedInvoiceTitle=5则此字段必须)invoiceContentint必须1:明细,3:电脑配件,19:耗材,22:办公用品备注:若增值发票则只能选1明细paymentTypeint必须1:货到付款submitStateInt必须是否预占库存,0是预占库存(需要调用确认订单接口),1是不预占库存invoiceNameString非必须增值票收票人姓名备注:当invoiceType=2时则此字段必填invoicePhoneString非必须增值票收票人电话备注:当invoiceType=2时则此字段必填invoiceProviceInt非必须增值票收票人所在省备注:当invoiceType=2时则此字段必填invoiceCityInt非必须增值票收票人所在市备注:当invoiceType=2时则此字段必填invoiceCountyInt非必须增值票收票人所在区/县备注:当invoiceType=2时则此字段必填invoiceAddressString非必须增值票收票人所在地址备注:当invoiceType=2时则此字段必填返回结果{"result":{"jdOrderId":京东订单编号,"sku":[{"skuId":商品编号,"num":商品数量,"price":商品单价}],内部资料第25页注意保密产品帮助文档"orderPrice":商品总价}}7.4(货到付款)协议价货到付款实物下单接口URL:https://bizapi.jd.com/api/order/submitHTTPS请求方式:POST请求参数参数名称类型参数选项描述tokenString必须授权时获取的accesstokenthirdOrderString必须第三方的订单单号skuString必须[{"skuId":商品编号,"num":商品数量}](最高支持50种商品)nameString必须收货人provinceint必须一级地址cityint必须二级地址countyint必须三级地址townint非必须四级地址(如果该地区有四级地址,则必须传递四级地址)addressStirng必须详细地址zipStirng必须邮编phoneStirng必须座机号(与mobile其中一个有值即可)mobileStirng必须手机号(与phone其中一个有值即可)emailStirng必须邮箱remarkStirng非必须备注(少于100字)invoiceStateint必须开票方式(1为随货开票,0为订单预借,2为集中开票)invoiceTypeint必须1普通发票2增值税发票selectedInvoiceTitleint必须4个人,5单位companyNameString必须发票抬头(如果selectedInvoiceTitle=5则此字段必须)invoiceContentint必须1:明细,3:电脑配件,19:耗材,22:办公用品备注:若增值发票则只能选1明细paymentTypeint必须1:货到付款submitStateInt必须是否预占库存,0是预占库存(需要调用确认订单接口),1是不预占库存invoiceNameString非必须增值票收票人姓名内部资料第26页注意保密产品帮助文档备注:当invoiceType=2时则此字段必填invoicePhoneString非必须增值票收票人电话备注:当invoiceType=2时则此字段必填invoiceProviceInt非必须增值票收票人所在省备注:当invoiceType=2时则此字段必填invoiceCityInt非必须增值票收票人所在市备注:当invoiceType=2时则此字段必填invoiceCountyInt非必须增值票收票人所在区/县备注:当invoiceType=2时则此...