DOCS

Reverse inclusive pricing

Landed Cost•
InícioEcommerce global Inclusive pricing Reverse inclusive pricing

Reverse inclusive pricing

Remova impostos, taxas e encargos do seu preço inclusivo via API.

EM BREVE

O Reverse Zonos do Inclusive Pricing permite que você envie um preço inclusivo—um que já inclui impostos, taxas e/ou encargos—e receba o preço base em troca para documentação aduaneira. Isso permite que você exiba preços totais para os compradores enquanto ainda declara um preço base limpo e não inclusivo para a fatura comercial. Esta solução é ideal para mercados onde o inclusive pricing é esperado ou exigido, ajudando você a apoiar estratégias de preços globais e manter a precisão e conformidade aduaneira.

Como funciona? 

Para reverter impostos, taxas ou encargos de um preço inclusivo, você usará a configuração reverseAmountDetails em sua solicitação API. Este objeto informa ao Zonos quais componentes estão incluídos no seu preço de entrada e devem ser removidos para calcular o verdadeiro preço base para a alfândega.

Quando você envia um preço inclusivo com a respectiva configuração reverseAmountDetails, o Zonos irá:

  1. Analisar o preço inclusivo e os parâmetros especificados.
  2. Determinar quais componentes (impostos, taxas, encargos) reverter.
  3. Calcular o preço base removendo esses componentes.
  4. Retornar tanto o preço base ajustado quanto uma discriminação dos valores revertidos.

Guia da API 

Para integrar o reverse inclusive pricing ao seu fluxo de trabalho, inclua o objeto reverseAmountDetail na solicitação itemCreateWorkflow.

Configurando a solicitação

Passar reverseAmountDetail informa ao Zonos para reverter impostos, taxas e/ou encargos. Se essa configuração não for passada, o cálculo padrão de landed cost será realizado.

itemReverseAmountType

Define quais componentes estão incluídos no preço. Você pode escolher entre:

  • TAX: Apenas o imposto está incluído.
  • DUTY: Apenas o imposto de importação está incluído.
  • DUTY_TAX: Imposto de importação e imposto estão incluídos.
  • TAX_FEE: Imposto e taxas estão incluídos.
  • DUTY_FEE: Imposto de importação e taxas estão incluídos.
  • DUTY_TAX_FEE: Imposto de importação, imposto e taxas estão todos incluídos.
taxRateCountry

Indica o país cujo imposto rate está incluído no preço. Isso é opcional.

dutyRateCountry

Indica o país cujo imposto de importação rate está incluído no preço. Isso é opcional.

serviceLevelCodes

Isso é necessário apenas se itemReverseAmountType incluir FEE.

  • Especifica quais taxas de nível de serviço de envio estão incluídas no preço.
  • O valor deve ser um array de códigos de nível de serviço.
status (apenas resposta)

Indica o resultado do cálculo reverso. Este campo é retornado na resposta:

  • APPLIED: O cálculo reverso foi aplicado com sucesso.
  • NOT_APPLIED_UNDER_DE_MINIMIS: Nenhum cálculo aplicado porque o valor está abaixo do limite de de minimis.
  • NOT_APPLIED_NEGATIVE_VALUE: Cálculo foi pulado para evitar um valor negativo.

Exemplo de API

Uma vez que você tenha preparado a entrada necessária, envie a mutação GraphQL para a API usando seu cliente ou ferramenta preferida.

Mutação

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
mutation {
  partyCreateWorkflow(
    input: [
      { type: ORIGIN, location: { countryCode: US } }
      {
        type: DESTINATION
        location: { countryCode: CA, administrativeAreaCode: "AB" }
      }
    ]
  ) {
    id
  }
  itemCreateWorkflow(
    input: [
      {
        productId: "product-1"
        hsCode: "9503.00.9079"
        countryOfOrigin: US
        amount: 100
        quantity: 1
        currencyCode: USD
        reverseAmountDetail: { type: DUTY_TAX, taxRateCountry: CA }
      }
    ]
  ) {
    id
    amount
    currencyCode
    quantity
    hsCode
    countryOfOrigin
    reverseAmountDetail {
      originalAmount
      amount
      status
      type
      dutyRateCountry
      taxRateCountry
      taxRate
      dutyRate
      feeAmount
    }
  }
  cartonsCreateWorkflow(
    input: {
      length: 8
      width: 4
      height: 2
      dimensionalUnit: INCH
      weight: 1
      weightUnit: POUND
    }
  ) {
    id
  }
  shipmentRatingCreateWorkflow(
    input: {
      amount: "30.00"
      currencyCode: USD
      serviceLevelCode: "ups.worldwide_expedited"
    }
  ) {
    id
  }
  landedCostCalculateWorkflow(input: { calculationMethod: DDP_PREFERRED }) {
    id
    amountSubtotals {
      items
      shipping
      duties
      taxes
      fees
    }
    duties {
      amount
      currency
      note
    }
    fees {
      amount
      currency
      feeType
      type
      note
    }
    taxes {
      amount
      currency
    }
    method
  }
}

Resposta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
{
  "data": {
    "partyCreateWorkflow": [
      { "id": "party_cc85f44d-567a-4cb0-984f-17a0e2d97f78" },
      { "id": "party_0kcf5m0x404q6" }
    ],
    "itemCreateWorkflow": [
      {
        "id": "item_0kcf5rsa420zy",
        "amount": 95.0,
        "currencyCode": "USD",
        "quantity": 1,
        "hsCode": "9503.00.9079",
        "countryOfOrigin": "US",
        "reverseAmountDetail": [
          {
            "originalAmount": 100,
            "amount": 95.0,
            "status": "APPLIED",
            "type": "DUTY_TAX",
            "dutyRateCountry": "CA",
            "taxRateCountry": "CA",
            "taxRate": 0.05,
            "dutyRate": null,
            "feeAmount": null
          }
        ]
      }
    ],
    "cartonsCreateWorkflow": [{ "id": "carton_0kcf5rth4057g" }],
    "shipmentRatingCreateWorkflow": {
      "id": "shipment_rating_0kcf5rtpc057t"
    },
    "landedCostCalculateWorkflow": [
      {
        "id": "lc-6bfd94d67d2e43e5b5cf1143d56ca01e",
        "amountSubtotals": {
          "items": 95.0,
          "shipping": 30.0,
          "duties": 0.0,
          "taxes": 5.2,
          "fees": 9.5
        },
        "duties": [],
        "fees": [
          {
            "amount": 7.16,
            "currency": "USD",
            "feeType": "ADVANCEMENT",
            "type": "ADVANCEMENT",
            "note": null
          },
          {
            "amount": 1.77,
            "currency": "USD",
            "feeType": "BROKERAGE_FEE",
            "type": "BROKERAGE_FEE",
            "note": null
          },
          {
            "amount": 0.57,
            "currency": "USD",
            "feeType": "CURRENCY_CONVERSION_FEE",
            "type": "CURRENCY_CONVERSION_FEE",
            "note": null
          }
        ],
        "taxes": [
          { "amount": 4.75, "currency": "USD" },
          { "amount": 0.36, "currency": "USD" },
          { "amount": 0.09, "currency": "USD" }
        ],
        "method": "DDP"
      }
    ]
  }
}

Esta página foi útil?

Agendar uma demonstração

Dúvidas?

Obter suporte
© 2025 Zonoszonos.com
Nesta página:
  • Reverse inclusive pricing
  • Como funciona?
  • Guia da API