接 Item WMS：下发订单与收货，同步产品与库存
先向 UNIS 索取 Company ID、Customer ID 与 Facility ID，把 Item WMS 用户名和密码填进 Integration，测试登录、核对 Mapping，再激活出库、入库、标签、产品与库存。
Item WMS 连接器把本系统与 Item WMS（UNIS）连起来。它下发并可取消出库订单，查订单确认与发货确认，上传面单，创建并可取消入库收货，查收货确认与收货回执，导入与查询产品，并读取产品级库存（可用、已分配、损坏、冻结与在手）。它需要的三个 ID 全部由 UNIS 分配——您不能自己创建。一个连接按您填入的公司、客户与仓库值工作。
前置条件#
- 一个 Item WMS 登录：能登录 Item WMS 的用户名和密码。
- 您的 Company ID，由 UNIS 系统管理员分配。开始前先索取——它几乎在每次 API 调用时都要带。
- 您的 Customer ID，由 UNIS 财务（Finance）分配。它与 Company ID 来自不同团队，请单独向财务索取。
- 您的 Facility ID（仓库 ID），由您的 ITEM CSR 分配。确认它是本连接要对接的那个仓库的 ID。
- 通常您不需要 Base URL：连接默认使用生产地址。只有当 UNIS 给了您非生产或特殊环境时，才记下不同的地址。
拿凭证#
- 向 UNIS 系统管理员索取您的 Company ID。下面所有 ID 都由 UNIS 分配——您不能在 Item WMS 里自己创建。
- 向 UNIS 财务索取您的 Customer ID。这里不要复用 Company ID——两个 ID 是不同团队给的不同值。
- 向您的 ITEM CSR 索取 Facility ID，即本连接所服务仓库的仓库 ID。
- 记下集成用的 Item WMS 登录用户名和密码，与您登录 Item WMS 时用的完全一致。
填进 Integration#
- 打开 Integration，选择 Item WMS，新建连接。
- username——必填，用户名：集成用的 Item WMS 登录用户名，例如 your-username。
- password——必填，密码：同一个 Item WMS 登录的密码。作为秘密保存。
- company_id——必填，公司 ID：UNIS 系统管理员分配的 ID，形态例如 COMPANY01。按 UNIS 给您的原样填写。
- customer_id——必填，客户 ID：UNIS 财务分配的 ID，形态例如 CUST001。它与 Company ID 不是同一个值。
- facility_id——必填，仓库 ID：您的 ITEM CSR 分配的仓库 ID，形态例如 WH01。
- base_url——选填，Base URL：留空即用默认生产地址 https://wms.item.com/api/public/v1/public。只有 UNIS 给了非生产或特殊环境的不同地址时才填。
测试连接#
点测试连接。测试是真登录：它把您的 username 和 password 发到 Item WMS 的登录端点，拿到 token 才算通过。所以测通证明用户名和密码正确、地址能应答。测试不会带三个 ID 做业务调用，所以 Company ID、Customer ID 或 Facility ID 填错也可能测通，要到第一次真实的订单、收货、产品或库存调用时才失败。测试通过后，按 Mapping 一节的办法先用一次真实调用核对三个 ID，再激活。
配 Mapping / 选模板#
为订单、收货、产品与库存选 Item WMS 标准 Mapping，并把连接里的公司、客户与仓库值作为每次调用时带的值保留。然后在激活前核对：下发或查询一个真实订单，对照订单号、明细行与数量；对一个已知产品跑一次库存查询，把可用与在手数量和 Item WMS 对照。这一步同时也是核对三个 ID 的办法：登录测试查不了它们，这里结果正确，说明三个 ID 是一套、且指向正确的仓库。
激活#
激活后，连接把出库订单下发到 Item WMS，发送订单取消，创建入库收货与收货取消，上传面单，并持续拉取确认、发货确认与收货回执，产品导入、产品查询与库存读取也走同一个连接。先在 运行监控 / 日志里盯头几单订单与收货、和 Item WMS 对照无误，再放手跑。
请记住范围：本连接覆盖上面列的出库、入库、面单、产品与库存工作，范围就是您填入的公司、客户与仓库。另一个仓库或另一个客户的工作需要它自己的值——不要改正在跑的连接的 ID 来换仓；请另建一个连接。
常见问题#
测试报 AUTH_FAILED
登录被拒了：Item WMS 应答了登录调用，但没有返回 token。这说明所用的用户名、密码或地址对不上——登录组合必须是 Item WMS 登录本身，base_url 填了的话必须指向 Item WMS 的 API 地址。
用同样的用户名和密码直接登录一次 Item WMS，确认这组能登录；再把两个值重新复制一遍、不要带多余空格；base_url 除非 UNIS 给了不同地址，否则清空。然后重新测试。
测试通过了，但第一次真实订单或收货调用失败
ID 填错时就会这样：测试只用用户名和密码登录，而真实调用还要带 Company ID、Customer ID 与 Facility ID。所以 ID 错或不配套时测试能过、第一次业务调用才失败。
把三个 ID 与 UNIS 发给您的逐字对照：Company ID 来自 UNIS 系统管理员，Customer ID 来自 UNIS 财务，Facility ID 来自您的 ITEM CSR。把连接里错的值改对，再重复同一真实调用，确认成功后再激活。
Company ID、Customer ID 和 Facility ID 去哪拿？
三个 ID 全部由 UNIS 分配——您不能自己创建，而且来自三个不同来源。在 Item WMS 里找能生成它们的页面是找不到的。
向各自的来源要各自的 ID：Company ID 找 UNIS 系统管理员，Customer ID 找 UNIS 财务，Facility ID 找您的 ITEM CSR。三个都收齐后，按发给您的原样填进连接。
base_url 要填吗？
多数情况不用。base_url 是选填：留空时连接使用默认生产地址 https://wms.item.com/api/public/v1/public。把复制来的或猜的地址填进去，是登录失败的常见原因。
生产环境把 base_url 留空。只有 UNIS 给了非生产或特殊环境的不同地址时才填，并按给您的地址原样复制。
本系统里的库存数和 Item WMS 对不上
连接从 Item WMS 读产品级库存——可用、已分配、损坏、冻结与在手是分开的数量。对不上通常是比了不同的数量类型，或两个视图的产品、仓库范围不同。
选同一个仓库里的一个已知产品，两边比同一种数量类型（如可用对可用），并确认产品编码与 Item WMS 的产品一致。这个产品对得上后，再用同一数量类型复查更大的清单。