Antes de empezar
Una API key de pruebas de Flashpi
Y tu certificado .p12 cargado en esa cuenta.
Haber emitido al menos una factura
Con el quickstart de Flashpi.
Paso 1 · Entiende qué es el ambiente de pruebas
Es una copia del flujo del SRI donde los comprobantes no tienen validez tributaria. Sirve para equivocarte sin consecuencias. Usa siempre una API key de pruebas y nunca mezcles datos reales de clientes si no es necesario.
Paso 2 · Configura tu entorno
Mantén dos configuraciones separadas, una para pruebas y otra para producción:
# .env.pruebas
FLASHPI_API_KEY=tu_api_key_de_pruebas
# .env.produccion
FLASHPI_API_KEY=tu_api_key_de_produccionTu código debe leer la key desde el entorno. Así pasar a producción es cambiar una variable, no el código.
Paso 3 · Prueba estos casos
| Caso | Qué verificas |
|---|---|
| Factura a consumidor final | Que se autoriza con los datos mínimos. |
| Factura a una persona con cédula | Que valida la identificación. |
| Factura a una empresa con RUC | Que valida el RUC. |
| Factura con varios ítems | Que los totales cuadran. |
| Nota de crédito sobre una factura | Que referencia bien el documento original. |
| Un comprobante rechazado a propósito | Que tu sistema muestra el error y no se queda colgado. |
| Respuesta EN_PROCESAMIENTO | Que consultas el estado en lugar de reenviar. |
| El mismo pedido enviado dos veces | Que no generas comprobantes duplicados. |
Paso 4 · Provoca errores a propósito
Envía una identificación inválida, un campo obligatorio vacío y un total mal calculado. Confirma que tu sistema captura el error, lo registra y avisa al usuario. Consulta el catálogo de errores para saber qué esperar.
Paso 5 · Revisa el checklist antes de producción
- Certificado .p12 de producción cargado y vigente.
- API key de producción configurada solo en el entorno de producción.
- Establecimiento, punto de emisión y secuenciales revisados.
- Manejo de reintentos sin duplicar comprobantes.
- Registro (logs) de cada solicitud y de cada clave de acceso.
- Alerta si el SRI no responde o rechaza muchos comprobantes.
- Prueba final con una factura real de bajo valor.
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 43 | Clave de acceso ya registrada. | No reenvíes: consulta el estado del comprobante por su clave de acceso. | Ver detalle |
SRI 70 | Clave de acceso en procesamiento. | Espera unos segundos y consulta el estado. No reenvíes el comprobante. | Ver detalle |