El reto de facturar en un gimnasio o centro de fitness
- Cobros mensuales repetidos que generan decenas o cientos de comprobantes.
- Altas y bajas constantes de socios.
- Planes con distintos precios y servicios adicionales.
- Empresas que pagan la membresía de sus empleados y piden factura corporativa.
- Cada cobro exitoso dispara la emisión de su factura, sin cargarla a mano.
- Las altas y bajas se reflejan en el siguiente cobro de tu sistema.
- Cada plan y servicio adicional va como un ítem del comprobante.
- La factura corporativa sale a nombre de la empresa, con sus datos de facturación.
Cómo lo resuelve Flashpi
- PASO 01
Conecta tu sistema de membresías
Usa tu API key desde el software que registra los cobros.
sk_test_••••••••4f2a - PASO 02
Emite al cobrar
Cada pago exitoso dispara la emisión del comprobante.
POST /v1/facturas - PASO 03
Entrega el comprobante
Recibe la autorización y envíalo al correo del socio.
RIDE.pdf + factura.xml
Ejemplo: factura de una membresía 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": "Membresía mensual - plan básico",
"cantidad": 1,
"precio_unitario": 35.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": "Membresía mensual - plan básico",
"cantidad": 1,
"precio_unitario": 35.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": "Membresía mensual - plan básico",
"cantidad": 1,
"precio_unitario": 35.0
}
]
},
)
comprobante = res.json() <?php
$payload = <<<'JSON'
{
"comprador": {
"tipo_identificacion": "cedula",
"identificacion": "0102030405",
"razon_social": "Cliente de ejemplo",
"email": "[email protected]"
},
"detalles": [
{
"descripcion": "Membresía mensual - plan básico",
"cantidad": 1,
"precio_unitario": 35.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 tus membresías?
Escríbenos¿Se factura al cobrar o al inicio del mes?
Depende de tu modelo de cobro. La API emite cuando tu sistema envía la solicitud, así que puedes elegir el momento. Confirma con tu contador.
¿Qué pasa si un socio cancela?
Si ya se emitió la factura, se corrige con una nota de crédito que la referencia.
¿Puedo facturar a una empresa que paga la membresía de sus empleados?
Sí, emitiendo la factura a nombre de la empresa con sus datos de facturación.
¿Funciona con mi software de gestión?
Si tu software puede enviar solicitudes HTTP, o su proveedor puede integrarlo, sí. Revisa la integración para SaaS.