头程物流下单

一、功能介绍

与头程物流商进行接口对接，实现与物流商交互，提高发货操作便利性。您可以进行以下操作：

1. 向物流商下单/取消下单
2. 打印箱唛/交接单
3. 查看物流商揽收数据
4. 查看物流商费用数据
5. 查看物流轨迹信息

二、权限开通

【系统】-【角色管理】-【功能权限】-【物流】-【头程发货管理】中开启头程物流相关的功能权限。

三、数据同步逻辑

1.物流商订单信息更新

1. 拉取频率： 一天2次，每天晚上0、白天14点更新
2. 拉取范围： 针对创建时间为近3个月，状态非“已取消”、“已完成”的头程物流单进行拉取

2.实际揽收信息更新

1. 拉取频率： 一天2次，每天晚上0、白天14点更新
2. 拉取范围： 针对创建时间为近3个月，状态为“待提货”的头程物流单进行拉取

3.费用信息更新

1. 拉取频率： 一天一次，每天晚上0点更新
2. 拉取范围： 针对创建时间为近3个月，状态为“运输中”、“已完成”的头程物流单进行拉取

4.物流轨迹信息更新

1. 拉取频率： 一天一次，每天晚上0点更新
2. 拉取范围： 针对创建时间为近3个月，状态为“待提货”、“运输中”、“已完成”的头程物流单进行拉取

四、头程物流下单操作

前置操作：在操作下单前请先完成头程物流商的授权

操作入口：物流/基础配置/物流商资料，操作手册：https://help.jijiaerp.com/docs/5ynYfiDh (根据使用的物流商找到对应的操作指引)

1. 物流下单入口

路径：物流/头程发货管理/发货单

1. 仅 “提货中” 状态且未物流下单过的发货单支持进行头程物流下单，其他状态的发货单不显示【物流下单】按钮

2. 进行头程物流下单前，请确保发货单的装箱信息已同步上游的FBA货件/来源单据的装箱数据，若未同步上游装箱数据，点击【物流下单】按钮时会进行提示
   

   1. 若您确定发货单的装箱信息准确且无需同步，此时点击【确认】可继续进行头程下单

2. 物流下单操作

1. 需要先选择头程物流商，根据选择的物流商显示不同的填写内容

2. 所有头程物流商需要填写的信息都分为6大板块，不同物流商，每个板块要填写的内容会有区别，带“*”的为必填字段

1. 基础信息：指一些基础信息
2. 发件人信息：指发货地址信息，可以提前在地址簿维护好地址模板，直接引用
3. 收件人信息：指收货地址信息
4. 报关/清关信息：指物流商要求填写的报关/清关信息，单据维度填写
5. 产品信息：指下单给物流商的商品的报关/清关信息，数据主要来自产品资料中维护的数据
6. 箱货信息：指下单给物流商的箱子信息，数据来自发货单装箱明细，请确保装箱明细准确

3. 按要求填写完相关信息后，点击【确认】按钮进行下单，下单成功后自动进入到【物流下单看板】

1. 头程物流单号：物流商返回的订单号，可用此单号前往物流商系统中查询数据
2. 单据状态： 物流下单成功后默认为“待提货”状态，后续根据物流商的数据自动更新

2.1 宇腾物流下单重点字段说明

1. 基础信息

1. 客户订单号： 必填项，发往平台仓时，系统自动以货件的数据填充，发往非平台仓，系统自动以发货单号填充 ，可自行修改
2. FBA货件号： 发往平台仓时，系统自动以货件的数据填充

2. 收件人信息

1. 地址类型： 必填项，调宇腾接口实时获取数据，请根据发货的目的地类型进行选择
2. 交货仓库： 必填项，指宇腾在国内的交货仓，调宇腾接口实时获取数据，请根据实际情况进行选择
3. 目的地： 必填项，调宇腾接口实时获取数据，请根据实际情况进行选择
4. 收货地址名称： 当目的仓类型为FBA时为必填项，选择目的地后自动将选择的值填充到“收货地址名称”
5. 详细地址信息： 可手动输入，也可以一键填充关联 FBA货件的目的地

3. 报关/清关信息

1. 报关方式： 必填项，调宇腾接口实时获取数据，请根据需求进行选择
2. 清关方式： 必填项，调宇腾接口实时获取数据，请根据需求进行选择
3. 产品大类： 必填项，调宇腾接口实时获取数据，请根据需求进行选择
4. 是否购买保险： 请根据需求进行选择
5. 保险金额： 当“是否购买保险”选择为“是”时才显示，且必填

4. 产品信息

不同目的国，不同物流渠道存在不同的填写要求，具体要求请咨询物流商

