本文面向使用日本黑猫（ヤマト）专线的客户与客服，介绍完整业务闭环：配置号码段转单 API → 生成转单号与转单面单 → 用 AI 助手小易生成黑猫 EDI（SUYOTEI2.CSV）文件 → 导入黑猫官网。全程在易抵达系统内完成，无需手工加工文件。
¶ 一、先分清：黑猫的两种打单方式
在易抵达对接黑猫（ヤマト），获取运单号 + 出面单有两种完全不同的方式，配置和使用都不一样，请先确认您属于哪一种，切勿混用：
方式 A：官网直连打单（黑猫转单 API）
每票单实时调用黑猫官网接口获取运单号（送り状番号）与面单。打单成功时，这票单的信息已经同步在黑猫官网，无需再另行回传。配置方法见：创建日本黑猫打单接口。
方式 B：号码段 + EDI 批量导入官网（本文）
黑猫预先把一批运单号码（号码段）交给物流商，物流商不逐票联网，而是在易抵达本地导入号码段、顺序领用运单号、由易抵达（Jasper 模板）打印转单面单、贴单发货；发货后再把这批运单信息导出为黑猫 EDI 文件（SUYOTEI2.CSV，出荷予定データ），批量导入黑猫官网完成出货预告。
两者关键差异：
| 对比项 | 方式 A：官网直连打单 | 方式 B：号码段 + EDI 导入（本文） |
|---|---|---|
| 运单号来源 | 每票实时调黑猫官网接口获取 | 黑猫预先分配的号码段，本地顺序领用，不逐票联网 |
| 面单来源 | 由黑猫官网接口返回 | 由易抵达用 Jasper 模板本地打印转单面单 |
| 出货信息如何到官网 | 打单时官网已同步，无需回传 | 发货后导出 EDI 文件（SUYOTEI2.CSV）批量导入官网 |
| 适用场景 | 黑猫开放官网打单接口给您 | 黑猫只给一批号码、要求以出荷予定データ批量回传 |
| 配置文档 | 创建日本黑猫打单接口 | 本文 |
一句话记忆：方式 A 是"边打单边上传官网"，方式 B 是"先用黑猫给的号码本地打单、发完货再把信息批量导回官网"。 本文只讲方式 B（号码段）。
¶ 二、配置号码段方式（获取转单号与转单面单）
本节讲的是方式 B（号码段）的配置，与「创建日本黑猫打单接口」（方式 A 官网直连打单）是两套完全不同的东西，操作入口和参数都不一样，请勿参照方式 A 的文档来配号码段。
整个配置分三步：① 把黑猫给的号码段导入系统 → ② 建一个"对接模板 = 号码段"的转单 API 并挂上转单面单模板 → ③ 把这个转单 API 绑到对应的发货渠道（报价）。配置一次后即可长期使用。
¶ 2.1 导入号码段
在系统顶部菜单进入 基础数据 → 号码段，打开号码段列表页。页面底部有两种录入方式：
方式一：导入号码段（推荐，适合黑猫一次给一批号码）
点击底部 「导入」，在弹窗中填写：
- 代理：选择承运商档案（黑猫 / ヤマト）；
- 发货渠道名称：勾选这批号码要用于哪个（哪些）发货渠道，可多选；
- 号码类型：从下拉中选择对应的号码类型；
- 上传文件：上传黑猫提供的号码清单 Excel（
.xls / .xlsx，一行一个单号）。上传后弹窗底部会实时显示识别到的「数量」。
核对数量无误后点击确认，这批号码即导入系统备用。
方式二：手动录入（适合号码是连续区间时）
点击底部 「手动录入」，填写代理、发货渠道名称、号码类型后，再填：
- 开始号码 / 结束号码：号码段的起止（5–50 位数字或字母）；
- 分配规则：默认「顺序」（按号码从小到大依次领用），DHL 类特殊场景可选「DHL 规则」。
系统会自动把区间展开成一个个可领用的号码，底部同样实时显示「数量」。
导入后的号码段可在列表里「启用 / 禁用」。只有已启用的号码段才会被出仓取号时领用。
¶ 2.2 新建"号码段"转单 API 并挂上转单面单模板
进入 报价管理 → 转单 API，点击「添加」新建一个转单 API 模板：
- 在 「基本」 页填写 模板名称（自定义，如"黑猫号码段"）；
- 把 「模板」（对接模板） 下拉选为 「号码段」；
- 选为号码段后，会多出一个 「参数设置」 页，在其中的 「label 模版」 里勾选要套打的转单面单（标签）模板——这就是决定转单面单长什么样的 Jasper 模板（面单模板需事先由易抵达配置好，客服可协助）。
保存即得到一个"号码段"类型的转单 API。
¶ 2.3 把转单 API 绑定到发货渠道
进入对应发货渠道的 报价 → 转单 API 设置，在 「转单 API 模板」 里选择上一步建好的那个模板，保存。至此，凡走这个发货渠道的运单，出仓时就会自动从号码段领用转单号并套打转单面单。
¶ 2.4 生成转单号与转单面单
配置完成后，日常有两个入口取号、出面单：
- 下单页直接取号：在打单 / 录单页勾选 「获取转单号」，并按需勾选 「打印 LB」（打印转单标签 / 面单）、「打印转单发票」，下单时即完成取号与打印；
- 出仓时批量取号：在集货 / 出仓操作页，扫描或勾选运单后点击 「获取转单号」 按钮批量领号，点击 「打印」 批量套打转单面单；号码领错时可用 「清除转单号」 退回。
系统会从已启用的号码段里按分配规则领用一个号码作为该运单的转单号（送り状番号 / お問合せ伝票番号），并用 2.2 里选定的模板渲染出转单面单 PDF，存入运单档案随时可重打。
¶ 2.5 转单面单效果
转单面单由 Jasper 模板渲染为 PDF，可直接打印贴单。实际效果如下（示例已打码隐去敏感信息）：
面单上的**分拣码（仕分けコード）**由系统按收件人邮编自动匹配，无需手工填写，详见：日本专线邮编绑定运单分拣码。
¶ 2.6 转单面单模板下载（新机构配置的起点）
为新机构配置号码段面单时，可直接下载这份标准示例 Jasper 模板作为起点，在 2.2 的「参数设置 → label 模版」中上传使用，再按下表把示例的寄件人信息替换为贵司信息即可：
模板里收件人信息、转单号、条码、分拣码、发货日期/时间段等都是自动取运单数据（不用改）。只有**寄件人（ご依頼主／送り主）**这一块在模板里是写死的示例值，需要改成贵司在日本的发货主体信息：
| 模板中的示例值 | 含义 | 请改为 |
|---|---|---|
サンプル株式会社 |
寄件人公司名（ご依頼主） | 贵司在日本的发货公司名 |
000-0000 |
寄件人邮编（〒） | 贵司邮编 |
〇〇県〇〇市〇〇町1丁目1番1号 |
寄件人地址 | 贵司地址 |
000-0000-0000 |
寄件人电话（TEL） | 贵司联系电话 |
⚠️ 以上每个示例值在模板中都出现两处（上半「配達票」+ 下半「貼付票」），替换时两处都要改。修改可用 Jaspersoft Studio 打开编辑，或直接联系易抵达客服协助配置。
¶ 三、用小易生成黑猫 EDI 文件（SUYOTEI2.CSV）
贴单发货完成后，需要把这批运单的信息导出为黑猫 EDI 格式 CSV，导入黑猫官网做出货预告。这一步只需对易抵达的 AI 助手"小易"说一句话即可完成，无需手工导出、无需自己排版字段。
¶ 3.1 打开小易，发送生成指令
在系统右下角打开小易，直接把要生成的运单转单号发给它，例如：
帮我生成黑猫CSV文件
665270179081
665270178786
665270179055
……（一行一个，最多 1000 个）
也可以更简短：黑猫CSV 665270179081。
¶ 3.2 首次使用：补充黑猫月结账号与默认发货人
第一次使用时，小易会弹出一张**「黑猫出货资料补充」表单**，需要您填写两类资料（只需填一次，小易会按您的账号记住）：
① 黑猫月结账号信息
- 運賃請求先コード（黑猫月结客户代码）：黑猫签约（掛売）时分配的运费结算账号，必填，最长 12 位数字；
- 運賃請求先コード枝番（枝番/分账号）：同一账号下区分门店/部门用，没有可不填；填则恰好 3 位数字。
② 默认发货人（当运单本身没有发货人信息时使用）
- 荷送人電話番号（发货人电话）、荷送人名（发货人名称）、荷送人住所1/2（都道府県、市区町村）为必填，住所 3/4 选填。
为什么要填默认发货人？ 号码段业务的黑猫单，发货人通常是同一个固定主体（您在日本的发货公司）。运单里一般不单独存发货人，所以由您在这里提供一次，系统记住后自动套用到所有缺发货人的单。
填好后点提交即可。
¶ 3.3 生成结果：CSV 文件直接发到会话
提交资料后，小易立即生成文件并发到当前会话，点击即可下载。同时会用掩码回显您填的月结账号和发货人电话，方便核对位数与首尾数字是否正确：
¶ 3.4 再次使用：无需再填，直接出文件
因为资料已被记住，之后再生成（哪怕是一批几十个单号），小易会直接输出 CSV 文件，不再弹表单：
若某次要更换月结账号或默认发货人，直接把新的资料以消息发给小易即可更新；系统会覆盖记住新的值。
¶ 3.5 小易会自动做的校验
小易生成的 SUYOTEI2.CSV 严格按黑猫「出荷予定データ」2.40 版规格产出，会自动完成：
- 逐单校验：任一必填缺失或格式不符的单号会被跳过，并在回复里逐条说明原因（如"第 21 列 仕分けコード 缺失，请在系统中补全"），不影响其他单正常生成；
- 日文编码（CP932）：含表情/生僻字会提示修正；
- 黑猫禁用字符（逗号、引号等）自动按规范替换为空格并提醒；
- 单文件上限 1000 条；
- 集荷希望日取生成当天的日本时区日期。
¶ 四、把 EDI 文件批量导入黑猫官网（回传出货信息，不是打单）
⚠️ 重要：这一步不是在官网打单，也不会生成任何运单号或面单。 号码段方式下，运单号来自黑猫预先分配的号码段、转单面单由易抵达本地打印——这两件事在发货前就已经完成了。这里导入 SUYOTEI2.CSV，只是把已经发货的这批运单信息，以黑猫要求的「出荷予定データ」格式批量回传/预告给官网，让官网知道这些号码对应的收发件信息。官网不会据此再生成号码或面单。
这正是与"官网直连打单"（方式 A）最大的区别：方式 A 打单时官网已实时同步；方式 B 是发完货后用这一个 CSV 文件把信息一次性补报给官网。
具体操作：下载 SUYOTEI2.CSV 后，登录黑猫官网（https://bmypage.kuronekoyamato.co.jp/），在出荷予定データ导入功能中上传该文件即可。至此，"导入号码段 → 本地领用转单号 → 打印转单面单 → 发货 → 生成 EDI 文件 → 批量导入官网"的完整业务闭环结束。
建议导入前用黑猫官方的 YoteiCheck 校验工具做一次预检（小易生成时已按同一套 2.40 规格校验，正常情况下可直接导入）。
¶ 相关文档
- 日本专线快速启动
- 创建日本黑猫打单接口 —— 另一种方式（方式 A：官网直连打单），与本文号码段方式不同，仅供区分参考
- 日本专线邮编绑定运单分拣码
- 批量导入转单号
- 日本专线自定义转单 label