Integre o seu sistema de fulfillment com a GraphQL API da Zonos para criar etiquetas Japan Post com direitos aduaneiros pré-pagos.
Esta secção destina-se a equipas de engenharia que estão a construir um fluxo programático de etiquetas Japan Post que utilizará Verified Accounts. Se for um expedidor de pequena ou média dimensão sem recursos de desenvolvimento, consulte antes Criar etiquetas no Dashboard.
Os comerciantes com Japan Post Verified Account chamam a Zonos diretamente. A Zonos utiliza as suas próprias credenciais junto da Japan Post e inclui o seu Later Pay Number em todas as etiquetas, para que os portes sejam faturados à sua conta.
Num único pedido GraphQL, a Zonos:
Valida a sua Verified Account e os seus Later Pay Numbers.
Chama a Japan Post Label API (código 52) em seu nome para gerar a etiqueta e o número de seguimento.
Cria um Declaration ID para o pré-pagamento dos direitos aduaneiros.
Associa o Declaration ID ao número de seguimento através de declarationShipmentCreate.
Devolve-lhe a etiqueta, o número de seguimento e o registo do envio.
Não precisa das suas próprias credenciais da Japan Post API (CTID / palavra-passe CT). Precisa, no entanto, dos seus Japan Post Later Pay Numbers (後納お客様番号) associados à sua Zonos Verified Account.
Todos chamam a Zonos para criar tanto a etiqueta como o manifesto, pelo que nunca fornece as suas próprias credenciais da Japan Post (CTID / palavra-passe CT). O que muda consoante a configuração são os headers da API da Zonos que envia — encontre a sua linha abaixo e utilize o separador correspondente na secção Endpoint e autenticação de cada fluxo.
↕
Comerciante de e-commerce↕
Plataforma de envio (BYOA)↕
3PL / parceiro logístico / revendedor↕
Quem é
Uma marca que envia as suas próprias encomendas
Uma plataforma através da qual muitos comerciantes criam etiquetas
Um parceiro que envia em nome de vários clientes comerciantes
Verified Account que configura
Uma Verified Account (a sua)
Cada comerciante configura a sua; o utilizador envia em nome dele
Uma Verified Account utilizada para todos os seus expedidores
Headers da API da Zonos a enviar
Apenas credentialToken (o seu)
credentialToken (o seu) + accountKey (de cada comerciante)
Apenas credentialToken (o seu)
Later Pay Number a que são faturados os portes
O seu
O de cada comerciante
O seu
A quem a Zonos fatura os direitos aduaneiros
A si
A cada comerciante
A si
BYOA (Bring Your Own Account): cada comerciante detém a sua própria Japan Post Verified Account, e a plataforma cria etiquetas em nome desse comerciante enviando a account key do comerciante, em vez de expedir com a conta da própria plataforma.
Existem dois padrões de integração, consoante a forma como expede as encomendas.
Criar um envio único
A cadeia fundamental. Um único pedido GraphQL leva um envio desde os dados de partida (partes, artigos, embalagem) até uma etiqueta Japan Post pronta a imprimir. Utilize esta opção se expede as encomendas individualmente, à medida que os pedidos chegam.
O fluxo em lote com pagamento diferido. Abra uma consolidação de manhã, associe-lhe envios ao longo do dia através da cadeia de envio único e feche a consolidação no final do dia para obter uma única guia de expedição da Japan Post que abrange todo o lote. Utilize esta opção se liquida os portes da Japan Post numa única transação no final do dia, em vez de encomenda a encomenda.
Se atualmente cria etiquetas com a Japan Post My Page API (ctCode=52), pode manter essa integração e acrescentar a Zonos para etiquetas com destino aos EUA e direitos aduaneiros pré-pagos. Consulte Utilizar a Zonos com a My Page API para um mapeamento campo a campo e uma lista de verificação.
Criar etiquetas através da API
Criar etiquetas através da API
Integre o seu sistema de fulfillment com a GraphQL API da Zonos para criar etiquetas Japan Post com direitos aduaneiros pré-pagos.
Esta secção destina-se a equipas de engenharia que estão a construir um fluxo programático de etiquetas Japan Post que utilizará Verified Accounts. Se for um expedidor de pequena ou média dimensão sem recursos de desenvolvimento, consulte antes Criar etiquetas no Dashboard.
Como funciona o modelo de API Zonos + Japan Post
Os comerciantes com Japan Post Verified Account chamam a Zonos diretamente. A Zonos utiliza as suas próprias credenciais junto da Japan Post e inclui o seu Later Pay Number em todas as etiquetas, para que os portes sejam faturados à sua conta.
Num único pedido GraphQL, a Zonos:
declarationShipmentCreate.Não precisa das suas próprias credenciais da Japan Post API (CTID / palavra-passe CT). Precisa, no entanto, dos seus Japan Post Later Pay Numbers (後納お客様番号) associados à sua Zonos Verified Account.
Qual é a sua configuração?
Todos chamam a Zonos para criar tanto a etiqueta como o manifesto, pelo que nunca fornece as suas próprias credenciais da Japan Post (CTID / palavra-passe CT). O que muda consoante a configuração são os headers da API da Zonos que envia — encontre a sua linha abaixo e utilize o separador correspondente na secção Endpoint e autenticação de cada fluxo.
credentialToken(o seu)credentialToken(o seu) +accountKey(de cada comerciante)credentialToken(o seu)BYOA (Bring Your Own Account): cada comerciante detém a sua própria Japan Post Verified Account, e a plataforma cria etiquetas em nome desse comerciante enviando a account key do comerciante, em vez de expedir com a conta da própria plataforma.
Dois fluxos de API
Existem dois padrões de integração, consoante a forma como expede as encomendas.
Criar um envio único
A cadeia fundamental. Um único pedido GraphQL leva um envio desde os dados de partida (partes, artigos, embalagem) até uma etiqueta Japan Post pronta a imprimir. Utilize esta opção se expede as encomendas individualmente, à medida que os pedidos chegam.
Criar um envio único →
Expedição em lote (consolidação)
O fluxo em lote com pagamento diferido. Abra uma consolidação de manhã, associe-lhe envios ao longo do dia através da cadeia de envio único e feche a consolidação no final do dia para obter uma única guia de expedição da Japan Post que abrange todo o lote. Utilize esta opção se liquida os portes da Japan Post numa única transação no final do dia, em vez de encomenda a encomenda.
Expedição em lote (consolidação) →
Já utiliza a Japan Post My Page API?
Se atualmente cria etiquetas com a Japan Post My Page API (
ctCode=52), pode manter essa integração e acrescentar a Zonos para etiquetas com destino aos EUA e direitos aduaneiros pré-pagos. Consulte Utilizar a Zonos com a My Page API para um mapeamento campo a campo e uma lista de verificação.Esta página foi útil?