福建二级立库接口规范说明书(131104修正).doc

: .
接口规范说明书
二〇一一年八月
目 录
HYPERLINK \l "_Toc" 1 技术架构 1
HYPERLINK \l "_Toc" 系统架构图 1
HYPERLINK \l "_Toc" 接口标准说明 1
HYPERLINK \l "_Toc" 2 业务说明 2
HYPERLINK \l "_Toc" 业务流程图 3
HYPERLINK \l "_Toc" 3 接口设计 3
HYPERLINK \l "_Toc" 接口数据标准 3
1 技术架构
接口交互统一采用WEBSERVICE技术实现，客户端使用HTTP协议访问部署在接口服务器上WEBSERVICE，实现了便捷，安全以及跨平台等特点。
在此技术架构下客户端通过将参数组织成xml形式传递给在接口服务器上部署的不同业务的服务。此时服务解析客户的请求参数访问表库应用服务器获得客户所需信息或更新客户传递的信息到表库系统，再将结果以xml的格式返回给客户端。
系统架构图
外部系统访问表库部署应用服务器的外部交互接口后，表库应用服务器负责将数据分解、加工导入表库数据库。
同样，访问表库应用服务器上的统一接口，也可以获得数据，再在客户端分解获得最终结果数据。
接口标准说明
接口交互统一采用WEBSERVICE技术实现。接口说明约定如下：
1. 接口服务名严格按照本文档，所有服务名均为大写，并以SEND或SET开头。
2. 入参名称统一为大写字母。日期格式统一为“YYYY-MM-DD ”，如“2008-10-22”。月份格式为“YYYYMM”，如“”。带时间的日期格式统一为“YYYY-MM-DD HH24:MI:SS”，如“2008-10-22 15:30:25”，日期和时间中间空一格。
3. 出参入参为XML数据集格式。并以<DBSET></DBSET>来标记数据集的开始和结束。以<DBSET RESULT=”此处为返回标识值”></DBSET>标记返回标识。多行纪录以<R></R>标记作为分隔符。示例如下
<?xml version="" encoding="UTF-8"?>
<DBSET>
<R>
<C N=“SQBH”></C>
<C N=“TXM”>HZFDM</C>
<C N=“ZCBH”>FDM</C>
<C N=“CCBH”></C>
</R>
<R>
<C N=“SQBH”></C>
<C N=“TXM”>HZFDM</C>
<C N=“ZCBH”>FDM</C>
<C N=“CCBH”></C>
</R>
</DBSET>
2 业务说明
新表入库
营销新购设备建档，创建入库任务，营销将入库任务发送给立库。
自动校表线检定出库（无）
自动校表线检定入库（无）
人工检定出库
营销制定检定任务，生成检定/检测出库任务，营销将检定/检测出库任务发送给立库。
人工检定入库
人工检定完毕之后将设备入立库，立库上传入库清单到营销系统。
配送入库
立库接收省级配送设备或三级库房配送返回设备入库，立库上传入库清单到营销。
配送出库
营销制定配送任务，将配送出库任务发送给立库。
配表（备表）出库
营销生成配表（备表）工单，将领表出库任务发生给立库。
3 接口设计
发送出入库单据(工单)
服务名称
SEND_IO_TASK
服务路径
描述
将出库的工单编号，包含设备详细信息的需求（设备规格、厂家等）、数量等信息发送给智能表库系统。智能表库系统接收到任务后根据立体仓库内的库存情况对任务做处理，如库存信息满足单据的需求和数量，将生成下架任务，并调度设备执行出库任务；如库存信息不满足单据的需求和数量，将产生提示信息，并将信息反馈给营销系统。
调用规则