El reto de facturar en una clínica o consultorio
- Varias áreas facturan (consulta, laboratorio, farmacia) y todas deben quedar ordenadas.
- El pago suele dividirse entre el paciente y una aseguradora.
- El software clínico suele ser cerrado y difícil de adaptar.
- Se manejan datos sensibles: la facturación no debe exponerlos.
- Consulta, laboratorio y farmacia facturan desde el mismo sistema, por atención.
- Emites un comprobante a nombre de cada parte: paciente o aseguradora.
- Tu software se conecta por API, sin que cambies de sistema.
- La solicitud solo lleva datos de identificación y contacto, nunca información clínica.
Cómo lo resuelve Flashpi
- PASO 01
Conecta tu software de gestión
Usa tu API key desde el sistema que ya registra las atenciones.
sk_test_••••••••4f2a - PASO 02
Emite por atención
Envía los datos de facturación y Flashpi genera, firma y envía el comprobante al SRI.
POST /v1/facturas - PASO 03
Archiva y consulta
Recupera el XML y la autorización de cualquier comprobante cuando lo necesites.
XML + autorización
Ejemplo: factura de una consulta médica
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": "Consulta de medicina general",
"cantidad": 1,
"precio_unitario": 30.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": "Consulta de medicina general",
"cantidad": 1,
"precio_unitario": 30.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": "Consulta de medicina general",
"cantidad": 1,
"precio_unitario": 30.0
}
]
},
)
comprobante = res.json()<?php
$payload = <<<'JSON'
{
"comprador": {
"tipo_identificacion": "cedula",
"identificacion": "0102030405",
"razon_social": "Cliente de ejemplo",
"email": "[email protected]"
},
"detalles": [
{
"descripcion": "Consulta de medicina general",
"cantidad": 1,
"precio_unitario": 30.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
- Facturas electrónicas El comprobante principal de venta. API de facturas electrónicas
- Notas de crédito y débito Para devoluciones, descuentos posteriores y correcciones.
- Retenciones electrónicas Para las retenciones que tu clínica emite como agente de retención.
- Consulta de XML y autorización Para recuperar cualquier comprobante por su clave de acceso.
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#.
tu backend → Flashpi → SRI Preguntas frecuentes
¿Tienes otra pregunta sobre cómo facturar en tu clínica?
Escríbenos¿Puedo facturar a una aseguradora y a un paciente en la misma atención?
Puedes emitir comprobantes separados a nombre de cada parte, según corresponda. Confirma con tu contador cómo registrar el copago.
¿Se integra con mi sistema de historias clínicas?
Si tu sistema puede enviar solicitudes HTTP, o su proveedor puede integrarlo, sí. Revisa las integraciones para ERP y SaaS.
¿Cómo corrijo una factura ya emitida?
Emitiendo una nota de crédito que referencia la factura original. Mira la guía Cómo emitir y anular notas de crédito por API.
¿Qué datos del paciente se envían?
Para facturar solo se necesitan datos de identificación y contacto. No envíes información clínica en la solicitud.