Portabilidad de datos

1. Descargar o preparar un cambio

1. Inicia sesión con el acceso de propietario o administrador de tu empresa y entra en Baja y exportación.
2. Pulsa «Preparar exportación». La opción de la plataforma prepara archivos JSON. La interfaz documentada más abajo admite también CSV.
3. Cuando termine la preparación, descarga todos los archivos, incluidos los manifiestos. Cada archivo tiene su propio enlace; no se entrega un único ZIP.
4. Conserva una copia en tu destino antes de la fecha indicada. Los paquetes duran como máximo 48 horas y pueden regenerarse mientras siga abierto tu plazo de extracción.

Si necesitas asistencia para cambiar de proveedor o trasladar tus datos a tu propia infraestructura, escribe a mavvi@mavvi.es indicando la empresa, el alcance y las fechas deseadas. No hace falta iniciar primero una baja para pedir ayuda. Las condiciones y los plazos del cambio están en los Términos y condiciones.

Organiza el traslado asistido antes de terminar el servicio contratado. Después del fin del servicio se conserva el acceso a la descarga de los datos propios durante el plazo aplicable. Una ampliación de conservación no prolonga el uso de las funciones de pago, ni produce una renovación o un cobro nuevo.

Cuando salen solo algunos locales, su opción de exportación entrega los datos de esos locales. Los datos generales de personas y configuración de toda la empresa se obtienen mediante la exportación de la cuenta.

2. Archivos y lectura de los datos

JSON: cada archivo de datos contiene category, cutoffAt, readStartedAt, readFinishedAt y una lista rows. Conserva objetos, listas, números, booleanos y valores vacíos null. Es la opción recomendada para importar datos en otro programa.

CSV: texto UTF‑8 con marca BOM, separador de coma y finales de línea CRLF. La primera fila contiene los campos en orden alfabético; las celdas van entre comillas dobles y las comillas interiores se duplican. Los objetos y listas se guardan como texto JSON dentro de la celda. Un valor nulo se representa como celda vacía. Los textos que podrían ejecutarse como fórmulas reciben un apóstrofo inicial; JSON conserva el valor sin esa transformación.

Originales: logotipos e imágenes propias disponibles en JPEG, PNG y, para logotipos, WebP, con un máximo de 5 MiB por original. Las referencias a una imagen en los datos no sustituyen al archivo original. Se entregan los archivos conservados por Mavvi, sin descargar contenidos de direcciones externas.

Manifiestos: siempre son JSON. Identifican el paquete, empresa, fechas, categorías, intervalos reales de lectura, exclusiones y partes. Para cada parte incluyen nombre, tipo, tamaño en bytes, número de filas y resumen SHA‑256 para comprobar su integridad. Si hay varios manifiestos, reúne sus listas de partes. Una categoría vacía aparece en los intervalos aunque no tenga archivo de filas.

Sus claves son version, schemaVersion, schemaUrl, jobId, accountId, cutoffAt, preparationStartedAt, preparedAt, expiresAt, consistency, categories, categoryReadIntervals, exclusions y parts. Cada intervalo contiene readStartedAt, readFinishedAt, rowCount y complete. Cada parte identifica id, sequence, category, file_name, content_type, size_bytes, row_count, sha256, read_started_at y read_finished_at. Las claves nuevas pueden faltar en archivos preparados con una versión anterior; prepara un paquete nuevo para obtener la estructura actual.

Cada parte contiene como máximo 500 registros y puede dividirse antes por tamaño. Los archivos no superan 8 MiB. Los datos se leen por categorías: el corte excluye registros creados después de la solicitud, pero los cambios posteriores en registros existentes pueden reflejarse al leerlos. Las fechas de lectura permiten conocer ese intervalo; no se garantiza una instantánea de toda la cuenta tomada en un solo momento.

Los identificadores son textos estables dentro de la exportación. Los campos terminados en _id enlazan con el id correspondiente: por ejemplo, business_id con Locales, contact_id con Contactos y action_id con Objetivos. user_id, assigned_to, created_by, updated_by y recorded_by identifican usuarios de acceso; reports_to_id identifica una persona del directorio. Algunas referencias pueden quedar vacías si el registro relacionado dejó de estar disponible.

Las fechas usan ISO 8601 con zona horaria. Los campos de estado y clasificación son códigos de texto; deben conservarse al importar. Un campo puede ser null si no existe valor o su contenido se ha excluido. Las listas vacías se representan como [] y los objetos vacíos como {}.

3. Registro de categorías y campos

Estos nombres de archivo y campos permiten a tu equipo o proveedor de destino interpretar la exportación. Abre cada categoría para consultar su estructura.

Estructuras anidadas

