Aviso de Operación

POST/v1/aviso-operacion3 créditosComerciov1.0.0

Extrae los datos del Aviso de Operación.

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://api.istmobot.com/v1/aviso-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://api.istmobot.com/v1/aviso-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_aviso`	`string \| null`	Número de Aviso de Operación: RUC o cédula + año + secuencia, ej. 8-954-1813-2026-574436816
`tipo_persona`	`"natural" \| "juridica" \| null`	natural (cédula, titular declarante) o juridica (sociedad con RUC y representante legal)
`razon_social`	`string \| null`	Sociedad titular; en persona natural, nombre completo del titular
`nombre_comercial`	`string \| null`	Nombre del establecimiento (Razón Comercial)
`ruc`	`string \| null`	RUC tal como aparece, ej. 155612345-2-2019. En persona natural coincide con la cédula
`dv`	`string \| null`	Dígito verificador del RUC, 1 o 2 dígitos
`cedula`	`string \| null`	Cédula del titular (solo persona natural), ej. 8-954-1813
`nacionalidad`	`string \| null`	Nacionalidad del declarante, ej. Panameño. Solo en el aviso (no en la certificación)
`representante_legal`	`string \| null`	Representante legal (solo persona jurídica)
`actividades[]`	`array`	Actividades declaradas, con código CIIU cuando lo trae el documento
`actividades[].codigo`	`string \| null`	Código CIIU de la actividad, ej. 6202. null si el documento no lo trae
`actividades[].descripcion`	`string`	Descripción de la actividad tal como aparece
`capital_invertido`	`number \| null`	Capital invertido en balboas (B/.)
`domicilio_declarante`	`string \| null`	Domicilio del declarante tal como aparece (provincia, distrito, corregimiento, resto). Solo en el aviso
`direccion`	`string \| null`	Dirección del establecimiento (calle, casa, urbanización) sin provincia/distrito/corregimiento cuando vienen aparte
`provincia`	`string \| null`	Provincia del establecimiento, ej. PANAMÁ
`distrito`	`string \| null`	Distrito del establecimiento, ej. PANAMÁ
`corregimiento`	`string \| null`	Corregimiento del establecimiento, ej. PARQUE LEFEVRE
`fecha_inicio_operacion`	`string \| null`	Fecha de inicio de operaciones, yyyy-mm-dd
`fecha_emision`	`string \| null`	Fecha de expedición del documento, yyyy-mm-dd. Solo en la certificación
`telefono`	`string \| null`	Teléfono del declarante, ej. 61546401
`correo`	`string \| null`	Correo electrónico si aparece
`codigo_verificacion`	`string \| null`	No. de Control de la certificación, ej. 2026-18428662

Ejemplo

{
  "data": {
    "numero_aviso": "155612345-2-2019-2019-612345",
    "tipo_persona": "juridica",
    "razon_social": "CAFÉ ISTMO, S.A.",
    "nombre_comercial": "Café Istmo",
    "ruc": "155612345-2-2019",
    "dv": "45",
    "cedula": null,
    "nacionalidad": null,
    "representante_legal": "María Elena Quintero Ríos",
    "actividades": [
      {
        "codigo": "5610",
        "descripcion": "Actividades de restaurantes y de servicio móvil de comidas"
      },
      {
        "codigo": "4721",
        "descripcion": "Venta al por menor de café, té y productos de panadería"
      }
    ],
    "capital_invertido": 10000,
    "domicilio_declarante": null,
    "direccion": "Calle 50, Edificio Istmo Plaza, local 3",
    "provincia": "PANAMÁ",
    "distrito": "PANAMÁ",
    "corregimiento": "BELLA VISTA",
    "fecha_inicio_operacion": "2019-03-15",
    "fecha_emision": "2026-09-18",
    "telefono": "61234567",
    "correo": null,
    "codigo_verificacion": "2026-18500001"
  },
  "meta": {
    "request_id": "req_3f9c2a",
    "credits_used": 3,
    "plugin_version": "1.0.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