DOCS

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 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.

Termos principais 

  • 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.

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.

Campo↕Identificador da UE↕O que é↕Status↕
skuIdentificador de produto do comerciante (M-PID)O ID que você, seu marketplace ou sua plataforma atribui ao produto, como seu SKU.Obrigatório
manufacturerProductIdIdentificador 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
gtinIdentificador 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.
{
  "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.

↕Número IOSS da Zonos (a maioria dos comerciantes)↕Seu próprio número IOSS↕
taxIdNumberOmitaSeu número IOSS
taxRemittanceCalculationREMITTANCEREMITTANCE para uma estimativa que inclui o IVA, NO_REMITTANCE para criar a etiqueta
shipmentInput.references.taxCodeOmitaSeu número IOSS, ao criar a etiqueta
Quem recolhe e repassa o IVAZonosVocê ou seu marketplace
O que a Zonos fatura para vocêTributos aduaneiros, IVA e taxasTributos 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.

Obter uma estimativa de landed cost 

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.

1mutation EstimateLandedCost(
2$partyInput: [PartyCreateWorkflowInput!]!
3$itemInput: [ItemCreateWorkflowInput!]!
4$cartonInput: [CartonCreateWorkflowInput!]!
5$shipmentRatingInput: ShipmentRatingCreateWorkflowInput!
6$landedCostInput: LandedCostWorkFlowInput!
7) {
8 partyCreateWorkflow(input: $partyInput) {
9 id
10 type
11 }
12 itemCreateWorkflow(input: $itemInput) {
13 id
14 }
15 cartonsCreateWorkflow(input: $cartonInput) {
16 id
17 }
18 shipmentRatingCreateWorkflow(input: $shipmentRatingInput) {
19 id
20 amount
21 serviceLevel {
22 code
23 }
24 }
25 landedCostCalculateWorkflow(input: $landedCostInput) {
26 id
27 currencyCode
28 amountSubtotals {
29 duties
30 taxes
31 fees
32 shipping
33 landedCostTotal
34 }
35 duties {
36 amount
37 description
38 }
39 taxes {
40 amount
41 description
42 }
43 remittance {
44 amount
45 description
46 note
47 taxIdNumber
48 }
49 }
50}

Criar uma etiqueta 

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": {
    "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, 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.
{
  "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"
    }
  }
}
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.

1mutation CreateDeclarationShipment(
2$partyInput: [PartyCreateWorkflowInput!]!
3$itemInput: [ItemCreateWorkflowInput!]!
4$cartonInput: [CartonCreateWorkflowInput!]!
5$shipmentRatingInput: ShipmentRatingCreateWorkflowInput!
6$landedCostInput: LandedCostWorkFlowInput!
7$shipmentInput: ShipmentCreateWorkflowInput!
8) {
9 partyCreateWorkflow(input: $partyInput) {
10 id
11 type
12 }
13 itemCreateWorkflow(input: $itemInput) {
14 id
15 }
16 cartonsCreateWorkflow(input: $cartonInput) {
17 id
18 }
19 shipmentRatingCreateWorkflow(input: $shipmentRatingInput) {
20 id
21 amount
22 serviceLevel {
23 code
24 }
25 }
26 landedCostCalculateWorkflow(input: $landedCostInput) {
27 id
28 currencyCode
29 amountSubtotals {
30 duties
31 taxes
32 fees
33 shipping
34 landedCostTotal
35 }
36 duties {
37 amount
38 description
39 }
40 taxes {
41 amount
42 description
43 }
44 remittance {
45 amount
46 description
47 note
48 taxIdNumber
49 }
50 }
51 shipmentCreateWorkflow(input: $shipmentInput) {
52 id
53 trackingDetails {
54 number
55 }
56 shipmentCartons {
57 label {
58 url
59 }
60 }
61 }
62}

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 landedCostCalculateWorkflow de cada envio, conforme mostrado acima, e depois anexe e feche o lote conforme descrito em Despacho em lote.

Esta página foi útil?