DOCS

Inclusive Pricing inverso

Inclusive Pricing inverso

Invierta aranceles, impuestos y tarifas de su precio inclusivo mediante API.

BETA

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

¿Cómo funciona? 

Para invertir aranceles, impuestos o tarifas de un precio inclusivo, usará la configuración reverseAmountDetails en su solicitud de API. Este objeto indica a Zonos qué componentes están incluidos en su precio de entrada y deben eliminarse para calcular el verdadero precio base para aduanas.

Cuando envía un precio inclusivo con la configuración reverseAmountDetails correspondiente, Zonos:

  1. Analizará el precio inclusivo y los parámetros especificados.
  2. Determinará qué componentes (aranceles, impuestos, tarifas) invertir.
  3. Calculará el precio base eliminando estos componentes.
  4. Devolverá tanto el precio base ajustado como un desglose de los importes invertidos.

Guía de API 

Para integrar Inclusive Pricing inverso en su flujo de trabajo, incluya el objeto reverseAmountDetail en la solicitud itemCreateWorkflow.

Configurar la solicitud

Pasar reverseAmountDetail indica a Zonos que invierta aranceles, impuestos y/o tarifas. Si no se pasa esta configuración, 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 arancel.
  • DUTY_TAX: Se incluyen arancel e impuesto.
  • TAX_FEE: Se incluyen impuesto y tarifas.
  • DUTY_FEE: Se incluyen arancel y tarifas.
  • DUTY_TAX_FEE: Se incluyen arancel, impuesto y tarifas.
taxRateCountry

Indica el país cuya tarifa de impuestos está incluida en el precio. Esto es opcional.

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

Indica el país cuya tarifa arancelaria está incluida en el precio. Esto es opcional.

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

Esto solo es necesario 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ó correctamente.
  • NOT_APPLIED_UNDER_DE_MINIMIS: No se aplicó ningún cálculo porque el valor está por debajo del umbral 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 usando su cliente o herramienta preferida.

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}

¿Fue útil esta página?