52文库-文库文档资料大全! 
圆通开放平台常见问题解答
如有疑问，请进入圆通官方网站查询。
Q:什么是圆通开放平台？
A:圆通开放平台是基于圆通基础数据的开放平台，提供给总公司内部各部门、外部合作伙伴与网点参与的一个数据交互平台，例如数据接口、数据同步等。它是圆通信息一体化，规范化的重要渠道。我们的使命是把更快的提升圆通信息化水平，更好的提升圆通服务质量。
Q:如何注册成为开放平台用户？
A:请先与圆通相关业务人员取得联系，洽谈好相关业务，再到开放平台注册成为开放平台用户。
Q:接口目前有哪些？分别能实现什么功能
A:如需了解平台开放有哪些接口，以及各个接口对应业务场景说明，请仔细阅读接口文档。
Q:接口请求协议及方式是什么？
A:请按HTTP协议POST方式请求接口。
Q:我不知道哪个接口能实现我想要的功能，这个时候该怎么办？
A:仔细阅读接口文档，或者您跟业务部门取得联系之后，业务部门会引导您正确的调用开放平台的接口。
Q:如何获取接口调用参数？
A:您需要先注册成为开放平台用户，然后申请接口，申请成功后，就可以查看到对应的接口参数。
Q:我注册之后申请到的参数可以调用所有接口吗？
A:目前正式参数只可以调用服务类的接口，若需调用订单类、电子面单类接口，请与我们业务部门联系。
Q:每天有接口请求访问数量限制吗？
A:目前接口没有访问数量上的限制。
Q:KK系统的DES加密一直都跟文档中给出的不一致怎么办？
A:DES加密可以参照Demo中给出的代码，java语言正常使用，.net加密秘钥是下单接口的秘钥，其他秘钥需要单独配置。php有两种方式，第一，客户服务器允许运行java环境，可以使用demo中的方法；第二客户服务器不允许运行java环境，对接我们的获取加密报文接口。
Q:KK系统测试环境测试通过了是否可以上线使用？
A:不可以，测试环境用于前期开发环节，用于验证是否成功推送数据给我们。测试环境不推送数据给海关。
Q:KK为什么要进行线上实单测试？
A:实单测试是在正式环境中进行的，使用正式账号，主要是用于确定报文字段是否正确。
Q:KK对接电子口岸新系统是看哪个接口文档？
A:看郑州新郑海关的对接文档。
Q:包装种类（packageTypeCiq）、运输方式（transportationMethod）等字段填什么内容？--KK
A:这些按照接口文档里说明，查看数据字典，例如包装种类：纸箱对应的4M。
Q:海关那边显示与申报单不符是什么情况？--KK
A:这个通常是由于申报价值（worth）、件数（packNum）、数量（quantity）导致的，测试的时候联系我们这边修改再重推就行。
Q:我们这边数据错误，需要重新报关怎么办？--KK
A:自己联系海关与圆通，删除数据，然后重新推送订单给圆通。
Q:海外的走件信息，我们推给圆通与圆通官网显示的可以我们自定义吗？--KK
A:不可以，只能参照接口文档里给出的几个，如果想要用自己自定义的，另外提一份需求过来，我们这边评估后给出是否能添加的结果。
Q:订单数据需要多久才能推送给海关？--KK
A:大概五分钟左右，如果是电商活动日，数据多可能会造成数据积压，会慢一点。
Q:海外走件信息推送过去之后，大概多久后会在官网显示？--KK
A:10分钟左右。
Q:状态推送接口怎么测试？
A:在开放平台的联调页面，接口类型选择“订单类”接口，接口名称选择“物流状态通知接口”，然后在客户Url中填写测试环境的地址，点击提交我们这边就可以把数据推送过去了。
Q:为什么推送过来的数据解析不正确？
A:开放平台使用.net开发，对于特殊字符会经过处理，例如“+”会变成空格，测试环境中处理一下就行，正式环境是java语言，不会出现这种情况。
Q:物流状态推送接口正式上线后什么时候会有数据推送过来？
A:正常会在进行扫描操作后就会有数据推送。
Q:订单取消接口随时都能用来取消订单吗？
A:必须在上门揽收之前通过接口取消订单，而且不支持电子面单的取消订单。
Q:物流状态推送接口是每条状态都推送吗？
A:不是，推送的状态是根据客户需求配置的，参照接口文档里说明的那几个状态。
Q:圆通电子面单下单接口采用的是什么传输协议？
A:接口均采用Http传输协议。
Q:圆通电子面单下单接口用什么方式请求？
A:Get请求用于测试是否可以连通圆通接口服务器，数据传输必须用post请求。
Q:接口下单一共要传哪些参数？
A:主体一共是四个，logistics_interface data_digest clientId type
Q:电子面单的加密方式是怎样的？
A:签名的原理是对要发送的xml报文字符串加上商家密钥，先进行MD5加密，然后转换成base64字符串，作为数字签名的数据。即： Base64 (MD5(16位) (logistics_interface +partnerId ))最后对所有参数的数据内容进行url编码。
Q:电子面单运单号是怎样拉取的？
A:拉取电子面单号接口是你们把订单信息及订单号通过接口上传到圆通,这边会返回给你们匹配好的运单号、三段码等数据。
Q:电子面单接口为什么会报S01错误？
A:上传的订单报文不合法，在请求报文中你们可能漏传了我们接口要求必传的字段，或者填写的格式不在正确，数据有问题，有特殊符号等等
Q:电子面单接口为什么会报S02错误？
A:1.测试地址不对 2.测试的账号密钥不匹配 3.加密方式有问题
Q:我在开发过程中，签名规则一直不正确，该怎么办？
A:你可以在接口文档内，查看各接口类中的签名规则。
Q:订单号的生成规则是怎样的？
A:获取电子面单请求,是上传一单(订单号)返回一单(运单号),订单号跟运单号是一对一的,还有就是你们传的订单号必须是唯一的,相同订单上传的话,会返回你第一次请求的运单号.
Q:官网上联调没问题，但是代码请求只返回success，没有轨迹数据？--走件流程接口
A:1.使用了get请求，接口只接受post请求，使用get请求会导致只返回success。 2.没有用&符相连，参数之间要用&符相连 3.参数名要为v，sign，user_id，大小写不兼容 4.contentType：application/x-www-form-urlencoded;charset=utf-8，其他类型的contentType不可以。
Q:我想使用走件流程接口该怎么做？
A:1.先在开放平台上注册账号，选择对应的审核人员。如不知对应的审核人员是谁可询问圆通业务人员，否则无人审核。 2.审核通过后，登录账号，申请走件接口，等待审核通过 3.走件开通后，可在页面中看到走件接口的相关参数，使用参数进行联调即可。（注：走件只有正式账号，接口开通后显示的即为正式账号。）
Q:走件流程接口的API协议的版本号填什么？
A:1.01
Q:电子面单接口为什么会报S06错误？
A:并发请求太快，圆通电子面单接口禁止用多线程访问，上传一单返回一单。也有可能是你们自身的网络原因导致。
Q:电子面单接口为什么会报S03错误？
A:1，客户编码中没有单号了，需要联系网点。2，请求单号的类型不对（一共有普通单号，COD单号两种）
Q:电子面单接口为什么会报S04错误？
A:接口请求参数为空：logistics_interface, data_digest或clientId 缺一不可。
Q:电子面单接口为什么会报S09错误？
A:数据入库异常，联系电子面单开发项目组成员。
Q:代收货款没有录单金额怎么办？
A:代收货款没有录单金额,要从几个可能性上去分析 1.客户上传订单，没有带上金额 2.客户上传订单，有金额，但是没有在系统里配置 3.客户上传订单，有金额，也有配置，但是没有在金刚通过COD审核 4.客户上传订单，有金额，也有配置，金刚通过了COD审核，但是订单没有推送到金刚 5.客户没有上传订单
Q:itemsWeight字段可以不传吗？--电子面单
A:itemsWeight该字段要么不传，要么必须赋值，传0也是可以的。
