¶ 菜鸟法国快递：打单、面单、轨迹与大包封包
适用于已取得菜鸟法国快递接口参数、并已在易抵达中维护对应报价/发货渠道的场景。
¶ 功能范围
- 创建法国本地派送运单，并获取转单号与 PDF 面单。
- 按转单号单票或批量抓取轨迹，并在运单轨迹页查看结果。
- 创建菜鸟法国大包，将已打单的小包关联到大包。
¶ 操作前准备
- 向菜鸟获取接口地址、来源 CP 编号（资源 code）、菜鸟身份、Link Key、派送产品及业务类型。
- 准备已维护收/发货渠道、收寄件资料和申报信息的测试运单。
- 如使用自提产品 PFR009，先在运单「其他信息」填写菜鸟法国自提点 ID。
接口参数属于渠道敏感信息，请勿在截图、文档或群聊中展示完整密钥。
¶ 一、配置菜鸟法国快递转单 API
入口：菜单 → 报价管理 → 转单 API → 添加。创建完成后还需要把该 API 绑定到对应的成本价/发货渠道，否则运单无法调用菜鸟法国快递打单。
- 选择模板「菜鸟法国快递」，获取模式按业务需要选择；保存基本信息。
- 打开「参数设置」，维护菜鸟提供的域名、来源 CP 编号、菜鸟身份、Link Key、法国派送产品、业务类型、无法派送处理方式、面单格式和面单取值字段等。
- 如需封包，在同一「参数设置」继续向下填写大包参数：大包分拣码、提货联系人、手机号、国家、省/州、城市、区域、街道、详细地址、邮编、邮箱和港口等。大包分拣码
outSortcode、提货联系人、手机号、国家、城市、详细地址、邮编、邮箱为创建大包的必要资料；不可留空。
- 按页面提示维护寄/退件人资料，确认保存后，将该转单 API 绑定到用于打单的成本价/发货渠道。
¶ 二、打单并获取转单号、面单
入口：快递 → 运单列表。
- 查询并选中已经绑定菜鸟法国快递发货渠道、且资料完整的待打单运单；点击底部/工具栏的「获取转单号」，在确认窗口点击「确定」。
- 等待处理完成后，查看列表「转单号」列：应返回菜鸟法国运单号。
- 打开运单右侧「文件」页签，确认存在系统 Label 或「转单 Label.pdf」；可下载或打印该面单。
- 需要核查接口交互时，在运单的请求参数/报文入口查看「打单」报文，确认返回成功；不要导出或传播含密钥的完整报文。
成功判定：系统同时取得菜鸟法国运单号与面单内容/面单地址后，才判定打单成功；只返回订单信息而未返回运单号或面单时，会提示异常。
¶ 三、配置并抓取轨迹
¶ 1. 配置轨迹接口
入口：快递 → 运单列表 → 轨迹 → 添加轨迹/轨迹对接设置。
- 新建或选择「菜鸟法国快递」轨迹接口。
- 在参数页填写菜鸟提供的域名、来源 CP 编号、Link Key；轨迹语言可按业务要求设置，未填写时默认按
fr_FR查询。
- 在「轨迹对接设置」中选择承运商「菜鸟法国快递」，单号类型选择「转单号」，保存。
¶ 2. 单票或批量抓取
- 在运单列表选中一票或多票已获得转单号的运单。
- 点击「立即爬取轨迹」，确认执行；批量操作同样先多选运单后执行。
- 进入运单「轨迹」页签，核对节点时间、地点与描述。需要排查时打开轨迹抓取报文，核查请求和返回是否成功。
¶ 四、创建菜鸟法国大包并封包
入口：快递 → 包号页面。
- 在运单列表勾选已成功打单的小包，点击「生成批号/包号」，类型选择「包号」，填写或确认包号后点击「确定」。
- 进入快递 → 包号页面，按刚生成的包号查询；查询结果出现该包号及其小包明细后，选中该行，点击底部「封包」。
- 在「包号条码（单证模板处上传）」选择「代理面单 - 菜鸟法国快递」，按要求录入包号条码并确认。系统用打单成功后持久化的菜鸟 LP 物流订单号 关联小包；不可用客户单号或菜鸟运单号替代。
- 封包完成后，查看包号状态。大包语言未填写时系统默认使用
en_us；接口成功返回菜鸟大包单号后才会标记封包成功。需要排查时可在运单报文中查看封包请求及返回。
¶ 常见检查点
- 打单无转单号或面单：核对转单 API 是否已绑定到当前发货渠道；再检查接口参数和打单报文。
- PFR009 自提产品报错：确认已填写菜鸟法国自提点 ID。
- 无轨迹：核对轨迹接口单号类型为「转单号」，并确认菜鸟侧该转单号已有可查询轨迹；未配置轨迹语言时按
fr_FR查询。 - 大包封包失败：大包分拣码
outSortcode为必填项；同时检查提货联系人、地址等必填资料、小包是否已打单成功，以及是否已保存对应的 LP 物流订单号。
¶ 验收清单
- 打单成功，获得菜鸟法国转单号。
- 文件页存在并可下载/打印转单 Label。
- 打单报文返回成功。
- 单票和批量轨迹抓取成功，轨迹监控结果一致。
- 大包封包成功，且可查看封包报文。
¶ 相关文档
- 其他承运商 / 代理接口：同类承运商与代理接口文档入口。
- 绑定转单号自动获取接口：需要通过规则自动获取转单号时参考。
- 配置轨迹抓取：通用轨迹抓取配置与排查说明。