麦哲伦WMS海外仓系统 API 接口对接说明

简介: 麦哲伦WMS海外仓系统 API提供仓库、运输、出入库、库存及商品管理等核心接口,支持GET/POST调用,需携带customerId与API Key认证。响应统一返回code=200标识成功,涵盖单据查询/创建/取消、箱标生成、物流追踪、费率查询等功能,助力高效对接海外仓业务。(239字)

麦哲伦WMS海外仓系统 API 接口请求路径与功能详细说明‌

所有接口的调用均需在请求头(header Parameters)中携带客户ID (customerId) 和 API密钥 (API Key) 进行身份验证。接口响应遵循统一格式,其中 code 为200表示成功。

{"code": 0, "data": {}, "message": "string", "taskid": "string"}

‌一、 基础信息接口‌

  1. ‌获取仓库列表‌
  • ‌功能描述:‌ 查询当前账户下所有可用的海外仓库信息。
  • ‌请求路径/接口:‌ Warehouse
  • ‌请求方式:‌ 根据上下文推断,通常为 GET。
  • ‌主要参数:‌ 认证信息置于请求头。
  • ‌返回数据 (data):‌ 仓库信息列表。
  1. ‌获取运输服务‌
  • ‌功能描述:‌ 根据指定的仓库代码,查询该仓库支持的所有物流运输服务(如快递、邮政、专线等)。
  • ‌请求路径/接口:‌ ShippingService
  • ‌请求方式:‌ 推断为 GET。
  • ‌查询参数 (query Parameters):‌
  • WarehouseCode ‌(必填)‌: 目标仓库的代码。
  • ‌返回数据 (data):‌ 可用的运输服务列表。

‌二、 入库管理 (Inbound)‌

  1. ‌查询入库单‌
  • ‌功能描述:‌ 根据入库单号查询特定入库单的详细信息及状态。
  • ‌请求路径/接口:‌ Inbound > Retrieves
  • ‌请求方式:‌ GET。
  • ‌查询参数 (query Parameters):‌
  • Number ‌(必填)‌: 入库单号 (Inbound Number)。
  • ‌返回数据 (data):‌ 入库单详情。
  1. ‌创建入库单‌
  • ‌功能描述:‌ 向WMS系统提交一个新的入库计划,创建入库单。
  • ‌请求路径/接口:‌ Inbound > Create
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌ 需提交包含商品明细、预报数量等信息的JSON对象。
  • ‌返回数据 (data):‌ 包含系统生成的入库单号 {"Number": "string"}。
  1. ‌取消入库单‌
  • ‌功能描述:‌ 取消一个已创建但尚未完成收货的入库单。
  • ‌请求路径/接口:‌ Inbound > Cancel
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌ {"Number": "string"},其中Number为要取消的入库单号。
  • ‌返回数据 (data):‌ 操作结果。
  1. ‌获取箱标‌
  • ‌功能描述:‌ 获取指定入库单的箱唛/箱标文件,用于打印并粘贴在入库货物的外箱上。
  • ‌请求路径/接口:‌ Inbound > BoxLabel
  • ‌请求方式:‌ GET。
  • ‌查询参数 (query Parameters):‌
  • Number ‌(必填)‌: 入库单号 (Inbound Number)。
  • ‌返回数据 (data):‌ 箱标文件信息(通常为PDF的URL或Base64编码数据)。

‌三、 库存管理 (Inventory)‌

  1. ‌查询库存‌
  • ‌功能描述:‌ 查询库存信息,支持多种查询方式。
  • ‌请求路径/接口:‌ Inventory > Retrieves
  • ‌请求方式:‌ GET。用于简单查询,参数可能通过查询字符串传递。
  • ‌返回数据 (data):‌ 库存信息。
  1. ‌查询库存列表(分页)‌
  • ‌功能描述:‌ 以分页形式查询所有商品的库存列表,支持条件筛选。
  • ‌请求路径/接口:‌ Inventory > Retrieves (查询列表)
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌ 可包含分页参数(如PageNumber, PageSize)及其他筛选条件。
  • ‌返回数据 (data):‌ 分页格式的库存列表,结构为 {"PageItems": [...], "PageNumber": 0, "PageSize": 0, "TotalNumber": 0}。
  1. ‌查询库存详情‌
  • ‌功能描述:‌ 查询更详细的库存信息,可能包括批次、库位等。
  • ‌请求路径/接口:‌ Inventory > Retrieves Detail
  • ‌请求方式:‌ GET。
  • ‌返回数据 (data):‌ 详细的库存记录列表。

