WebService接+口设计说明书-客户部分.doc

WebService接口设计说明书 文思创新技术有限公司 2012年9月 关于本文档 主 题 WebService接口设计 说　　明 本文档说明了WebService接口功能需求和接口详细设计 适用对象 相关需求人员、相关开发人员 修 订 历 史 版 本 章 节 类 型 日 期 作 者 说 明 1.1 3.6 A 2012-9-7 陈浩月 新增客户信息录入接口 说明：类型－创建（C）、修改（U）、删除（D）、增加（A）； 评 审 记 录 角 色 签 名 日 期 说 明 目 录 1. 前言 5 1.1. 目的 5 1.2. 范围 5 1.3. 名词和缩略语 5 1.4. 参考文档 5 2. 概述 6 2.1. 需求描述 6 2.2. 接口实现技术说明 6 2.3. 业务流程 6 2.4. 业务规则说明 6 2.5. 接口定义概述 6 3. 核心系统提供服务定义 6 3.1. 公共信息说明 6 3.2. 客户信息保存 7 4. 代码注释 13 4.1. 客户状态 13 4.2. 客户类型 13 4.3. 来源地区 13 4.4. 所属机构 13 4.5. 机构等级 13 4.6. 资本结构 14 4.7. 币种 14 4.8. 评级机构 16 4.9. 信用等级 16 5. 待确认问题 19 6. 已确认问题 19 7. 数据结构设计 19 前言 目的 作为双方接口实现及接口调用的标准文件，双方将按照本文所描述的内容完成各自的工作，当接口调用过程中发生不一致时，以此文作为最终判断依据。本文档仅用于描述为实现WebService接口，所需要的相关定义。 范围 此处应该是说明适用该接口的范围，如客户信息等。以下表格可以考虑放在服务定义处描述。 增加通用业务规则 在中再保险项目中，根据用户需求，需要在核心业务系统中实现外围系统客户在核心系统保存功能。 名词和缩略语 名词及缩略语 解释 技术层术语 SOAP 简单对象访问协议（Simple Object Access Protocol）。 WebService 一种接口标准。WebService的主要目标是跨平台的互操作性。为了达到这一目标，WebService完全基于XML（可扩展标记语言）、XSD（XMLSchema）独立于平台、独立于软件供应商的标准，是创建可互操作的、分布式应用程序的新平台。 参考文档 概述 需求描述 在核心业务系统中实现外围系统客户在核心系统保存功能。 接口实现技术说明 采用WebService axis交互方式。 代码 数据类型 非空 编码 备注 1 结果代码 resultCode String Y Y 见3.1.2 2 错误信息 errorMessage String Y 具体错误信息 代码 返回错误信息代码 代码 说明 200 成功 101 重复数据 102 业务错误 103 系统异常 规则 其中所有接口的比例入参，如偿付能力充足率等，不需要转化小数后结果，如偿付能力充足率为30%，则相对应字段传送30； 客户信息保存 客户信息保存接口 CustomerInfoWebService 用途 客户信息交互是指通过服务接口向核心系统传送客户数据的过程。由核心系统提供本接口，核心系统会对客户数据做永久保存。 声明 待提供WSDL后更新 入口参数 序号 名称 代码 数据类型 非空 编码 备注 操作类型 BusinessType Char(1) N 新增 修改 客户基本信息 CustomerInfo CustomerInfo N 客户信息 账户信息 AccountList ListAccount 账户信息集合 财务实力评级CreditList ListCredit 财务实力评级偿付能力SolvencyList ListSolvency 偿付能力AntiMoneyLaundering AntiMoneyLaundering 反洗钱信息 联系人 ContactPersonList ListContactPerson 联系人集合 CustomerInfo类型 代码 数据类型 非空 编码 备注 公司名称 customerName varchar(128) N 唯一性，不可重复 公司简称 customerShortName varchar(128) N 唯一性，不可重复 公司简码 companyTemp varchar(4) N 唯一性，不可重复 资本结构 c