¿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:
- Analizará el precio inclusivo y los parámetros especificados.
- Determinará qué componentes (aranceles, impuestos, tarifas) invertir.
- Calculará el precio base eliminando estos componentes.
- 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.
itemReverseAmountTypeDefine 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.
taxRateCountryIndica 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.
dutyRateCountryIndica 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.
serviceLevelCodesEsto 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.
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 type note } taxes { amount currency } method }}
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.