商康电子商务与供应链系统接口整合详细设计方案v1.2

湖南商康医药有限公司电子商务网站与供应链系统整合详细设计方案版本日期描述V1.02010年08月30日確認整合方案V1.12010年10月20日根據聯調實際情況對文檔進行補充和更正目录1.背景与需求32.述语53.整合方案53.1.接口设计原则53.2.接口架构和部署63.3.约定说明73.4.中间表接口方式详细描述73.5.通知表83.5.1.I_EC_NOTE（电子商务系统业务通知表）83.5.2.I_EC_NOTE_BAK（电子商务系统业务通知备份表）83.5.3.I_ERP_NOTE（ERP系统业务通知表）93.5.4.I_ERP_NOTE_BAK（ERP系统业务通知备份表）104.主要业务处理114.1.订单114.1.1.接口表114.1.2.WebService134.1.3.业务描述164.2.商品184.2.1.接口表184.2.2.WebService214.2.3.业务描述224.2.4.约定说明244.3.会员254.3.1.接口表254.3.2.业务描述264.4.促销294.4.1.WebService295.异常处理325.1.订单异常处理325.2.订单退货325.3.接口调用异常325.3.1.有数据依赖的业务产生异常335.3.2.只是数据普通交互，没有依赖关系的业务产生异常335.4.数据库异常335.5.网络等异常335.6.操作系统336.性能要求与验收准则331. 背景与需求湖南商康医药有限公司供应链系统采用普升软件提供的普升医药物流管理系统（PowerGSP），是商康医药和其母公司全洲医药集团以及全洲医药集团下属分公司/子公司、办事处进行医药商业贸易及供应链服务的核心业务处理软件，主要负责采购、质量、销售、财务、仓储、物流等关键业务的信息管理。电子商务网站由用友开发，实现的主要内容包括网上交易管理、网上订单受理、订单状态反馈、网络在线客服以及网上支付等。供应链系统与电子商务网站的接口与集成需求主要内容包括：（一）数据共享与集成l 电子商务网站的客户资料、商品资料基本信息从供应链系统进行增量同步；l 供应链系统将商品促销活动信息定期传送给电子商务网站，由电子商务网站在前端展现。（二）业务流程集成l 电子商务网站完成订单后，能够将订单提交到供应链系统，并将库存满足情况反馈到电子商务网站，方便订单提交者确认支付；l 电子商务网站对订单进行确认和支付以后，将订单及支付信息提交给供应链系统，由供应链系统对支付进行核验，确认支付完成后，进行出库拣配和物流配送，并将订单状态反馈到商务网站，以便电子商务网站可以向客户提供订单状态查询服务；l 电子商务网站的注册会员需要成为药品交易的供应商或客户时，可以将相关资料提交到供应链系统，经供应链系统进行客户资料审核后，反馈到电子商务网站。图1.订单前后台处理用例图图2.数据交换用例图注：更详细业务描述请参考商康网B2B需求分析说明书2. 述语B2B系统指商康网B2B电子商务系统。ERP系统也称供应链系统、业务系统或批发系统，即普升PowerGSP。采购会员能通过B2B系统在线采购商品的采购商会员，后来商康项目组把“采购商”改名为“采购会员”；ERP中与B2B采购会员相对应的是往来单位。3. 整合方案3.1. 接口设计原则l 可靠性：B2B系统和ERP系统是隔离的，确保是一个系统出了问题不影响对方。l 安全性：系统之间有清晰的调用边界，可以对只涉及到的表开放相应的权限。l 可追溯：可以通过档案日志和备份日志追溯处理时间和执行的系统。3.2. 接口架构和部署B2B系统与ERP系统以中间表和WebService这两种方式进行整合，架构与部署如图4所示。图4.系统连接架构示意图中间表对于实时性不强的业务（比如基础数据、商品等），两方系统将通过数据库中间表的形式实现数据共享或交互。在这种方式下，B2B系统和ERP系统根据业务需要往约定的中间接口表写入或读取数据。如图5所示。中间接口表将部署在ERP外网数据库实例里，如图4所示。电子商务系统中间表ERP系统图5.中间表方式接口示意图WebService对于实时性很强或有复杂的规则（如促销等）的业务则将通过web service来实现数据共享或交互。3.3. 约定说明l 电子商务系统与ERP系统是两个各自独立运行的系统，中间表可驻留在任一方的数据库实例内。l 中间表的数据库编码为UTF-8。l B2B系统与ERP系统对中间表要有相应的读写权限，也需要定义和执行存储过程的权限。l 电子商务系统与ERP系统不可以直接访问对方的数据，它们只能通过中间表来进行数据同步。l 若具体业务没有明确说明，中间表数据中为NULL的字段默认视作无效数据双方都不需要进行处理；空字符串视作有效数据。l 为了方便操作，所有通知表均不添加外键约束。l 中间表名称，ERP系统端的表以”I_ERP_”作为前缀；B2B系统端的表以“I_EC_”作为前缀。l 中间表名、中间表字段名在数据库中一律使用大写。l WebService的服务调用名称、输入输出参数名称严格区分大小写。l WebService的服务调用名称、输入输出参数信息、XML格式等以最终确认的WebService Schema文件为准。3.4. 中间表接口方式详细描述通知机制中间表中设置了“通知表”用以模拟消息机制，ERP系统和B2B系统均有属于自己的通知表，通知表的详细说明请看Error! Reference source not found.通知表一节。通知对方处理事件B2B系统或ERP系统往自己的通知表里写入事件通知，把业务事件代码写入通知的actionType字段。接收/处理事件B2B系统或ERP系统监控（定时轮询）对方的通知表；有新消息的情况下读取新通知，根据通知里的业务事件代码（actionType）进行相关的数据读取和操作；处理完事件后把通知的handleStatus设置成1、把handleTime设置成当前时间，再把通知数据转移到通知备份表。示例ERP系统新添加了一个商品，通知B2B系统过程：（1） ERP系统在自己的通知表I_ERP_NOTE里写入一条新通知。（2） ERP把新增的商品数据写入中间表I_ERP_PRODUCT，并把通知的ID写进记录里作为与通知表关联的键。B2B同步新商品数据过程：（1） B2B系统监控对方的通知表I_ERP_NOTE。（2） B2B系统发现I_ERP_NOTE有新消息，通过actionType得知该消息是ERP系统里新添加了商品，需要进行数据同步。（3） B2B系统通过通知ID到I_ERP_PRODUCT表读取新增的商品数据，并进行处理。（4） 处理完后把通知的handleStatus设置为1、把handleTime设置成当前时间。（5） B2B系统把通知移动到通知备份表I_ERP_NOTE_BAK，即把数据先复制到备份表再把通知记录删除。3.5. 通知表l 通知表就是一个负责总控消息的表；通知表的数据都必须是需要处理的；l 通过查看通知表，可知道当前有哪些业务需要处理；通过查看通知表备份表，可知道已经处理了哪些业务；l 通知表的数据处理完就备份删除；而其他中间表的数据是累加的，处理完后是否需要清空要视乎事务的需要。3.5.1. I_EC_NOTE（电子商务系统业务通知表）字段名称数据类型备注ecNoteIDintegerPK，自增actionTypeVarchar(32)业务事件代码【1=订单】1_2 =取消订单1_3 =在线支付【3=会员】3_1会员网上注册3_2为ERP往来单位开通B2B会员帐号noteTimedate通知时间orderIdinteger如果是关于订单的通知,填写订单接口表的订单Id；否则为NULLorderStatusInteger订单状态notesVarchar(255)说明内容(关于订单状态变化的说明文字，如订单被客户撤销等)handleStatusinteger0 未处理 ，1处理成功，2处理失败handleTimedate处理时间，默认是null 注：处理完成后的通知数据要进行备份和删除，即先把通知数据复制到 I_ EC_NOTE_BAK再删除。3.5.2. I_EC_NOTE_BAK（电子商务系统业务通知备份表）当ERP系统处理I_EC_NOTE后要修改处理状态和更新处理时间，并备份到I_EC_NOTE_BAK中。字段名称数据类型字段含义ecNoteIDinteger对应I_EC_NOTE表同名字段。主键actionTypeVarchar(32)对应I_EC_NOTE表同名字段。noteTimeDate对应I_EC_NOTE表同名字段。handleTimedate对应I_EC_NOTE表同名字段。OrderIDIntegerOrderStatusIntegerNoteshandleStatusinteger对应I_EC_NOTE表同名字段。handleTimedate对应I_EC_NOTE表同名字段。3.5.3. I_ERP_NOTE（ERP系统业务通知表）字段名称数据类型字段含义erpNoteIDintegerPK，自增actionTypeVarchar(32)业务类型【1=订单】1_1 =更新订单状态1_4=更新TMS信息【2=商品】2_1 = 新增或修改商品信息2_1_d = 删除商品信息2_2 = 新增或修改经营类型2_2_d = 删除经营类型2_3 = 新增或修改功效类别2_3_d = 删除功效类别2_4 = 新增或修改品种类型2_4_d = 删除品种类型2_5 = 新增或修改剂型2_5_d =删除剂型2_6 = 新增或修改基本药品目录分类2_6_d = 删除基本药品目录分类2_7=新增或更新物流商信息2_7_d=删除物流商信息【3=会员】3_3 GSP认证通知3_4往来单位信息增量更新noteTimedate通知时间OrderIDInteger如果是关于订单的通知,填写订单接口表的主键erpOrderID；否则为NULLorderStatusInteger订单状态1草拟2已提交3待支付4已确认支付5已申请出库6正在拣配出库7已出库待发运8货物已发出9确认收货10已终止(整单退货退款)11财务撤销确认-1已作废notesVarchar(255)说明内容(关于订单状态变化的说明文字，如订单被ERP撤销、订单审核失败等)handleStatus