Volver al inicio

Descarga de datos: estructura y formatos

Última actualización: 29 de octubre de 2026 · Versión: 1.0

1. Qué describe esta página

Esta página describe el archivo que genera la opción Ajustes → Perfil → «Descargar mis datos (RGPD)» de Scandallo: qué ficheros contiene, en qué formatos y con qué estructura y campos. Es la descripción actualizada de las estructuras y formatos de los datos exportables a la que se refiere el artículo 26.b) del Reglamento (UE) 2023/2854 (Reglamento de Datos) y, junto con la propia descarga, la interfaz abierta de exportación del apartado 17.4 de los Términos y Condiciones de Uso, disponible gratis para el Cliente y para los proveedores de destino que autorice.

Scandallo es un nombre comercial de DELAMAR A SU RESTAURANTE, S.L. (sociedad unipersonal), NIF B11969672.


2. Cómo se obtiene

  • Dónde: en la aplicación, Ajustes → Perfil → «Descargar mis datos (RGPD)», con la sesión iniciada.
  • Coste: ninguno. Se puede descargar en cualquier momento, hasta 5 veces por hora.
  • Qué datos incluye:
    • si eres titular de una cuenta, los datos de tu cuenta y de todos los locales de los que eres titular;
    • si formas parte del equipo de otro negocio (Usuario autorizado), solo tus datos personales (cuenta, perfil, pertenencias, mensajes y encuestas), no los del negocio en el que trabajas.
  • Para otro proveedor: el Cliente puede entregar el archivo al proveedor de destino que elija o pedir ayuda con la transferencia por los canales del apartado 9 de esta página (apartado 17 de los Términos y Condiciones de Uso).

3. Contenido del archivo

La descarga es un archivo comprimido ZIP llamado scandallo-mis-datos-AAAA-MM-DD.zip (la fecha es la de la descarga) que contiene tres ficheros:

FicheroFormatoContenido
datos.jsonJSON (RFC 8259), codificado en UTF-8.Todos los datos de la descarga, con la estructura del apartado 4.
ficheros.htmlPágina HTML, codificada en UTF-8, que se abre con cualquier navegador.Enlaces para descargar los archivos que el Servicio conserva: imágenes y PDF de facturas, fotos de platos y foto de perfil, agrupados por local. Los enlaces son válidos durante 2 días (48 horas); después basta con volver a descargar los datos, que genera enlaces nuevos. Cada archivo se descarga en el formato en que el Servicio lo conserva (imagen o PDF).
LEEME.txtTexto plano, codificado en UTF-8.Explicación del contenido, fecha de la descarga, número de locales incluidos, lo que no se incluye (apartado 7) y, si alguna parte no se pudo leer, un aviso para repetir la descarga.

4. Estructura de datos.json

El fichero contiene un único objeto JSON con estas claves:

ClaveTipoContenido
formatoTextoIdentificador y versión del formato. Valor actual: "Scan-Dallo · exportación completa de la cuenta · v1".
exportado_elFecha y horaMomento de la descarga.
cuentaObjetoDatos de la cuenta de quien descarga (ver abajo).
localesLista de identificadoresIdentificadores (id) de los locales incluidos.
tablasObjetoUna clave por tabla (apartado 6); el valor de cada una es una lista de filas, y cada fila, un objeto con sus campos.
no_incluidoLista de textosLo que no va en la descarga automática y cómo pedirlo.
erroresLista de textosPartes que no se pudieron leer en esa descarga (nombres de tabla o de grupo de archivos). Vacía si la descarga está completa.

Campos del objeto cuenta:

CampoContenido
idIdentificador de la cuenta.
emailCorreo electrónico de acceso.
altaFecha y hora de creación de la cuenta.
email_verificado_elFecha y hora de verificación del correo.
ultimo_accesoFecha y hora del último inicio de sesión.
metodos_de_accesoFormas de acceso de la cuenta (por ejemplo, correo electrónico o Google).
datos_de_perfilDatos de perfil que guarda el sistema de autenticación (por ejemplo, el nombre recibido de Google).

