DOCS

Landed cost object

/

Objeto Landed Cost

Explore las capacidades y funciones del objeto Landed Cost.

El objeto Landed Cost proporciona un desglose y total de aranceles de importación, impuestos y tarifas.

Atributos 

CampoNotas
id STRINGEl identificador único para el objeto. El id para el objeto de Landed Cost siempre tendrá el prefijo ldct.
amount_subtotal HASHTotal de Landed cost. Si se usa para un checkout de comercio electrónico, recomendamos usar estos totales para mostrar al usuario final. Estos totales permiten una integración más fácil sin la necesidad de sumar aranceles, impuestos o tarifas por artículo y nivel de envío. Se encuentran detalles adicionales en el objeto de landed cost. Ver atributos secundarios a continuación.
amount_subtotal.duties DECIMALSuma de todos los aranceles en el array de aranceles. Incluye aranceles aplicados a artículos, envío o cualquier arancel adicional aplicado a la importación. Para entender cómo se calculan los aranceles, consulte el documento de aranceles de importación.
amount_subtotal.fees DECIMALSuma de las diversas tarifas en el array de tarifas. Incluye tarifas de despacho, tarifas de importación del país u otras tarifas aplicadas a la importación. Para entender más sobre las tarifas de importación, consulte el documento de tarifas de importación.
amount_subtotal.taxes DECIMALSuma de todos los impuestos en el array de impuestos. Incluye impuestos aplicados a artículos, aranceles, envío o tarifas. Para entender más sobre los impuestos de importación, consulte el documento de impuestos de importación.
currency HASHHash que proporciona información sobre la moneda base enviada en la solicitud y otras monedas con el rate de cambio utilizado en el momento de la respuesta. Esto es útil si desea convertir a la moneda del país de importación o a otras monedas utilizadas en el cálculo de landed cost. Ver atributos secundarios a continuación.
currency.id STRINGEl identificador único para el objeto de moneda.
currency.base STRINGLa moneda base enviada en la solicitud de landed cost, representada por un código ISO de tres letras. Todos los montos en el objeto de landed cost están listados en la moneda base.
currency.date TIMESTAMPLa fecha en la que se obtuvo el rate de cambio, en el formato ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ
currency.rates HASHHash que contiene las monedas y los tipos de cambio necesarios para la conversión desde la moneda base.
currency.rates.currency STRINGUna moneda de rate de cambio utilizada en el cálculo de landed cost.
currency.rates.rate DECIMALEl rate de cambio en el momento de la solicitud de landed cost para la moneda especificada.
customs HASHHash que contiene información utilizada para determinar el landed cost así como información necesaria para la documentación y el despacho de aduanas. Ver atributos secundarios a continuación.
customs.delivery_duty_paid STRINGLa capacidad de facturar aranceles e impuestos a alguien que no sea el destinatario (DDP - entrega con derechos pagados) varía según la empresa de envíos, el servicio de envío o el país de destino. Los valores posibles son disponible, no disponible y desconocido. Si se utiliza el landed cost para un checkout de comercio electrónico, solo debe permitir al comprador pagar aranceles e impuestos si el resultado es disponible. Si el resultado es desconocido, puede presentar al comprador una cantidad estimada de aranceles e impuestos que tendrá que pagar a la entrega o puede optar por no mostrar los aranceles e impuestos en absoluto para ese nivel de servicio del transportista. Si el resultado es no disponible, su cuenta ha sido configurada en el Panel de Control de Zonos para no permitir DDP, aunque sea un servicio permitido por el transportista seleccionado.
customs.items LISTLa lista de artículos enviados en la solicitud. Consulte los atributos secundarios a continuación.
customs.items.id STRINGEl identificador único enviado en la solicitud.
customs.items.amount DECIMALEl monto del artículo en la moneda base. Este es el monto enviado en la solicitud para este artículo.
customs.items.country_of_origin STRINGEl país de fabricación donde se produjo el artículo. Representado por un código ISO de dos letras. Consulte el documento de aranceles de importación para comprender cómo el país de origen afecta el cálculo del landed cost.
customs.items.country_of_origin_source STRINGLa fuente del país de origen. Los valores posibles son zonos, solicitud_api y predeterminado_cuenta plataforma.
customs.items.description_customs STRINGLa descripción sugerida de los bienes para la factura comercial. Esta descripción suele ser diferente de una descripción minorista y generalmente incluirá una descripción general de qué es, de qué está hecho y para qué se utiliza.
customs.items.description_retail STRINGLa descripción minorista del artículo.
customs.items.detail STRINGCaracterísticas adicionales, atributos o descripciones del artículo.
customs.items.dimensions LISTEl tamaño del envío. hash
customs.items.dimensions.height DECIMALLa altura del artículo.
customs.items.dimensions.length DECIMALLa longitud del artículo.
customs.items.dimensions.unit STRINGLa unidad de medida para las dimensiones del artículo. Los valores posibles son pulgada, centímetro, milímetro y nulo. Cuando es nulo, se utilizará pulgada.
customs.items.dimensions.width DECIMALEl ancho del artículo.
customs.items.hs_code STRINGEl código arancelario armonizado utilizado para determinar la rate en el cálculo del landed cost.
customs.items.hs_code_source STRINGLa fuente del código arancelario armonizado utilizado, que puede ser establecido por Zonos. Los valores posibles son zonos, solicitud_api, zonos, predeterminado_cuenta y corrección_hs.
customs.items.image_url STRINGLa URL de la imagen.
customs.items.note STRINGDetalles adicionales sobre el despacho del artículo o el código arancelario, si corresponde. Un ejemplo para India es Según las pautas de importación de India para envíos personales, su código HS se corrigió a 9804.90.00.
customs.items.quantity INTEGERLa cantidad del artículo enviada en la solicitud.
customs.items.upc_code STRINGEl código UPC del artículo.
customs.items.weight DECIMALEl peso del artículo.
customs.items.weight_unit STRINGLa unidad de medida para el peso. Los valores posibles son libra, onza, kilogramo y nulo. Cuando es nulo, se utilizará libra.
customs.ship_to_country STRINGEl país de importación donde se aplican aranceles e impuestos.
customs.shipping_amount DECIMALEl monto del envío que debe figurar en la documentación aduanera.
de_minimis HASHInformación sobre el umbral específico del país que determina cuándo se aplican los aranceles e impuestos. La matriz de tasas de cambio contendrá la conversión rate utilizada para determinar si la importación estaba por encima o por debajo de los umbrales de aranceles e impuestos. Ver atributos secundarios a continuación.
de_minimis.formula STRINGLa fórmula utilizada para calcular la elegibilidad del umbral de minimis.
de_minimis.method STRINGEste es el método de cálculo, como cif, cifd, cifdt, fob o fobd.
de_minimis.note STRINGDetalles adicionales sobre el de minimis, como proporcionar información si un artículo no era elegible para la consideración de minimis, como el vino.
de_minimis.threshold STRINGSi el impuesto está por debajo o por encima del umbral de impuestos. Los valores posibles incluyen above o below.
de_minimis.type STRINGEl de minimis aplicado al type. Los valores posibles incluyen tax y duty.
duties HASHUna matriz de aranceles aplicados a la importación. La suma de los montos de los aranceles es igual a amount_subtotal.duties. Ver atributos secundarios a continuación.
duties.amount DECIMALEl monto del arancel sobre el item, shipping o fee.
duties.description STRINGDescripciones variadas del arancel, como duty, anti_dumping_duty y más.
duties.formula STRINGLa fórmula utilizada para calcular el monto del arancel. Para el arancel, esto es típicamente la tarifa para el país de importación y podría ser ad valorem o un arancel específico rate.
duties.item_id STRINGEl identificador único enviado en la solicitud. El id solo se proporciona cuando el tipo es item.
duties.note STRINGDetalles adicionales sobre el arancel, incluidos acuerdos de libre comercio, tasas de arancel reducidas, aranceles antidumping y más.
duties.type STRINGEl arancel se aplica al type. Los valores posibles incluyen item, shipping y fee.
fees HASHUna matriz de tarifas aplicadas a la importación. La suma de los montos de las tarifas es igual a amount_subtotal.fees. Ver atributos secundarios a continuación.
fees.amount DECIMALEl monto de la tarifa aplicada al artículo, envío, arancel, nivel de servicio, transportista o país. Este monto está en la moneda base y puede haber sido convertido de la moneda respectiva del país de importación a la moneda base enviada en la solicitud.
fees.description STRINGDescripciones variadas de la tarifa, como UPS Disbursement Fee, FedEx Advancement Fee y An Post Clearance Fee.
fees.formula STRINGLa fórmula utilizada para calcular la tarifa. Para las tarifas, esto es típicamente un monto fijo, un porcentaje de los aranceles e impuestos, u otra fórmula.
fees.item_id STRINGSu identificador único enviado en la solicitud de landed cost. El id solo se proporciona cuando el tipo es item.
fees.note STRINGDetalles adicionales sobre la tarifa, si es necesario.
fees.type STRINGLa tarifa se aplica al type. Los valores posibles incluyen advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country y other.
messages HASHUna lista de mensajes no críticos, por ejemplo, “El monto del envío en la solicitud era nulo, esto podría afectar el cálculo.”
messages.message STRINGUn mensaje útil relacionado con su solicitud de Landed Cost y qué información no crítica faltaba.
messages.type STRINGEl tipo de mensaje. Los valores posibles incluyen price_adjustment, default_value_used, shipping_missing y item_weight_missing.
remittance HASHUna matriz que contiene el monto y los detalles de lo que debe remitirse a un país específico (por ejemplo, Australia, Nueva Zelanda, Noruega o Reino Unido).
remittance.amount DECIMALEl monto de dinero que debe remitirse a un país específico.
remittance.description STRINGUna descripción de para qué es la remesa (por ejemplo, IVA del Reino Unido).
remittance.note STRINGUna nota sobre cómo se debe remitir el impuesto (por ejemplo, remit a HMRC trimestralmente).
removed_items LISTLa lista de artículos eliminados de la solicitud para el cálculo del landed cost. Ver atributos secundarios a continuación.
removed_items.id STRINGEl identificador único enviado en la solicitud.
removed_items.amount DECIMALEl monto del artículo en la moneda base. Este es el monto enviado en la solicitud para este artículo.
removed_items.country_of_origin STRINGEl país de fabricación donde se produjo el artículo o producto. Representado por un código ISO de dos letras. Consulte el documento de derechos de importación para entender cómo el país de origen impacta el cálculo del landed cost.
removed_items.country_or_origin_source STRINGLa fuente del país de origen. Los valores posibles son zonos_catalog, api_request, y account_default platform.
removed_items.description_customs STRINGLa descripción sugerida de los bienes para la factura comercial. Esta descripción generalmente diferirá de una descripción minorista y típicamente incluirá una descripción general de qué es, de qué está hecho y para qué se usa.
removed_items.description_retail STRINGLa descripción minorista del artículo.
removed_items.hs_code STRINGEl código arancelario armonizado utilizado para determinar la rate arancelaria en el cálculo del landed cost.
removed_items.hs_code_source STRINGLa fuente del código arancelario armonizado utilizado, que puede ser establecido por Zonos. Los valores posibles son zonos_catalog, api_request, platform, zonos_classified, account_default, y hs_correction.
removed_items.note STRINGDetalles adicionales sobre el despacho del artículo o el código HS, si corresponde. Un ejemplo para India es Según las directrices de importación de India para envíos personales, su código HS fue corregido a 9804.90.00.
removed_items.quantity INTEGERLa cantidad del artículo según se envió en la solicitud.
taxes HASHUna matriz de impuestos aplicados a la importación. La suma de los montos de impuestos es igual a amount_subtotal.taxes. Ver atributos secundarios a continuación.
taxes.amount DECIMALEl monto del impuesto sobre el artículo, envío, arancel o tarifa.
taxes.description STRINGDescripciones variadas del impuesto aplicado, como tax, VAT, GST, PST, HST, y más.
taxes.formula STRINGLa fórmula utilizada para calcular el monto del impuesto generalmente incluye el impuesto del país de importación; sin embargo, esto también puede ser un impuesto estatal (o provincial) o un impuesto reducido (o añadido).
taxes.item_id STRINGEl identificador único enviado en la solicitud de landed cost. El id solo se proporciona cuando el tipo es item.
taxes.note STRINGDetalles adicionales sobre el impuesto, incluyendo tasas de impuestos reducidas u otra información aplicable sobre el impuesto aplicado.
taxes.type STRINGEl impuesto se aplica al type. Los valores posibles incluyen item duty y shipping así como los tipos de tarifas de advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country, y other.

