将您的履行系统与 Zonos GraphQL API 集成以创建预付税的日本邮政标签。
本部分适用于构建将使用已验证账户的程序化日本邮政标签工作流的工程团队。如果您是一个没有开发资源的小型或中型发货人,请改为查看在仪表板中创建标签。
日本邮政已验证账户商家直接调用 Zonos。Zonos 使用其自己的日本邮政凭证,并在每个标签上包含您的 Later Pay Number,以便邮资计入您的账户。
在单个 GraphQL 请求中,Zonos:
declarationShipmentCreate
您无需自己的日本邮政 API 凭证(CTID / CT 密码)。您需要将日本邮政 Later Pay Numbers(後納お客様番号)连接到您的 Zonos 已验证账户。
每个人都调用 Zonos 来创建标签和清单,所以您永远不会提供自己的日本邮政凭证(CTID / CT 密码)。根据设置改变的是您传递的 Zonos API 标头——找到下面您的行,然后在每个流程的端点和身份验证部分中使用匹配的选项卡。
credentialToken
accountKey
BYOA(自带账户): 每个商家拥有自己的日本邮政已验证账户,平台通过传递商家的账户密钥代表该商家创建标签,而不是在平台自己的账户下运送。
根据您如何派遣包裹,有两种集成模式。
基础链。一个 GraphQL 请求将一个发货从原始输入(参与方、物品、包装)一直带到可打印的日本邮政标签。如果您在订单到达时单独运送包裹,请使用此方法。
创建单个发货 →
延迟付款批处理流程。在上午打开合并,在整个一天使用单个发货链将发货附加到其中,然后在一天结束时关闭合并以获得覆盖整个批次的一个日本邮政派遣单。如果您在一天结束时在一次交易中结算日本邮政邮资而不是逐包裹,请使用此方法。
批量派遣(合并)→
如果您当前使用日本邮政 My Page API(ctCode=52)创建标签,您可以保留该集成并添加 Zonos 用于预付关税的美国标签。请参阅将 Zonos 与 My Page API 配合使用以获取逐字段映射和验证清单。
ctCode=52
通过 API 创建标签
通过 API 创建标签
将您的履行系统与 Zonos GraphQL API 集成以创建预付税的日本邮政标签。
本部分适用于构建将使用已验证账户的程序化日本邮政标签工作流的工程团队。如果您是一个没有开发资源的小型或中型发货人,请改为查看在仪表板中创建标签。
Zonos + 日本邮政 API 模型如何运作
日本邮政已验证账户商家直接调用 Zonos。Zonos 使用其自己的日本邮政凭证,并在每个标签上包含您的 Later Pay Number,以便邮资计入您的账户。
在单个 GraphQL 请求中,Zonos:
declarationShipmentCreate将报关单 ID 链接到跟踪号。您无需自己的日本邮政 API 凭证(CTID / CT 密码)。您需要将日本邮政 Later Pay Numbers(後納お客様番号)连接到您的 Zonos 已验证账户。
您使用的是哪种设置?
每个人都调用 Zonos 来创建标签和清单,所以您永远不会提供自己的日本邮政凭证(CTID / CT 密码)。根据设置改变的是您传递的 Zonos API 标头——找到下面您的行,然后在每个流程的端点和身份验证部分中使用匹配的选项卡。
credentialToken(您的)credentialToken(您的)+accountKey(每个商家的)credentialToken(您的)BYOA(自带账户): 每个商家拥有自己的日本邮政已验证账户,平台通过传递商家的账户密钥代表该商家创建标签,而不是在平台自己的账户下运送。
两个 API 流程
根据您如何派遣包裹,有两种集成模式。
创建单个发货
基础链。一个 GraphQL 请求将一个发货从原始输入(参与方、物品、包装)一直带到可打印的日本邮政标签。如果您在订单到达时单独运送包裹,请使用此方法。
创建单个发货 →
批量派遣(合并)
延迟付款批处理流程。在上午打开合并,在整个一天使用单个发货链将发货附加到其中,然后在一天结束时关闭合并以获得覆盖整个批次的一个日本邮政派遣单。如果您在一天结束时在一次交易中结算日本邮政邮资而不是逐包裹,请使用此方法。
批量派遣(合并)→
已经使用日本邮政 My Page API?
如果您当前使用日本邮政 My Page API(
ctCode=52)创建标签,您可以保留该集成并添加 Zonos 用于预付关税的美国标签。请参阅将 Zonos 与 My Page API 配合使用以获取逐字段映射和验证清单。这个页面有帮助吗?