DOCS

Inclusive Pricing reverso

Landed Cost•
InícioComércio eletrônico global Inclusive Pricing Inclusive Pricing reverso

Inclusive Pricing reverso

Inverta duties, taxes e fees do seu preço inclusivo via API.

BETA

O Inclusive Pricing reverso da Zonos permite enviar um preço inclusivo — um que já inclui duties, taxes e/ou fees — e receber o preço base em troca para a documentação aduaneira. Isso permite exibir preços totais aos compradores enquanto declara um preço base limpo e não inclusivo para a fatura comercial. Esta solução é ideal para mercados onde Inclusive Pricing é esperado ou exigido, ajudando a respaldar estratégias de preços globais e manter a precisão e a conformidade aduaneira.

Como funciona? 

Para inverter duties, taxes ou fees de um preço inclusivo, você usará a configuração reverseAmountDetails na solicitação da API. Este objeto indica à Zonos quais componentes estão incluídos no 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 configuração reverseAmountDetails correspondente, a Zonos:

  1. Analisará o preço inclusivo e os parâmetros especificados.
  2. Determinará quais componentes (duties, taxes, fees) inverter.
  3. Calculará o preço base removendo esses componentes.
  4. Retornará tanto o preço base ajustado quanto um detalhamento dos valores invertidos.

Guia da API 

Para integrar Inclusive Pricing reverso no seu fluxo de trabalho, inclua o objeto reverseAmountDetail na solicitação itemCreateWorkflow.

Configurar a solicitação

Passar reverseAmountDetail indica à Zonos que inverta duties, taxes e/ou fees. Se esta configuração não for passada, será realizado o cálculo padrão de landed cost.

itemReverseAmountType

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

  • TAX: Apenas o tax está incluído.
  • DUTY: Apenas o duty está incluído.
  • DUTY_TAX: Duty e tax estão incluídos.
  • TAX_FEE: Tax e fees estão incluídos.
  • DUTY_FEE: Duty e fees estão incluídos.
  • DUTY_TAX_FEE: Duty, tax e fees estão incluídos.
taxRateCountry

Indica o país cuja taxa de imposto está incluída no preço. Isso é opcional.

  • Se não for especificado, o sistema usa por padrão a taxa de imposto do país de destino.
  • O valor deve ser um código de país ISO válido.
dutyRateCountry

Indica o país cuja taxa de duty está incluída no preço. Isso é opcional.

  • Se não for especificado, o sistema usa por padrão a taxa de imposto do país de destino.
  • O valor deve ser um código de país ISO válido.
serviceLevelCodes

Isso só é necessário se itemReverseAmountType incluir FEE.

  • Especifica quais fees 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 (somente resposta)

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

  • APPLIED: O cálculo reverso foi aplicado corretamente.
  • NOT_APPLIED_UNDER_DE_MINIMIS: Nenhum cálculo foi aplicado porque o valor está abaixo do limiar de de minimis.
  • NOT_APPLIED_NEGATIVE_VALUE: O cálculo foi omitido para evitar um valor negativo.

Exemplo de API

Depois de preparar a entrada necessária, envie a mutation GraphQL para a API usando o cliente ou ferramenta de sua preferência.

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

Esta página foi útil?

Obter suporte·Documentos legais·© 2026 Zonos
Nesta página:
  • Inclusive Pricing reverso
  • Como funciona?
  • Guia da API