Antes de empezar

Una API key de pruebas de Flashpi

Guárdala en una variable de entorno, nunca en el código ni en el repositorio.

Solicítala aquí

Tu certificado de firma .p12

Cargado en la cuenta de pruebas.

Cargar el certificado

Tus datos de emisor

RUC, establecimiento y punto de emisión configurados en tu cuenta.

La clave de acceso del comprobante

49 dígitos.

Paso 1 · Entiende la clave de acceso

Es el identificador único de 49 dígitos de cada comprobante electrónico. Se genera al emitirlo y te la devuelve la API. Si quieres saber cómo se forma, lee La clave de acceso del SRI.

Paso 2 · Consulta el estado y la autorización

bashGET /v1/comprobantes/{clave}

curl https://api.flashpi.ec/v1/comprobantes/CLAVE_DE_ACCESO \
  -H "Authorization: Bearer $FLASHPI_API_KEY"

Respuesta:

json200 OK · comprobante autorizado

{
  "estado": "AUTORIZADO",
  "clave_acceso": "(49 dígitos)",
  "numero_autorizacion": "(número de autorización del SRI)",
  "fecha_autorizacion": "(fecha y hora)"
}

Paso 3 · Descarga el XML autorizado

bashGET /v1/comprobantes/{clave}/xml

curl https://api.flashpi.ec/v1/comprobantes/CLAVE_DE_ACCESO/xml \
  -H "Authorization: Bearer $FLASHPI_API_KEY" \
  -o comprobante.xml

Guarda el archivo junto a la operación en tu sistema. El XML autorizado es el comprobante válido.

Paso 4 · Casos de uso comunes

Reenviar el comprobante al correo de un cliente que lo perdió.
Auditoría: verificar que todos tus comprobantes están autorizados.
Conciliación contable: cruzar tus ventas contra lo autorizado.
Soporte: revisar el estado de un documento reportado por un cliente.

Errores frecuentes

Síntoma	Causa probable	Qué hacer	Referencia
`401 Unauthorized`	API key ausente, inválida o de otro ambiente.	Revisa el header `Authorization` y que uses la key del ambiente correcto.	Ver detalle
`SRI 70`	Clave de acceso en procesamiento.	Espera unos segundos y consulta el estado. No reenvíes el comprobante.	Ver detalle

Siguientes pasos

Referencia: consultar estado Documentación de la API. Referencia: consultar XML Documentación de la API. Servicio de consulta de XML y autorización Conoce el servicio.

Cómo consultar el XML y la autorización de un comprobante por clave de acceso