istmobot
Soluciones
Fiscal

Consulta la factura electrónica por CUFE

Pega el CUFE o sube la factura y recibe los datos del registro oficial de la DGI, no los del papel.

  • Por CUFE o subiendo la factura.
  • Datos tal como constan en la DGI.
Entrada
PDF, foto o valor
Respuesta
JSON · Excel
Costo
2 créditos
POST /v1/facturaEjemplo de respuesta
{
  "cufe": "FE0120000000000-0-000000-0000002026010100000000000000000000000000000000",
  "numero": "0000001234",
  "protocolo": "20260000000000000001",
  "fecha_emision": "2026-09-10T10:15:00-05:00",
  "fecha_autorizacion": "2026-09-10T10:15:20-05:00",
  "emisor": {
    "nombre": "DISTRIBUIDORA ISTMO S.A.",
    "ruc": "155612345-2-2019",
    "dv": "45",
    "direccion": "Vía España, Panamá",
    "telefono": "300-0000"
  },
  "receptor": {
    "nombre": "Cliente Ejemplo",
    "ruc": "8-123-456",
    "dv": "12",
    "direccion": "PANAMA"
  },
  "items": [
    {
      "descripcion": "Servicio de consultoría",
      "codigo": null,
      "cantidad": 1,
      "precio_unitario": 100,
      "descuento": 0,
      "itbms": 7,
      "total": 107
    }
  ],
  "subtotal": 100,
  "itbms": 7,
  "total": 107,
  "metodo_pago": "Crédito",
  "fuente": "dgi",
  "consultado_en": "2026-09-17T12:00:00-05:00"
}

Qué devuelve

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

CampoTipoDescripción
cufestringCódigo Único de Factura Electrónica (DGI)
numerostring | null
protocolostring | nullProtocolo de autorización DGI
fecha_emisionstring | nullISO 8601, hora de Panamá
fecha_autorizacionstring | nullISO 8601, hora de Panamá
emisor.nombrestring | null
emisor.rucstring | null
emisor.dvstring | null
emisor.direccionstring | null
emisor.telefonostring | null
receptor.nombrestring | null
receptor.rucstring | null
receptor.dvstring | null
receptor.direccionstring | null
items[]array
items[].descripcionstring
items[].codigostring | nullCódigo o referencia de la línea según el emisor
items[].cantidadnumber
items[].precio_unitarionumber
items[].descuentonumber
items[].itbmsnumberImpuesto de la línea
items[].totalnumber
subtotalnumber | null
itbmsnumber | null
totalnumber | null
metodo_pagostring | null
fuente"dgi"Los datos vienen del registro oficial de la DGI, no del papel
consultado_enstring

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/factura \
  -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

Preguntas frecuentes

¿Qué es el CUFE de una factura electrónica?

Es el Código Único de Factura Electrónica que la DGI asigna a cada factura autorizada en Panamá. Empieza por FE y viene impreso en el documento.

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

Escribe el CUFE en el panel o llama a GET /v1/factura/{cufe}. Si no tienes el CUFE a mano, sube el PDF o la foto y se lee del documento.

¿Los datos salen del documento o de la DGI?

De la DGI. El campo fuente indica dgi: emisor, receptor, ítems, ITBMS y total tal como constan en el registro oficial.

¿Detecta facturas falsas o modificadas?

Si el CUFE no existe en la DGI, no hay respuesta válida. Si existe, comparas lo que dice el papel con lo que devuelve el registro.

¿Devuelve el detalle de los ítems?

Sí: descripción, código, cantidad, precio unitario, descuento, ITBMS y total por línea, además de subtotal, ITBMS y total de la factura.

Beta privada, sin costo.

Para negocios en Panamá.

Solicitar acceso