Extrae los datos del Aviso de Operación
El PDF del Aviso de Operación o de su certificación, convertido en los campos que tu sistema necesita.
- Entrada
- PDF o foto
- Respuesta
- JSON · Excel
- Costo
- 3 créditos
{ "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" }
Qué devuelve
Siempre los mismos campos. Lo que no aparece en el documento llega 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 |
Cómo usarla
Plataforma
Sube el archivo y ve el resultado. Descárgalo en Excel. Sin código.
API
curl -X POST https://www.istmobot.com/api/v1/aviso-operacion \ -H "Authorization: Bearer ib_live_..." \ -F "file=@documento.pdf"
Respuesta 202 con un id; el resultado llega por webhook o consultando el id. Referencia completa.
Para quién
- Bancos y fintech que abren cuentas empresariales y piden el aviso al cliente.
- Proveedores y marketplaces que dan de alta comercios.
- Firmas legales y contables que registran clientes nuevos.
Preguntas frecuentes
¿Qué datos extrae del Aviso de Operación?
Número de aviso, tipo de persona, razón social, nombre comercial, RUC y DV, cédula o representante legal, actividades con código CIIU, capital, dirección y fecha de inicio.
¿Sirve con la certificación del Aviso de Operación?
Sí. Acepta el aviso original y su certificación; algunos campos solo existen en uno de los dos.
¿Distingue persona natural de sociedad?
Sí. tipo_persona indica natural o juridica, y según el caso devuelve la cédula del titular o el representante legal.
¿Valida el aviso contra PanamaEmprende?
No. Lee lo que dice el documento y lo estructura. La verificación en el registro oficial sigue siendo tuya.
¿Puedo descargar los datos en Excel?
Sí. Desde el panel, cada documento se descarga en Excel además del JSON.
istmobot