Zonos + 日本邮政 API 模型如何运作
日本邮政已验证账户商人直接调用 Zonos。Zonos 使用其自己的日本邮政凭证，并在每个标签上包含您的后纳金额，以便邮资计入您的账户。
在单个 GraphQL 请求中，Zonos：
- 验证您的已验证账户和后纳金额。
- 代表您调用日本邮政标签 API（代码 52）以生成标签和跟踪号。
- 为美国关税预付创建报关单 ID。
- 通过
declarationShipmentCreate将报关单 ID 链接到跟踪号。 - 将标签、跟踪号和发货记录返回给您。
您无需自己的日本邮政 API 凭证（CTID / CT 密码）。您需要将日本邮政后纳金额（後納お客様番号）连接到您的 Zonos 已验证账户。
您使用的是哪种设置？
每个人都调用 Zonos 来创建标签和清单，所以您永远不会提供自己的日本邮政凭证（CTID / CT 密码）。根据设置改变的是您传递的 Zonos API 标头——找到下面您的行，然后在每个流程的端点和身份验证部分中使用匹配的选项卡。
| ↕ | 电子商务商人↕ | 运输平台 (BYOA)↕ | 3PL / 物流合作伙伴 / 经销商↕ |
|---|---|---|---|
| 您是谁 | 一个运送自己订单的品牌 | 许多商人通过其创建标签的平台 | 代表许多商人客户运送的合作伙伴 |
| 您设置的已验证账户 | 一个已验证账户（您自己的） | 每个商人设置他们自己的；您代表他们运送 | 一个用于所有发货人的已验证账户 |
| 要传递的 Zonos API 标头 | 仅 credentialToken（您的） | credentialToken（您的）+ accountKey（每个商人的） | 仅 credentialToken（您的） |
| 谁的后纳金额是计入邮资的 | 您的 | 每个商人的 | 您的 |
| Zonos 向谁开具关税发票 | 您 | 每个商人 | 您 |
BYOA（自带账户）： 每个商人拥有自己的日本邮政已验证账户，平台通过传递商人的账户密钥代表该商人创建标签，而不是在平台自己的账户下运送。
已经使用日本邮政 My Page API？
如果您当前使用日本邮政 My Page API（ctCode=52）创建标签，您可以保留该集成并添加 Zonos 用于预付关税的美国标签。请参阅将 Zonos 与 My Page API 配合使用以获取逐字段映射和验证清单。
通过 API 创建标签
将您的履行系统与 Zonos GraphQL API 集成以创建预付税的日本邮政标签。
本部分适用于构建将使用已验证账户的程序化日本邮政标签工作流的工程团队。如果您是一个没有开发资源的小型或中型发货人，请改为查看在仪表板中创建标签。