中国邮政EMS及邮政小包API对接文档

简介：
本文档详细介绍了如何通过API实现与中国邮政EMS和邮政小包服务的数据对接方法、参数设置及接口调用指南。 中国邮政的“新一代寄递业务信息平台咨询设计”项目的接口需求说明书主要涵盖了多个API接口，这些接口主要用于电子商务商家与邮政小包服务之间的对接，确保包裹从寄送、追踪到派揽以及账单处理等环节能够实现自动化和高效性。 ### 1. 订单信息接入 - **订购服务申请接口**：允许商家提交订单请求，并提供必要的订单详情如寄件人及收件人的信息。 - **服务审核接口**：邮政系统对商家的订单进行合规性和准确性的核查，确保流程顺畅无误。 - **下单取号接口**：在通过审核后，此接口用于获取物流运单号码以便后续跟踪包裹状态。 - **订单接入接口**：允许商家向邮政平台提交完整订单信息开始处理过程。 - **白名单订阅接口**：提供给有需要的商家以订阅特定服务，并接收实时更新或通知消息。 - **订单更新接口**：当任何有关于现有订单的信息发生变化时，此功能可以让商家进行相应的修改操作。 - **订单取消接口**：允许在必要情况下通过该接口撤销已提交但未处理完毕的订单请求。 ### 2. 四级分拣码 这是一种邮政系统内部使用的编码体系，旨在确保包裹能够准确无误地被送达到指定目的地。 ### 3. 轨迹信息接口 - **运单轨迹信息获取接口**：商家或用户可以通过此功能查询到包裹的实时位置和运输状态。 - **运单轨迹信息推送接口**：邮政系统会主动向相关方提供最新的包裹动态消息，确保及时更新。 ### 4. 派揽相关接口 - **上门取件接口（派揽）**：商家可以安排邮递人员到指定地点收取包裹，并且包括预约时间和安全认证的设置。 - **派揽状态返回接口**：反馈关于取件操作的结果信息，例如是否成功完成等。 - **揽收结果返回接口**：告知商家有关于此次揽收的具体情况和相关细节。 - **揽收结果查询接口**：提供进一步的信息查询服务以获取完整的揽收详情。 ### 5. 账单相关接口 - **运费计算接口**：根据包裹的重量、目的地等因素生成相应的费用信息供参考使用。 - **账单查询接口**：商家可以查看历史和当前的所有账目情况，以便于财务管理。 - **账单明细接口**：详细列出每笔交易的具体费用项目，如运输费及其他附加服务收费等。 ### 6. 安全及数据完整性 所有涉及到的API都包含了必要的安全认证机制以确保在传输过程中信息的安全性和防止任何未经授权的数据篡改行为。例如，在下单取号接口中对某些字段进行了必填项的要求调整来增强系统的安全性并改善用户体验。 这些不断迭代更新的功能和优化措施体现了中国邮政为适应市场需求和技术进步所作出的努力，旨在提供更加稳定且全面的服务体验给用户。比如增加了预约定时服务、提升了揽收范围描述的准确性以及异常原因说明等改进点，以进一步提升服务质量。此外还提供了SDK示例及多种编程语言下的调用方式指导文档，方便开发者进行集成和使用该平台的各项功能和服务。