DOCS

Reverse inclusive pricing

Landed Cost•
InicioComercio electrónico global Inclusive pricing Reverse inclusive pricing

Reverse inclusive pricing

Revise derechos, impuestos y tarifas de su precio todo incluido a través de la API.

PRÓXIMAMENTE

Zonos' Reverse Inclusive Pricing le permite enviar un precio todo incluido—uno que ya incluye derechos, impuestos y/o tarifas—y recibir el precio base a cambio para la documentación aduanera. Esto le permite mostrar precios todo incluido a los compradores mientras declara un precio base limpio y no incluido para la factura comercial. Esta solución es ideal para mercados donde se espera o se requiere inclusive pricing, ayudándole a apoyar estrategias de precios globales y mantener la precisión y el cumplimiento aduanero.

¿Cómo funciona? 

Para revertir derechos, impuestos o tarifas de un precio todo incluido, utilizará la configuración reverseAmountDetails en su solicitud API. Este objeto le indica a Zonos qué componentes están incluidos en su precio de entrada y deben ser eliminados para calcular el verdadero precio base para aduanas.

Cuando envíe un precio todo incluido con la respectiva configuración reverseAmountDetails, Zonos:

  1. Analizará el precio todo incluido y los parámetros especificados.
  2. Determinará qué componentes (derechos, impuestos, tarifas) revertir.
  3. Calculará el precio base eliminando estos componentes.
  4. Devolverá tanto el precio base ajustado como un desglose de los montos revertidos.

Guía de API 

Para integrar el reverse inclusive pricing en su flujo de trabajo, incluya el objeto reverseAmountDetail en la solicitud itemCreateWorkflow.

Configurando la solicitud

Pasar reverseAmountDetail le indica a Zonos que revierta derechos, impuestos y/o tarifas. Si esta configuración no se pasa, se realizará el cálculo estándar de landed cost.

itemReverseAmountType

Define qué componentes están incluidos en el precio. Puede elegir entre:

  • TAX: Solo se incluye el impuesto.
  • DUTY: Solo se incluye el derecho.
  • DUTY_TAX: Se incluyen el derecho y el impuesto.
  • TAX_FEE: Se incluyen el impuesto y las tarifas.
  • DUTY_FEE: Se incluyen el derecho y las tarifas.
  • DUTY_TAX_FEE: Se incluyen el derecho, el impuesto y las tarifas.
taxRateCountry

Indica el país cuyo impuesto rate está incluido en el precio. Esto es opcional.

  • Si no se especifica, el sistema utiliza el impuesto rate del país de destino por defecto.
  • El valor debe ser un código de país ISO válido.
dutyRateCountry

Indica el país cuyo derecho rate está incluido en el precio. Esto es opcional.

  • Si no se especifica, el sistema utiliza el impuesto rate del país de destino por defecto.
  • El valor debe ser un código de país ISO válido.
serviceLevelCodes

Esto es requerido solo si itemReverseAmountType incluye FEE.

  • Especifica qué tarifas de nivel de servicio de envío están incluidas en el precio.
  • El valor debe ser un array de códigos de nivel de servicio.
status (solo respuesta)

Indica el resultado del cálculo inverso. Este campo se devuelve en la respuesta:

  • APPLIED: El cálculo inverso se aplicó con éxito.
  • NOT_APPLIED_UNDER_DE_MINIMIS: No se aplicó ningún cálculo porque el valor está por debajo del umbral de de minimis.
  • NOT_APPLIED_NEGATIVE_VALUE: Se omitió el cálculo para evitar un valor negativo.

Ejemplo de API

Una vez que haya preparado la entrada requerida, envíe la mutación GraphQL a la API utilizando su cliente o herramienta preferida.

Mutación

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

Respuesta

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"
      }
    ]
  }
}

¿Fue útil esta página?

Reservar una demostración

¿Preguntas?

Obtener soporte
© 2025 Zonoszonos.com
En esta página:
  • Reverse inclusive pricing
  • ¿Cómo funciona?
  • Guía de API