阳光采购网与EAM接口方案.doc

阳光采购网 EAM 接口方案 阳光采购网与 EAM 接口方案 珠海市同海科技股份有限公司 2014 年 10 月 阳光采购网 EAM 接口方案 2/18 目目 录录 1.介绍4 1.1.目标.4 1.2.文档范围 .4 2.系统详细解决方案5 2.1.与 EAM 业务划分5 2.2.接口集成架构6 2.2.1.WebService 架构.6 2.3.供应商信息6 2.3.1.业务场景6 2.3.2.服务商接口说明7 2.3.2.1.服务信息7 2.3.2.2.输入7 2.3.2.3.输出8 2.4.询价、招标信息.10 2.4.1.业务场景10 2.4.2.采购单导入接口说明10 2.4.2.1.服务信息10 2.4.2.2.输入11 2.4.2.3.输出13 2.4.3.采购单作废接口说明14 2.4.3.1.服务信息14 2.4.3.2.输入14 2.4.3.3.输出14 2.4.4.采购单结果接口说明15 2.4.4.1.服务信息15 2.4.4.2.输入15 2.4.4.3.输出15 2.5.附件信息 .17 2.5.1.业务场景17 2.5.2.附件下载接口说明17 2.5.2.1.服务信息17 2.5.2.2.输入17 2.5.2.3.输出18 阳光采购网 EAM 接口方案 3/18 文档信息文档信息 编写者编写日期 审核者审核日期 批准人批准日期 变更历史变更历史 版本号日期变更者变更描述批准 1.12014.10.16 初步讨论确认接口内容 1.22014.10.21 修改完善接口方案 阳光采购网 EAM 接口方案 4/18 1. 介绍介绍 1.1.目标目标 本文档的目的是表述阳光采购网与佛山恒益资产管理系统（EAM 系统）之 间数据交换解决方案，以及具体的实施计划。 阳光采购网系统包括内网、外网两个部分，内网主要用于用户方单位进行 物资采购的相关操作，外网实现供应商报价；内、外网相结合，解决在询价和 招投标过程中的质疑、澄清工作。 内网的询价招标来自 EAM 系统中审批过的询价招标，由采购经理确认后 将询价招标发布到外网，进行询价/招标工作；供应商在外网报价，询价/招标 确定预中标单位后，将报价结果返回到 EAM 系统。 1.2.文档范围文档范围 本文档为阳光采购网项目涉及的相关系统方案，将主要针对供应商管理模 块、询价、招标、合同模块与 EAM 系统接口的解决方案以及以上模块运行相 关业务流程做详细的描述。 阳光采购网 EAM 接口方案 5/18 2. 系统详细解决方案系统详细解决方案 2.1.与与 EAM 业务划分业务划分 供应商管理：供应商管理： 阳光采购网系统负责供应商资料的收集、变更及审批；EAM 系统责负责供 应商的评价工作； 采购管理：采购管理： 由 EAM 系统传递已审批的询价招标单，在阳光采购网中进行发标、质疑/ 澄清、供应商报价、开标、业务员预决标的操作，将预决标的结果传递给 EAM 系统。 第三方系统内网 询价/招标 报价结果 写入报价结果 外网 报价 合格供应商合格供应商注册供应商 询价/招标读取 阳光采购网 EAM 接口方案 6/18 2.2.接口集成架构接口集成架构 2.2.1.WebService 架构架构 1、 接口须经过验证才能被调用； 2、 接口双方握手成功，方可获取下行数据，或上传业务数据。 阳阳光光采采购购网网Web Service接接口口调调用用 供供应应商商门门户户接接口口业业务务系系统统 1 获取/上传 数据 1 响应请求 1 得到结果 返回处理结果 系统ID + 用户名+ 用户Key 2.3.供应商信息供应商信息 2.3.1.业务场景业务场景 停用原 EAM 系统的供应商，以阳光采购网中的供应商信息的编码作为判 断条件来同步阳光采购网系统供应商的数据。 场景举例：场景举例： 场景 1：阳光采购网中新增供应商信息？ 阳光采购网 EAM 接口方案 7/18 供应商在阳光采购网外网进行新注册，注册完毕后，网站管理员接收供应 商资料后，由采购经理在内网将供应商进行提交审批，审批通过后，EAM 通过 调用“服务商接口”将新增的供应商信息读取出来并进行同步操作，根据供应 商编码作为区分唯一标识，EAM 从新增信息中取走供应商的信息，如果出现误 差的地方将做更新处理。 场景 2：阳光采购网中修改供应商信息？ 供应商在外网修改供应商信息后，同步数据至内网，EAM 通过调用“服务 商接口”得到最后修改日期范围内的所有已修改供应商信息，EAM 根据最新的 修改的数据进行同步更新操作。 场景 3：会员报价后如何新增供应商？ 在询价过程中出现会员报价时，将报价结果发送至 EAM 中，EAM 有相关 的供应商没有在供应商库的提示，根据提示，采购经理进入至阳光采购网内网 中将相关的供应商审批成为合格的供应商，并通过接口进行同步即可。 2.3.2.服务商接口说明服务商接口说明 2.3.2.1.服务信息服务信息 服务名称服务名称 GetSupplierSrv 服务描述服务描述第三方系统使用此服务向 B2B 系统读取合格供应商信息 服务类型服务类型 读出 写入 同步同步/ /异步方式异步方式 同步 异步 实现方式实现方式 WebService JMS ODI 业务规则和逻辑业务规则和逻辑 1.前期进行编码映射，后期双方系统供应商编码以 B2B 编码为准 出错和异常处理机制出错和异常处理机制调用失败后记录日志并重试，若重试 3 次全部不成功，则进行人工干预。 数据量数据量应控制查询时间(即服务商入网时间条件)进行查询，B2B 限制只可查询时间范围为 3 个 月以内的数据。 服务安全和权限要求服务安全和权限要求双方通过定义用户名及密码进行安全验证，需做到可不定时修改密码。 使用建议使用建议建议第三方系统具备手动、自动调用同步接口的功能。定时调用最好避开用户使用时间 2.3.2.2.输入输入 MsgHeader 阳光采购网 EAM 接口方案 8/18 序序 号号 字段名称字段名称字段描述字段描述数据类型数据类型要求要求字段约束字段约束 1.SYSTEM_ID 服务消费方系统 ID VARCHAR2(30)Y 取统一定义的系统编码 2.SYSTEM_NAME 服务消费方系统名称 NVARCHAR2(30)Y 取统一定义的系统名称 3.USER_ID 用户 ID VARCHAR2(50)Y 服务消费方系统操作用 户 ID 4.USER_KEY 用户密匙 VARCHAR2(50)Y 服务消费方系统操作用 户 5.InputCollectionInputCollection 查询条件对象 ObjectY 查询条件对象 InputCollectionInputCollection 序号序号字段名称字段名称字段描述字段描述数据类型数据类型要求要求字段约束字段约束 1.SU_CODE 供应商编码 VARCHAR2(30)N 2.SU_NAME 供应商名称 NVARCHAR2(100)N 3.SU_SHORTNAME 供应商简称 NVARCHAR2(30)N 4.SU_BUSCODE 营业执照注册号 VARCHAR2(60)N 5.SU_ED_START 最后更新日期始 DATEN 默认为当前时间 6.SU_ED_END 最后更新日期止 DATE N 默认为当前时间，时间段不可超出 3 个月 2.3.2.3.输出输出 OutputCollection 序号序号字段名称字段名称字段描述字段描述数据类型数据类型备注备注 1.SERVICE_FLAG 服务标识 VARCHAR2(30) 标识服务执行结果，TRUE/FALSE 2.ERROR_MESSAGE 服务消息 VARCHAR2(2000) 如果失败，则返回错误信息 3.Output_Count 返回的供应商 数量 NUMBER 4.Output_XML 返回信息 XML 格式字符串 VARCHAR2(2000) 查询成功的 XML 格式供应商数据集 Output_XMLOutput_XML：格式格式 供应商编码 供应商名称 供应商简称 供应商类型(物资类/工程服务类) 阳光采购网 EAM 接口方案 9/18 营业执照号 国税登记号 地税登记号 组织机构代码 注册资金 成立时间 经营范围 法定代表人 地址 收款银行 银行账号 联行号 开户姓名 注册日期 供应商状态(1 合格 2 已过期 3 已作废) 最后修改日期 用户编码 用户姓名 用户类型(主用户/业务联系人) 电子邮箱 移动电话 固定电话 传真号 阳光采购网 EAM 接口方案 10/18 . 2.4.询价、招标信息询价、招标信息 2.4.1.业务场景业务场景 EAM 系统生成询价/招标单，审批完成后通过接口导入到阳光采购网，在阳 光采购网将询价/招标发布到外网进行供应商报价操作；EAM 获取阳光采购网开 标并议价后所有供应商报价结果。 场景举例：场景举例： 1. 当 EAM 导入询价招标单后，需要进入阳光采购网进行数据确认及发布 操作。 2. 当询价招标从 EAM 导入到阳光采购网后，在没有发布到外网的时候是 可以在 EAM 进行修改的，修改后的数据同步更新到阳光采购网；在询 价招标单发布到外网后，EAM 系统将不可调用接口进行修改，只允许 调用作废接口作废单据后重新导入。 3. 询价在开标日期即将到时需要延期，采购经理至阳光采购网内网进行延 期，同步至外网即可。 4. 开标后，在阳光采购网进行澄清报价，供应商将二次议价结果发送至阳 光采购网后，在预决标操作完成（即已过议价节点）时，EAM 可通过 调用“采购单结果接口”读取询价招标单的所有供应商报价结果。 2.4.2.采购单导入接口说明采购单导入接口说明 2.4.2.1.服务信息服务信息 服务名称服务名称 TH_B2B_ImportTenderSrv 服务描述服务描述第三方系统使用此服务向 B2B 系统导入询价招标单信息 服务类型服务类型 读出 写入 同步同步/ /异步方式异步方式 同步 异步 阳光采购网 EAM 接口方案 11/18 实现方式实现方式 WebService JMS ODI 业务规则和逻辑业务规则和逻辑 1.在 B2B 没有把采购单发布到外网前，第三方系统可通过调用接口修改采购单 2.不提供删除接口，如发布到外网后，需修改采购单据则需要调用采购单作废接口作 废单据后重新导入新的采购单 出错和异常处理机制出错和异常处理机制调用失败后记录日志并重试，若重试 3 次全部不成功，则记录日志进行人工干预。 数据量数据量每次导入单条采购单 服务安全和权限要求服务安全和权限要求双方通过定义用户名及密码进行安全验证，需做到可不定时修改密码。 使用建议使用建议建议第三方系统具备手动、自动调用同步接口的功能。定时调用最好避开用户使用时间 2.4.2.2.输入输入 MsgHeader 序序 号号 字段名称字段名称字段描述字段描述数据类型数据类型要求要求字段约束字段约束 1.SYSTEM_ID 服务消费方系统 ID VARCHAR2(30)Y 取统一定义的系统编码 2.SYSTEM_NAME 服务消费方系统名称 NVARCHAR2(30)Y 取统一定义的系统名称 3.USER_ID 用户 ID VARCHAR2(50)Y 服务消费方系统操作用 户 ID 4.USER_KEY 用户密匙 VARCHAR2(50)Y 服务消费方系统操作用 户 5.InputCollectionInputCollection 采购单数据对象 ObjectY 采购单数据对象 InputCollectionInputCollection 序号序号字段名称字段名称字段描述字段描述数据类型数据类型要求要求字段约束字段约束 1.SYS_CODE 第三方系统采购 单号 VARCHAR2(30)Y 第三方系统采购单号 2.TE_CODE 采购单号 VARCHAR2(30)N B2B 系统中的采购单号 (如需在发布外网前修改采购单则需要 传递) 3.TE_TITLE 采购单描述 NVARCHAR2(30)Y 4.TE_TYPE 采购单类型 NVARCHAR2(20)Y 物资询价/物资招标/工程询价/工程招 标 5.TE_PUB 是否公开 VARCHAR2(20) Y TRUE 公开 FALSE 邀请 (默认为 TRUE) 6.TE_PRE 是否估价 VARCHAR2(20) N TRUE 估价 FALSE 询价招标 (默认为 FALSE) 7.TE_RAISER 提交人工号 VARCHAR2(30)Y 两边人员工号需对应一致 8.TE_RAISER_DATE 提交日期 DATEY 9.TE_CURRENCY 采购单币种 VARCHAR2(30)N 默认为“人民币” 阳光采购网 EAM 接口方案 12/18 序号序号字段名称字段名称字段描述字段描述数据类型数据类型要求要求字段约束字段约束 10.TE_ETA 要求到货天数 NUMBERY 签订合同后 X 天到货 11.TE_QU_ED 报价截止天数 NUMBERY 发布到外网后 X 天后截止 12.TE_QU_DATE 报价截止时间 DATEY 截止时间（时分秒） 13.TE_QUERY_ED 质疑截止天数 NUMBERY 发布到外网后 X 天后截止 14.TE_QUERY_DATE 质疑截止时间 DATEY 截止时间（时分秒） 15.TE_QUTYPE 报价类型 VARCHAR2(20) N TRUE 需全部报价 FALSE 可部分报价 (默认为 TRUE) 16.TE_QUCLASS 报价方式 VARCHAR2(20) N TRUE 网上报价 FALSE 密封邮寄 (默认为 TRUE) 17.TE_SW_DATE 工程计划开工日 期 DATE N 如为工程采购类的，则必填 18.TE_CW_DATE 工程计划竣工日 期 DATE N 如为工程采购类的，则必填 19.TE_MEMO 备注说明 NVARCHAR2(500)N 20.LinesLines 采购采购条目条目数据实体数据实体Y Y采购采购条目数据实体条目数据实体 21.SuppliersSuppliers 邀请供应商邀请供应商数据实体数据实体 N N 邀请供应商数据实体邀请供应商数据实体 如为邀请采购则必填如为邀请采购则必填 22.TermsTerms 条款信息条款信息数据实体数据实体N N采购单条款数据实体采购单条款数据实体 23.DocmentsDocments 附件信息附件信息数据实体数据实体N N采购单附件数据实体采购单附件数据实体 LinesLines : : 采购条目数据实体采购条目数据实体 序号序号字段名称字段名称字段描述字段描述数据类型数据类型 要要 求求 字段约束字段约束 1.TL_CODE 条目流水编码 VARCHAR2(30)Y 要求必须唯一性，采购结果返回时对 应 2.TL_ITEMID 物资编码 VARCHAR2(30)Y 3.TL_ITEMNAME 物资名称 NVARCHAR2(50)Y 4.TL_SPC 规格型号 NVARCHAR2(200)Y 5.TL_QUANTITY 采购数量 FLOATY 6.TL_UNIT 计量单位 NVARCHAR2(10)Y 7.TL_UNITCOST 预估单价 FLOATN 预估单价,内部参考使用 8.TL_TAX 税率 VARCHAR2(10)Y0%/3%/4%/6%/13%/17% 9.TL_MANUFACTURE 生产厂家 NVARCHAR2(100)N 10.TL_BRAND 要求品牌 NVARCHAR2(100)N 11.TL_ETA 要求到货天数 NUMBERY 签订合同后 X 天到货 12.TL_MATERIAL 要求材质 NVARCHAR2(100)N 13.TL_PARTNUM 部件号 NVARCHAR2(100)N 阳光采购网 EAM 接口方案 13/18 序号序号字段名称字段名称字段描述字段描述数据类型数据类型 要要 求求 字段约束字段约束 14.TL_ENNAME 英文名称 VARCHAR2(100)N 15.TL_SERIAL 序列号 VARCHAR2(100)N 16.TL_ORDERNUM 订货号 VARCHAR2(100)N 17.TL_DRAWNUM 图号或件号 VARCHAR2(100)N 18.TL_SERIALNUM 出厂编号 VARCHAR2(100)N 19.TL_PRODAREA 产地 VARCHAR2(100)N 20.TL_DETAILEDPAR 详细参数说明 NVARCHAR2(500)N 21.TL_MEMO 物资备注说明 NVARCHAR2(500)N SuppliersSuppliers : : 邀请供应商数据实体邀请供应商数据实体 序号序号字段名称字段名称字段描述字段描述数据类型数据类型 要要 求求 字段约束字段约束 1.SU_CODE 供应商编码 VARCHAR2(30)Y B2B 供应商编码 2.SU_NAME 供应商名称 NVARCHAR2(50)Y TermsTerms : : 采购单条款数据实体采购单条款数据实体 序号序号字段名称字段名称字段描述字段描述数据类型数据类型 要要 求求 字段约束字段约束 1.TM_CODE 条款编码 VARCHAR2(30)Y 需要求编码唯一性 2.TM_TITLE 条款标题 NVARCHAR2(50)Y 3.TM_DETAIL 条款细节 NVARCHAR2(500)Y DocumentsDocuments : : 采购单附件数据实体采购单附件数据实体 序号序号字段名称字段名称字段描述字段描述数据类型数据类型 要要 求求 字段约束字段约束 1.DC_DESC 附件描述 NVARCHAR2(100)Y 2.DC_DATE 上传时间 DATEN 默认为当前时间 3.DC_TYPE 附件类型 VARCHAR2(30)Y 基础数据同步，待讨论 4.DC_RAISER 附件上传人工号 VARCHAR2(30)N 默认为采购单提交人 5.FILE_BYTE 附件二进制流 BASE64BINARYY 附件,二进制流传输，不宜过大，建议 限制不超过 5M 2.4.2.3.输出输出 OutputCollection 序号序号字段名称字段名称字段描述字段描述数据类型数据类型备注备注 1.SERVICE_FLAG 服务标识 VARCHAR2(30) 标识服务执行结果，TRUE/FALSE 2.ERROR_MESSAGE 服务消息 VARCHAR2(2000) 如果失败，则返回错误信息 阳光采购网 EAM 接口方案 14/18 3.Output_Code 导入成功的 B2B 采购单单号 VARCHAR2(30) 第三方系统保存，用于读取采购结果 2.4.3.采购单作废接口说明采购单作废接口说明 2.4.3.1.服务信息服务信息 服务名称服务名称 TH_B2B_ImportCancelTenderSrv 服务描述服务描述第三方系统使用此服务向 B2B 系统作废已导入的询价招标单 服务类型服务类型 读出 写入 同步同步/ /异步方式异步方式 同步 异步 实现方式实现方式 WebService JMS ODI 业务规则和逻辑业务规则和逻辑 1.只能作废从第三方系统导入过来的询价招标单 2.作废操作不可逆 出错和异常处理机制出错和异常处理机制调用失败后记录日志并重试，若重试 3 次全部不成功，则记录日志进行人工干预。 数据量数据量每次作废单张单据 服务安全和权限要求服务安全和权限要求双方通过定义用户名及密码进行安全验证，需做到可不定时修改密码。 使用建议使用建议建议第三方系统做好事务处理，确保两边系统数据一致 2.4.3.2.输入输入 MsgHeader 序序 号号 字段名称字段名称字段描述字段描述数据类型数据类型要求要求字段约束字段约束 1.SYSTEM_ID 服务消费方系统 ID VARCHAR2(30)Y 取统一定义的系统编码 2.SYSTEM_NAME 服务消费方系统名称 NVARCHAR2(30)Y 取统一定义的系统名称 3.USER_ID 用户 ID VARCHAR2(50)Y 服务消费方系统操作用 户 ID 4.USER_KEY 用户密匙 VARCHAR2(50)Y 服务消费方系统操作用 户 5.TE_CODETE_CODE 采购单号采购单号 VARCHAR2(30)VARCHAR2(30)Y Y B2BB2B 系统的采购单号系统的采购单号 6.S Y SYS_CODESYS_CODE 第三方系统采购单号第三方系统采购单号 VARCHAR2(30)VARCHAR2(30)Y Y 第三方系统的采购单号第三方系统的采购单号 2.4.3.3.输出输出 OutputCollection 序号序号字段名称字段名称字段描述字段描述数据类型数据类型备注备注 1.SERVICE_FLAG 服务标识 VARCHAR2(30) 标识服务执行结果，TRUE/FALSE 2.ERROR_MESSAGE 服务消息 VARCHAR2(2000) 如果失败，则返回错误信息 阳光采购网 EAM 接口方案 15/18 2.4.4.采购单结果接口说明采购单结果接口说明 2.4.4.1.服务信息服务信息 服务名称服务名称 TH_B2B_GetTenderResultSrv 服务描述服务描述第三方系统使用此服务向 B2B 系统读取询价招标单的开标结果信息 服务类型服务类型 读出 写入 同步同步/ /异步方式异步方式 同步 异步 实现方式实现方式 WebService JMS ODI 业务规则和逻辑业务规则和逻辑 3.只能在开标后，并且在预决标完成（即已完成议价后）才允许读取采购单的结果信 息 4.可重复读取采购单结果 出错和异常处理机制出错和异常处理机制调用失败后记录日志并重试，若重试 3 次全部不成功，则记录日志进行人工干预。 数据量数据量每次读取单条采购单结果 服务安全和权限要求服务安全和权限要求双方通过定义用户名及密码进行安全验证，需做到可不定时修改密码。 使用建议使用建议建议第三方系统具备手动、自动调用同步接口的功能。定时调用最好避开用户使用时间 2.4.4.2.输入输入 MsgHeader 序序 号号 字段名称字段名称字段描述字段描述数据类型数据类型要求要求字段约束字段约束 1.SYSTEM_ID 服务消费方系统 ID VARCHAR2(30)Y 取统一定义的系统编码 2.SYSTEM_NAME 服务消费方系统名称 NVARCHAR2(30)Y 取统一定义的系统名称 3.USER_ID 用户 ID VARCHAR2(50)Y 服务消费方系统操作用 户 ID 4.USER_KEY 用户密匙 VARCHAR2(50)Y 服务消费方系统操作用 户 5.TE_CODETE_CODE 采购单号采购单号 VARCHAR2(30)VARCHAR2(30)Y Y B2BB2B 系统的采购单号系统的采购单号 6.S Y SYS_CODESYS_CODE 第三方系统采购单号第三方系统采购单号 VARCHAR2(30)VARCHAR2(30)Y Y 第三方系统的采购单号第三方系统的采购单号 2.4.4.3.输出输出 OutputCollection 序号序号字段名称字段名称字段描述字段描述数据类型数据类型备注备注 1.SERVICE_FLAG 服务标识 VARCHAR2(30) 标识服务执行结果，TRUE/FALSE 2.ERROR_MESSAGE 服务消息 VARCHAR2(2000) 如果失败，则返回错误信息 阳光采购网 EAM 接口方案 16/18 3.Output_XML 返回信息 XML 格式字符串 VARCHAR2(2000) 查询成功的 XML 格式供应商数据集 Output_XMLOutput_XML：格式格式 报价单号 采购单号 供应商编码 状态（1 预中标/中标 ， 2 非预中标/中标） 提交人用户名 报价日期 报价单币种 报价有效日期 报价人公司(简)/报价人名 承诺到货天数（合同签订后 X 天内） 备注说明 报价条目流水号 采购条目流水号 物资名称 含税单价 税率 报价条目币种 承诺到货天数（合同签订后 X 天内） 原始报价(议价前含税单价) 备注说明 作者注：V1.3 版本新增，报价单附件信息，如报价单无附件， 此节点下为空，附件通过此节点下的信息读取附件接口下载。 附件 ID 流水号 报价单号 附件名称(包含扩展名,如 abc.rar) 阳光采购网 EAM 接口方案 17/18 . 2.5.附件信息附件信息 2.5.1.业务场景业务场景 阳光采购网与之接口的系统，存在附件需要传送给接口另一方，如供应商 信息存在“营业执照”作为附件。若不提供统一存取附件的接口服务，则接口 双方均需从服务器拷贝文件，此时，需要建立操作系统访问用户，共享文件目 录，增加了维护难度。 供应商附件信息需通过调用接口才能读取，返回文件的二进制流，一个供 应商有多个附件。 2.5.2.附件下载接口说明附件下载接口说明 2.5.2.1.服务信息服务信息 服务名称服务名称 TH_B2B_DownloadDocSrv 服务描述服务描述第三方系统通过已知附件 ID(DC_ID)以及所属业务单号(DC_EN_CODE)，使用此服务向 B2B 系统读取附件信息 阳光