1. 中文报关名： 取自【产品资料-物流/报关-中文报关名】
2. 英文报关名： 取自【产品资料-物流/报关-英文报关名】
3. 报关编码： 取自【产品资料-物流/报关-报关信息-清关编码】
4. 申报单价： 取自【产品资料-物流/报关-报关信息-申报单价】
5. 材质：取自【产品资料-基础信息-材质】
6. 用途：取自【产品资料-基础信息-用途】
7. 型号：取自【产品资料-物流/报关-申报型号】
8. 品牌：取自【产品资料-基础信息-品牌】
9. 产品性质：调宇腾接口实时获取，请根据需求进行选择
10. 产品净重：取自【产品资料-采购信息-单品净重】
11. 销售价格发往FBA仓时，点击【一键获取】按钮，可自动从【商品管理-Amazon】中根据MSKU获取对应的销售价格
12. 销售链接：发往FBA仓时，点击【一键获取】按钮，可自动从【商品管理-Amazon】中根据MSKU获取对应的销售链接

2.2 新智慧物流下单重点字段说明

1. 基础信息

1. 客户订单号： 必填项，发往平台仓时，系统自动以货件的数据填充，发往非平台仓，系统自动以发货单号填充 ，可自行修改
2. ReferenceID： 发往平台仓时，系统自动以货件的数据填充

2. 收件人信息

1. FBA仓代码：若目的仓类型为FBA仓时必填，调新智慧接口实时获取数据，请根据发货的目的地类型进行选择
2. 详细地址信息：根据选择的 FBA 仓代码，调新智慧接口实时获取数据，可手动修改

3. 报关/清关信息

以下内容系统均为设为非必填项，不同货代要求不同，请根据实际发货情况填写

1. 交税方式
2. 交货条款
3. 报关方式
4. 清关方式
5. 申报币种
6. 物品属性
7. EORI号
8. IOSS号
9. VAT号
10. VAT公司名
11. VAT公司注册地址

4. 产品信息

不同目的国，不同物流渠道存在不同的填写要求，具体要求请咨询物流商

1. 中文报关名：取自【产品资料-物流/报关-中文报关名】
2. 英文报关名：取自【产品资料-物流/报关-英文报关名】
3. 报关编码：取自【产品资料-物流/报关-报关信息-清关编码】
4. 申报单价：取自【产品资料-物流/报关-报关信息-申报单价】
5. 材质：取自【产品资料-基础信息-材质】
6. 用途：取自【产品资料-基础信息-用途】
7. 型号：取自【产品资料-物流/报关-申报型号】
8. 品牌：取自【产品资料-基础信息-品牌】
9. 原产地：取自【产品资料-采购信息-原产地】
10. 特殊属性：取自【产品资料-物流报关-特殊属性】
11. 产品毛重(g)：取自【产品资料-采购信息-单品毛重】
12. 产品尺寸(cm)：取自【产品资料-采购信息-包装尺寸】
13. 销售价格：发往FBA仓时，点击【一键获取】按钮，可自动从【商品管理-Amazon】中根据MSKU获取对应的销售价格
14. 销售链接：发往FBA仓时，点击【一键获取】按钮，可自动从【商品管理-Amazon】中根据MSKU获取对应的销售链接

2.3 美通物流下单重点字段说明

1. 基础信息

1. 客户订单号： 必填项，发往平台仓时，系统自动以货件的数据填充，发往非平台仓，系统自动以发货单号填充 ，可自行修改

2. 发件人信息
无需填写

3. 收件人信息

1. 地址类型：必填项，请根据目的仓类型进行选择
2. 提货方式：必填项，请根据需求进行选择
3. FBA仓代码：若地址类型选择为 “1-FBA地址” 时必填，其他情况下无需填写，下拉单选，调美通接口实时获取数据
4. 海外仓名称：若地址类型选择为 “2-第三方海外仓” 时必填，其他情况下无需填写
5. 海外仓入库代码：若地址类型选择为 “2-第三方海外仓” 时支持填写，非必填，其他情况下无需填写
6. 详细地址信息：地址类型选择为 “1-FBA地址” 时为非必填项，无需填写；地址类型选择为 “2-第三方海外仓”&“3-私人地址” 时为必填项，请填写实际的目的地址

4. 报关/清关信息

1. 交税方式：必填项，请根据需求进行选择
2. 报关方式：必填项，请根据需求进行选择
3. 申报币种：必填项，请根据需求进行选择
4. 税号：必填项，请根据需求进行选择
5. 物品属性：必填项，请根据需求进行选择，支持下拉多选

5. 产品信息

不同目的国，不同物流渠道存在不同的填写要求，具体要求请咨询物流商

