Quoter v2 API - Impuestos y regulaciones

Genera el analisis arancelario de uno o varios productos a partir de su descripcion, fraccion arancelaria de 8 digitos y pais relacionado con la operacion.

POST https://api.camtomx.com/api/v3/quoter_v2/new-quote

Costo: 0.25 creditos por producto. Incluir RRNA no agrega costo.

Autenticacion

Incluye tu API key en el header:

Authorization: Bearer sk_tu_api_key
Content-Type: application/json

Nunca expongas una API key en frontend. Llama este endpoint desde tu backend.

Query parameters

string

required

Pais cuya tarifa y regulaciones se analizaran. Actualmente, Quoter v2 soporta MEX.

boolean

default:"false"

Si es true, agrega las Regulaciones y Restricciones No Arancelarias aplicables. No agrega costo.

string

Identificador opcional para trazabilidad de la integracion.

Body

El body usa application/json.

string

required

Direccion de la operacion. Valores: import o export.

array

required

Lista de 1 a 20 productos. El costo total es cantidad de productos x 0.25 creditos.

Cada producto contiene:

Campo	Tipo	Requerido	Descripcion
`product_description`	string	Si	Descripcion clara del producto
`hscode_8digits`	string	Si	Fraccion arancelaria de 8 digitos
`country`	string	Si	Pais de origen o destino relacionado con la operacion

El campo language es opcional. Usa Spanish o English; el valor predeterminado es Spanish.

Ejemplo

import requests

response = requests.post(
    "https://api.camtomx.com/api/v3/quoter_v2/new-quote",
    headers={
        "Authorization": "Bearer sk_tu_api_key",
        "Content-Type": "application/json",
    },
    params={
        "country_code": "MEX",
        "include_rrna": "true",
        "user_identifier": "orden-1042",
    },
    json={
        "direction": "import",
        "language": "Spanish",
        "products": [
            {
                "product_description": "Microfono alambrico para uso profesional",
                "hscode_8digits": "85181004",
                "country": "CHN",
            }
        ],
    },
    timeout=180,
)

response.raise_for_status()
print(response.json())

const response = await fetch(
  "https://api.camtomx.com/api/v3/quoter_v2/new-quote?country_code=MEX&include_rrna=true",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk_tu_api_key",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      direction: "import",
      language: "Spanish",
      products: [
        {
          product_description: "Microfono alambrico para uso profesional",
          hscode_8digits: "85181004",
          country: "CHN"
        }
      ]
    })
  }
);

if (!response.ok) {
  throw new Error(`Quoter v2 respondio ${response.status}`);
}

console.log(await response.json());

curl -X POST \
  "https://api.camtomx.com/api/v3/quoter_v2/new-quote?country_code=MEX&include_rrna=true" \
  -H "Authorization: Bearer sk_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": "import",
    "language": "Spanish",
    "products": [
      {
        "product_description": "Microfono alambrico para uso profesional",
        "hscode_8digits": "85181004",
        "country": "CHN"
      }
    ]
  }'

Respuesta

La respuesta es un arreglo. Cada posicion corresponde al producto enviado en la misma posicion.

array

Aranceles aplicables. Cada elemento incluye rate_type, rate, name, description y reason.

array

Impuestos aplicables, como IVA o IEPS.

array

Restricciones evaluadas y si aplican al producto.

string[]

Tratados comerciales relevantes para la operacion.

array

Notas legales o regulatorias con referencia, ley y detalle.

string

Unidad de medida aduanera.

string[]

Datos que pueden mejorar la precision del analisis.

boolean

Indica si el producto podria estar sujeto a IEPS.

array

Solo aparece cuando include_rrna=true y el analisis RRNA termina correctamente. Incluye nombre, clave, permiso o NOM, acotacion, razon, ambiguedades y applies.

Ejemplo abreviado

[
  {
    "tariffs": [
      {
        "rate_type": "percentage",
        "rate": 0.15,
        "name": "IGI",
        "description": "Impuesto General de Importacion",
        "reason": "Tarifa aplicable a la fraccion"
      }
    ],
    "taxes": [
      {
        "rate_type": "percentage",
        "rate": 0.16,
        "name": "IVA",
        "description": "Impuesto al Valor Agregado",
        "reason": "Importacion a Mexico"
      }
    ],
    "restrictions": [],
    "trade_agreements": [],
    "notes": [],
    "unit": "Pza",
    "suggestions": [],
    "ieps": false,
    "regulaciones_rrna": []
  }
]

Las tasas porcentuales usan formato decimal: 0.16 significa 16%.

Creditos

Productos	Costo
1	0.25 creditos
2	0.50 creditos
10	2.50 creditos
20	5.00 creditos

El cobro se realiza antes de procesar.
Si el procesamiento falla, los creditos se reembolsan.
include_rrna=true no agrega costo.
Las llamadas con API key siempre consumen creditos.

Errores

HTTP	Causa	Accion
`400`	Se enviaron 0 o mas de 20 productos	Envia entre 1 y 20 productos
`401`	API key ausente o invalida	Revisa `Authorization: Bearer ...`
`403`	Creditos insuficientes o acceso denegado	Revisa saldo y suscripcion
`422`	Body invalido	Revisa campos, tipos y valores permitidos
`500`	Error interno al generar la cotizacion	Reintenta con backoff; si persiste, contacta soporte

Recomendaciones

Envia una descripcion especifica: material, uso, composicion y presentacion.
Usa una fraccion de exactamente 8 digitos.
Conserva el orden del arreglo para relacionar cada respuesta con su producto.
Configura un timeout de al menos 180 segundos cuando uses include_rrna=true.
Reintenta solo errores 500 con backoff exponencial.

General

Autenticacion

Endpoints

Referencia

Quoter v2 API - Impuestos y regulaciones

Autenticacion

Query parameters

Body

Ejemplo

Respuesta

Ejemplo abreviado

Creditos

Errores

Recomendaciones

​Autenticacion

​Query parameters

​Body

​Ejemplo

​Respuesta

​Ejemplo abreviado

​Creditos

​Errores

​Recomendaciones

Autenticacion

Query parameters

Body

Ejemplo

Respuesta

Ejemplo abreviado

Creditos

Errores

Recomendaciones