• seo_settings.keywords: lista de id (texto), keyword (texto) y created_at (fecha). seo_settings.slots: lista de slot (número 1 o 2), keyword_id (identificador o nulo), pending_keyword (texto o nulo) y change_pending (booleano). Contiene la elección del cliente, sin posiciones ni resultados de Google.
• customer_objective: objeto o nulo. Incluye name, description, metric, direction y unit (textos), target_value y period_days (números). Solo se conserva el contenido propio acreditado. La descripción generada por un análisis queda nula; no contiene valores medidos, recomendaciones ni evidencias.
• custom_fields: objeto con los nombres y valores personalizados del contacto. profile_data: objeto que contiene exclusivamente las claves elegidas en field_overrides; sus valores corresponden a los cambios del cliente.
• call_to_action: actionType y url (textos, cuando proceden). event_data: title, startAt y endAt (textos con el título y las fechas/horas configuradas). offer_data: couponCode, redeemOnlineUrl y termsConditions (textos opcionales). Se conservan sus claves y valores JSON tal como están guardados.
• prompts: lista JSON de consultas configuradas para GEO, con id, theme y text (textos). Las configuraciones anteriores pueden contener directamente los textos en la lista. Las etiquetas y el contenido son configuración propia, no respuestas de los proveedores.

4. Interfaz documentada de exportación

Esta interfaz se ofrece sin cargo para la portabilidad. Usa HTTPS y la sesión autenticada del propietario o administrador en Mavvi. La cuenta se determina por esa sesión; no se acepta un identificador de otra empresa. La documentación y los archivos pueden entregarse al proveedor de destino. No se ofrece una clave de API separada para estas operaciones.

POST /api/account/offboarding/exports

Cabecera Content-Type: application/json. Cuerpo {"format":"json"} o {"format":"csv"}. Para la salida concreta de unos locales, añade locationRequestId con el identificador de esa salida propia. Devuelve HTTP 202 y job con id, status y expiresAt. Máximo cuatro solicitudes por hora y usuario de la empresa; una preparación en curso puede reutilizarse.

GET /api/account/offboarding/exports

Devuelve jobs, hasta 20 preparaciones propias. Consulta una con ?jobId=IDENTIFICADOR. Cada elemento incluye estado, fechas, rows, partsCount, parts y nextPartsCursor. Cuando el estado sea ready, descarga sus partes. Para más de 200 partes, consulta el mismo jobId añadiendo partsCursor con el valor recibido, hasta que sea nulo.

GET /api/account/offboarding/exports/{jobId}/{partId}

Usa el downloadUrl de cada parte, con la misma sesión. Devuelve el archivo con su tipo, nombre y cabecera X-Export-SHA256. Las partes incluyen también id, category, fileName, contentType, sizeBytes, rowCount, sha256 y fechas de lectura.

DELETE /api/account/offboarding/exports

Cuerpo JSON con jobId: cancela esa preparación propia. No solicita la baja ni elimina los datos de trabajo de la empresa.

Estados de preparación: queued, processing, ready, failed, cancelled y expired. Revisa el estado mientras se prepara; un fallo no se presenta como una exportación completa. Los errores se devuelven como JSON con message: acceso no autorizado (401/403), parámetros inválidos (422), límite de solicitudes (429), archivo no disponible (404), plazo terminado (410) o indisponibilidad temporal (503).

Ejemplo ficticio de un archivo JSON de Locales:

{
  "category": "businesses",
  "cutoffAt": "2026-10-07T08:00:00.000Z",
  "readStartedAt": "2026-10-07T08:00:01.000Z",
  "readFinishedAt": "2026-10-07T08:00:02.000Z",
  "rows": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Cafetería Ejemplo",
      "category": "cafe",
      "slug": "cafeteria-ejemplo",
      "website_url": "https://example.org",
      "location": "Ciudad Ejemplo",
      "status": "active",
      "group_id": null,
      "created_at": "2026-10-01T09:00:00+00:00",
      "updated_at": "2026-10-06T09:00:00+00:00",
      "seo_settings": {
        "keywords": [
          {
            "id": "22222222-2222-4222-8222-222222222222",
            "keyword": "cafetería",
            "created_at": "2026-10-01T09:00:00+00:00"
          }
        ],
        "slots": []
      }
    }
  ]
}

5. Alcance y restricciones

• La descarga requiere conservar el permiso de administración y el plazo de extracción. Si cualquiera termina, se detiene también una descarga en curso. Los enlaces no son públicos ni amplían ese plazo.
• No se exportan contraseñas, tokens, secretos, cargas técnicas de proveedores ni información interna de seguridad. Sí se incluyen los identificadores, relaciones, fechas y configuraciones propios descritos en este registro.
• Esta exportación no incluye reseñas y contenido obtenidos de Google, estadísticas ni análisis derivados, ni texto o evidencia de acciones cuyo origen propio no esté acreditado. Esta es una limitación del exportador actual; no significa que todo dato relacionado con Google quede automáticamente excluido de un derecho de portabilidad.
• Para conectar las fichas con otro servicio, utiliza tu propio acceso autorizado a Google y la conexión que ofrezca el destino. Mavvi no transfiere sus credenciales de conexión. Una solicitud de cambio no amplía los plazos de conservación permitidos por Google ni modifica los originales allí.
• Las facturas y documentos de contratación se consultan por su canal de facturación; no forman parte de este paquete de datos de trabajo. La conservación legal se describe en los Términos y la política de privacidad.
• El destino puede necesitar adaptar nombres de campos, relaciones o formatos. La exportación no reproduce automáticamente todas las funciones de Mavvi. Si falta un dato propio que necesitas trasladar, indícalo a mavvi@mavvi.es para revisar su disponibilidad y las condiciones aplicables.

Este registro describe la interfaz y los formatos disponibles; no sustituye los derechos establecidos en los Términos y condiciones y en la normativa aplicable.