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.
Tu certificado de firma .p12
Cargado en la cuenta de pruebas.
Tus datos de emisor
RUC, establecimiento y punto de emisión configurados en tu cuenta.
Paso 1 · Guarda tu API key
Crea una variable de entorno en tu terminal:
export FLASHPI_API_KEY="tu_api_key_de_pruebas"Paso 2 · Emite la factura
Una sola solicitud. Flashpi arma el XML, lo firma con tu certificado y lo envía al SRI.
curl -X POST https://api.flashpi.ec/v1/facturas \
-H "Authorization: Bearer $FLASHPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"comprador": {
"tipo_identificacion": "cedula",
"identificacion": "0102030405",
"razon_social": "Cliente de ejemplo",
"email": "[email protected]"
},
"detalles": [
{ "descripcion": "Servicio de ejemplo", "cantidad": 1, "precio_unitario": 25.00 }
]
}'Paso 3 · Lee la respuesta
Si todo sale bien, recibes el estado del comprobante:
{
"estado": "AUTORIZADO",
"clave_acceso": "(49 dígitos)",
"numero_autorizacion": "(número de autorización del SRI)",
"fecha_autorizacion": "(fecha y hora)"
}-
estado - Resultado del SRI para tu comprobante.
-
clave_acceso - Identificador único de 49 dígitos. Guárdala: la usarás para consultar el comprobante.
-
numero_autorizacionfecha_autorizacion - Datos de la autorización.
A veces el SRI aún está procesando y recibes esto:
{
"estado": "EN_PROCESAMIENTO",
"clave_acceso": "(49 dígitos)"
}No reenvíes el comprobante: consulta su estado en el paso siguiente.
Paso 4 · Consulta el estado
curl https://api.flashpi.ec/v1/comprobantes/CLAVE_DE_ACCESO \
-H "Authorization: Bearer $FLASHPI_API_KEY"Reemplaza CLAVE_DE_ACCESO por la que recibiste. Mira la referencia del endpoint.
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 |
422 Esquema XML | Algún campo no cumple la estructura esperada. | Lee el detalle del error y corrige el campo indicado. | Ver detalle |
SRI 39 | Firma inválida. | Vuelve a cargar tu .p12, confirma su clave y su vigencia. | Ver detalle |
SRI 43 | Clave de acceso ya registrada. | No reenvíes: consulta el estado del comprobante por su clave de acceso. | Ver detalle |