‌四、 出库管理 (Outbound)‌

  1. ‌查询出库单‌
  • ‌功能描述:‌ 根据出库单号或客户参考号查询出库单详情。
  • ‌请求路径/接口:‌ Outbound > Retrieves
  • ‌请求方式:‌ GET。
  • ‌查询参数 (query Parameters):‌
  • Number ‌(必填)‌: 出库单号或客户参考号。
  • ‌返回数据 (data):‌ 出库单详情。
  1. ‌创建出库单‌
  • ‌功能描述:‌ 创建新的出库订单(发货单)。根据货物类型分为“小货”和“大货”两种创建方式,其请求参数结构可能不同。
  • ‌请求路径/接口:‌
  • Outbound > Create (新建 小货)
  • Outbound > Create (新建 大货)
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌ 需提交包含收货信息、商品明细、物流服务等信息的JSON对象。
  • ‌返回数据 (data):‌ 包含系统生成的出库单号 {"Number": "string"}。
  1. ‌取消出库单‌
  • ‌功能描述:‌ 取消一个已创建但尚未开始处理的出库单。
  • ‌请求路径/接口:‌ Outbound > Cancel
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌ {"Number": "string", "ReferenceNo": "string"},需同时提供系统单号和客户参考号。
  • ‌返回数据 (data):‌ 操作结果。
  1. ‌查询取消状态‌
  • ‌功能描述:‌ 查询出库单的取消申请处理状态。
  • ‌请求路径/接口:‌ Outbound > GetCancel
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌ {"Number": "string", "ReferenceNo": "string"}。
  • ‌返回数据 (data):‌ 取消任务的状态信息。
  1. ‌上传运单‌
  • ‌功能描述:‌ 将由物流商提供的面单(运单)文件上传至WMS系统,用于仓库贴单发货。
  • ‌请求路径/接口:‌ Outbound > UpdateShippingLabel
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌
  • Number: 出库单号。
  • TrackingNo: 物流跟踪号。
  • Base64Pdf: 运单PDF文件经过Base64编码后的字符串。
  • ‌返回数据 (data):‌ 上传结果。
  1. ‌物流追踪查询‌
  • ‌功能描述:‌ 根据运单号或出库单号查询包裹的物流轨迹信息。
  • ‌请求路径/接口:‌ Outbound > Tracking
  • ‌请求方式:‌ GET。
  • ‌查询参数 (query Parameters):‌
  • Number ‌(必填)‌: 运单号或出库单号。
  • ‌返回数据 (data):‌ 物流追踪信息列表。
  1. ‌查询运输服务费率‌
  • ‌功能描述:‌ 获取各物流运输服务的资费标准。
  • ‌请求路径/接口:‌ Outbound > Shipping Service Rate
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌ 可能包含查询条件(如仓库、目的地、重量等)。
  • ‌返回数据 (data):‌ 运输服务及其费率的列表。

‌五、 商品管理 (Product)‌

  1. ‌查询商品(按SKU)‌
  • ‌功能描述:‌ 根据唯一的商品SKU编码查询单个商品的详细信息。
  • ‌请求路径/接口:‌ Product > Retrieves
  • ‌请求方式:‌ GET。
  • ‌查询参数 (query Parameters):‌
  • Sku ‌(必填)‌: 商品SKU。
  • ‌返回数据 (data):‌ 商品详情。
  1. ‌创建商品‌
  • ‌功能描述:‌ 在WMS系统中新建一个商品档案,用于后续的入库和库存管理。
  • ‌请求路径/接口:‌ Product > Create
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌ 需提交包含SKU、名称、规格、条码等商品信息的JSON对象。
  • ‌返回数据 (data):‌ 包含系统新生成的商品ID {"Id": 0}。
  1. ‌查询商品列表(分页)‌
  • ‌功能描述:‌ 以分页形式查询系统中的商品列表,支持按SKU、条码等条件筛选。
  • ‌请求路径/接口:‌ Product > Retrieves (查询列表)
  • ‌请求方式:‌ POST。
  • ‌请求体 (Payload):‌
  • Sku: 商品SKU(可选)。
  • Barcode: 商品条码(可选)。
  • PageNumber: 页码。
  • PageSize: 每页数量。
  • ‌返回数据 (data):‌ 分页格式的商品列表,结构为 {"PageItems": [...], "PageNumber": 0, "PageSize": 0, "TotalNumber": 0}。


