Integración · ERP y software contable

API de facturación electrónica para ERP y software contable

Agrega facturación electrónica a tu ERP o software contable sin construir el flujo del SRI desde cero.

EVENTOS EN TU ERP→ comprobante

Venta confirmada Factura

Pago a proveedor Retención

Despacho de mercadería Guía de remisió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?

El reto

Lo que tendrás que resolver

01

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.

02

Cada empresa que usa tu ERP tiene su propio RUC, su certificado y su numeración.

03

Cada comprobante debe quedar conciliado con su documento y su asiento contable.

04

Los cambios normativos del SRI no deberían obligarte a reprogramar tu ERP cada vez.

Cómo se integra

Cómo se integra con tu ERP

Tu software no necesita generar XML, firmarlo ni hablar con los servicios del SRI.

  1. 01 Conecta Genera tu API key y úsala solo desde tu backend.
  2. 02 Engánchate al evento correcto Cuando ocurra en tu sistema, envía los datos a Flashpi.
  3. 03 Guarda el resultado Registra la clave_acceso y el estado en tu documento.
  4. 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 ERPComprobante
Venta confirmada o contabilizadaFactura
Devolución o descuento posteriorNota de crédito
Pago a proveedor con retenciónRetención
Compra a quien no emite facturaLiquidación de compra
Despacho de mercaderíaGuía de remisión

Mapeo de campos

En tu ERPEn la API
Cliente (tipo de identificación, identificación, razón social, correo)comprador
Líneas del documentodetalles
Documento de origen (en devoluciones)documento_modificado
Documento sustento (en retenciones)documento_sustento
ResultadoGuarda 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:

jswebhook-flashpi.mjs
// 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:

json200 OK · comprobante autorizado
{
  "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 ERP

  1. 1 Guarda la clave_acceso En el documento del ERP. Es la llave para consultas, reportes y auditoría.
  2. 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. 3 Evita duplicados Usa un identificador único por documento y, ante dudas, consulta el estado antes de reenviar.
  4. 4 Concilia a diario Consulta los comprobantes que sigan en EN_PROCESAMIENTO y corrige los rechazados.
  5. 5 Planifica la multiempresa Define cómo se asocia cada empresa de tu ERP con su certificado y su API key.
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 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.

Empieza hoy

Integra tu ERP con el SRI

Prueba la API en el ambiente de pruebas y cuéntanos tu caso. Te ayudamos a planear la integración.