广东省全员人口系统与查环查孕接口详细指南

本文档详细介绍了广东省全员人口系统与查环查孕系统之间的接口规范，以便于接口开发和测试。这两个系统之间的数据交换是通过WebService服务进行的，接口设计基于XML格式的数据报文。 接口概述： 接口的核心是双向数据传输，省全员人口系统作为服务提供者，通过发布WebService服务，提供了个案查询接口和查环查孕结果接收接口。查环查孕系统则作为客户端，实时调用这些接口来获取和提交数据。接口调用的过程是：首先，查环查孕系统通过个案查询接口获取待检查的个案信息；然后，在完成检查后，将检查结果通过查环查孕结果接收接口发送回全员人口系统。 接口设计细节： 1. WebService服务的接口地址以HTTPS方式访问，示例地址为`https://192.168.0.200:8443/ws/GdjsDataExchange?wsdl`，实际应用时需替换为生产环境的IP和端口。 2. 服务接口方法名为`execute`，接受一个XML格式的参数，包括业务编号和请求参数。请求参数内容由开发者根据实际需求填充，字符集为UTF-8。 3. 方法的返回值同样为XML格式，包含了处理结果，字符集也是UTF-8。 接口规范部分详细说明了两个主要接口的操作： 4.1 服务随机码接口： - 请求报文规范：包含了业务代码，可能还包含其他必要的请求参数，如随机码等。 - 应答报文规范：可能返回服务验证结果，如随机码是否有效等。 4.2 全员个案查询接口： - 请求报文规范：用户输入的查询条件（如姓名、身份证号等）封装在XML中。 - 应答报文规范：返回查询到的个案信息，包括个人基本信息和相关计划生育记录。 4.3 查环查孕结果接收接口： - 请求报文规范：包含检查结果信息，如检查日期、检查项目、结果状态等。 - 应答报文规范：系统接收到结果后确认处理状态，并可能给出后续操作建议。 5. 接口返回码： 提供了一组标准化的返回码，用于表示接口调用的成功与否以及具体的错误信息。 6. 编码表： 对接口调用过程中可能出现的各类数据进行了编码，如检查方法（如TCT检查、B超检查）、查孕结果（如已婚未育、已采取避孕措施等）、查环结果（如环状避孕器正常、缺失等）以及服务机构和避孕节育措施的信息。 总结来说，这份接口说明文档为开发者提供了清晰的指导，帮助他们在省全员人口系统和查环查孕系统之间建立稳定、高效的数据交换流程。