关于实施联调
WMS联调周期预计5个工作日，如果是管家婆新客户，联调前管家婆需要达到开账状态。联调过程无需人员到客户现场，对接群关注消息及时配合即可，具体要求见本文档中的第二点对接准备。
1. WMS对接说明
全渠道通过奇门接口将要发送到WMS的请求首先发送到奇门，由奇门进行数据的解析、字段映射、数据翻译，再将处理后的数据通过全渠道所请求的目的地发送至WMS系统；WMS系统收到请求后，将返回结果发送到奇门，由奇门返回至全渠道。
2. 对接准备
| 内容 | 说明 | 备注 |
| 联调微信群 | 微信/钉钉 | WMS、客户、代理都需要加群，群里对接调试。 |
| 奇门Appkey | 仓储（WMS）提供 | 发送给全渠道工作人员 |
| 全渠道公司名称 | 代理商/客户提供 | 发送给全渠道工作人员 |
| 管家婆线下ERP版本 | 如：辉煌ⅡTOP+15.0 | |
| 管家婆数据库版本 | SQL2008R2及以上 | 强制要求 |
3. 对接流程及细节步骤详述
如果全渠道已经在正常使用，可以直接跳转至本文的3.4开启云仓发货流程.
3.1. 账号注册与购买
由代理商登录管家公系统跳转全渠道服务商系统注册全渠道公司账号并在客户--客户管理中购买WMS产品增值套餐
登录云上管家--客户服务管理--添加增值产品（选择全渠道二代增值产品并选择账套）完成全渠道部署
3.2. 提交奇门上线申请
由全渠道技术支持人员根据对接准备中的奇门Appkey、货主代码（CustomerID）和全渠道公司名称在奇门中心提交WMS上线申请，提交申请后将申请截图发给WMS方进行审核，WMS方审核通过后由代理商/全渠道服务人员登录全渠道进行线下ERP账套的绑定及WMS账号的配置。
3.3. 线下ERP账套绑定
由代理商或全渠道技术支持人员登录全渠道二代，在系统--系统配置中进行线下ERP账套的绑定操作
点击“去绑定”，在弹出的界面选择产品系列后点击“下一步”，以“辉煌”为例
点击“下一步”后，会弹出录入数据库地址、账号、密码、数据库名称的界面，若是部署在本地的，可以直接录入后点击“绑定账套”；若是部署在云上管家的，可以点击右下角的“智能绑定”按钮
进行ERP管理员身份验证，验证后点击“开始绑定”即可，若存在多个账套则需要选择账套进行绑定。
3.4. 开启云仓发货流程
在全渠道“订单”--“订单配置”中开启云仓发货流程
3.5. WMS账号配置
由代理商/全渠道技术支持人员登录全渠道二代，根据对接准备中提供的WMS厂商和货主代码（CustomerID）在云仓--三方WMS货主配置中添加货主，其中货主名称自定义，货主代码和用户ID是一样的。
在资料--仓库信息中编辑需要对接WMS的本地仓库，将仓库性质设置为WMS仓库，并选择已经新增的货主及设置WMS仓库代码后保存。至此WMS账号配置完成。
3.6. 获取管家婆商品
由代理/全渠道技术支持人员在全渠道商品信息中获取ERP商品，需要将服务商品获取上来，若不存在服务商品需要在线下ERP中新增
3.7. 同步商品到WMS
在“云仓”--“三方WMS商品同步”中将商品信息同步到WMS
3.8. 同步入库单到WMS
①在同步入库单之前需要明确我们需要同步“采购订单”还是“采购单草稿”，明确之后在“云仓”--“三方WMS配置”--“单据类型配置”中将“采购同步WMS类型”设置为我们需要的类型
②在管家婆中录入采购入库单（仓库选择WMS仓库，商品信息选择已同步到WMS的商品）并保存为草稿
③在“云仓”--“ERP入库管理”中选择货主名称后查到刚才做的采购入库单，勾选并点击“同步WMS”
④由WMS方仓库人员在WMS系统中确认单据信息无误后完成收货操作并回传给全渠道，若WMS回传数量与同步WMS数量一致则该单据会自动过账，同时全渠道中单据状态会变为已过账，若WMS回传数量与同步WMS数量不一致或者过账报错则单据不会自动过账，需要与WMS方确认无误后到管家婆系统手动操作过账
3.9. 同步出库单到WMS
①同理需要明确同步到WMS的单据类型，明确之后在“云仓”--“三方WMS配置”--“单据类型配置”中将“销售同步WMS类型”设置为我们需要的类型
②在管家婆中录入销售出库单（仓库选择WMS仓库，商品信息选择已同步到WMS的商品）并保存为草稿
③在“云仓”--“ERP出库管理”中选择货主名称后查到刚才做的销售出库单，勾选并点击“同步WMS”
④由WMS方仓库人员在WMS系统中确认单据信息无误后完成收货操作并回传给全渠道，若WMS回传数量与同步WMS数量一致则该单据会自动过账，同时全渠道中单据状态会变为已过账，若WMS回传数量与同步WMS数量不一致或者过账报错则单据不会自动过账，需要与WMS方确认无误后到管家婆系统手动操作过账
3.10. 同步销售退货单到WMS
①管家婆录入销售退货单
（注：必须是调用原销售单或原进货单生成的退货单 且被调用原单必须是已经同步到WMS的状态）
②单据要为草稿状态（不开审核或审核通过的才会显示在ERP入库管理） 仓库要选择WMS仓库
③在“云仓”--“ERP入库管理”中选择货主名称后查到刚才做的销售退货单，勾选并点击“同步WMS”
④由WMS方仓库人员在WMS系统中确认单据信息无误后完成收货操作并回传给全渠道，若WMS回传数量与同步WMS数量一致则该单据会自动过账，同时全渠道中单据状态会变为已过账，若WMS回传数量与同步WMS数量不一致或者过账报错则单据不会自动过账，需要与WMS方确认无误后到管家婆系统手动操作过账
3.11. 同步销售订单/采购订单到WMS
若要同步销售订单/采购订单到WMS，需要先将“三方WMS配置---ERP单据相关配置---单据类型配置---销售同步WMS类型/采购同步WMS类型”切换成销售/采购订单后保存，刷新页面后云仓菜单下会有销售订单出库管理和采购订单入库管理菜单
在管家婆开销售/采购订单并保存单据后，在全渠道---云仓---销售订单出库管理/采购订单入库管理中查询到该订单，勾选单据后点击右上角”同步WMS“按钮即可将单据同步到WMS系统
由WMS仓库人员进行出入库操作并将实际的出入库数据回传回来，然后点击查询或者点击右下角的刷新按钮即可看到WMS出/入库状态会变成“已出库”或者“已入库”
点击“查看回传详情”可以看到具体的回传数据（注：只有销售/采购订单支持多次回传，每次回传后会自动生成一张销售出库单/采购入库单并自动完成过账）
3.12. 网店单据同步WMS
①登录全渠道下载网店订单
②将订单从原始订单提交到订单审核，仓库选择WMS仓库
③选择物流公司，审核订单到“云仓--网店订单发货”页面，勾选订单点击“同步WMS”
3.13. 支持同步WMS的单据类型汇总
| 出入库类型 | 单据类型 |
| 出库类 | 销售出库单 |
| 采购退货单 | |
| 同价调拨单 | |
| 变价调拨单 | |
| 报损单 | |
| 其他出库单 | |
| 销售订单 | |
| 入库类 | 销售退货单 |
| 同价调拨单 | |
| 变价调拨单 | |
| 报溢单 | |
| 其他入库单 | |
| 采购订单 |
4. WMS配置说明
4.1. 售后单宽松管理
适用于将原销售单是非WMS订单，但需要将售后单同步到WMS进行入库的场景。
勾选：非WMS仓库的售后单可以在对应的出入库界面查询到并可同步到WMS
不勾选：售后单严格管理，非WMS仓库的售后单据不可同步至WMS（不显示出来），严格管理的售后单对应的原销售单必须已同步WMS且是已出库状态且该售后单必须是调用该销售单生成的
注：勾选该配置后，所有同步到WMS的售后单的单据类型都将变为“CGRK”，销售退货单的类型也会变成“CGRK”而不是“XTRK”
4.2. 出库类单据同步价格设置
针对出库类单据，适用于需要将出库类单据的金额数量信息同步到WMS的业务场景
4.3. 销售单同步至WMS的订单类型
该配置主要用于设置出库类单据从哪个接口同步到WMS，走不同的接口同步到WMS，单据类型则不同
名词解释：
B2B：出库单通过出库单创建接口（StockoutCreate）同步到WMS，单据类型：PTCK，即普通出库
B2C：出库单通过发货单创建接口（DeliveryorderCreate）同步到WMS，单据类型：JYCK，即交易出库
B2BCK：出库单通过出库单创建接口（StockoutCreate）同步到WMS，单据类型：B2BCK，即B2B出库
4.4. 调拨单同步WMS类型
该配置用于设置调拨单同步到WMS后WMS显示的单据类型，两个选项系统会同步不同的单据类型给WMS。
4.5. WMS入库单备注来源
4.6. WMS出库单备注来源
4.7. WMS出库单卖家备注来源
4.8. WMS出库单买家留言来源
4.9. WMS订单编号回传到自定义字段
该配置用于将单据同步到WMS后，WMS返回的单号写入到管家婆单据表头自定义或者摘要字段的选项使用，WMS单号可用于与WMS对账时使用。
4.10. 收货信息取值
管家婆ERP的出库类单据没有标准的收件人信息字段时，系统将根据该配置将字段中的收件人信息解析成标准格式后同步到WMS系统中。
统一自定义：姓名、电话、省市区地址写在资格字段后系统自动解析。
分字段自定义：姓名、电话、省市区地址分别填写在三个不同字段中。
4.11. 物流信息回写
出库类单据适用，WMS出库后回传物流公司和物流单号，系统将该信息写入到管家婆的表头自定义中，方便业务员在管家婆中就可以查看到物流信息。物流公司和物流单号不能选择相同字段。
4.12. 寄件人信息取值
该配置适用于出库类单据，同步单据时部分WMS会要求同步寄件人信息。可以根据实际情况配置，选择仓库和业务员时候则需要在管家婆的仓库和业务员信息中填写好地址电话等信息。如果选择自定义信息时，则需要配置好固定的寄件人信息。
4.13. 出库类单据默认物流公司
该配置适用于出库类单据，WMS系统会要求出库类单据同步物流公司，在这里选择一个物流公司后，所有单据都会自动匹配该物流公司，部分单据如果需要修改可以在ERP出库管理中勾选单据点击修改物流公司进行单独修改。
4.14. 按WMS出库/入库日期更新单据日期
该配置只对草稿类型单据生效，勾选后草稿单据在回传过账的时候会自动将单据日期更新为当前日期。ERP订单回传生成的单据的单据日期为出库/入库日期
5、 常见问题
同步信息给WMS时候失败原因带有“WMS厂商接口返回异常”字样的，均为wms接口报错，优先将报错信息复制后发给WMS的人排查。如果WMS的人反馈需要ERP技术处理，则联系我们。