一、功能介绍
与头程物流商进行接口对接,实现与物流商交互,提高发货操作便利性。您可以进行以下操作:
- 向物流商下单/取消下单
- 打印箱唛/交接单
- 查看物流商揽收数据
- 查看物流商费用数据
- 查看物流轨迹信息
二、权限开通
【系统】-【角色管理】-【功能权限】-【物流】-【头程发货管理】中开启头程物流相关的功能权限。

三、数据同步逻辑
1.物流商订单信息更新
- 拉取频率: 一天2次,每天晚上0、白天14点更新
- 拉取范围: 针对创建时间为近3个月,状态非“已取消”、“已完成”的头程物流单进行拉取
2.实际揽收信息更新
- 拉取频率: 一天2次,每天晚上0、白天14点更新
- 拉取范围: 针对创建时间为近3个月,状态为“待提货”的头程物流单进行拉取
3.费用信息更新
- 拉取频率: 一天一次,每天晚上0点更新
- 拉取范围: 针对创建时间为近3个月,状态为“运输中”、“已完成”的头程物流单进行拉取
4.物流轨迹信息更新
- 拉取频率: 一天一次,每天晚上0点更新
- 拉取范围: 针对创建时间为近3个月,状态为“待提货”、“运输中”、“已完成”的头程物流单进行拉取
四、头程物流下单操作
在操作下单前请先完成头程物流商的授权,操作入口:物流/基础配置/物流商资料,操作手册:https://help.jijiaerp.com/docs/5ynYfiDh (根据使用的物流商找到对应的操作指引)
1. 物流下单入口
路径:物流/头程发货管理/发货单
-
仅 “提货中” 状态且未物流下单过的发货单支持进行头程物流下单,其他状态的发货单不显示【物流下单】按钮
-
进行头程物流下单前,请确保发货单的装箱信息已同步上游的FBA货件/来源单据的装箱数据,若未同步上游装箱数据,点击【物流下单】按钮时会进行提示

- 若您确定发货单的装箱信息准确且无需同步,此时点击【确认】可继续进行头程下单
2. 物流下单操作
1. 需要先选择头程物流商,根据选择的物流商显示不同的填写内容
2. 所有头程物流商需要填写的信息都分为6大板块,不同物流商,每个板块要填写的内容会有区别,带“*”的为必填字段
- 基础信息:指一些基础信息
- 发件人信息:指发货地址信息,可以提前在地址簿维护好地址模板,直接引用
- 收件人信息:指收货地址信息
- 报关/清关信息:指物流商要求填写的报关/清关信息,单据维度填写
- 产品信息:指下单给物流商的商品的报关/清关信息,数据主要来自产品资料中维护的数据
- 箱货信息:指下单给物流商的箱子信息,数据来自发货单装箱明细,请确保装箱明细准确
3. 按要求填写完相关信息后,点击【确认】按钮进行下单,下单成功后自动进入到【物流下单看板】
- 头程物流单号:物流商返回的订单号,可用此单号前往物流商系统中查询数据
- 单据状态: 物流下单成功后默认为“待提货”状态,后续根据物流商的数据自动更新
2.1 宇腾物流下单重点字段说明
1. 基础信息
- 客户订单号: 必填项,发往平台仓时,系统自动以货件的数据填充,发往非平台仓,系统自动以发货单号填充
- FBA货件号: 发往平台仓时,系统自动以货件的数据填充
2. 收件人信息
- 地址类型: 必填项,调宇腾接口实时获取数据,请根据发货的目的地类型进行选择
- 交货仓库: 必填项,指宇腾在国内的交货仓,调宇腾接口实时获取数据,请根据实际情况进行选择
- 目的地: 必填项,调宇腾接口实时获取数据,请根据实际情况进行选择
- 收货地址名称: 非必填项
- 详细地址信息: 可手动输入,也可以一键填充关联 FBA货件的目的地
3. 报关/清关信息
- 报关方式: 必填项,调宇腾接口实时获取数据,请根据需求进行选择
- 清关方式: 必填项,调宇腾接口实时获取数据,请根据需求进行选择
- 产品大类: 必填项,调宇腾接口实时获取数据,请根据需求进行选择
- 是否购买保险: 请根据需求进行选择
- 保险金额: 当“是否购买保险”选择为“是”时才显示,且必填
4. 产品信息
- 中文报关名: 取自【产品资料-物流/报关-中文报关名】
- 英文报关名: 取自【产品资料-物流/报关-英文报关名】
- 报关编码: 取自【产品资料-物流/报关-报关信息-清关编码】
- 申报单价: 取自【产品资料-物流/报关-报关信息-申报单价】
- 材质:取自【产品资料-基础信息-材质】
- 用途:取自【产品资料-基础信息-用途】
- 型号:取自【产品资料-物流/报关-申报型号】
- 品牌:取自【产品资料-基础信息-品牌】
- 产品性质:调宇腾接口实时获取,请根据需求进行选择
- 产品净重:取自【产品资料-采购信息-单品净重】
- 销售价格:需手动填写
- 销售链接:需手动填写
2.2 新智慧物流下单重点字段说明