1. 中文报关名：取自【产品资料-物流/报关-中文报关名】
2. 英文报关名：取自【产品资料-物流/报关-英文报关名】
3. 报关编码：取自【产品资料-物流/报关-报关信息-清关编码】
4. 申报单价：取自【产品资料-物流/报关-报关信息-申报单价】
5. 材质：取自【产品资料-基础信息-材质】
6. 用途：取自【产品资料-基础信息-用途】
7. 型号：取自【产品资料-物流/报关-申报型号】
8. 品牌：取自【产品资料-基础信息-品牌】
9. 产品毛重(g)：取自【产品资料-采购信息-单品毛重】
10. 采购单价：取自【产品资料-采购信息-参考成本】
11. 销售价格：发往FBA仓时，点击【一键获取】按钮，可自动从【商品管理-Amazon】中根据MSKU获取对应的销售价格
12. 销售链接：发往FBA仓时，点击【一键获取】按钮，可自动从【商品管理-Amazon】中根据MSKU获取对应的销售链接

2.4 德速物流下单重点字段说明

1. 基础信息

1. 客户订单号： 必填项，发往平台仓时，系统自动以货件的数据填充，发往非平台仓，系统自动以发货单号填充 ，可自行修改
2. 渠道能力：若在物流渠道自定义参数中有维护初始值，此处会自动带出，可以手动进行修改
3. 特殊产品：若在物流渠道自定义参数中有维护初始值，此处会自动带出，可以手动进行修改
4. 渠道分区：请在选择好 “订单类型”、“是否FBA”、“起运地”、“目的国家”、“FBA仓库代码” 后再选择渠道分区

2. 发件人信息

1. 按界面提示填写

3. 收件人信息

1. 是否FBA：系统会自动根据目的仓类型进行判断
2. FBA仓代码：若是否FBA为 “是” 时必填，为 “否” 则无需填写，下拉单选，调德速接口实时获取数据
3. 省/州：若是否FBA为 “否” 时必填，下拉单选，调德速接口实时获取数据
4. 城市：若是否FBA为 “否” 时必填，下拉单选，调德速接口实时获取数据

4. 报关/清关信息

1. 是否报关：必填项，请根据需求进行选择
2. 是否PVA：必填项，请根据需求进行选择
3. 是否包税：必填项，请根据需求进行选择
4. 是否购买保险：必填项，请根据需求进行选择
   • 当勾选保险时，保险类型必填

5. 产品信息

不同目的国，不同物流渠道存在不同的填写要求，具体要求请咨询物流商

1. 中文报关名：取自【产品资料-物流/报关-中文报关名】
2. 英文报关名：取自【产品资料-物流/报关-英文报关名】
3. 报关编码：取自【产品资料-物流/报关-报关信息-清关编码】
4. 申报单价：取自【产品资料-物流/报关-报关信息-申报单价】
5. 材质：取自【产品资料-基础信息-材质】
6. 用途：取自【产品资料-基础信息-用途】
7. 型号：取自【产品资料-物流/报关-申报型号】
8. 品牌：取自【产品资料-基础信息-品牌】
9. 特殊属性：取自【产品资料-物流报关-特殊属性】
10. 单位：由德速定义的枚举值
11. 产品净重(g)：取自【产品资料-采购信息-单品净重】
12. 产品毛重(g)：取自【产品资料-采购信息-单品毛重】
13. 采购单价：取自【产品资料-采购信息-参考成本】
14. 销售链接：发往FBA仓时，点击【一键获取】按钮，可自动从【商品管理-Amazon】中根据MSKU获取对应的销售链接

2.5 云途头程物流下单重点字段说明

1. 基础信息

• 客户订单号： 必填项，发往平台仓时，系统自动以货件的数据填充，发往非平台仓，系统自动以发货单号填充 ，可自行修改

2. 发件人信息

• 云途无需发件地址信息，无需填写

3. 收件人信息

• 交货类型： 必填项，请根据需求选择上门揽收或自送
• 揽收地址： 当交货类型选择上门揽收时，揽收地址必填
• 揽收时间： 当交货类型选择上门揽收时，揽收时间必填
• 交货仓库： 当交货类型选择上自送时，交货仓库必填
• 交货时间： 当交货类型选择上自送时，交货时间必填
• 地址类型： 指目的地的类型，请根据需求选择亚马逊地址、私人地址、海外仓地址
• 海外仓类型： 当地址类型选择为海外仓地址时必填
• 仓库代码： 当地址类型选择为海外仓地址、亚马逊地址时必填
• 详细地址信息： 地址类型选择为 “FBA地址” 时为非必填项，无需填写；地址类型选择为 “海外仓地址”&“私人地址” 时请填写实际的目的地址

