Exportar datos a CSV

Introducción

Los reportes en pantalla te sirven para el día a día, pero a veces necesitás datos crudos para:

• Armar un tablero en Excel / Google Sheets.
• Pasárselo al contador o socio para conciliación.
• Subir a un BI (Metabase, Tableau, Looker Studio, etc.).
• Hacer modelos predictivos / comparativas con otros eventos.

La función de exportar CSV te baja los datos crudos en formato estándar, listos para cargar a cualquier herramienta.

Tipos de export disponibles

Podés exportar 3 tipos de reporte desde la pantalla de reportes del evento:

1. Ventas diarias

Columnas:

• Fecha de cada orden aprobada.
• Ingresos (total de la orden).
• Cargo servicio (comisión aplicada a esa orden).
• Canal (online, POS, invitación, lista de invitados).

Una fila por orden aprobada. Si querés totales por día o por canal, agrupá en tu planilla externa.

Uso típico: tendencias de venta día a día, comparar con calendario de acciones de marketing.

2. Por tipo de entrada

Columnas:

• Tipo (General, VIP, etc.).
• Precio.
• Vendidos (cantidad).
• Total (recaudación por ese tipo).
• % Vendido (sobre cupo total del tipo).

Una fila por tipo de entrada.

Uso típico: evaluar qué mix de tipos funcionó, planificar el próximo evento.

3. Por canal

Columnas:

• Canal.
• Órdenes (cantidad).
• Ingresos (total).

Una fila por canal.

Uso típico: entender distribución de ventas, justificar inversión en staff de POS o marketing online.

Cómo exportar

1. 01

   Entrá al detalle del evento desde el dashboard.

2. 02

   En el sidebar del evento, elegí Reportes.

3. 03

   Seleccioná el tab del reporte que querés exportar (Ventas diarias, Por tipo, o Por canal).

4. 04

   Configurá filtros si querés acotar el rango de fechas o (en eventos recurrentes) la ocurrencia.

5. 05

   Hacé clic en el botón Exportar CSV (arriba del reporte).

6. 06

   El archivo se descarga automáticamente con nombre reporte-{tipo}-{evento}-{fecha}.csv.

7. 07

   Abrilo en Excel / Google Sheets / tu herramienta preferida. El CSV usa coma como separador estándar.

Scope del export

• Los exports son por evento, no globales. Si querés consolidar varios eventos, exportá cada uno por separado y uní en tu herramienta externa.
• Si el evento es recurrente, podés exportar una ocurrencia específica (con el filtro) o todas las ocurrencias juntas.
• El rango de fechas te permite acotar (ej: solo la última semana de venta).

Protección contra formula injection

Los CSVs incluyen escape de caracteres peligrosos para evitar inyección de fórmulas al abrir en Excel. Caracteres que inician con =, +, - o @ se prefijan con apóstrofe para que Excel los trate como texto, no como fórmula.

Esto es transparente para el usuario, pero tenelo en cuenta si ves apóstrofes al principio de algunas celdas.

Lo que NO está en el export

Los exports son a nivel de reporte agregado. No podés exportar:

• Lista de órdenes individuales con nombre/email de cada comprador.
• Listado de QR escaneados con timestamp y scanner.
• Detalle de transferencias de entradas.
• Reporte de comisiones por RRPP (pedilo a soporte si lo necesitás en planilla).
• Export a PDF (solo CSV).

Si alguno de estos datos te hace falta urgente, escribí a ayuda@vortahub.com.ar y el equipo puede exportarlo manualmente desde el backoffice.

Cómo procesar el CSV

En Google Sheets

1. 01
   Abrí Google Sheets.
2. 02
   Archivo → Importar → Subir el CSV descargado.
3. 03
   Configurá "Separador: coma". Confirmá.
4. 04
   Trabajá con los datos como cualquier hoja.

En Excel

1. 01
   Abrí Excel.
2. 02
   Doble clic en el CSV o Archivo → Abrir.
3. 03
   Si Excel no reconoce las columnas, usá Datos → Desde texto y configurá coma como separador, UTF-8 como encoding.

En herramientas de BI

La mayoría aceptan CSV directo. Si tu BI requiere otro formato, convertí el CSV a JSON / Parquet / lo que sea con scripts sencillos.

Preguntas frecuentes

¿El CSV incluye datos del comprador (nombre, email)?

No, por privacidad. Los exports son agregados. Si necesitás datos individuales, escribinos con el motivo y procesamos manualmente.

¿Cuántos registros soporta un export?

Muy grandes (decenas de miles). El CSV es streaming — se genera en el server y el navegador lo descarga progresivamente. Si un evento tuvo 5.000 órdenes, el export de Por tipo es chiquito (una fila por tipo); el de Ventas diarias tiene una fila por día × canal, también manejable.

¿Se pueden programar exports automáticos?

Por ahora no. Es manual desde el botón. Está en el roadmap para una versión futura.

¿El CSV tiene BOM UTF-8?

No. Si Excel muestra tildes o eñes mal, abrilo vía Datos → Desde texto y elegí UTF-8 como origen del archivo.

¿Puedo exportar desde el dashboard global (sin evento)?

Por ahora solo es export por evento. La pantalla global de Reportes muestra datos consolidados pero no tiene botón de export. Podés exportar cada evento por separado y consolidar externamente.

¿Se puede importar datos de vuelta a Vorta Hub?

No. Las órdenes se crean a través del checkout o el POS, no por import de archivo.

Siguientes pasos

• Reportes globales y por evento — vista en pantalla antes de exportar.
• KPIs y alertas — overview del home.
• Finanzas por evento — reporte financiero completo.