istmobot

API para documentos de Panamá

La API de istmobot recibe un documento panameño o un valor (como un CUFE) y devuelve sus datos en JSON con un esquema fijo por tipo de documento. Tiene keys de prueba con respuestas de ejemplo, webhooks firmados y un servidor MCP para agentes de IA.

Solicitar acceso Documentación

Dos formas de entrada

  • Documentos: POST /v1/{solucion} con el archivo en multipart/form-data. Responde 202 con un id; el resultado llega por webhook o con GET /v1/documentos/{id}.
  • Consultas: GET /v1/{solucion}/{valor}, por ejemplo una factura por su CUFE. Responde de inmediato.

Pensada para integrarse

  • Keys ib_test_ que devuelven datos de ejemplo sin consumir créditos, para desarrollar sin documentos reales.
  • Webhooks firmados con HMAC SHA-256 cuando un documento termina de procesarse.
  • Especificación OpenAPI pública para generar clientes.
  • Servidor MCP para conectar la API a Claude, Cursor o ChatGPT.
  • Descarga del resultado en Excel para quien no programa.

Validar, no solo leer

Algunas soluciones van más allá de leer el documento. La factura electrónica se consulta por CUFE y devuelve los datos tal como constan en la DGI. El comprobante Yappy se compara con los pagos que tu cuenta realmente recibió, si reenvías sus notificaciones a istmobot.

Una coincidencia confirma que existe un pago o una factura registrada con esos datos. No reemplaza tu propio criterio ante documentos sospechosos.

Documentos que procesa istmobot

Pagos

Comprobante Yappy

Extrae los datos del comprobante Yappy y verifica que el pago se recibió.

PDFImagenJSONExcel
Fiscal

Factura electrónica DGI

Consulta la factura electrónica en la DGI, por CUFE o desde el documento.

PDFImagenCUFEJSONExcel
Comercio

Aviso de Operación

Extrae los datos del Aviso de Operación.

PDFImagenJSONExcel
Identidad

Cédula panameña

Extrae los datos de la cédula panameña.

PDFImagenJSONExcel
Servicios

Recibo ENSA

Extrae los datos del recibo de ENSA.

PDFImagenJSONExcel
Servicios

Recibo Naturgy

Extrae los datos del recibo de Naturgy.

PDFImagenJSONExcel
Servicios

Recibo IDAAN

Extrae los datos del recibo de IDAAN.

PDFImagenJSONExcel
Vehículos

Estado de cuenta Panapass

Extrae los datos del estado de cuenta Panapass.

PDFImagenJSONExcel

Preguntas frecuentes

¿Existe una API para verificar comprobantes Yappy?

Sí. POST /v1/yappy con la captura devuelve los datos del comprobante y, si reenvías las notificaciones de Yappy a tu buzón de istmobot, si ese pago coincide con uno recibido.

¿Cómo consulto una factura electrónica por CUFE desde mi sistema?

Con GET /v1/factura/{cufe}. Devuelve emisor, receptor, ítems, ITBMS y total del registro de la DGI.

¿Puedo probar la API sin documentos reales?

Sí. Las keys ib_test_ responden con datos de ejemplo de cada solución y no consumen créditos.

¿Cómo sé cuándo terminó de procesarse un documento?

Por webhook (evento firmado) o consultando GET /v1/documentos/{id} hasta que su estado sea listo.

Guías relacionadas

Beta privada, sin costo.

Para negocios en Panamá.

Solicitar acceso