5. Convenciones

  • Identificadores: el campo id de cada fila es un identificador único (UUID, salvo que se indique otra cosa).
  • Relaciones: los campos que terminan en _id contienen el id de la fila relacionada: business_id, del local (businesses); supplier_id y default_supplier_id, del proveedor (suppliers); ingredient_id, del ingrediente (ingredients); invoice_id y shared_from_invoice_id, de la factura (invoices); recipe_id y sub_recipe_id, de la receta o elaboración (recipes); folder_id y parent_id, de la carpeta (folders); count_id, del recuento de inventario (inventory_counts).
  • Fechas: las fechas con hora siguen la norma ISO 8601, con zona horaria; las fechas sin hora, el formato AAAA-MM-DD; los periodos mensuales (period), el formato AAAA-MM.
  • Importes: en euros, como números decimales, salvo en la tabla payments, donde amount_total y amount_tax se expresan en céntimos (la unidad mínima de la moneda, como los facilita la plataforma de pagos).
  • Campos vacíos: valor null.
  • Campos estructurados: algunos campos contienen a su vez objetos o listas JSON (por ejemplo, raw_ocr_json, preparation, drink_extras, drink_targets, capabilities o permissions).
  • Archivos: los campos image_url, photo_url y avatar_url contienen la ruta interna del archivo en el almacenamiento del Servicio, no un enlace público; el archivo se descarga desde ficheros.html.

6. Tablas

Las tablas de un local solo incluyen las filas de los locales de los que quien descarga es titular. Las tablas de la persona solo incluyen sus propias filas. Las tablas marcadas como completas se exportan con todos sus campos: si en el futuro se añade alguno, aparecerá también en la descarga y se incorporará a esta página.

6.1. Locales y suscripción

TablaContenidoCampos
businessesCada local.id, name, type (tipo de negocio), tax_country (país a efectos fiscales), created_at, onboarding_completed_at, trial_started_at, price_alerts_enabled (avisos por email activados), public_menu_enabled (carta pública activada), stock_updated_at, avatar_url (foto de perfil), drink_profile y drink_targets (configuración de las bebidas).
subscriptionsSuscripción del local.business_id, status, plan_tier (basico, pro, negocio o max), billing_interval (mensual o anual), trial_end, current_period_end (fin del periodo pagado), monthly_ocr_limit (escaneos al mes), updated_at.
paymentsCobros de la suscripción.business_id, stripe_invoice_id (número interno de la factura en la plataforma de pagos), status, amount_total, amount_tax, currency, paid_at, failed_at, hosted_invoice_url e invoice_pdf (enlaces a la factura), created_at.
ocr_usageEscaneos con IA usados cada mes.business_id, period, count, updated_at.
custom_plan_requests (completa)Solicitudes de plan a medida hechas desde la aplicación.id, business_id, scans, capabilities, recipes_pref, notes, phone, estimated_price, status, created_at.
custom_plan_grantsPlan a medida activado.business_id, capabilities, activated_at.

6.2. Proveedores, ingredientes y precios

TablaContenidoCampos
suppliers (completa)Proveedores.id, business_id, name, cif, counts_as_purchase (si sus facturas cuentan como compra), created_at.
supplier_product_aliases (completa)Correspondencias entre el texto de un producto en las facturas de un proveedor y un ingrediente.id, business_id, supplier_id, ingredient_id, normalized_text, created_at, updated_at.
ingredients (completa)Ingredientes.id, business_id, name, category, base_unit, default_merma_pct (merma por defecto, en %), default_supplier_id, stock_qty (existencias), par_min y par_max (niveles mínimo y máximo), allergens_reviewed_at, created_at.
ingredient_allergens (completa)Alérgenos de cada ingrediente.id, business_id, ingredient_id, allergen_code, source (origen de la asignación), created_at.
ingredient_prices (completa)Histórico de precios de cada ingrediente.id, ingredient_id, supplier_id, invoice_id, date, price, quantity, unit, created_at.

6.3. Facturas y carpetas

TablaContenidoCampos
folders (completa)Carpetas.id, business_id, name, color, parent_id, position, created_at.
invoices (completa)Facturas y albaranes.id, business_id, supplier_id, folder_id, numero, date, base (base imponible), iva (cuota de IVA), total, status, counts_as_purchase, image_url, raw_ocr_json (resultado de la lectura con IA tal como se obtuvo), shared_from_invoice_id (factura de otro local de la que procede, si se copió), created_at.
invoice_lines (completa)Líneas de cada factura.id, invoice_id, ingredient_id, raw_text (texto de la línea), qty, unit, price, quality_flag (aviso de calidad de la lectura).

