El reto de facturar en una institución educativa o academia
- Facturación recurrente cada mes por las pensiones.
- Picos de volumen al inicio de cada periodo, con cientos de comprobantes.
- La factura puede ir a nombre del representante o de una empresa.
- Los cursos online se pagan al instante y el estudiante espera su comprobante.
- Las pensiones del mes se emiten desde tu sistema, una por estudiante.
- Las matrículas del periodo se envían por API, sin cargarlas a mano.
- Cada factura sale a nombre del representante o de la empresa que paga.
- En cursos online, el comprobante se emite en cuanto se confirma el pago.
Cómo lo resuelve Flashpi
- PASO 01
Conecta tu plataforma
Usa tu API key desde el sistema que gestiona matrículas y cobros.
sk_test_••••••••4f2a - PASO 02
Emite al registrar el pago
Envía los datos del pago y Flashpi genera y firma el comprobante.
POST /v1/facturas - PASO 03
Entrega el comprobante
Recibe la autorización y envíalo al representante o al estudiante.
RIDE.pdf + factura.xml
Ejemplo: factura de una pensión mensual
Una sola solicitud a la API. Flashpi construye el XML, lo firma con tu certificado y lo envía al SRI.
- Sin armar XML ni SOAP
- Firma con tu certificado .p12
- Estado y clave de acceso en la respuesta
curl -X POST https://api.flashpi.ec/v1/facturas \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"comprador": {
"tipo_identificacion": "cedula",
"identificacion": "0102030405",
"razon_social": "Cliente de ejemplo",
"email": "[email protected]"
},
"detalles": [
{
"descripcion": "Pensión mensual - octubre",
"cantidad": 1,
"precio_unitario": 120.0
}
]
}' const res = await fetch("https://api.flashpi.ec/v1/facturas", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.FLASHPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"comprador": {
"tipo_identificacion": "cedula",
"identificacion": "0102030405",
"razon_social": "Cliente de ejemplo",
"email": "[email protected]"
},
"detalles": [
{
"descripcion": "Pensión mensual - octubre",
"cantidad": 1,
"precio_unitario": 120.0
}
]
}),
});
const comprobante = await res.json(); import os
import requests
res = requests.post(
"https://api.flashpi.ec/v1/facturas",
headers={"Authorization": f"Bearer {os.environ['FLASHPI_API_KEY']}"},
json={
"comprador": {
"tipo_identificacion": "cedula",
"identificacion": "0102030405",
"razon_social": "Cliente de ejemplo",
"email": "[email protected]"
},
"detalles": [
{
"descripcion": "Pensión mensual - octubre",
"cantidad": 1,
"precio_unitario": 120.0
}
]
},
)
comprobante = res.json() <?php
$payload = <<<'JSON'
{
"comprador": {
"tipo_identificacion": "cedula",
"identificacion": "0102030405",
"razon_social": "Cliente de ejemplo",
"email": "[email protected]"
},
"detalles": [
{
"descripcion": "Pensión mensual - octubre",
"cantidad": 1,
"precio_unitario": 120.0
}
]
}
JSON;
$ch = curl_init('https://api.flashpi.ec/v1/facturas');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('FLASHPI_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
]);
$comprobante = json_decode(curl_exec($ch), true); {
"estado": "AUTORIZADO",
"clave_acceso": "(49 dígitos)",
"numero_autorizacion": "(nº del SRI)",
"fecha_autorizacion": "(fecha y hora)"
} Comprobantes que más usarás
Compatible con tu software
Flashpi es una API REST: funciona con cualquier lenguaje o framework que pueda enviar solicitudes HTTP. Tenemos ejemplos por lenguaje para Java, Node, Python, Ruby, PHP, Go y C#.
Preguntas frecuentes
¿Tienes otra pregunta sobre cómo facturar matrículas y pensiones?
Escríbenos¿A nombre de quién se factura una pensión?
A nombre de quien debe constar como comprador, por lo general el representante. Confirma con tu contador.
¿Se pueden emitir cientos de facturas al inicio del periodo?
Sí, pero te recomendamos diseñar la emisión con colas y reintentos. Mira Cómo manejar colas de trabajo y reintentos.
¿Cómo corrijo un error en una matrícula facturada?
Con una nota de crédito que referencia la factura original, y luego emitiendo la factura correcta.
¿Funciona con mi plataforma de cursos?
Si tu plataforma puede enviar solicitudes HTTP desde su backend, sí. Revisa las integraciones para SaaS y CMS.