Integra Camtom con tu sistema via API REST

Arquitectura de la API de Camtom

La API de Camtom sigue los principios REST y utiliza JSON como formato de intercambio. Todos los endpoints requieren autenticacion via API key en el header Authorization. La API está versiónada (actualmente v2) y mantiene compatibilidad hacia atrás dentro de la misma versión mayor. La URL base es https://api.camtom.com/v2.

Paso 1: Obtener credenciales de API

Desde tu panel de Camtom, navega a Configuracion > API > Generar clave. Obtendras una API key de tipo sk_live_... para produccion y sk_test_... para el entorno sandbox. Guarda la clave en un lugar seguro — no podrás verla de nuevo. Si la pierdes, genera una nueva y revoca la anterior.

Paso 2: Endpoints principales

• POST /v2/classify — Enviar descripción de producto y recibir sugerencias de fracción arancelaria.
• POST /v2/documents/extract — Subir factura en PDF o imagen y recibir datos estructurados.
• GET /v2/tariff/{fraction} — Consultar datos de una fracción arancelaria: tasa, regulaciones, notas.
• POST /v2/clients — Crear o actualizar expediente de cliente en KYB.
• GET /v2/clients/{rfc}/status — Consultar estado del expediente y documentos vigentes.

Paso 3: Ejemplo de integración — Clasificación

Para clasificar un producto, envía un POST a /v2/classify con el campo description en el body. La respuesta incluirá un array de sugerencias ordenadas por confianza, cada una con la fracción, descripción TIGIE, tasa arancelaria, regulaciones no arancelarias y un score de confianza entre 0 y 1. Un score superior a 0.85 indica alta confianza.

Paso 4: Manejo de errores y límites

La API usa códigos HTTP estándar: 200 para exito, 400 para errores de validación, 401 para autenticacion fallida, 429 para exceso de solicitudes y 500 para errores internos. El rate limit por defecto es de 100 solicitudes por minuto. Si necesitas mayor capacidad, contacta a tu ejecutivo de cuenta para un plan personalizado.

Paso 5: Webhooks para procesamiento asincrono

Para operaciones que toman más tiempo, como la extracción de documentos complejos, puedes registrar un webhook URL. Camtom enviara un POST a tu endpoint cuando el procesamiento termine, incluyendo los resultados completos. Esto permite una integración no bloqueante ideal para flujos de trabajo de alto volumen.