# 黑猫（ヤマト）号码段业务全流程：从转单号、转单面单到 EDI 文件导入官网
> 本文面向使用日本黑猫（ヤマト）专线的客户与客服，介绍完整业务闭环：**配置号码段转单 API → 生成转单号与转单面单 → 用 AI 助手小易生成黑猫 EDI（SUYOTEI2.CSV）文件 → 导入黑猫官网**。全程在易抵达系统内完成，无需手工加工文件。
## 一、先分清：黑猫的两种打单方式
在易抵达对接黑猫（ヤマト），**获取运单号 + 出面单**有两种完全不同的方式，配置和使用都不一样，请先确认您属于哪一种，切勿混用：
**方式 A：官网直连打单（黑猫转单 API）**
每票单**实时调用黑猫官网接口**获取运单号（送り状番号）与面单。打单成功时，这票单的信息**已经同步在黑猫官网**，无需再另行回传。配置方法见：[创建日本黑猫打单接口](/zh/api/yamato)。
**方式 B：号码段 + EDI 批量导入官网（本文）**
黑猫**预先把一批运单号码（号码段）交给物流商**，物流商**不逐票联网**，而是在易抵达本地导入号码段、顺序领用运单号、由易抵达（Jasper 模板）打印**转单面单**、贴单发货；发货后再把这批运单信息导出为黑猫 **EDI 文件（SUYOTEI2.CSV，出荷予定データ）**，**批量导入黑猫官网**完成出货预告。
两者关键差异：
| 对比项 | 方式 A：官网直连打单 | 方式 B：号码段 + EDI 导入（本文） |
|---|---|---|
| **运单号来源** | 每票实时调黑猫官网接口获取 | 黑猫预先分配的号码段，本地顺序领用，不逐票联网 |
| **面单来源** | 由黑猫官网接口返回 | 由易抵达用 Jasper 模板本地打印转单面单 |
| **出货信息如何到官网** | 打单时官网已同步，无需回传 | 发货后导出 EDI 文件（SUYOTEI2.CSV）**批量导入官网** |
| **适用场景** | 黑猫开放官网打单接口给您 | 黑猫只给一批号码、要求以出荷予定データ批量回传 |
| **配置文档** | [创建日本黑猫打单接口](/zh/api/yamato) | 本文 |
> 一句话记忆：**方式 A 是"边打单边上传官网"，方式 B 是"先用黑猫给的号码本地打单、发完货再把信息批量导回官网"。** 本文只讲方式 B（号码段）。
---
## 二、配置号码段方式（获取转单号与转单面单）
> 本节讲的是**方式 B（号码段）**的配置，与「[创建日本黑猫打单接口](/zh/api/yamato)」（方式 A 官网直连打单）是**两套完全不同**的东西，操作入口和参数都不一样，请勿参照方式 A 的文档来配号码段。
整个配置分三步：**① 把黑猫给的号码段导入系统 → ② 建一个"对接模板 = 号码段"的转单 API 并挂上转单面单模板 → ③ 把这个转单 API 绑到对应的发货渠道（报价）**。配置一次后即可长期使用。
### 2.1 导入号码段
在系统顶部菜单进入 **基础数据 → 号码段**，打开号码段列表页。页面底部有两种录入方式：
**方式一：导入号码段（推荐，适合黑猫一次给一批号码）**
点击底部 **「导入」**，在弹窗中填写：
- **代理**：选择承运商档案（黑猫 / ヤマト）；
- **发货渠道名称**：勾选这批号码要用于哪个（哪些）发货渠道，可多选；
- **号码类型**：从下拉中选择对应的号码类型；
- **上传文件**：上传黑猫提供的号码清单 Excel（`.xls / .xlsx`，**一行一个单号**）。上传后弹窗底部会实时显示识别到的「数量」。
核对数量无误后点击确认，这批号码即导入系统备用。
**方式二：手动录入（适合号码是连续区间时）**
点击底部 **「手动录入」**，填写代理、发货渠道名称、号码类型后，再填：
- **开始号码 / 结束号码**：号码段的起止（5–50 位数字或字母）；
- **分配规则**：默认「顺序」（按号码从小到大依次领用），DHL 类特殊场景可选「DHL 规则」。
系统会自动把区间展开成一个个可领用的号码，底部同样实时显示「数量」。
> 导入后的号码段可在列表里「启用 / 禁用」。只有已启用的号码段才会被出仓取号时领用。
### 2.2 新建"号码段"转单 API 并挂上转单面单模板
进入 **报价管理 → 转单 API**，点击「添加」新建一个转单 API 模板：
1. 在 **「基本」** 页填写 **模板名称**（自定义，如"黑猫号码段"）；
2. 把 **「模板」（对接模板）** 下拉选为 **「号码段」**；
3. 选为号码段后，会多出一个 **「参数设置」** 页，在其中的 **「label 模版」** 里勾选要套打的**转单面单（标签）模板**——这就是决定转单面单长什么样的 Jasper 模板（面单模板需事先由易抵达配置好，客服可协助）。
保存即得到一个"号码段"类型的转单 API。
### 2.3 把转单 API 绑定到发货渠道
进入对应发货渠道的 **报价 → 转单 API 设置**，在 **「转单 API 模板」** 里选择上一步建好的那个模板，保存。至此，凡走这个发货渠道的运单，出仓时就会自动从号码段领用转单号并套打转单面单。
### 2.4 生成转单号与转单面单
配置完成后，日常有两个入口取号、出面单：
- **下单页直接取号**：在打单 / 录单页勾选 **「获取转单号」**，并按需勾选 **「打印 LB」**（打印转单标签 / 面单）、**「打印转单发票」**，下单时即完成取号与打印；
- **出仓时批量取号**：在集货 / 出仓操作页，扫描或勾选运单后点击 **「获取转单号」** 按钮批量领号，点击 **「打印」** 批量套打转单面单；号码领错时可用 **「清除转单号」** 退回。
系统会从已启用的号码段里按分配规则领用一个号码作为该运单的**转单号（送り状番号 / お問合せ伝票番号）**，并用 2.2 里选定的模板渲染出**转单面单 PDF**，存入运单档案随时可重打。
### 2.5 转单面单效果
转单面单由 Jasper 模板渲染为 PDF，可直接打印贴单。实际效果如下（示例已打码隐去敏感信息）：
> 面单上的**分拣码（仕分けコード）**由系统按收件人邮编自动匹配，无需手工填写，详见：[日本专线邮编绑定运单分拣码](/zh/fetch-no/fenjianma)。
### 2.6 转单面单模板下载（新机构配置的起点）
为新机构配置号码段面单时，可直接下载这份**标准示例 Jasper 模板**作为起点，在 2.2 的「参数设置 → label 模版」中上传使用，再按下表把示例的**寄件人**信息替换为贵司信息即可：
**⬇ [下载：黑猫号码段转单面单模板（示例）.jrxml](/api-yamato-number-range/黑猫号码段转单面单模板_示例.jrxml)**
模板里**收件人信息、转单号、条码、分拣码、发货日期/时间段**等都是**自动取运单数据**（不用改）。只有**寄件人（ご依頼主／送り主）**这一块在模板里是写死的示例值，需要改成贵司在日本的发货主体信息：
| 模板中的示例值 | 含义 | 请改为 |
|---|---|---|
| `サンプル株式会社` | 寄件人公司名（ご依頼主） | 贵司在日本的发货公司名 |
| `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/](https://bmypage.kuronekoyamato.co.jp/)），在**出荷予定データ导入**功能中上传该文件即可。至此，"导入号码段 → 本地领用转单号 → 打印转单面单 → 发货 → 生成 EDI 文件 → 批量导入官网"的完整业务闭环结束。
> 建议导入前用黑猫官方的 YoteiCheck 校验工具做一次预检（小易生成时已按同一套 2.40 规格校验，正常情况下可直接导入）。
---
## 相关文档
- [日本专线快速启动](/zh/quick-start/japan-line)
- [创建日本黑猫打单接口](/zh/api/yamato) —— **另一种方式（方式 A：官网直连打单）**，与本文号码段方式不同，仅供区分参考
- [日本专线邮编绑定运单分拣码](/zh/fetch-no/fenjianma)
- [批量导入转单号](/zh/operation/batch-import-transfer-number)
- [日本专线自定义转单 label](/zh/export-template/japan-express)