Primeros pasosInicio rapido
Inicio rapido
Clasifique su primer producto en 5 minutos con la API de The Trade Hub.
Esta guia le acompana desde la creacion de su cuenta hasta su primera clasificacion aduanera via la API. En 5 minutos, estara operativo.
Requisitos previos
- Un navegador web moderno
- Una herramienta para realizar solicitudes HTTP (
curl, Postman o su lenguaje de programacion favorito)
Crear una cuenta y una organizacion
Visite The Trade Hub y cree su cuenta. Puede registrarse con su email o via Google/Microsoft.
Una vez conectado, cree una organizacion. La organizacion es la entidad que agrupa sus claves API, su consumo y sus miembros.
Generar una clave API
Desde su organizacion, acceda a la pagina Desarrollador:
- Vaya a Organizacion > Desarrollador
- Haga clic en "Crear una clave API"
- De un nombre descriptivo a su clave
- Seleccione los scopes necesarios (
classifypara clasificacion,export_controlpara control de exportaciones) - Copie la clave mostrada - no sera visible de nuevo
Primera clasificacion
Cree un job de clasificacion con su clave API:
curl -X POST https://api.thetradehub.eu/v1/classify/jobs \
-H "X-API-Key: th_live_su_clave_api" \
-H "Content-Type: application/json" \
-d '{
"content": "Cable USB-C a Lightning para iPhone, longitud 1m, color blanco"
}'La solicitud es asincrona. Recibe inmediatamente un identificador de job:
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "pending",
"created_at": "2026-02-25T10:30:00Z"
}Recuperar los resultados
Interrogue el estado del job hasta obtener los resultados:
curl https://api.thetradehub.eu/v1/classify/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "X-API-Key: th_live_su_clave_api"Campos clave de la respuesta:
| Campo | Descripcion |
|---|---|
rankings[].hs_code | Codigo del Sistema Armonizado (6, 8 o 10 digitos) |
rankings[].confidence | Puntuacion de confianza (0 a 1) |
rankings[].gri_justification | Justificacion basada en las Reglas Generales Interpretativas |
rankings[].validated | true si el codigo ha sido verificado en la nomenclatura TARIC |
Proximos pasos
- Consulte la referencia API Clasificacion para el detalle completo de parametros y respuestas
- Explore la clasificacion por lotes para procesar varios productos
- Descubra los patrones de integracion para las buenas practicas en produccion
- Navegue por los referenciales para los datos de referencia aduaneros
Última actualización