4. 报关/清关信息

• 申报币种： 必填项，请根据需求进行选择
• 货物类型： 非必填项，请根据需求进行选择
• 进口商公司名称： 非必填项，请根据需求进行选择
• 增值税号： 非必填项，请根据需求进行选择

5. 产品信息

不同目的国，不同物流渠道存在不同的填写要求，具体要求请咨询物流商

• 中文报关名： 取自【产品资料-物流/报关-中文报关名】
• 英文报关名： 取自【产品资料-物流/报关-英文报关名】
• 报关编码： 取自【产品资料-物流/报关-报关信息-清关编码】
• 申报单价： 取自【产品资料-物流/报关-报关信息-申报单价】
• 材质： 取自【产品资料-基础信息-材质】
• 用途： 取自【产品资料-基础信息-用途】
• 型号： 取自【产品资料-物流/报关-申报型号】
• 品牌： 取自【产品资料-基础信息-品牌】
• 产品毛重(g)： 取自【产品资料-采购信息-单品毛重】
• 数量单位： 需手动填写
• 销售链接： 发往FBA仓时，点击【一键获取】按钮，可自动从【商品管理-Amazon】中根据MSKU获取对应的销售链接

五、头程物流运输跟进

1. 在发货单界面，找到对应的发货单，点击 “头程物流单号” 或 “物流下单详情” 可直接跳转到该单的下单详情页，也可以通过点击 【物流下单看板】 进入到看板页，找到对应的头程物流单点击“头程物流单号”或【详情】按钮进入详情页查看
   
   

1. 物流下单看板

1. 单据状态

1. 待提货：物流下单成功后的初始状态
2. 运输中：获取到揽收数据后变更为此状态
3. 已完成：获取到签收数据后变更为此状态
4. 已取消：手动取消或强制作废后变更为此状态
5. 下单失败：提交物流商下单，物流商返回失败时的状态，此时可以重新下单

2. 单据操作

1. 打印箱唛：打印物流商返回的箱唛，并贴到每个箱子上
   

2. 打印交接单：打印物流商返回的交接单，交接给物流商
   

   1. 注意：并非所有物流商都支持打印交接单，当物流商不支持打印交接单时会进行提示
      

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

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

2. 物流下单详情

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

2.2 履约详情

1. 同时显示下单时的箱子数据和物流商揽收后返回的箱子数据，用于核实物流商的揽收情况
2. 若尾程走的快递，则会显示物流商返回的子转单号
3. 支持记录揽收信息确认状态（不与物流商交互，仅内部记录），若揽收数据有异议，请线下联系物流商处理

2.3 费用详情

1. 显示物流商返回的计费信息

1. 费用金额(原币种)：指物流商返回的币种及对应的金额
2. 费用金额(本位币)：指将原币种金额换算成系统中维护的本位币的金额。根据汇率设置中的汇率将原币金额转为对应本位币金额，汇率优先使用“我的汇率”，未维护则再取“官方汇率”
3. 物流费用名称：指物流商返回的费用名称
4. 系统费用项名称：指将物流商返回非费用名称映射成积加系统中定义的费用项名称，若未维护准确的映射关系，则默认系统费用项为 “头程杂费”，入账方式为 “计入成本并请款” ，分摊规则为 “按计费重(kg)”
   1. 积加费用项名称维护路径：财务/基础设置/费用项管理/物流/头程物流费
   
   2. 映射关系维护

   1. 路径：物流/基础配置/物流渠道/批量费用映射
      

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

2.4 轨迹明细

1. 显示物流商返回的轨迹信息
   

2.5 操作日志

1. 显示用户操作日志
   

六、发货单相关操作说明

1. 发货单同步装箱信息

2. 当目的仓为 FBA 仓时，支持手动选择同步“FBA货件装箱明细”还是同步“调拨单/交货单装箱信息”

3. 完成同步后，发货单的手动同步装箱状态将从“未同步”变更为“已同步”
   

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

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

6. 发货单确认出运时，支持自定义是否要自动同步物流商返回的头程费用，以及同步的费用作为预估费用还是同步为实际费用
   

七、常见问题

Q1：哪些头程物流商支持打印交接单？
A1：宇腾物流

Q2：发件人信息是否需要填写？
A1：系统支持填写，具体是否要填写请联系对应货代确认

Q3：哪些状态的发货单支持物流下单？
A3：仅“提货中”状态的发货单支持物流下单，请注意生成发货单时选择“通知提货”生成“提货中”状态的发货单，请勿直接确认出运

Q4：新智慧物流下单时，收件人信息/FBA仓代码选不到对应的数据
A4：原因是货代没有维护对应的地址库，请联系货代进行维护