1. 基础信息
- 客户订单号: 必填项,发往平台仓时,系统自动以货件的数据填充,发往非平台仓,系统自动以发货单号填充
- ReferenceID: 发往平台仓时,系统自动以货件的数据填充
2. 收件人信息
- FBA仓代码:若目的仓类型为FBA仓时必填,调新智慧接口实时获取数据,请根据发货的目的地类型进行选择
- 详细地址信息:根据选择的 FBA 仓代码,调新智慧接口实时获取数据,可手动修改
3. 产品信息
- 中文报关名:取自【产品资料-物流/报关-中文报关名】
- 英文报关名:取自【产品资料-物流/报关-英文报关名】
- 报关编码:取自【产品资料-物流/报关-报关信息-清关编码】
- 申报单价:取自【产品资料-物流/报关-报关信息-申报单价】
- 材质:取自【产品资料-基础信息-材质】
- 用途:取自【产品资料-基础信息-用途】
- 型号:取自【产品资料-物流/报关-申报型号】
- 品牌:取自【产品资料-基础信息-品牌】
- 原产地:取自【产品资料-采购信息-原产地】
- 特殊属性:取自【产品资料-物流报关-特殊属性】
- 产品毛重(g):取自【产品资料-采购信息-单品毛重】
- 产品尺寸(cm):取自【产品资料-采购信息-包装尺寸】
- 销售价格:需手动填写
- 销售链接:需手动填写
五、头程物流运输跟进
- 在发货单界面,找到对应的发货单,点击 “头程物流单号” 或 “物流下单详情” 可直接跳转到该单的下单详情页,也可以通过点击 【物流下单看板】 进入到看板页,找到对应的头程物流单点击“头程物流单号”或【详情】按钮进入详情页查看


1. 物流下单看板
1. 单据状态
- 待提货:物流下单成功后的初始状态
- 运输中:获取到揽收数据后变更为此状态
- 已完成:获取到签收数据后变更为此状态
- 已取消:手动取消或强制作废后变更为此状态
- 下单失败:提交物流商下单,物流商返回失败时的状态,此时可以重新下单
2. 单据操作
-
打印箱唛:打印物流商返回的箱唛,并贴到每个箱子上

-
打印交接单:打印物流商返回的交接单,交接给物流商

- 注意:并非所有物流商都支持打印交接单,当物流商不支持打印交接单时会进行提示

-
取消下单:指向物流商取消下单,“待提货”、“运输中”状态的允许取消下单,实际取消结果以物流商返回的为准

-
强制作废:若取消下单失败,但是仍想将积加系统内的单据取消时使用,强制作废前请确保在物流商系统中的单据已取消成功

2. 物流下单详情
2.1 下单详情
显示下单时填写的“基础信息”、“发件人信息”、“收件人信息”、“报关/清关信息”、“产品信息”、“箱货信息”

2.2 履约详情
- 同时显示下单时的箱子数据和物流商揽收后返回的箱子数据,用于核实物流商的揽收情况
- 若尾程走的快递,则会显示物流商返回的子转单号
- 支持记录揽收信息确认状态(不与物流商交互,仅内部记录),若揽收数据有异议,请线下联系物流商处理
2.3 费用详情
1. 显示物流商返回的计费信息
- 费用金额(原币种):指物流商返回的币种及对应的金额
- 费用金额(本位币):指将原币种金额换算成系统中维护的本位币的金额。根据汇率设置中的汇率将原币金额转为对应本位币金额,汇率优先使用“我的汇率”,未维护则再取“官方汇率”
- 物流费用名称:指物流商返回的费用名称
- 系统费用项名称:指将物流商返回非费用名称映射成积加系统中定义的费用项名称,若未维护准确的映射关系,则默认系统费用项为 “头程杂费”,入账方式为 “计入成本并请款” ,分摊规则为 “按计费重(kg)”
1. 积加费用项名称维护路径:财务/基础设置/费用项管理/物流/头程物流费

2. 映射关系维护
-
路径:物流/基础配置/物流渠道/批量费用映射

-
需手动填写物流商的费用项名称,并选择对应的系统费用项

2.4 轨迹明细
- 显示物流商返回的轨迹信息

2.5 操作日志
- 显示用户操作日志
六、发货单相关操作说明
-
发货单同步装箱信息
-
当目的仓为 FBA 仓时,支持手动选择同步“FBA货件装箱明细”还是同步“调拨单/交货单装箱信息”
-
完成同步后,发货单的手动同步装箱状态将从“未同步”变更为“已同步”

-
头程物流下单成功后,发货单的“物流商”&“头程物流单号”字段会显示物流下单时的“头程物流商名称”&“物流商单号”

-
提货中状态的发货单作废、已出运状态的发货单已发作废时,请确保发货单关联的头程物流单已取消,否则会作废失败

-
发货单确认出运时,若关联的头程物流单存在物流商返回的物流费用,此时会自动填充数据并作为 “实际费用” ,在备注中会记录“系统拉取物流商”,您可以手动进行调整
1.若在确认出运时头程物流单不存在物流商返回的物流费用,确认出运后物流商才返回的物流费用,此时发货单录入实际费用时也会同步物流商返回的物流费用

七、常见问题
Q1:哪些头程物流商支持打印交接单?
A1:宇腾物流
Q2:发件人信息是否需要填写?
A1:系统支持填写,具体是否要填写请联系对应货代确认
Q3:哪些状态的发货单支持物流下单?
A3:仅“提货中”状态的发货单支持物流下单,请注意生成发货单时选择“通知提货”生成“提货中”状态的发货单,请勿直接确认出运
Q4:新智慧物流下单时,收件人信息/FBA仓代码选不到对应的数据
A4:原因是货代没有维护对应的地址库,请联系货代进行维护