WMS与金蝶云星空对接
一、概述
AI-WMS PLUS在与金蝶云星空系统进行对接时，对金蝶云星空系统的对接要求事项如下：
1、支持对接的金蝶版本：云星空
2、与WMS对接的申请单、出入库单据，表头增加“WMS单据号码”栏位：
（1）建议字段KEY值（标识)：F_TXTS_WMS_NO
（2）当单据表头“WMS单据号码”有值时，则需控制单据不允许删除及修改。
3、跟WMS对接的申请类单据，单据的仓库增加必填控制：金蝶云星空系统，非正式出入库单据，系统未强制仓库为必填，当与WMS对接，对接的申请单据，需要请金蝶技术支持人员，增加“仓库”必填的控制；
4、跟WMS对接的出入库单据，需要请金蝶技术支持人员增加保存检测：不允许录入WMS仓库的单据。（即手工录入单据时，表身的仓库不允许输入WMS接管的仓库）
5、储位管理：
（1）储位只存在于WMS系统，即储位资料不回推ERP系统；
（2）金蝶系统启用WMS对接的仓库，不允许启用仓位。
6、单位处理：生成WMS的单据、及WMS推送给ERP的单据时，默认按基准单位，作为WMS的主单位，生成WMS单据以主单位生成，及ERP单据的回推以基准单位回推。
二、自定义字段-WMS单据号码（参考）
如成品入库流程：金蝶【生产订单】->金蝶【生产汇报单】->WMS【入库通知单】->WMS【入库单】->金蝶【生产入库单】
则金蝶申请单据【生产汇报单】和出入库单据【生产入库单】，都要建立自定义字段。
三、基础资料同步说明
说明：因基础资料是采用差异获取方式，故建议基础资料不要删除，如在ERP直接删除，则会造成WMS的数据冗余，建议不用的资料设置停用日期。
1、从金蝶云星空同步到AI-WMS PLUS的基础资料
| 金蝶基础资料名称 | WMS基础资料名称 |
| 物料 | 货品资料 |
| 商品分组 | 中类代号 |
| 仓库 | 仓库资料 |
| 部门 | 部门资料 |
| 供应商 | 客户/厂商资料 |
| 客户 | 客户/厂商资料 |
2、需两套系统各自维护的资料
（1）用户资料
（2）权限资料
四、支持对接的单据
| ERP流程 | 出入库类型 | 金蝶系统单据名称 | 生成WMS单据名称 | 数据来源方式 | 特殊影响说明 |
| 成品入库 | 申请单 | 生产订单/生产汇报单 | 入库通知单 | WMS定时向ERP系统获取 | |
| 出入库单据 | 生产入库单 | 入库单 | WMS推送给ERP系统 | ||
| 成品出库 | 申请单 | 发货通知单 | 出库通知单 | WMS定时向ERP系统获取 | |
| 出入库单据 | 销售出库单 | 出库单 | WMS推送给ERP系统 | ||
| 材料入库/委外成品入库 | 申请单 | 收料通知单 | 入库通知单 | WMS定时向ERP系统获取 | |
| 出入库单据 | 采购入库单 | 入库单 | WMS推送给ERP系统 | ||
| 材料退料 | 申请单 | 退料申请单/采购退料单 | 出库申请单 | WMS定时向ERP系统获取 | 当以【采购退料单】作为申请单时，则代表金蝶的库存与WMS的库存存在差异，会影响盘点；同时，该类单据在WMS出库后，出库信息不回推给ERP系统。 |
| 出入库单据 | 采购退料单 | 出库单 | 1、当申请单=退料申请单，则WMS推送给ERP系统； 2、当申请单=采购退料单时，则不回推ERP。 |
||
| 领料出库 | 申请单 | 生产发料通知单/生产用料清单/生产领料单 | 出库通知单 | WMS定时向ERP系统获取 | 当以【生产领料单】作为申请单时，则代表金蝶的库存与WMS的库存存在差异，会影响盘点；同时，该类单据在WMS出库后，出库信息不回推给ERP系统。 |
| 出入库单据 | 生产领料单 | 出库单 | 1、当申请单=生产发料通知单/生产用料清单，则WMS推送给ERP系统； 2、当申请单=生产领料单时，则不回推ERP。 |
||
| 补料出库 | 申请单 | WMS手工操作【批量产生出库通知单】 （来源生产订单)/生产补料单 |
出库通知单 | 当以【生产补料单】作为申请单时，则代表金蝶的库存与WMS的库存存在差异，会影响盘点；同时，该类单据在WMS出库后，出库信息不回推给ERP系统。 | |
| 出入库单据 | 生产补料单 | 出库单 | 1、当申请单=WMS手工操作【批量产生出库通知单】 （来源生产订单) ，则WMS推送给ERP系统； 2、当申请单=生产补料单时，则不回推ERP。 |
||
| 退料入库 | 申请单 | WMS手工操作【批量产生入库通知单】 （来源生产订单)/生产退料单 |
入库通知单 | 当以【生产退料单】作为申请单时，则代表金蝶的库存与WMS的库存存在差异，会影响盘点；同时，该类单据在WMS出库后，出库信息不回推给ERP系统。 | |
| 出入库单据 | 生产退料单 | 入库单 | 1、当申请单=WMS手工操作【批量产生入库通知单】 （来源生产订单) ，则WMS推送给ERP系统； 2、当申请单=生产退料单时，则不回推ERP。 |
||
| 销货退货 | 申请单 | 退货通知单 | 入库通知单 | WMS定时向ERP系统获取 | |
| 出入库单据 | 销售退货单 | 入库单 | WMS推送给ERP系统 | ||
| 委外领料出库 | 申请单 | 委外用料清单/委外领料单 | 出库通知单 | WMS定时向ERP系统获取 | 当以【委外领料单】作为申请单时，则代表金蝶的库存与WMS的库存存在差异，会影响盘点；同时，该类单据在WMS出库后，出库信息不回推给ERP系统。 |
| 出入库单据 | 委外领料单 | 出库单 | 1、当申请单=委外用料清单，则WMS推送给ERP系统； 2、当申请单=委外领料单时，则不回推ERP。 |
||
| 委外补料出库 | 申请单 | WMS手工操作【批量产生出库通知单】 （来源委外用料清单)/委外补料单 |
出库通知单 | WMS定时向ERP系统获取 | 当以【委外补料单】作为申请单时，则代表金蝶的库存与WMS的库存存在差异，会影响盘点；同时，该类单据在WMS出库后，出库信息不回推给ERP系统。 |
| 出入库单据 | 委外补料单 | 出库单 | 1、当申请单=WMS手工操作【批量产生出库通知单】 （来源委外用料清单) ，则WMS推送给ERP系统； 2、当申请单=委外补料单时，则不回推ERP。 |
||
| 委外退料入库 | 申请单 | WMS手工操作【批量产生入库通知单】 （来源委外用料清单)/委外退料单 |
入库通知单 | 当以【委外退料单】作为申请单时，则代表金蝶的库存与WMS的库存存在差异，会影响盘点；同时，该类单据在WMS出库后，出库信息不回推给ERP系统。 | |
| 出入库单据 | 委外退料单 | 入库单 | 1、当申请单=WMS手工操作【批量产生入库通知单】 （来源委外用料清单) ，则WMS推送给ERP系统； 2、当申请单=委外退料单时，则不回推ERP。 |
||
| 有申请来源的调拨 | 申请单 | 调拨申请单(拨出仓=WMS接管) | 调拨通知单 | WMS定时向ERP系统获取 | |
| 出入库单据 | 直接调拨单 | 库存调拨单 | WMS推送给ERP系统 | ||
| 有申请来源的调拨 | 申请单 | 调拨申请单(拨出仓库=ERP仓库、拨入仓=WMS接管) | 入库通知单 | WMS定时向ERP系统获取 | |
| 出入库单据 | 直接调拨单 | 入库单 | WMS推送给ERP系统 | ||
| 其他出库 | 申请单 | 出库申请单 | 出库通知单 | WMS定时向ERP系统获取 | |
| 出入库单据 | 其他出库单 | 出库单 | WMS推送给ERP系统 |
五、WMS开启对接金蝶云星空说明
1、系统设定
（1）启用金蝶API：开启
（2）接口Url：必填，即金蝶云星空的访问地址，需填写WMS服务器能正常访问的地址
（3）应用ID、应用密钥：必填，可以从金蝶云星空【第三方系统登录授权】获取
（4）账套ID：必填，可以从金蝶云星空【Web API】->【在线测试WebAPI】获取
（5）用户名：必填，登录金蝶云星空的用户名
（6）组织编码：非必填，如果金蝶云星空是有组织编码的则填写，如果没有则不需要填写；如果金蝶云星空一个账套有多个组织编码、且多个组织编码都要对接到WMS同一个账套，则可以使用WMS的货主功能，启用货主功能后，在【货主编码设定】中填写对接金蝶云星空的资料。
（7）WMS仓库：必填，进入查询窗口后通过接口直调金蝶云星空的仓库资料，选择WMS接管的仓库，可多选。
（8）默认制单人代号：必填，填写金蝶云星空的登录用户代号，推送单据到金蝶云星空时，制单人取此处设置的值。
（9）默认部门代号：必填，填写金蝶云星空的部门代号，推送单据到金蝶云星空时，部门取此处设置的值。
（10）启用日期：该栏位主要作用于计算获取什么审核日期之后的金蝶云星空单据，搭配下方选项【审核日期取值(近X天)】一起使用。设置日期后，则与【当前系统日期-审核日期取值(近X天)】的日期作比较，若设置的日期大于【当前系统日期-审核日期取值(近X天)】的日期，则以“启用日期”作为获取ERP申请单的开始时间，否则以【当前系统日期-审核日期取值(近X天)】的日期作为获取ERP申请单的开始时间。
举例：
当前系统日期：2024-04-15；审核日期取值(近X天)：30天；2024-04-15减30天，即为2024-03-15；
若设置【启用日期】=2024-03-20，则大于2024-03-15，那么以2024-03-20作为获取ERP申请单的开始时间，即表示审核日期在2024-03-20及之后的ERP申请单会被获取为WMS通知单；
若设置【启用日期】=2024-01-01，则小于2024-03-15，那么以2024-03-15作为获取ERP申请单的开始时间，即表示审核日期在2024-03-15及之后的ERP申请单会被获取为WMS通知单。
（11）审核日期取值(近X天)：默认值30
（12）获取生产订单的订单类型：非必填，可填写多个订单类型，以;分隔。如果有填写，则只获取所填写的这些订单类型的【生产订单】。
（13）推送单据-不自动提交单据别：非必填，可选择多个单据别。当有勾选时，则在推送这些单据别的单据到金蝶云星空时，单据的状态=创建。
（14）推送单据-不自动终审单据别：非必填，可选择多个单据别。当有勾选时，则在推送这些单据别的单据到金蝶云星空时，单据的状态=审核中。
PS.如果单据别在【推送单据-不自动提交单据别】和【推送单据-不自动终审单据别】都没有设置，则推送单据到金蝶云星空时，单据的状态=已审核。
（15）重载基础资料：勾选对应基础资料选项，点击【重载】后，会将该基础资料上次获取时间清空，在下次【WMS数据同步服务-同步金蝶基础资料】执行时，会重载该基础资料。
2、获取金蝶单据资料设置
打开菜单【系统管理】->【系统设定】->【获取ERP单据资料】->【获取金蝶单据资料设置】
勾选需要从金蝶云星空获取的申请单据，然后保存即可。
3、WMS数据同步
打开WMS服务同步工具，勾选“同步金蝶基础资料”、“获取金蝶单据”和“推送金蝶单据”，然后点击【保存设定】。
PS. 如果有修改过【系统设定】的设置，则需要重启此服务。
（1）同步金蝶基础资料：走轮询时间，如设置为300秒，则服务每隔300秒执行一次。启用后，会将金蝶云星空系统中的基础资料会同步到AI-WMS PLUS系统。
（2）获取金蝶单据：走轮询时间，如设置为60秒，则服务每隔60秒执行一次。启用后，当帐套对接金蝶云星空系统，则会根据轮询时间定期到金蝶云星空抓取符合条件的单据，生成WMS的【入库通知单】、【出库通知单】、【调拨通知单】。
（3）推送金蝶单据：走轮询时间，如设置为60秒，则服务每隔60秒执行一次。启用后，当帐套对接金蝶云星空系统，则会将WMS的入库单、出库单等单据推送给金蝶云星空。
六、疑难排解
（一）【WMS数据同步】在执行“同步金蝶基础资料”时出现错误“会话信息已丢失，请重新登录”
解决方法：
1、在WMS服务器访问金蝶地址，检查是否能正常访问；
2、检查WMS【系统设定】-【金蝶云星空】的相关栏位配置是否正确，请着重检查【接口Url】、【应用ID】、【应用密钥】、【账套ID】、【组织编码】等栏位。
（二）【WMS数据同步】在执行子服务“获取金蝶单据”时发现无法获取单据，出现异常说明“金蝶云星空已超过使用期限【{0}】，请联系注册人员！”
解决方法：
1、请到WMS【注册信息】-【其他】页面，查看是否包含“金蝶云星空”的注册信息、且可用日期未过期
（1）如果没有“金蝶云星空”的注册信息、或可用日期已过期的，请联系注册人员；
（2）如果有“金蝶云星空”的注册信息、且可用日期未过期的，请重启下WMS服务。
（三）【WMS数据同步】在执行子服务“获取金蝶单据”时发现无法获取单据，出现异常说明”列名 ‘F_TALG_Text2’ 无效。\r\n列名 ‘F_TALG_Text2’ 无效。”
解决方法：
1、请到金蝶云星空检查WMS对接的申请类单据是否有建立好自定义栏位“WMS单据号码”、且KEY值（标识)是正确的。
PS. 自定义栏位的KEY值（标识)一般是建议设置为’F_TXTS_WMS_NO’，但如果有与研发另外协议好的，则按协议好的进行设置，如下图，则协议好的自定义字段标识值为’F_TALG_Text2’。
（四）在推送WMS的出入库单据到金蝶云星空失败，提示类似如下图，反写xxx单据失败
解决方法：这些都是金蝶云星空返回来的提示信息，代表在金蝶生成单据失败。比如像单据需要走检验，但是还没检验的，那么在金蝶有可能不支持直接入库，具体请检查金蝶的数据。
