Los puntos finales Obtener detalles del código armonizado y Buscar datos del código armonizado para la V1 de esta API están obsoletos
Los proyectos actuales pueden seguir usando puntos finales de la API obsoletos. Sin embargo, para una mejor clasificación del código armonizado, te recomendamos actualizar tus integraciones para usar la V2 del punto final Búsqueda de datos de código armonizado.
El punto final Buscar datos del código armonizado de la API permite buscar y obtener información completa del Sistema armonizado (SA) al proporcionar algunos detalles sobre tu mercancía y su destino u origen. El código del SA correcto y los detalles de la mercancía pueden ayudarte a evitar retrasos causados por descripciones vagas de las mercancías y códigos de clasificación inconsistentes o que no se ingresaron. Contar con información precisa del SA también te ayuda a preparar los documentos necesarios para los artículos de tus envíos.
Nota: La búsqueda de esta API funciona con inteligencia artificial. Sus resultados son solo sugerencias. Al crear envíos, valida estos resultados e inclúyelos bajo tu propia responsabilidad. Las clasificaciones precisas las determinan en última instancia los agentes de aduana autorizados que utilices y las autoridades de aduana involucradas en el envío.
La búsqueda de código armonizado más simple requiere solo una descripción de la mercancía y un destino u origen. Esto te permite obtener información del SA incluso si no tienes toda la información de la mercancía.
Cuanta más información proporciones, más confiables serán los resultados de la búsqueda. Usa los siguientes campos en tu solicitud de Buscar datos del código armonizado:
commodityName: un nombre para la mercancía. Por ejemplo: «zapatillas deportivas para correr».commodityDescription*: una descripción de la mercancía. Mientras más detallada sea la descripción, más efectiva será la búsqueda. destinationCountryCodes*: el país o países de destino a los que se enviará la mercancía. Se requiere el país de destino o el de origen, y puedes proporcionar ambos. Proporciona el código ISO del país. Por ejemplo: «US» o «CA».originCountryCode*: el país de origen de la mercancía. Se requiere el país de origen o el de destino, y se aceptan ambos. Proporciona el código ISO del país. Por ejemplo: «IN» o «VN».countryOfManufacture: el país en el que se fabricó la mercancía. Proporciona el código ISO del país. Por ejemplo: «VN».productId: un identificador alfanumérico o SKU del producto.categories: la jerarquía o jerarquías de categorías asociadas con la mercancía. Por ejemplo: «calzado, zapatillas deportivas».material: el material de la mercancía. Por ejemplo: «cuero».unitPrice.amount: una cifra que indica el precio de la mercancía.unitPrice.currency: el código de tres letras de la moneda. Por ejemplo: «USD».*Campos obligatorios.
Una respuesta a una solicitud exitosa devuelve el código de país, el tipo de país y un arreglo de subheadingOptions que contiene hasta cuatro posibles coincidencias para un código de clasificación del SA, el nombre, una descripción de aduana y un arreglo de hasta cuatro posibles alternativas de arancel. Los resultados dentro del arreglo subheadingOptions se ordenan según el confidenceScore que el sistema calculó para el resultado, mostrando primero el resultado con el mayor nivel de confianza. El arreglo tarriffAlternates contiene más posibilidades de códigos y descripciones si incluiste destinationCountryCodes en tu solicitud.
Elige el código del SA más adecuado para la mercancía que vas a enviar.
Si proporcionas un país de destino y un país de origen, obtendrás información del SA que aplica para ambos países. Si solo proporcionas un destino o un origen, obtendrás información del SA para ese destino u origen.
