Servicios

Extrae los datos del recibo IDAAN

El recibo de agua que te manda el cliente como prueba de dirección, convertido en campos: NIC, titular, dirección y periodo.

Solicitar acceso Referencia API

Entrada: PDF o foto
Respuesta: JSON · Excel
Costo: 2 créditos

POST /v1/recibo-idaanEjemplo de respuesta

{
  "proveedor": "idaan",
  "servicio": "agua",
  "numero_cliente": "0012345678",
  "numero_medidor": "A-778899",
  "titular": "ROSA ELENA MORALES DE CASTILLO",
  "direccion": "VÍA ESPAÑA, CASA 23, EL CARMEN",
  "provincia": "PANAMÁ",
  "distrito": "PANAMÁ",
  "corregimiento": "BELLA VISTA",
  "fecha_emision": "2026-04-01",
  "periodo_desde": "2026-03-01",
  "periodo_hasta": "2026-03-31"
}

Qué devuelve

Siempre los mismos campos. Lo que no aparece en el documento llega como null.

Campo	Tipo	Descripción
proveedor	"ensa" \| "naturgy" \| "idaan"	Empresa que emite el recibo
servicio	"electricidad" \| "agua"	Servicio facturado
numero_cliente	string \| null	Identificador del suministro: NIS (ENSA/Naturgy) o NIC (IDAAN)
numero_medidor	string \| null	Número del medidor
titular	string \| null	Nombre del titular del servicio, tal como aparece en el recibo
direccion	string \| null	Dirección del suministro
provincia	string \| null	Provincia, solo si el recibo la separa
distrito	string \| null	Distrito, solo si el recibo lo separa
corregimiento	string \| null	Corregimiento, solo si el recibo lo separa
fecha_emision	string \| null	Fecha de emisión, yyyy-mm-dd
periodo_desde	string \| null	Inicio del período facturado, yyyy-mm-dd
periodo_hasta	string \| null	Fin del período facturado, yyyy-mm-dd

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/recibo-idaan \
  -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, cooperativas y financieras que piden comprobante de domicilio.
Alquileres, telefonía e internet que validan la dirección del cliente.
Equipos de cumplimiento que revisan expedientes KYC.

Preguntas frecuentes

¿Qué datos extrae del recibo IDAAN?

NIC, número de medidor, titular, dirección, provincia, distrito y corregimiento cuando vienen separados, fecha de emisión y periodo facturado.

¿Extrae el monto a pagar?

No. Está pensado como comprobante de domicilio: identifica al titular y la dirección, no los montos.

¿Sirve para validar comprobante de domicilio?

Sí. Te da titular y dirección para compararlos con lo que declaró el cliente, y la fecha para saber si el recibo es reciente.

¿Acepta foto o solo PDF?

Ambos: PDF descargado del IDAAN o foto del recibo impreso, en JPEG, PNG o WEBP.

¿Y si el recibo es de ENSA o Naturgy?

Hay una solución para cada uno: recibo ENSA y recibo Naturgy, con los mismos campos.

Beta privada, sin costo.

Para negocios en Panamá.

Solicitar acceso