API代码:JTYLOMS
ERP系统版本: V2.21.10.7及以上
当前操作文档针对渠道特殊配置进行梳理,更多JTYLOMS基础预报设置可参考:ERP基础物流服务商预报流程
关于授权
API服务设置,填写预先向服务商注册申请的账号授权数据
关于API服务绑定
服务商管理,添加API服务绑定
关于配置 - 服务商渠道配置
配置位置:服务商渠道-》服务商渠道配置 (必填 / 条件必填)
配置名称:订单类型
当配置不进行维护时,默认传空值;
当配置进行维护配置后,订单类型将进行对应匹配随订单提交给服务商;
模式【出库-适用于非平台订单】:目的国备货、代打包、末端派送指定J&T;
模式【备货-适用于非平台订单】:国内备货、代打包、末端派送指定J&T;
模式【仓储-适用于平台订单】:代打包、末端派送指定J&T;
模式【仅出库-适用于平台订单】:代打包、末端派送不指定J&T;
“适用于平台订单”的两个选项,需结合【物流管理-运输方式管理-是否开启多重预报】使用,订单不由极兔海外仓指定派送,改由其他三方物流运输
更多关于多重预报设置可参考:关于多重预报-基础数据设置
- 如果没有开启,该订单属于问题件,显示异常提示:“当前订单类型属于平台订单,需要开启多重预报以便推送面单、承运商信息至海外仓”;
- 如果开启,将物流段返回的面单和承运商给到海外仓进行创建出库单。
- 如果开启多重预报,但是【订单类型】没有选择 “适用于平台订单”的两个选项,则属于问题件,并且显示报错:“多重预报功能下,服务商渠道配置-【订单类型】需要选择【仓储-适用于平台订单】或者【仅出库-适用于平台订单】”
配置名称:关税支付方式
配置值:请选择(默认空值)、第三方、关税到付、关税预付
关于配置 - 产品同步场景 (必填 / 条件必填)
路径1:仓配管理系统-》头程管理-》发货管理-》海外仓产品-》服务商:JTYLOMS -极兔海外仓
操作:针对需要同步至海外仓产品 -选择对应品类
服务商对应字段:itemType
路径2:仓配管理系统 -》产品管理 -》产品资料管理-》产品详情-》属性【产品单位】
操作:维护对应服务商认可商品单位
服务商对应字段:unit
路径3:仓配管理系统 -》产品管理 -》产品资料管理-》产品详情-》属性【申报价值】
操作:商品对应商品单价(默认USD)
服务商对应字段:unitPrice
路径4:仓配管理系统 -》产品管理 -》产品资料管理-》产品详情-》属性【是否包含电池】
操作:根据产品情况,选择是否带电
服务商对应字段:isElectricity
路径5:仓配管理系统 -》产品管理 -》产品资料管理-》产品详情-》属性【带电容量(wh)】
操作:(条件必填)当产品属于带电产品时,需要维护产品对应带电容量
服务商对应字段:electricityCapacity
关于容量算法:带电容量(wh)= 额定电压(V)×额定容量(mAh)/1000
假设额定电压=220V
带电容量(wh)= 220×10000/1000=2220(wh)
其他逻辑
1、目前已知极兔仓库编号:
P.S. 不同仓库编码需要匹配不同API地址进行请求,相关信息需要与服务商沟通确定。
仓库ID | 仓库名称 |
VNM01 | 越南一号 |
QD01 | 青岛一号仓 |
YW01 | 义乌一号 |
GZ01 | 广州一号 |
PHI01 | 菲律宾海外仓 |
MY02 | 马来传统仓 |
SD01 | 威海一号仓 |
NN01 | 南宁一号 |
MY01 | 马来海外仓 |
021DCB | PIK |
THA01 | 泰国海外仓 |
021DCA | LEGOK |
SZ01 | 虎门云仓 |
XM01 | 厦门一号 |
IJ1 | 印尼一号 |
USW01 | 美西1号 |
FR01 | 法国一号仓 |
NLD01 | 荷兰1号 |
MED | MEDINA DC |
7899 | 阿联酋1号仓(测试) |
RUH001 | RUH WAREHOUSE |
2、关于 渠道-API服务代码维护对应需要维护服务商【transport-运输方式】数据
注:目前已实现 产品同步、库存同步、创建头程入库单、创建尾程出库单(预报订单)、获取跟踪号、获取标签、取消订单(出库单)、多重预报 功能对接。
添加评论