Comercio

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

POST /v1/aviso-operacionEjemplo de respuesta

{
  "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://api.istmobot.com/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.

Beta privada, sin costo.

Para negocios en Panamá.

Solicitar acceso