Solicitud de ejemplo

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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
{
  "id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
  "amount_subtotal": {
    "duties": 0,
    "fees": 15,
    "taxes": 12.25
  },
  "currency": {
    "id": "b5f06418-3",
    "base": "USD",
    "date": "2021-01-07T00:34:03.471+0000",
    "rates": [
      {
        "currency": "GBP",
        "rate": 0.8117
      }
    ]
  },
  "customs": {
    "delivery_duty_paid": "available",
    "items": [
      {
        "id": "294395",
        "amount": 39.17,
        "country_of_origin": "FR",
        "country_of_origin_source": null,
        "description_customs": "Hoka One Running Shoe - Women's",
        "description_retail": "Hoka One Running Shoe - Women's",
        "hs_code": "6116.10",
        "hs_code_source": "api_request",
        "note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
        "quantity": 1
      },
      {
        "id": "294396",
        "amount": 7.83,
        "country_of_origin": "CN",
        "country_of_origin_source": "account_default",
        "description_customs": "Galaxy Quest Men's Tee Blue",
        "description_retail": "Galaxy Quest Men's Tee Blue",
        "hs_code": "6217.10",
        "hs_code_source": "api_request",
        "note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
        "quantity": 1
      }
    ],
    "shipping_amount": 14.23,
    "ship_to_country": "GB"
  },
  "de_minimis": [
    {
      "formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
      "method": "FOB",
      "note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
      "threshold": "below",
      "type": "duty"
    },
    {
      "formula": "(cost {'<='} 0 gbp)",
      "method": "FOB",
      "note": "Tax applies to all shipments",
      "threshold": "above",
      "type": "tax"
    }
  ],
  "duties": [],
  "fees": [
    {
      "amount": 15,
      "description": "UPS United States Duty and Tax Forwarding Charge",
      "item_id": null,
      "formula": "15 USD",
      "note": null,
      "type": "ddp_service_fee"
    }
  ],
  "remittance": [
    {
      "amount": 12.25,
      "description": "UK VAT",
      "note": "remit to HMRC quarterly"
    }
  ],
  "removed_items": [],
  "taxes": [
    {
      "amount": 7.83,
      "description": "VAT (Value-added tax)",
      "item_id": "294395",
      "formula": "20%",
      "note": null,
      "type": "item"
    },
    {
      "amount": 2.3719,
      "description": "VAT (Value-added tax)",
      "item_id": "294395",
      "formula": "20%",
      "note": null,
      "type": "shipping"
    },
    {
      "amount": 1.57,
      "description": "VAT (Value-added tax)",
      "item_id": "294396",
      "formula": "20%",
      "note": null,
      "type": "item"
    },
    {
      "amount": 0.4741,
      "description": "VAT (Value-added tax)",
      "item_id": "294396",
      "formula": "20%",
      "note": null,
      "type": "shipping"
    }
  ]
}

¿Fue útil esta página?