6.4. Recetas y escandallos

TablaContenidoCampos
recipes (completa)Recetas, elaboraciones y escandallos de comida y bebida.id, business_id, name, category, source, color, n_servings, yield_qty, yield_unit, prep_time_min, preparation (pasos), notes, carta_description, on_menu, sale_price, vat_pct, target_food_cost_pct, indirect_pct_on_materials, indirect_fixed_per_serving, escandallo_at (fecha de activación del escandallo), allergens_reviewed_at, photo_url, drink_type, drink_label, glass_ml, drink_extras, created_at, updated_at.
recipe_items (completa)Ingredientes y elaboraciones de cada receta.id, recipe_id, ingredient_id, sub_recipe_id, raw_name, net_qty, unit, merma_pct, is_bottle.
recipe_allergen_overrides (completa)Alérgenos de un plato confirmados o corregidos a mano.recipe_id, business_id, allergen_code, present, created_at.

6.5. Ventas, inventario y costes

TablaContenidoCampos
recipe_sales (completa)Ventas de cada plato por mes.id, business_id, recipe_id, period, units_sold, amount_gross, source, updated_at.
sales_imports (completa)Importaciones de ventas desde archivos del TPV.id, business_id, file_name, source, mode, period, date_from, date_to, generated_at, units_total, amount_gross, created_at.
sales_name_decisions (completa)Respuestas a «¿Son el mismo plato?» al importar ventas.business_id, name_a, name_b, decision, keep_name, created_at.
inventory_counts (completa)Recuentos de inventario.id, business_id, counted_at, note, created_at.
inventory_count_items (completa)Cantidades de cada recuento.id, business_id, count_id, ingredient_id, qty, unit.
labor_costs (completa)Coste de personal de cada mes (importe total).id, business_id, period, amount, updated_at.
fixed_expenses (completa)Gastos fijos.id, business_id, name, monthly_amount, created_at, updated_at.
trial_surveys (completa)Respuestas a la encuesta del plan Gratis.id, business_id, rating, most_useful, missing, blocker, suggestions, created_at.

6.6. Datos de la persona

TablaContenidoCampos
profilesPerfil de quien descarga.id, business_id (local activo), role, full_name, created_at, tour_completed_at.
user_businessesLocales a los que pertenece quien descarga.business_id, role, status, permissions, job_title (puesto), display_name, approved_at, created_at.
feedbackMensajes enviados desde «Ayuda y opiniones».business_id, message, page, created_at.
satisfaction_surveysEncuesta de satisfacción.business_id, status, next_ask_at, snoozed_count, rating, recommend, most_useful, suggestion, plan, answered_at, created_at.

7. Lo que no incluye la descarga automática

  • Registros de seguridad (intentos de acceso, límites de peticiones), que se borran a los 90 días, y copias temporales de las lecturas con IA (30 días como máximo), cuyo contenido coincide con el de las facturas. Se facilitan a petición, en lo que no comprometa la seguridad del Servicio (apartado 17.5 de los Términos y Condiciones de Uso).
  • Datos del equipo de cada local: las personas del equipo, sus puestos y permisos, las invitaciones y el registro de actividad del equipo. También los nombres de las etiquetas de color de las recetas y los permisos por defecto del equipo. El titular puede pedirlos y se le facilitan gratis.
  • Datos internos de seguridad: los identificadores de cliente y de suscripción en la plataforma de pagos y el código del enlace de la carta pública, que se puede consultar en la aplicación.
  • Archivos que el Servicio no conserva: de las facturas de varias páginas solo se conserva la primera página, y de las facturas electrónicas importadas en XML se conservan los datos extraídos, pero no el archivo XML.

8. Cambios del formato

El campo formato indica la versión de la estructura. Si la estructura cambia (por ejemplo, porque se añade una tabla o un campo), esta página se actualiza con su fecha. Si el Cliente necesita los datos en un único paquete, en otro formato de uso común o con ayuda para cargarlos en otro servicio, puede pedirlo gratis por los canales del apartado 9.


9. Contacto

Las solicitudes de cambio de proveedor y de recuperación de datos se rigen por el apartado 17 de los Términos y Condiciones de Uso.