Tu ERP ya maneja ventas, clientes e inventario. Lo que falta es el flujo del SRI: generar el XML, firmarlo, enviarlo y procesar la autorización.
Para quién es esta página
Equipos de desarrollo de ERP y software contable, y responsables técnicos de empresas con ERP propio.
¿Eres dueño de un negocio y buscas una solución para tu sector?
Lo que tendrás que resolver
Cada empresa que usa tu ERP tiene su propio RUC, su certificado y su numeración.
Cada comprobante debe quedar conciliado con su documento y su asiento contable.
Los cambios normativos del SRI no deberían obligarte a reprogramar tu ERP cada vez.
Cómo se integra con tu ERP
Tu software no necesita generar XML, firmarlo ni hablar con los servicios del SRI.
- 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 ERP | Comprobante |
|---|---|
| Venta confirmada o contabilizada | Factura |
| Devolución o descuento posterior | Nota de crédito |
| Pago a proveedor con retención | Retención |
| Compra a quien no emite factura | Liquidación de compra |
| Despacho de mercadería | Guía de remisión |
Mapeo de campos
| En tu ERP | En la API |
|---|---|
| Cliente (tipo de identificación, identificación, razón social, correo) | comprador |
| Líneas del documento | detalles |
| Documento de origen (en devoluciones) | documento_modificado |
| Documento sustento (en retenciones) | documento_sustento |
| Resultado | Guarda clave_acceso y estado en el documento del ERP |
Para mantener el estado al día sin consultar una y otra vez, recibe los webhooks:
// webhook-flashpi.mjs: actualiza el estado del comprobante en tu ERP
import express from "express";
const app = express();
app.use(express.json());
app.post("/webhooks/flashpi", async (req, res) => {
// 1. Verifica que la solicitud realmente viene de Flashpi.
const { clave_acceso, estado } = req.body;
// 2. Actualiza el documento del ERP que tenga esa clave de acceso
await actualizarEstadoComprobante(clave_acceso, estado);
// 3. Responde rápido: el trabajo pesado va a una cola
res.sendStatus(200);
});
async function actualizarEstadoComprobante(claveAcceso, estado) {
// Reemplaza por tu capa de acceso a datos
console.log("Comprobante", claveAcceso, "->", estado);
}
app.listen(3000);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 para tu ERP
- 1 Guarda la
clave_accesoEn el documento del ERP. Es la llave para consultas, reportes y auditoría. - 2 Emite fuera de la transacción de venta Usa una cola para que una lentitud del SRI no bloquee a tus usuarios. Mira colas y reintentos.
- 3 Evita duplicados Usa un identificador único por documento y, ante dudas, consulta el estado antes de reenviar.
- 4 Concilia a diario Consulta los comprobantes que sigan en
EN_PROCESAMIENTOy corrige los rechazados. - 5 Planifica la multiempresa Define cómo se asocia cada empresa de tu ERP con su certificado y su API key.
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 sobre la integración con ERP
¿Tengo que implementar XML y firma en mi ERP?
No. Tu ERP envía JSON y Flashpi arma el XML, lo firma con el certificado del emisor y lo envía al SRI.
¿Cómo manejo varias empresas en un mismo ERP?
Cada empresa necesita su certificado y su configuración de emisor.
¿Qué pasa si el SRI no responde?
Tu ERP no debe quedarse esperando. Encola el comprobante y reintenta. Mira Colas y reintentos.
¿Puedo probar antes de salir a producción?
Sí, con el ambiente de pruebas del SRI.