API comercio exterior Mexico | Camtom API

La API de Camtom te permite integrar clasificacion arancelaria y extraccion de documentos directamente en tu sistema. Dos endpoints principales, una sola autenticacion, resultados en segundos.

Base URL

Todas las peticiones van a:

https://api.camtomx.com

Endpoints disponibles

TariffPro Mini

Clasificacion arancelaria interactiva. Envia una descripcion, imagenes o documentos y recibe codigos HS sugeridos con nivel de confianza.

CamtomDocs Extract

Extraccion de datos de documentos aduaneros. Envia un PDF o imagen con un JSON Schema y recibe datos estructurados.

Quick start

Clasifica un producto con multipart/form-data:

import requests

response = requests.post(
    "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini",
    headers={"Authorization": "Bearer sk_tu_api_key"},
    params={"country_code": "MEX", "model": "pro"},
    data={"product_description": "Camiseta de algodon para hombre, tejida, talla M"}
)
print(response.json())

const formData = new FormData();
formData.append("product_description", "Camiseta de algodon para hombre, tejida, talla M");

const response = await fetch(
  "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini?country_code=MEX&model=pro",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk_tu_api_key"
    },
    body: formData
  }
);
const data = await response.json();
console.log(data);

curl -X POST "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini?country_code=MEX&model=pro" \
  -H "Authorization: Bearer sk_tu_api_key" \
  -F "product_description=Camiseta de algodon para hombre, tejida, talla M"

Respuesta:

{
  "hscodes_array": [
    {
      "hscode_2digits": { "name": "Prendas y complementos de vestir, de punto", "code": "61" },
      "hscode_4digits": { "name": "Camisetas de punto", "code": "6109" },
      "hscode_6digits": { "name": "De algodon", "code": "6109.10" },
      "hscode_8digits": { "name": "Camisetas de algodon", "code": "6109.10.01" },
      "overall_confidence": 0.92,
      "justification": "Producto textil de punto de algodon para hombre...",
      "recommendations": "...",
      "tariff_info": {}
    }
  ],
  "summary_classification": "Camiseta de punto de algodon para hombre",
  "required_questions": [],
  "classification_record_id": "abc123"
}

Sistema de creditos

Cada llamada a la API consume creditos de tu organizacion:

Endpoint	Costo
TariffPro Mini	1 credito por clasificacion
CamtomDocs Extract	Segun paginas procesadas (ver `billed_pages` en la respuesta)

Los creditos disponibles se consultan desde organization.subscription.limits. Puedes ver tu saldo desde app.camtomx.com.

Siguientes pasos

Autenticacion

Obtener tu API key y configurar la autenticacion.

TariffPro Mini

Documentacion completa del endpoint de clasificacion arancelaria.

CamtomDocs Extract

Documentacion completa del endpoint de extraccion de documentos.

Codigos de error

Referencia de errores y como resolverlos.

​Base URL

​Endpoints disponibles

TariffPro Mini

CamtomDocs Extract

​Quick start

​Sistema de creditos

​Siguientes pasos

Autenticacion

TariffPro Mini

CamtomDocs Extract

Codigos de error

Base URL

Endpoints disponibles

Quick start

Sistema de creditos

Siguientes pasos