Qué exportamos cada día
Cada noche generamos tres CSVs con el cierre del día anterior. Tu despacho recibe el paquete por email (default), lo descarga del panel, o lo recoge por SFTP / S3 si estás en plan enterprise.
- incidencias.csv — incidencias creadas o actualizadas en las últimas 24 horas, con su estado vigente.
- comunicaciones.csv — todas las comunicaciones enviadas (residentes, proveedores, aseguradoras) con resumen y enlace al hilo completo.
- gastos.csv — gastos asociados a incidencias resueltas (cuando aplica), listos para conciliar contra el ERP económico.
Formato
- Codificación UTF-8, separador
;(estándar Excel español). Alternativa,configurable por despacho. - Comillas dobles para campos con saltos de línea o separadores.
- Schema documentado y versionado con semver. Cualquier cambio compatible (añadir columna) sube la minor; cualquier cambio incompatible (renombrar columna) sube la major y se anuncia con 30 días de preaviso.
Cómo se entrega
- Email diario al socio operativo — opción por defecto. ZIP con los tres CSVs adjunto. Despachos de 1–10 personas suelen quedarse aquí.
- Descarga manual desde el panel admin — siempre disponible. Útil para reprocesos o auditorías.
- Webhook S3 / SFTP (opt-in) — para despachos con integraciones automatizadas o ETL propio. Disponible en plan enterprise.
Schema de las columnas — qué incluye cada CSV
incidencias.csv
| Columna | Tipo | Ejemplo | Notas |
|---|---|---|---|
id | uuid | a3b9... | ID interno Incidencias (estable) |
external_ref | string | INC-2026-0421 | ID legible para el despacho |
created_at | ISO 8601 | 2026-05-15T08:23:00Z | UTC; convertir a Europa/Madrid en tu ERP si toca |
community_id | string | EDPRADO27 | Mapea al ID de comunidad de tu despacho (provisto en onboarding) |
community_name | string | Edificio Prado 27 | Texto legible |
resident_name | string | Juan García | Solo cuando hay un residente identificado |
unit_label | string | 3ºA | Vivienda / local / portal |
category | enum | ascensor, fuga, electricidad | Categorías del modelo (spec §5.1) |
urgency | enum | emergency, high, medium, low | Inferida por la IA, supervisada por el despacho |
state | enum | new, awaiting_resident, awaiting_supplier, resolved | Máquina de estados (spec §4) |
draft_response | text | (multilínea) | Último borrador aprobado o enviado |
supplier | string ∣ null | Ascensores Madrid SL | Solo si hay proveedor asignado |
updated_at | ISO 8601 | 2026-05-15T17:45:00Z | Última modificación |
comunicaciones.csv
Misma estructura conceptual: id, incidencia_id (foreign key), channel (whatsapp / email / voz), direction (in / out), recipient, subject, snippet, sent_at, thread_url.
gastos.csv
Para incidencias con gasto registrado: id, incidencia_id, concept, amount, currency (EUR), vat_rate, supplier, invoice_ref, incurred_at.
Cómo cargar el CSV en tu ERP
Cada ERP tiene su propio importador, pero todos aceptan CSV con cabecera. Los pasos genéricos:
- Adminet — Importación → Datos externos → CSV. Mapea
community_idal campo de comunidad y cargaincidencias.csv. Documentación oficial de Aareon describe el flujo paso a paso. - Gesfincas — Utilidades → Importar incidencias. Configura el mapeo de columnas la primera vez; queda guardado para futuros CSVs con el mismo schema.
- Fincaplus — Importación masiva desde el módulo de gestión de incidencias.
- Otros ERPs — la inmensa mayoría aceptan CSV con cabecera. Si necesitas ayuda con el mapeo, te acompañamos en onboarding.
¿Cuándo voy a tener integración nativa con [ERP]?
- Adminet — adaptador nativo en desarrollo (M4 según hoja de ruta). Mientras tanto, CSV diaria.
- Gesfincas — adaptador nativo M6, sujeto a acuerdo formal con TAAF. Mientras tanto, CSV diaria.
- Inmho / Portik — adaptadores bajo contrato enterprise.
- Otros — solicítalo. Si hay 5+ clientes pidiendo el mismo ERP, lo construimos. Escríbenos a hola@recepcionista.com.