LiberAI API

Integra clasificación arancelaria automatizada en tu sistema. Todos los endpoints requieren autenticación JWT de Supabase Auth.

Volver a LiberAI

Autenticación

Todos los endpoints protegidos requieren un token JWT en el header Authorization. Obtén tu token al iniciar sesión con Supabase Auth.

Ejemplo con cURL
curl -X POST https://tu-dominio.com/api/classify \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"description": "Laptop Dell", "country": "Panamá"}'
POST/api/classifyAUTH

Clasificar Producto por Texto

Clasifica un producto usando descripción textual. Utiliza tecnología avanzada para encontrar el código HS más preciso.

Headers
Authorization: Bearer 
Content-Type: application/json
Request Body
{
  "description": "Laptop Dell Inspiron 15 pulgadas",
  "country": "Panamá"
}
Response
{
  "success": true,
  "hs_code": "8471.30.00.00",
  "description": "Máquina automática para procesamiento de datos, portátil",
  "tariff_rate": 0,
  "tax_itbms": 7,
  "justification": "Clasificado bajo RGI Regla 1...",
  "confidence_score": 0.92,
  "analysis_steps": ["1. Identificación: ...", "2. Sección: ..."],
  "new_balance": 49,
  "candidates_count": 15,
  "verified": true
}
POST/api/chatAUTH

Chat con Asistente Aduanero

Conversación libre con el asistente especializado en comercio exterior y clasificación arancelaria.

Headers
Authorization: Bearer 
Content-Type: application/json
Request Body
{
  "message": "¿Cuál es el arancel para importar café tostado a Panamá?"
}
Response
{
  "response": "El café tostado se clasifica en la partida 0901.21...",
  "new_balance": 48
}
POST/api/v1/classifyAUTH

Clasificar Documentos (PDF/Excel/Imagen)

Envía documentos comerciales (facturas, BL, packing list) para clasificación automática avanzada. Procesamiento asíncrono.

Headers
Authorization: Bearer 
Content-Type: application/json
Request Body
{
  "fileUrls": [
    "https://storage.supabase.co/.../factura.pdf"
  ],
  "fileTypes": [".pdf"],
  "country": "Panamá",
  "transportMode": "maritimo"
}
Response
{
  "success": true,
  "jobId": "abc123-def456",
  "status": "processing",
  "message": "Expediente encolado"
}
GET/api/v1/classification/:jobId/historyAUTH

Historial de Versiones

Obtiene el historial completo de versiones de una clasificación, incluyendo correcciones humanas.

Headers
Authorization: Bearer
Response
{
  "versions": [
    {
      "version_number": 1,
      "hs_code": "8471.30.00.00",
      "change_type": "ai_classification",
      "created_at": "2026-03-09T10:00:00Z"
    },
    {
      "version_number": 2,
      "hs_code": "8471.30.00.90",
      "hs_code_previous": "8471.30.00.00",
      "change_type": "human_correction",
      "created_at": "2026-03-09T14:30:00Z"
    }
  ]
}

Códigos de Estado

200Operación exitosa
400Parámetros faltantes o inválidos
401Token JWT faltante o inválido
402Créditos insuficientes
403Permisos insuficientes
500Error interno del servidor