Recibo ENSA

POST/v1/recibo-ensa2 créditosServiciosv1.0.0

Extrae los datos del recibo de ENSA.

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/recibo-ensa \
  -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/recibo-ensa", {
  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
`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

Ejemplo

{
  "data": {
    "proveedor": "ensa",
    "servicio": "electricidad",
    "numero_cliente": "1234567",
    "numero_medidor": "E12345678",
    "titular": "MARÍA PÉREZ GONZÁLEZ",
    "direccion": "CALLE 50, EDIF. TORRE AZUL, APTO 12B",
    "provincia": "PANAMÁ",
    "distrito": "PANAMÁ",
    "corregimiento": "BELLA VISTA",
    "fecha_emision": "2026-03-15",
    "periodo_desde": "2026-02-12",
    "periodo_hasta": "2026-03-13"
  },
  "meta": {
    "request_id": "req_3f9c2a",
    "credits_used": 2,
    "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