hsCodes

La API de códigos HS está diseñada para clasificar envíos según la información proporcionada en los campos de entrada de acuerdo con el Sistema Armonizado (HS). Esta API permite que aplicaciones y clientes interactúen con Correos para obtener el código HS específico requerido para envíos internacionales.

En esta primera versión de la API se cuenta tan solo con una operación:

• calculateHSCode: Esta operación permite a los usuarios enviar detalles relevantes del envío a través del cuerpo de la solicitud. Procesa la información proporcionada, como los datos del remitente y del destinatario, la descripción del producto, la cantidad, el peso y otros atributos esenciales, para calcular y devolver el correspondiente Código HS. La operación aprovecha el conjunto completo de campos de entrada para calcular el Código HS apropiado, lo cual es crucial para que las autoridades aduaneras clasifiquen el envío con precisión y determinen los aranceles y los impuestos aplicables.:

• tariff-codes/{codTariff}: Esta operación permite a los usuarios consultar y comprobar la existencia de los datos de un determinada partifa aranelaria a partir de su código. En caso de no existir, el API devuelve un '404 - Not found'

Este API se utiliza tanto, para dar soporte a aplicaciones externas a Correos (DMZ) como para aplicaciones internas (RI).

Las políticas de seguridad aplicadas en DMZ y RI son diferentes.

Política de seguridad (DMZ):

Esta API aplica las siguientes políticas:

• "Client ID Enforcement", https://docs.mulesoft.com/api-manager/2.x/client-id-based-policies. Primero, la aplicación cliente debe solicitar acceso a esta API, luego se proporcionarán un par de client_id y client_secret. Una vez que los propietarios de la API acepten la solicitud, se otorgará al cliente la posibilidad de realizar solicitudes a la API si los encabezados de solicitud HTTP "client_id" y "client_secret" están configurados correctamente.

• "JWT Validation Correos", [https://anypoint.mulesoft.com/exchange/3bc027b3-e029-4d19-aea9-ef04e2044488/JWT_Validation_Correos/]. Primero, se debe solicitar acceso al API por medio de un token (Bearer Token) y a continuación utilizarlo para invocar al servicio.

Política de seguridad (RI):

Esta API tiene la política de seguridad denominada "Client ID Enforcement", https://docs.mulesoft.com/api-manager/2.x/client-id-based-policies. Primero, la aplicación cliente debe solicitar acceso a esta API, luego se proporcionarán un par de client_id y client_secret. Una vez que los propietarios de la API acepten la solicitud, se otorgará al cliente la posibilidad de realizar solicitudes a la API si los encabezados de solicitud HTTP "client_id" y "client_secret" están configurados correctamente.