问题1：各接口意义及必要串接接口？
答：
推送接口：
| 序号 | 接口名称 | 業務類型 | 接口描述 | 调應方 | 接收方 |
| ※ 1 |
商品同步接口 |
商品 |
OneWarehouse通过此接口新增/更新商品档案给WMS |
OneWarehouse | WMS |
| ※ 2 |
采取购物清单下单接口 |
入庫 |
OneWarehouse通过此接口自动化「采购入库单」给WMS |
||
| ※ 3 | 退货入库列表下单接口 | OneWarehouse通过此接口统一「退货入库单」给WMS | |||
| ※ 4 |
进入库单取消接口 |
OneWarehouse通过此接口批量入库单取消（含采购/进口）请求给WMS |
|||
| ※ 5 |
出库单下单接口 |
出庫
|
OneWarehouse通过此接口自动化「出库订单」给WMS |
||
| ※ 6 |
出库单取消接口 |
OneWarehouse通过此接口批量取消出库订单请求给WMS |
|||
| ※ 7 |
出库单回调接口 |
WMS通过此接口自动化「出库单出库状态/明细」给OneWarehouse |
WMS | OneWarehouse | |
| ※ 8 | 仓库取消发货接口 | WMS通过此接口主动出库单取消请求给OneWarehouse（可用于发现仓库发货流程中，仓库端意外，需要主动中断该订单发货场景） | |||
| ※ 9 | 入库单回调接口 | 入庫 | WMS通过此接口自动化「入库单入库状态/明细」给OneWarehouse |
查询接口：
| 序号 | 接口名称 | 業務類型 | 接口描述 | 调應方 |
| ※ 1 |
鍲取面單接口 |
出庫 |
WMS通过此接口查询「出库订单」的运单图片（非仓库物流，返回图片下载链接，图片默认PDF格式） |
WMS |
| 2 | 获取自画面参数接口 | 如果仓库需要不直接获取运单图片时，可调用该接口获取到运单组成的参数，可用该资讯仓库自行绘制运单图片 | ||
| 3 | 申請包接口 | 当仓库出库时发现一个订单有多包裹情况，需获取新的运单号时使用，每次调用代表申请一个运单号 | ||
| 4 | 獲取商家信息接口 | 貨主資料 | WMS通过此接口查询货主的公司名称等资料 |
注意：红色星号※建议接口必接
问题2：回调key和下发key对应用途，以什么为基准去检查webhook请求？
答：
回调key的用途及检查基准
用途：
- 回调key主要用于WMS（仓库管理系统）在入库单或出库单操作成功后，回调OneWarehouse系统时进行身份验证。OneWarehouse系统在接收到回调请求时，会解析请求中的按键，并与默认设置或存储的回调键进行对比，以确认请求的来源是否合法，从而阻止未经授权的访问。
檢查依据：
- 密钥一致性：检查请求中的密钥与OneWarehouse系统中存储的回调密钥是否完全一致。
- 请求来源验证：通过验证密钥，确认请求确实来自WMS系统，而非其他恶意来源。
- 定时器与签名验证（如适用）：除密钥外，还可以结合请求中的定时器和签名进行进一步的验证，保证请求的实时性和数据的完整性。
下发key用途及检查基准
用途：
- 下发key用于OneWarehouse系统在调用WMS系统时进行身份验证。OneWarehouse系统保留包含sign、timestamp等字段的请求发送给WMS系统，WMS系统则根据OneWarehouse下发的密钥、指定的加密方式及对请求参数进行加密处理，将结果与请求中的标志进行对比，以确认请求的合法性。
檢查依据：
- 加密结果一致性：WMS系统使用下发密钥对请求参数进行加密处理后，得到的结果应与请求中的标志完全一致。
- 请求参数验证：除了加密结果外，WMS系统还应验证请求中的其他参数，如时间戳（计时器），以保证请求的实时性和数据的准确性。
- 安全性考虑：在使用下发密钥进行加密验证时，应确保加密方式的安全性，避免使用已知存在漏洞的加密算法或协议。
问题3：是否要IP白名单限制？
答：
如果WMS系统有相关的访问限制需求，我们可以为OneWarehouse系统提供以下的IP白名单列表，以便WMS系统进行配置。而当WMS系统回调OneWarehouse网关时，是需要设置IP白名单限制的。
OneWarehouse系统的固定出口IP地址如下：
- 121.11.221.130
- 121.11.221.131
- 52.77.143.211
- 122.248.196.11
- 46.51.219.5
- 13.214.244.173
- 18.143.33.165
- 13.215.123.123
- 120.78.70.56
- 120.78.69.89
- 120.78.67.40
- 120.78.71.91
问题4：申请测试环境需要准备哪些内容？
答：
1. 准备测试环境
A. 提供接收URL
- 任务：您需要准备 6 个测试用的 URL 地址，这些地址将作为 OneWarehouse 接口的目标。这 6 个地址对应以下 6 个接口：
-
- 商品同步接口
- 采取购物清单下单接口
- 退货入库列表下单接口
- 进入库单取消接口
- 出库单下单接口
- 出库单取消接口
- 建议：这些URL可以指向您内部的一个模拟服务，该服务能够接收请求并返回模拟的响应。
B. Mock内部实现
- 任务：设置mock服务以接收和处理来自OneWarehouse的个体请求。
- 建议：mock服务应能够模拟真实的业务逻辑，包括返回成功状态码、模拟数据库操作等，以便验证接口通讯的正确性和数据的准确性。
2. 接口与测试
A.配置OneWarehouse个体接口
- 您的任务：在收到并确认的接收URL后，OneWarehouse将配置其子接口以指向您提供的URL。
B. 执行接口测试
- 任务：进行一系列接口对接测试
- 目的：验证每个接口的功能是否按预期工作，数据是否正确传输和处理。
3. 问题反馈与调整
- 任务：在测试过程中，如果发现任何问题（如数据格式错误、响应超时、逻辑处理错误等），双方应及时沟通并提供详细的错误和日志。
- 行动：根据问题反馈，双方共同协作，调整接口实现或模拟服务的配置，底座所有接口正常通讯并满足需求业务。
问题5：在沙盒环境中测试的流程怎样？
答：
1. 环境准备
- 设置沙盒环境：确保沙盒环境已配置完成，并与生产环境隔离，巴勒斯坦测试数据影响实际业务。
- 数据准备：根据测试需求，在沙盒环境中准备必要的测试数据，如商品分类、供应商信息等。
2. 創建商品案
- 步驟：
- 在系统中手动创建几个商品档案，包括商品的基本信息、库存设置等。
- 注意记录商品ID和创建时间，以便后续跟踪和验证。
- 實證點：
- 确认商品档案是否成功创建，且信息准确无误。
- 确认此时立即调用创建商品介面（根据业务逻辑）。
3. 入库测试
- 步驟：
- 创建入库单，并输入相关商品信息和数量。
- 调用创建入库单流程，观察系统反应。
- 调用入库单回调介面，将入库单状态改变为完成状态。
- 實證點：
- 确认录入库单是否成功创建并被系统接受。
- 验证库存是否根据入库单数量正确增加。
- 检查系统日志和回调记录，确保流程无误。
4. 出库测试
- 步驟：
- 创建出库单，选择需要出库的商品和数量。
- 模拟仓库出库完成，记录相关信息（如出库时间、操作员等）。
- 调用出库单回调界面，将订单状态更改为已出库状态。
- 實證點：
- 确认出库单是否成功创建并被系统接受。
- 验证库存是否根据出库单数量正确减少。
- 确保物流面单介绍面能够正常获取面单图片（如适用）。
- 检查系统日志和回调记录，确保流程无误。
5. 火灾测试
- 步驟：
- 模拟实际操作场景，结合商品创建、入库、出库等多个前期进行测试。
- 测试系统在异常情况下的反应，如网络中断、数据异常等。
- 进行负载测试，验证系统在高并发情况下的性能和稳定性。
- 實證點：
- 确认系统在各个环节之间的数据传输和处理是否准确无误。
- 验证系统在异常情况下的恢复能力和错误处理机制。
- 确保系统在高负载情况下仍能保持良好的性能和稳定性。
6. 记录与反攻
- 记录测试结果：详细记录每个测试步骤的结果和发现的问题。
- 问题反馈与跟踪：及时向开发团队反馈测试中发现的问题，并跟踪问题的解决进度。
- 总结测试报告：在测试结束后，总结测试结果和经验教训，编写测试报告以供后续参考。
问题6：货主身份如何区分？
答：
在API中，我们使用字段“account_no”作为货主的身份ID，用于区分不同的货主。在贵司系统中可以建立相关货主档案与“account_no”进行关联，这样实现根据“account_no”来区分不同的货主通过这种方式，贵方能够准确识别和处理来自不同货主的商品、单据和相关信息。
评论
0 条评论
请登录写评论。