Certificado de Operación ATTT

POST/v1/certificado-operacion2 créditosVehículosv0.1.0

Extrae los datos del certificado de operación (cupo) de transporte de la ATTT.

Petición

multipart/form-data con un solo campo:

Campo	Tipo	Descripción
`file`	archivo	JPEG, PNG, WEBP, GIF o PDF. Máximo 10 MB. Obligatorio.

curl

curl https://www.istmobot.com/api/v1/certificado-operacion \
  -H "Authorization: Bearer ib_live_..." \
  -F file=@documento.png

JavaScript

const form = new FormData();
form.append("file", fileBlob, "documento.png");
const res = await fetch("https://www.istmobot.com/api/v1/certificado-operacion", {
  method: "POST",
  headers: { Authorization: "Bearer ib_live_..." },
  body: form,
});
const { data, meta } = await res.json();

Respuesta

200 con data según la tabla y meta (request_id, credits_used, plugin_version, sandbox). Campos ausentes en el documento llegan como null.

Campo	Tipo	Descripción
`numero`	`string \| null`	Número del certificado de operación o cupo
`titular`	`string \| null`	Concesionario o propietario del cupo
`cedula_ruc`	`string \| null`	Cédula o RUC del titular
`placa`	`string \| null`	Placa del vehículo
`marca`	`string \| null`	Marca del vehículo
`modelo`	`string \| null`	Modelo del vehículo
`anio`	`number \| null`	Año del vehículo
`tipo_servicio`	`string \| null`	Tipo de servicio, ej. Taxi, Carga, Turismo, Colectivo
`ruta`	`string \| null`	Ruta o zona autorizada
`organizacion`	`string \| null`	Cooperativa u organización transportista
`fecha_expedicion`	`string \| null`	Fecha de expedición, yyyy-mm-dd
`fecha_vencimiento`	`string \| null`	Fecha de vencimiento, yyyy-mm-dd
`vigente`	`boolean \| null`	true si la fecha de vencimiento no ha pasado

Ejemplo

{
  "data": {
    "numero": "CO-8-12345",
    "titular": "TRANSPORTES DEL ISTMO, S.A.",
    "cedula_ruc": "2345678-1-2020",
    "placa": "AB1234",
    "marca": "HINO",
    "modelo": "500",
    "anio": 2022,
    "tipo_servicio": "Carga",
    "ruta": "Panamá - Colón",
    "organizacion": null,
    "fecha_expedicion": "2025-01-15",
    "fecha_vencimiento": "2030-01-15",
    "vigente": true
  },
  "meta": {
    "request_id": "req_3f9c2a",
    "credits_used": 2,
    "plugin_version": "0.1.0",
    "sandbox": false
  }
}

Con una key ib_test_ recibes exactamente este data con credits_used: 0 y sandbox: true.

Errores

401 key inválida · 402 sin créditos · 422 entrada inválida o extracción fallida · 429 rate limit. Formato en Errores.

Ver la solución · Probar en el explorador