使用Zonos与日本邮政My Page API

本指南适用于已经与日本邮政My Page Web API集成以创建标签（操作ctCode=52）的团队。对于现在需要关税预付的美国寄送包裹，您通过Zonos创建标签。Zonos是My Page工作流程的扩展：它代表您调用My Page Label API（ctCode=52），添加美国关税Declaration ID和DDP标记，然后将My Page标签和跟踪号返回给您。日本邮政仍然生成标签，并通过您的Later Pay Number向您收取邮资。

简而言之：您继续在My Page上构建，Zonos处理美国寄送的关税层。

如果您是第一次集成，请从创建单个寄送开始。

Zonos如何适应 

对于美国寄往的包裹，您将寄送发送到Zonos CreateDeclarationShipment GraphQL工作流程，而不是直接调用My Page。在该单个请求中，Zonos：

1. 使用您的Verified Account的Later Pay Numbers代表您调用日本邮政Label API（ctCode=52），以便邮资仍然被计入您的日本邮政账户。
2. 创建美国关税Declaration ID并将其链接到跟踪号。
3. 将DDP标记添加到标签。
4. 将日本邮政标签和跟踪号返回给您。

CreateDeclarationShipment链接七个步骤。您已经为ctCode=52请求组装的相同数据分布在它们中：

• 发件人/收件人 → partyCreateWorkflow中的ORIGIN和DESTINATION方。
• 物品 → itemCreateWorkflow（shipmentCartons内的行项目）。
• 包装和重量 → cartonsCreateWorkflow。
• 服务、处理和海关标志 → shipmentCreateWorkflow。

您的My Page字段如何映射到Zonos 

每个表格显示日本邮政My Page ctCode=52参数在Zonos工作流程中的位置。有关完整字段详情、类型和必需字段，请参见创建单个寄送。

服务和处理 → shipmentCreateWorkflow

发件人 → partyCreateWorkflow（ORIGIN方）

收件人 → partyCreateWorkflow（DESTINATION方）

收件人to_*参数映射到DESTINATION方的方式与发件人字段相同。

物品 → itemCreateWorkflow

要了解的转换 

这些是通常需要注意的转换：

• 服务级别取代sendType + transType。 选择单个Zonos japan_post.*服务级别，该级别与您今天作为两个单独参数发送的邮件服务和运输方式相匹配。
• 投保价值（declaredValue）必须为JPY，整数日元。 其他货币或分数日元将被拒绝。
• 重量以克为单位发送给日本邮政。 提供纸箱上的weight + weightUnit；Zonos进行转换。
• 物品海关描述限制为85个半角字符。
• 所有地址字段必须为英文（罗马）字符。

验证您的美国标签 

当您通过Zonos创建美国标签时，确认从端到端都有效：

1. 工作流程返回跟踪号和标签。 检查响应中的shipmentCreateWorkflow.trackingDetails.number和shipmentCartons[].label.url。
2. 创建了Declaration ID并链接。 只有当Declaration ID链接到跟踪号时，寄送才会关税预付 — Zonos在同一请求中进行此操作。
3. DDP打印在标签上。 打开返回的标签，确认DDP标记存在。
4. 寄送出现在您的Zonos Dashboard中，位于您的Verified Account下。
5. 对于批量分发， 确认合并关闭并返回日本邮政分发单（代码61）。请参见批量分发（合并）。
6. 与My Page标签进行比较。 以两种方式创建相同的寄送，并确认打印标签上的服务级别、重量、申报价值和物品详情相匹配。

相关 

• 创建单个寄送 — CreateDeclarationShipment工作流程的完整字段参考。
• 批量分发（合并） — 将一天的包裹捆绑到一个日本邮政分发单中。