三、 对接流程建议‌

  1. ‌获取认证信息:‌ 登录麦哲伦WMS海外仓系统系统,获取 customerId 和 API Key。
  2. ‌环境准备:‌ 确保您的系统能发起HTTPS/HTTP请求并处理JSON数据。
  3. ‌接口调试:‌
  • 建议从 ‌Warehouse (获取仓库)‌ 等基础查询接口开始,验证认证是否成功。
  • 使用 ‌Product > Create‌ 创建测试商品。
  • 逐步测试核心业务流程:‌创建入库单 -> 查询库存 -> 创建出库单 -> 查询跟踪‌。
  1. ‌异常处理:‌ 密切关注接口返回的 code 和 message 字段,非 0 时表示操作异常或失败。
  2. ‌上线核对:‌ 正式上线前,请完成所有业务场景的接口联调,并确保数据传输的准确性与完整性。
相关文章
|
8月前
|
JSON 自然语言处理 供应链
跨境电商ERP如何对接索恩WMS海外仓系统
索恩WMS是专为跨境电商海外仓打造的智能仓储系统,支持多平台订单同步、实时库存管理、智能拣货与全球物流对接,覆盖入库、出库、库存、财务等全链路API,助力企业降本增效、提升履约体验。(239字)
595 3
|
8月前
|
人工智能 供应链 监控
开发wms系统该具备那些专业能力 低代码实现专业wms系统优势
2026年,WMS已跃升为串联供应链全环节的核心基础设施。本文从定义、技术、功能、行业适配、案例及趋势六大维度,系统解析专业WMS如何通过AI、IoT、低代码等技术实现库存精准管控、作业提效、成本优化与全链协同,助力企业深度数字化转型。
|
7月前
|
Web App开发 缓存 安全
私域直播系统开发搭建方案
本方案设计了一套高可用、低延迟的私域直播系统,采用分层架构(客户端/业务/音视频/基础设施),支持多端接入、实时互动、电商闭环与数据统计;选用微服务+WebRTC+CDN技术栈,兼顾性能、合规与安全,开发预算约20–50万元。
|
7月前
|
传感器 数据采集 物联网
别再瞎选了!LoRa、Wi-Fi、蓝牙3种无线技术选型指南,看完再也不踩坑
LoRa、Wi-Fi、蓝牙看起来都能无线传输,实际用起来天差地别,选错了轻则项目延期,重则直接推倒重来。今天就用最通俗易懂的方式讲清三者的核心差异,帮你一次性搞懂不同场景该怎么选。
|
7月前
|
数据采集 物联网 中间件
仓储中RFID为何能逐步替代传统人工管理?
解析RFID在仓储中的应用优势,对比人工管理在效率、准确率与成本上的差异,说明RFID如何实现自动化、提升库存准确率并降低运营成本。
406 1
|
7月前
|
数据采集 供应链 数据可视化
为什么鞋服零售大量引入RFID管理?
RFID在鞋服零售中的价值并不止于单点门面,更在于能围绕库存、效率、供应链和销售形成系统性管理体系,促进销售额增长和管理成本下降。
401 2
为什么鞋服零售大量引入RFID管理?
|
8月前
|
安全 Windows
没人告诉你的秘密:Typora+PicGo+GitHub 免费图床天花板
没人告诉你的秘密:Typora+PicGo+GitHub 免费图床天花板
没人告诉你的秘密:Typora+PicGo+GitHub 免费图床天花板
|
8月前
|
网络协议 物联网 网络安全
EWM103-W15SP系列WiFi模块与电脑TCP透传通信教程
本教程详解亿佰特EWM103-W15SP WiFi模块的TCP透传通信配置,涵盖AP模式(模块作热点+TCP Server)和STA模式(模块连路由器+TCP Client)两种方案,含AT指令配置、网络参数设置及数据收发测试全流程。
|
8月前
|
存储 NoSQL MongoDB
别再瞎选 NoSQL 了!Redis、MongoDB、ES 场景边界、底层原理与生产选型全解
本文深度解析Redis、MongoDB、Elasticsearch三大主流NoSQL的选型误区、核心定位、架构原理、适用与禁忌场景,并提供生产级对比、决策树、代码实战及避坑指南,强调“NoSQL是补充而非替代”,倡导按需选型、组合使用、避免过度设计。
911 2
|
7月前
|
JSON 测试技术 API
Postman-win64-7.3.5-Setup安装步骤详解(附接口测试入门教程)
`Postman-win64-7.3.5-Setup.exe`是Postman接口测试工具的Windows安装包,专用于API调试、HTTP请求发送与后端接口测试,支持GET/POST等请求、参数配置及接口保存,开发、测试、联调必备。

热门文章

最新文章