Já cria etiquetas com a Japan Post My Page API? Mantenha a sua integração e adicione a Zonos para etiquetas para os EUA com direitos aduaneiros pré-pagos.
Este guia destina-se a equipas que já estão integradas com a Japan Post My Page Web API para criar etiquetas (operação ctCode=52). Para encomendas com destino aos EUA, que agora exigem o pré-pagamento dos direitos aduaneiros, a etiqueta é criada através da Zonos. A Zonos é uma extensão do fluxo de trabalho da My Page: chama a My Page Label API (ctCode=52) em seu nome, adiciona o Declaration ID de direitos aduaneiros dos EUA e a marcação DDP, e devolve-lhe a etiqueta da My Page e o número de seguimento. A Japan Post continua a produzir a etiqueta e a faturar os portes através do seu Later Pay Number.
Em resumo: continua a desenvolver sobre a My Page, e a Zonos trata da camada de direitos aduaneiros dos EUA para os envios com destino aos Estados Unidos.
Se está a fazer a integração pela primeira vez, comece por Criar um envio único.
Para uma encomenda com destino aos EUA, envie o envio para o fluxo de trabalho GraphQL CreateDeclarationShipment da Zonos, em vez de chamar diretamente a My Page. Nesse único pedido, a Zonos:
Chama a Japan Post Label API (ctCode=52) em seu nome, utilizando os Later Pay Numbers da sua Verified Account, para que os portes continuem a ser faturados na sua conta Japan Post.
Cria o Declaration ID de direitos aduaneiros dos EUA e associa-o ao número de seguimento.
Adiciona a marcação DDP à etiqueta.
Devolve-lhe a etiqueta da Japan Post e o número de seguimento.
O CreateDeclarationShipment encadeia sete passos. Os mesmos dados que já reúne para um pedido ctCode=52 são distribuídos por esses passos:
Remetente / destinatário → as partes ORIGIN e DESTINATION do partyCreateWorkflow.
Artigos → itemCreateWorkflow (as linhas de artigos dentro de shipmentCartons).
Embalagem e peso → cartonsCreateWorkflow.
Serviço, manuseamento e indicadores aduaneiros → shipmentCreateWorkflow.
A Zonos trata disto por si
Não precisa de enviar as credenciais da Japan Post nem o código de operação (ctCode, ctId, ctPw), a data de envio (sendDate) ou as observações da declaração DDP. A Zonos define-os automaticamente quando chama a My Page.
Cada tabela mostra para onde vai cada parâmetro ctCode=52 da Japan Post My Page no fluxo de trabalho da Zonos. Para obter todos os detalhes dos campos, os tipos e os campos obrigatórios, consulte Criar um envio único.
Serviço e manuseamento → shipmentCreateWorkflow
Parâmetro My Page↕
Campo Zonos↕
Notas↕
sendType + transType
serviceLevel (e shipmentRatingCreateWorkflow.serviceLevelCode)
Um único nível de serviço Zonos codifica o serviço postal e o modo de transporte — por exemplo, japan_post.air.parcel. Tem de ser um nível de serviço japan_post.*.
pkgType
contentsType
SALE_OF_GOODS, ECOMMERCE_GOODS, COMMERCIAL_GOODS, COMMERCIAL_SAMPLE, RETURNED_GOODS, GIFT, DOCUMENTS ou OTHER.
senderInstruction
nonDelivery.option
RETURN_AFTER_RETENTION, RETURN_IMMEDIATELY, FORWARD ou ABANDON. A Zonos divide a instrução única de "devolução" da My Page em dois valores.
fw_TransType
nonDelivery.transportMethod
AIR ou MOST_ECONOMICAL. Aplica-se às duas opções RETURN_*.
noCm
isNonCommercial
true / false.
damges
declaredValue
Valor segurado. Tem de estar em JPY, em ienes inteiros.
Estas são as transformações que mais frequentemente exigem atenção:
O nível de serviço substitui sendType + transType. Escolha o único nível de serviço Zonos japan_post.* que corresponde ao serviço postal e ao transporte que atualmente envia como dois parâmetros separados.
O valor segurado (declaredValue) tem de estar em JPY, em ienes inteiros. Outras moedas ou frações de iene serão rejeitadas.
O peso é enviado à Japan Post em gramas. Indique weight + weightUnit na caixa; a Zonos faz a conversão.
As descrições aduaneiras dos artigos estão limitadas a 85 caracteres half-width.
Todos os campos de morada têm de estar em caracteres ingleses (romanos).
Quando criar uma etiqueta para os EUA através da Zonos, confirme que tudo funcionou do início ao fim:
O fluxo de trabalho devolve um número de seguimento e uma etiqueta. Verifique shipmentCreateWorkflow.trackingDetails.number e shipmentCartons[].label.url na resposta.
Foi criado e associado um Declaration ID. O envio só tem os direitos aduaneiros pré-pagos quando o Declaration ID está associado ao número de seguimento — a Zonos faz isto no mesmo pedido.
A marcação DDP está impressa na etiqueta. Abra a etiqueta devolvida e confirme que a marcação DDP está presente.
O envio aparece no seu Zonos Dashboard, na sua Verified Account.
No despacho em lote, confirme que a consolidação é fechada e devolve a guia de expedição da Japan Post (Code 61). Consulte Despacho em lote (consolidação).
Compare com uma etiqueta da My Page. Crie o mesmo envio das duas formas e confirme que o nível de serviço, o peso, o valor declarado e os detalhes dos artigos coincidem na etiqueta impressa.
Teste antes de entrar em produção
Valide o fluxo completo num envio de teste antes de enviar volume de produção para os EUA através da Zonos. A sua integração com a My Page mantém-se para tudo o resto.
Utilizar a Zonos com a My Page API
Utilizar a Zonos com a Japan Post My Page API
Já cria etiquetas com a Japan Post My Page API? Mantenha a sua integração e adicione a Zonos para etiquetas para os EUA com direitos aduaneiros pré-pagos.
Este guia destina-se a equipas que já estão integradas com a Japan Post My Page Web API para criar etiquetas (operação
ctCode=52). Para encomendas com destino aos EUA, que agora exigem o pré-pagamento dos direitos aduaneiros, a etiqueta é criada através da Zonos. A Zonos é uma extensão do fluxo de trabalho da My Page: chama a My Page Label API (ctCode=52) em seu nome, adiciona o Declaration ID de direitos aduaneiros dos EUA e a marcação DDP, e devolve-lhe a etiqueta da My Page e o número de seguimento. A Japan Post continua a produzir a etiqueta e a faturar os portes através do seu Later Pay Number.Em resumo: continua a desenvolver sobre a My Page, e a Zonos trata da camada de direitos aduaneiros dos EUA para os envios com destino aos Estados Unidos.
Se está a fazer a integração pela primeira vez, comece por Criar um envio único.
Como a Zonos se integra
Para uma encomenda com destino aos EUA, envie o envio para o fluxo de trabalho GraphQL
CreateDeclarationShipmentda Zonos, em vez de chamar diretamente a My Page. Nesse único pedido, a Zonos:ctCode=52) em seu nome, utilizando os Later Pay Numbers da sua Verified Account, para que os portes continuem a ser faturados na sua conta Japan Post.O
CreateDeclarationShipmentencadeia sete passos. Os mesmos dados que já reúne para um pedidoctCode=52são distribuídos por esses passos:ORIGINeDESTINATIONdopartyCreateWorkflow.itemCreateWorkflow(as linhas de artigos dentro deshipmentCartons).cartonsCreateWorkflow.shipmentCreateWorkflow.Não precisa de enviar as credenciais da Japan Post nem o código de operação (
ctCode,ctId,ctPw), a data de envio (sendDate) ou as observações da declaração DDP. A Zonos define-os automaticamente quando chama a My Page.Como os seus campos da My Page correspondem à Zonos
Cada tabela mostra para onde vai cada parâmetro
ctCode=52da Japan Post My Page no fluxo de trabalho da Zonos. Para obter todos os detalhes dos campos, os tipos e os campos obrigatórios, consulte Criar um envio único.Serviço e manuseamento →
shipmentCreateWorkflowsendType+transTypeserviceLevel(eshipmentRatingCreateWorkflow.serviceLevelCode)japan_post.air.parcel. Tem de ser um nível de serviçojapan_post.*.pkgTypecontentsTypeSALE_OF_GOODS,ECOMMERCE_GOODS,COMMERCIAL_GOODS,COMMERCIAL_SAMPLE,RETURNED_GOODS,GIFT,DOCUMENTSouOTHER.senderInstructionnonDelivery.optionRETURN_AFTER_RETENTION,RETURN_IMMEDIATELY,FORWARDouABANDON. A Zonos divide a instrução única de "devolução" da My Page em dois valores.fw_TransTypenonDelivery.transportMethodAIRouMOST_ECONOMICAL. Aplica-se às duas opçõesRETURN_*.noCmisNonCommercialtrue/false.damgesdeclaredValuetotalWeightcartonsCreateWorkflow.weight+weightUnitRemetente →
partyCreateWorkflow(parteORIGIN)from_namperson.firstName+person.lastNamefrom_companyNameperson.companyNamefrom_postallocation.postalCodefrom_add1/from_add2/from_add3location.line1/location.line2/location.localityfrom_preflocation.administrativeAreaCodefrom_telperson.phoneDestinatário →
partyCreateWorkflow(parteDESTINATION)Os parâmetros
to_*do destinatário correspondem à parteDESTINATIONda mesma forma que os campos do remetente.to_namperson.firstName+person.lastNameto_companyNameperson.companyNameto_couCdlocation.countryCodeUSouPR.to_add1/to_add2/to_add3location.line1/location.line2/location.localitylocation.postalCode/location.administrativeAreaCode/person.phoneArtigos →
itemCreateWorkflowitem_pkgcustomsDescriptionitem_hsCodehsCodeitem_numquantityitem_weightmeasurements(peso por unidade)item_costamountitem_curUnitcurrencyCodeConversões a ter em conta
Estas são as transformações que mais frequentemente exigem atenção:
sendType+transType. Escolha o único nível de serviço Zonosjapan_post.*que corresponde ao serviço postal e ao transporte que atualmente envia como dois parâmetros separados.declaredValue) tem de estar em JPY, em ienes inteiros. Outras moedas ou frações de iene serão rejeitadas.weight+weightUnitna caixa; a Zonos faz a conversão.Verificar as suas etiquetas para os EUA
Quando criar uma etiqueta para os EUA através da Zonos, confirme que tudo funcionou do início ao fim:
shipmentCreateWorkflow.trackingDetails.numbereshipmentCartons[].label.urlna resposta.Valide o fluxo completo num envio de teste antes de enviar volume de produção para os EUA através da Zonos. A sua integração com a My Page mantém-se para tudo o resto.
Relacionado
CreateDeclarationShipment.Esta página foi útil?