Antes de empezar
Tu archivo .p12 vigente y su clave
Una API key de pruebas de Flashpi
Paso 1 · Revisa tu certificado
Antes de subirlo, confirma que el archivo es el .p12 que te entregó la entidad certificadora, que no esté vencido y que conoces su clave.
Un certificado vencido es la causa más común de firmas inválidas.
Paso 2 · Súbelo a tu cuenta
curl -X POST https://api.flashpi.ec/v1/certificados \
-H "Authorization: Bearer $FLASHPI_API_KEY" \
-F "[email protected]" \
-F "clave=$CLAVE_DEL_P12"Guarda la clave en una variable de entorno o en un gestor de secretos. No la escribas en el comando ni en tu historial de terminal.
Paso 3 · Verifica que quedó cargado
curl https://api.flashpi.ec/v1/certificados \
-H "Authorization: Bearer $FLASHPI_API_KEY"Deberías ver el titular del certificado y su fecha de vencimiento. Anota esa fecha en tu calendario para renovarlo a tiempo.
Paso 4 · Emite un comprobante firmado
Emite una factura de prueba como en el quickstart. Si la respuesta es AUTORIZADO, la firma es válida.
Paso 5 · Cuida tu certificado
- Nunca subas el .p12 ni su clave a un repositorio.
- Úsalo solo desde tu backend.
- Renueva antes del vencimiento.
- Para entender cómo se protege en la nube, lee Almacenamiento seguro de archivos .p12.
Errores frecuentes
| Síntoma | Causa probable | Qué hacer | Referencia |
|---|---|---|---|
SRI 39 | Firma inválida. | Vuelve a cargar tu .p12, confirma su clave y su vigencia. | Ver detalle |
SRI 35 | El archivo no cumple la estructura XML. | Revisa los campos obligatorios y sus formatos. | Ver detalle |
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 |