Flashpi 01
El folio concentra cargos de varias áreas (habitación, restaurante, servicios) en una sola cuenta.
Para quién es esta página
Proveedores de software hotelero (PMS) y equipos técnicos de cadenas o establecimientos con sistema propio.
¿Tienes un hotel o alojamiento?
El reto
Lo que tendrás que resolver
02
A veces hay que dividir la cuenta entre el huésped y una empresa o agencia.
03
Hay huéspedes nacionales, extranjeros y empresas, con tipos de identificación distintos.
04
El check-out debe ser rápido, con la fila esperando en recepción.
05
Después del check-out pueden aparecer correcciones.
Cómo se integra
Cómo se integra con tu PMS
Tu software no necesita generar XML, firmarlo ni hablar con los servicios del SRI.
PMS Software hotelero
API Flashpi XML · firma · envío
SRI Recepción y autorización
- 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 PMS | Comprobante |
|---|---|
| Cierre del folio (check-out) | Factura |
| Ajuste o corrección posterior | Nota de crédito |
Del folio a la factura
| En tu PMS | En la API |
|---|---|
| Huésped o empresa a facturar (cédula, RUC o pasaporte) | comprador |
| Cargos del folio (noches, consumos, servicios) | detalles |
| Folio dividido entre dos partes | Una factura por cada parte, con sus cargos |
| Resultado | Guarda clave_acceso y estado en el folio |
Ejemplo de factura de un folio de un huésped extranjero:
{
"comprador": {
"tipo_identificacion": "pasaporte",
"identificacion": "X1234567",
"razon_social": "Huésped de ejemplo",
"email": "[email protected]"
},
"detalles": [
{ "descripcion": "Alojamiento habitación doble (2 noches)", "cantidad": 2, "precio_unitario": 60.00 },
{ "descripcion": "Desayuno buffet", "cantidad": 2, "precio_unitario": 8.00 },
{ "descripcion": "Servicio de lavandería", "cantidad": 1, "precio_unitario": 5.00 }
]
}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
Buenas prácticas para tu PMS
- 1 Emite al cerrar el folio No antes, para que los cargos estén completos.
- 2 Soporta la división de cuentas Una factura por cada parte que paga.
- 3 Valida el tipo de identificación Según el huésped.
- 4 Guarda la
clave_accesoen el folio Y muéstrala en el cierre. - 5 Define el proceso de correcciones Después del check-out, con notas de crédito.
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 PMS
¿Cómo facturo a un huésped extranjero?
Usando el tipo de identificación que corresponda, por ejemplo pasaporte. Confirma los tipos válidos y los requisitos vigentes.
¿Cómo divido una cuenta entre el huésped y una empresa?
Emites una factura por cada parte, con los cargos que le corresponden a cada una.
¿Se emite al hacer el check-in o el check-out?
Depende de tu proceso. La API emite cuando tu PMS envía la solicitud, normalmente al cerrar el folio.
¿Y las reservas que vienen de agencias u OTAs?
Se factura a quien deba constar como comprador, según el acuerdo comercial. Confirma con tu contador.