Flashpi 01
Multi-cliente: cada cliente de tu SaaS tiene su RUC, su certificado y su numeración.
Para quién es esta página
Equipos de producto y de ingeniería de plataformas SaaS, marketplaces y software por suscripción.
¿Tienes un negocio de educación, eventos, gimnasio o clínica?
El reto
Lo que tendrás que resolver
02
Onboarding sin fricción: tus clientes deben subir su certificado desde tu pantalla, sin salir de tu producto.
03
Escala: el volumen crece con cada cliente nuevo y con los picos de cada uno.
04
Tu marca: la facturación debe sentirse parte de tu producto, no un servicio externo.
Cómo se integra
Cómo se integra con tu SaaS
Tu software no necesita generar XML, firmarlo ni hablar con los servicios del SRI.
SaaS SaaS y marketplaces
API Flashpi XML · firma · envío
SRI Recepción y autorización
- 01 Conecta Genera tu API key y úsala solo desde tu backend.
- 02 Engánchate al evento correcto Cuando ocurra en tu sistema, envía los datos a Flashpi.
- 03 Guarda el resultado Registra la
clave_accesoy el estado en tu documento. - 04 Mantén el estado al día Recibe webhooks o consulta el comprobante cuando lo necesites.
En qué momento emitir cada comprobante
| Evento en tu SaaS | Comprobante |
|---|---|
| Pago de una suscripción o compra | Factura |
| Reembolso o cancelación | Nota de crédito |
| Compra a un proveedor sin factura | Liquidación de compra |
Un cliente de la API por tenant
El patrón es sencillo: guardas la configuración de Flashpi de cada cliente y creas un cliente de la API por solicitud.
// Un cliente de Flashpi por cada cliente (tenant) de tu SaaS
export function flashpiPara(tenant) {
const baseUrl = "https://api.flashpi.ec/v1";
const headers = {
Authorization: `Bearer ${tenant.flashpiApiKey}`,
"Content-Type": "application/json",
};
return {
async emitirFactura(factura) {
const res = await fetch(`${baseUrl}/facturas`, {
method: "POST",
headers,
body: JSON.stringify(factura),
});
const data = await res.json();
if (!res.ok) {
throw new Error(`Flashpi ${res.status}: ${JSON.stringify(data)}`);
}
return data;
},
};
}Para el onboarding, tu backend sube el certificado del cliente:
# Onboarding: tu cliente sube su certificado desde tu propia pantalla
# y tu backend lo envía a Flashpi con la API key de ese cliente.
curl -X POST https://api.flashpi.ec/v1/certificados \
-H "Authorization: Bearer $API_KEY_DEL_CLIENTE" \
-F "[email protected]" \
-F "clave=$CLAVE_DEL_P12"El ejemplo supone una API key por cliente.
Respuesta esperada al emitir:
{
"estado": "AUTORIZADO",
"clave_acceso": "(49 dígitos)",
"numero_autorizacion": "(número de autorización del SRI)",
"fecha_autorizacion": "(fecha y hora)"
} Buenas prácticas
Buenas prácticas para tu SaaS
- 1 Nunca guardes el .p12 de tus clientes en tu base de datos Sin cifrado ni gestión de secretos. Mira Almacenamiento seguro de archivos .p12.
- 2 Aísla a cada cliente Una falla o un pico de uno no debe afectar a los demás.
- 3 Usa webhooks Para actualizar el estado en tu producto sin consultar constantemente.
- 4 Avisa antes del vencimiento Del certificado de cada cliente.
- 5 Ofrece un ambiente de pruebas A tus clientes antes de activarles la facturación real.
Incluido
Lo que Flashpi te da
- API REST con JSON Versionada en /v1 y descrita con OpenAPI 3.1. Ver referencia
- Ambiente de pruebas del SRI Valida tu integración antes de producción. Cómo probarlo
- Colección de Postman Para explorar los endpoints.
- SDKs open source en GitHub
- Webhooks Para recibir el estado de cada comprobante.
- Ejemplos por lenguaje y soporte técnico
- Estado del servicio en tiempo real status.flashpi.ec
Preguntas frecuentes
Preguntas sobre la integración con SaaS
¿Cómo manejo a mis clientes, cada uno con su RUC?
Cada cliente se configura como un emisor con su certificado y su numeración.
¿Mis clientes pueden subir su certificado desde mi producto?
Sí. Tu backend recibe el archivo y lo envía a Flashpi. Mira cómo cargar un .p12 por API.
¿Soporta mucho volumen?
Diseña tu integración con colas y reintentos, y habla con nuestro equipo sobre tu volumen esperado.
¿Puedo ofrecerlo con mi marca?
La experiencia de usuario es tuya: la API trabaja en segundo plano.