Envie pacotes Japan Post com tributos pré-pagos para destinos selecionados da UE com a API da Zonos e escolha como o IVA da UE é tratado.
A partir de 1º de outubro de 2026 (JST), sua Verified Account pode criar etiquetas Japan Post com tributos pré-pagos, quando o destino permitir, para estes destinos da UE: Dinamarca, França (incluindo Mônaco), Andorra, departamentos ultramarinos franceses (Guadalupe, Guiana Francesa, Martinica), Suécia, Espanha, Países Baixos, Eslováquia, Itália, Finlândia, Luxemburgo, Estônia e Malta.
A elegibilidade de um envio para DDP depende do destino, do valor do envio e de se ele é um presente, e algumas áreas de código postal são excluídas. Consulte Prontidão dos países da UE para ver as regras de cada destino.
Você usa o mesmo fluxo CreateDeclarationShipment que usa para envios aos EUA. Para um envio à UE, altere o endereço de destino, passe identificadores de produto em todos os itens (obrigatórios a partir de 1º de novembro de 2026, veja abaixo) e use dois campos opcionais em landedCostCalculateWorkflow para escolher como o IVA é tratado. Se você usar seu próprio número IOSS, também deve passá-lo em shipmentInput.references.taxCode para que ele seja aplicado à etiqueta. Todo o resto funciona exatamente como descrito em Criar um envio único.
DDP (Delivered Duty Paid): Os tributos e impostos são pagos antes de o pacote chegar, para que seu cliente não precise pagar nada na entrega. A Zonos envia em DDP para os destinos da UE suportados sempre que as regras do destino permitem. Consulte Prontidão dos países da UE.
IVA (Imposto sobre o valor agregado, VAT): O imposto sobre o consumo da UE, cobrado sobre as mercadorias, o frete e os tributos aduaneiros. A alíquota depende do país de destino.
IOSS (Import One-Stop Shop): Um registro da UE que permite ao vendedor recolher o IVA no momento da venda e pagá-lo à UE em uma única declaração mensal, em vez de o IVA ser cobrado quando o pacote chega. O IOSS se aplica a envios com mercadorias de valor igual ou inferior a €150. Um número IOSS tem o formato IM seguido de 10 dígitos.
A partir de 1º de novembro de 2026, toda declaração aduaneira da UE para uma venda online deve listar três identificadores de produto para cada item. Até lá eles são voluntários, mas recomendamos enviá-los desde já para que sua integração esteja pronta.
Campo↕
Identificador da UE↕
O que é↕
Status↕
sku
Identificador de produto do comerciante (M-PID)
O ID que você, seu marketplace ou sua plataforma atribui ao produto, como seu SKU.
Obrigatório
manufacturerProductId
Identificador de produto do fabricante não padronizado (NS-PID)
O código de produto próprio do fabricante ou fornecedor, como um número de modelo ou de peça.
Obrigatório
gtin
Identificador de produto do fabricante padronizado (S-PID)
Um número de código de barras baseado em um padrão internacional, como um código JAN, EAN ou UPC, ou um ISBN para livros.
Obrigatório se o produto tiver um. Se não tiver, omita gtin.
Onde fornecê-los
Todo item precisa dos três identificadores, seja na solicitação da etiqueta ou salvos no item do seu catálogo da Zonos. Recomendamos passá-los na solicitação da etiqueta.
Na solicitação da etiqueta (recomendado): passe os três em cada item em itemCreateWorkflow.
No seu catálogo da Zonos: salve-os nos itens do seu catálogo, por meio de uma integração de canal, de uma importação de CSV ou da Catalog API. A Zonos então precisa encontrar o item do catálogo para cada envio:
Com uma integração de canal que sincroniza pedidos e itens do catálogo: adicione o número de rastreamento da Japan Post ao pedido no seu canal. A Zonos associa o envio ao pedido pelo número de rastreamento.
Sem uma integração de canal: passe o sku correspondente em todos os itens na solicitação da etiqueta.
A sacola de lona não tem número de código de barras, por isso gtin é omitido.
Esses campos ficam com a Zonos e não são enviados à API My Page da Japan Post, portanto não afetam nenhum limite de campo da Japan Post. A Zonos atua como declarante terceiro nos seus envios para a UE. Para a regra completa, consulte Regulamentação de imposto de importação da UE.
Não. Se você não tem um número IOSS, está tudo certo. A Zonos tem seu próprio número IOSS. Quando você envia com sua Zonos Verified Account, a Zonos usa o número IOSS dela, cobra de você o IVA junto com os tributos aduaneiros e repassa o IVA à UE em seu nome. A maioria dos comerciantes usa esta opção.
Use seu próprio número IOSS somente se você já tiver um, ou se vender por meio de um marketplace que tenha um (por exemplo, eBay ou Etsy) e recolher o IVA dos seus clientes no checkout. Passar seu número IOSS indica à Zonos que não deve cobrar o IVA de você uma segunda vez, porque você (ou seu marketplace) fará o repasse.
↕
Número IOSS da Zonos (a maioria dos comerciantes)↕
Seu próprio número IOSS↕
taxIdNumber
Omita
Seu número IOSS
taxRemittanceCalculation
REMITTANCE
REMITTANCE para uma estimativa que inclui o IVA, NO_REMITTANCE para criar a etiqueta
shipmentInput.references.taxCode
Omita
Seu número IOSS, ao criar a etiqueta
Quem recolhe e repassa o IVA
Zonos
Você ou seu marketplace
O que a Zonos fatura para você
Tributos aduaneiros, IVA e taxas
Tributos aduaneiros e taxas
Seu número IOSS se aplica somente a envios de €150 ou menos
Passe seu próprio número IOSS somente em envios com mercadorias de valor igual ou inferior a €150. A Zonos verifica apenas o formato (IM seguido de 10 dígitos). Se o formato for inválido, a Zonos ignora o número e usa o número IOSS dela, por isso confira com atenção o número que você envia.
Execute o fluxo até landedCostCalculateWorkflow, sem shipmentCreateWorkflow, para ver os tributos aduaneiros, o IVA e as taxas de um envio. Nada é enviado e nenhuma etiqueta é criada. A requisição é a mesma de Criar um envio único com um destino na UE; apenas landedCostInput muda.
Usando o número IOSS da Zonos
Omita taxIdNumber e defina taxRemittanceCalculation como REMITTANCE. A estimativa retorna o tributo aduaneiro da UE, o IVA e as taxas. Esse é o valor que a Zonos faturará para você, e a Zonos repassa o IVA com o número IOSS dela.
1{
2"landedCostInput":{
3"calculationMethod":"DDP",
4"endUse":"NOT_FOR_RESALE",
5"currencyCode":"EUR",
6"taxRemittanceCalculation":"REMITTANCE"
7}
8}
Usando seu próprio número IOSS
Passe seu número IOSS em taxIdNumber. Escolha taxRemittanceCalculation de acordo com sua necessidade:
REMITTANCE: A estimativa retorna o IVA, para que você saiba quanto recolher do seu cliente e repassar com seu próprio registro IOSS.
NO_REMITTANCE: Use esta opção se você já tem seus próprios sistemas para calcular e recolher o IVA. A estimativa não retorna IVA, apenas os tributos aduaneiros e as taxas que a Zonos faturará para você.
1{
2"landedCostInput":{
3"calculationMethod":"DDP",
4"endUse":"NOT_FOR_RESALE",
5"currencyCode":"EUR",
6"taxIdNumber":"IM5281234567",
7"taxRemittanceCalculation":"REMITTANCE"
8}
9}
Exemplo completo: Estimar tributos e impostos
Uma requisição de estimativa completa, das partes ao landed cost, para um envio do Japão para a França. A mutation é a mesma para as duas opções; apenas as variáveis de landedCostInput mudam.
Execute o fluxo CreateDeclarationShipment completo, incluindo shipmentCreateWorkflow, com um destino na UE. A Zonos cria a etiqueta Japan Post e o número de rastreamento, e fatura para você depois que o pacote entra no fluxo postal.
Usando o número IOSS da Zonos
Omita taxIdNumber e references.taxCode e defina taxRemittanceCalculation como REMITTANCE. Você não passa um número IOSS em nenhum lugar: a Zonos aplica o número IOSS dela ao envio por padrão, fatura para você os tributos aduaneiros e o IVA, e repassa o IVA à UE.
landedCostInput.taxIdNumber, com taxRemittanceCalculation definido como NO_REMITTANCE. A Zonos não cobra IVA de você neste envio, porque você já o recolheu e fará o repasse com seu próprio registro IOSS. A Zonos fatura para você os tributos aduaneiros e as taxas.
shipmentInput.references.taxCode. Isso aplica seu número IOSS à etiqueta Japan Post.
Usa seu próprio número IOSS? Passe-o nos dois lugares
Ao criar uma etiqueta com seu próprio número IOSS, sempre passe-o tanto em landedCostInput.taxIdNumber (com NO_REMITTANCE) quanto em shipmentInput.references.taxCode. Se faltar qualquer um deles, você pode ser cobrado pelo IVA que você mesmo está repassando, ou seu número IOSS pode não ser aplicado à etiqueta. REMITTANCE com seu próprio número IOSS serve apenas para estimativas.
Exemplo completo: Criar uma etiqueta Japan Post
Uma requisição CreateDeclarationShipment completa, das partes à etiqueta, para um envio do Japão para a França. A mutation é a mesma para as duas opções. Com seu próprio número IOSS, as variáveis mudam em dois lugares: landedCostInput e shipmentInput.references.taxCode.
Os envios para a UE podem ir no mesmo lote de despacho com pagamento diferido dos seus envios para os EUA. Defina os campos de IOSS no landedCostCalculateWorkflow de cada envio, conforme mostrado acima, e depois anexe e feche o lote conforme descrito em Despacho em lote.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Enviar para a UE
Enviar para a UE
Envie pacotes Japan Post com tributos pré-pagos para destinos selecionados da UE com a API da Zonos e escolha como o IVA da UE é tratado.
A partir de 1º de outubro de 2026 (JST), sua Verified Account pode criar etiquetas Japan Post com tributos pré-pagos, quando o destino permitir, para estes destinos da UE: Dinamarca, França (incluindo Mônaco), Andorra, departamentos ultramarinos franceses (Guadalupe, Guiana Francesa, Martinica), Suécia, Espanha, Países Baixos, Eslováquia, Itália, Finlândia, Luxemburgo, Estônia e Malta.
A elegibilidade de um envio para DDP depende do destino, do valor do envio e de se ele é um presente, e algumas áreas de código postal são excluídas. Consulte Prontidão dos países da UE para ver as regras de cada destino.
Você usa o mesmo fluxo
CreateDeclarationShipmentque usa para envios aos EUA. Para um envio à UE, altere o endereço de destino, passe identificadores de produto em todos os itens (obrigatórios a partir de 1º de novembro de 2026, veja abaixo) e use dois campos opcionais emlandedCostCalculateWorkflowpara escolher como o IVA é tratado. Se você usar seu próprio número IOSS, também deve passá-lo emshipmentInput.references.taxCodepara que ele seja aplicado à etiqueta. Todo o resto funciona exatamente como descrito em Criar um envio único.Termos principais
IMseguido de 10 dígitos.Identificadores de produto (obrigatórios a partir de 1º de novembro de 2026)
A partir de 1º de novembro de 2026, toda declaração aduaneira da UE para uma venda online deve listar três identificadores de produto para cada item. Até lá eles são voluntários, mas recomendamos enviá-los desde já para que sua integração esteja pronta.
skumanufacturerProductIdgtingtin.Onde fornecê-los
Todo item precisa dos três identificadores, seja na solicitação da etiqueta ou salvos no item do seu catálogo da Zonos. Recomendamos passá-los na solicitação da etiqueta.
itemCreateWorkflow.skucorrespondente em todos os itens na solicitação da etiqueta.{ "itemInput": [ { "name": "Cotton T-shirt", "sku": "TSHIRT-BLK-M", "manufacturerProductId": "MFR-TS-2201", "gtin": "4901234567894" }, { "name": "Canvas tote bag", "sku": "TOTE-NAT-01", "manufacturerProductId": "MFR-TB-0310" } ] }A sacola de lona não tem número de código de barras, por isso
gtiné omitido.Esses campos ficam com a Zonos e não são enviados à API My Page da Japan Post, portanto não afetam nenhum limite de campo da Japan Post. A Zonos atua como declarante terceiro nos seus envios para a UE. Para a regra completa, consulte Regulamentação de imposto de importação da UE.
Você precisa do seu próprio número IOSS?
Não. Se você não tem um número IOSS, está tudo certo. A Zonos tem seu próprio número IOSS. Quando você envia com sua Zonos Verified Account, a Zonos usa o número IOSS dela, cobra de você o IVA junto com os tributos aduaneiros e repassa o IVA à UE em seu nome. A maioria dos comerciantes usa esta opção.
Use seu próprio número IOSS somente se você já tiver um, ou se vender por meio de um marketplace que tenha um (por exemplo, eBay ou Etsy) e recolher o IVA dos seus clientes no checkout. Passar seu número IOSS indica à Zonos que não deve cobrar o IVA de você uma segunda vez, porque você (ou seu marketplace) fará o repasse.
taxIdNumbertaxRemittanceCalculationREMITTANCEREMITTANCEpara uma estimativa que inclui o IVA,NO_REMITTANCEpara criar a etiquetashipmentInput.references.taxCodePasse seu próprio número IOSS somente em envios com mercadorias de valor igual ou inferior a €150. A Zonos verifica apenas o formato (
IMseguido de 10 dígitos). Se o formato for inválido, a Zonos ignora o número e usa o número IOSS dela, por isso confira com atenção o número que você envia.Obter uma estimativa de landed cost
Execute o fluxo até
landedCostCalculateWorkflow, semshipmentCreateWorkflow, para ver os tributos aduaneiros, o IVA e as taxas de um envio. Nada é enviado e nenhuma etiqueta é criada. A requisição é a mesma de Criar um envio único com um destino na UE; apenaslandedCostInputmuda.Usando o número IOSS da Zonos
Omita
taxIdNumbere definataxRemittanceCalculationcomoREMITTANCE. A estimativa retorna o tributo aduaneiro da UE, o IVA e as taxas. Esse é o valor que a Zonos faturará para você, e a Zonos repassa o IVA com o número IOSS dela.{"landedCostInput": {"calculationMethod": "DDP","endUse": "NOT_FOR_RESALE","currencyCode": "EUR","taxRemittanceCalculation": "REMITTANCE"}}Usando seu próprio número IOSS
Passe seu número IOSS em
taxIdNumber. EscolhataxRemittanceCalculationde acordo com sua necessidade:REMITTANCE: A estimativa retorna o IVA, para que você saiba quanto recolher do seu cliente e repassar com seu próprio registro IOSS.NO_REMITTANCE: Use esta opção se você já tem seus próprios sistemas para calcular e recolher o IVA. A estimativa não retorna IVA, apenas os tributos aduaneiros e as taxas que a Zonos faturará para você.{"landedCostInput": {"calculationMethod": "DDP","endUse": "NOT_FOR_RESALE","currencyCode": "EUR","taxIdNumber": "IM5281234567","taxRemittanceCalculation": "REMITTANCE"}}Exemplo completo: Estimar tributos e impostos
Uma requisição de estimativa completa, das partes ao landed cost, para um envio do Japão para a França. A mutation é a mesma para as duas opções; apenas as variáveis de
landedCostInputmudam.mutation EstimateLandedCost($partyInput: [PartyCreateWorkflowInput!]!$itemInput: [ItemCreateWorkflowInput!]!$cartonInput: [CartonCreateWorkflowInput!]!$shipmentRatingInput: ShipmentRatingCreateWorkflowInput!$landedCostInput: LandedCostWorkFlowInput!) {partyCreateWorkflow(input: $partyInput) {idtype}itemCreateWorkflow(input: $itemInput) {id}cartonsCreateWorkflow(input: $cartonInput) {id}shipmentRatingCreateWorkflow(input: $shipmentRatingInput) {idamountserviceLevel {code}}landedCostCalculateWorkflow(input: $landedCostInput) {idcurrencyCodeamountSubtotals {dutiestaxesfeesshippinglandedCostTotal}duties {amountdescription}taxes {amountdescription}remittance {amountdescriptionnotetaxIdNumber}}}Criar uma etiqueta
Execute o fluxo
CreateDeclarationShipmentcompleto, incluindoshipmentCreateWorkflow, com um destino na UE. A Zonos cria a etiqueta Japan Post e o número de rastreamento, e fatura para você depois que o pacote entra no fluxo postal.Usando o número IOSS da Zonos
Omita
taxIdNumberereferences.taxCodee definataxRemittanceCalculationcomoREMITTANCE. Você não passa um número IOSS em nenhum lugar: a Zonos aplica o número IOSS dela ao envio por padrão, fatura para você os tributos aduaneiros e o IVA, e repassa o IVA à UE.{ "landedCostInput": { "calculationMethod": "DDP", "endUse": "NOT_FOR_RESALE", "currencyCode": "EUR", "taxRemittanceCalculation": "REMITTANCE" } }Usando seu próprio número IOSS
Passe seu número IOSS em dois lugares:
landedCostInput.taxIdNumber, comtaxRemittanceCalculationdefinido comoNO_REMITTANCE. A Zonos não cobra IVA de você neste envio, porque você já o recolheu e fará o repasse com seu próprio registro IOSS. A Zonos fatura para você os tributos aduaneiros e as taxas.shipmentInput.references.taxCode. Isso aplica seu número IOSS à etiqueta Japan Post.{ "landedCostInput": { "calculationMethod": "DDP", "endUse": "NOT_FOR_RESALE", "currencyCode": "EUR", "taxIdNumber": "IM5281234567", "taxRemittanceCalculation": "NO_REMITTANCE" }, "shipmentInput": { "serviceLevel": "japan_post.air.ems_merchandise", "generateLabel": true, "contentsType": "ECOMMERCE_GOODS", "references": { "taxCode": "IM5281234567" } } }Ao criar uma etiqueta com seu próprio número IOSS, sempre passe-o tanto em
landedCostInput.taxIdNumber(comNO_REMITTANCE) quanto emshipmentInput.references.taxCode. Se faltar qualquer um deles, você pode ser cobrado pelo IVA que você mesmo está repassando, ou seu número IOSS pode não ser aplicado à etiqueta.REMITTANCEcom seu próprio número IOSS serve apenas para estimativas.Exemplo completo: Criar uma etiqueta Japan Post
Uma requisição
CreateDeclarationShipmentcompleta, das partes à etiqueta, para um envio do Japão para a França. A mutation é a mesma para as duas opções. Com seu próprio número IOSS, as variáveis mudam em dois lugares:landedCostInputeshipmentInput.references.taxCode.mutation CreateDeclarationShipment($partyInput: [PartyCreateWorkflowInput!]!$itemInput: [ItemCreateWorkflowInput!]!$cartonInput: [CartonCreateWorkflowInput!]!$shipmentRatingInput: ShipmentRatingCreateWorkflowInput!$landedCostInput: LandedCostWorkFlowInput!$shipmentInput: ShipmentCreateWorkflowInput!) {partyCreateWorkflow(input: $partyInput) {idtype}itemCreateWorkflow(input: $itemInput) {id}cartonsCreateWorkflow(input: $cartonInput) {id}shipmentRatingCreateWorkflow(input: $shipmentRatingInput) {idamountserviceLevel {code}}landedCostCalculateWorkflow(input: $landedCostInput) {idcurrencyCodeamountSubtotals {dutiestaxesfeesshippinglandedCostTotal}duties {amountdescription}taxes {amountdescription}remittance {amountdescriptionnotetaxIdNumber}}shipmentCreateWorkflow(input: $shipmentInput) {idtrackingDetails {number}shipmentCartons {label {url}}}}Despacho em lote
Os envios para a UE podem ir no mesmo lote de despacho com pagamento diferido dos seus envios para os EUA. Defina os campos de IOSS no
landedCostCalculateWorkflowde cada envio, conforme mostrado acima, e depois anexe e feche o lote conforme descrito em Despacho em lote.CartonCreateWorkflowInput ItemCreateWorkflowInput LandedCostWorkFlowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput ShipmentRatingCreateWorkflowInput
cartonsCreateWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentRatingCreateWorkflow
Esta página foi útil?