{
  "version": "2026.09.3",
  "updatedAt": "2026-09-25",
  "encoding": "UTF-8",
  "contact": "info@escaneaypide.es",
  "conventions": {
    "identifiers": "Cadenas opacas; conservarlas para relacionar registros.",
    "timestamps": "ISO 8601 con zona horaria; fechas de contadores en YYYY-MM-DD (UTC).",
    "prices": "Números decimales en la moneda del restaurante; null indica un valor pendiente, nunca precio cero.",
    "optionalValues": "Un campo opcional puede omitirse o ser null. Arrays vacíos significan ausencia de elementos.",
    "csv": "CSV con cabecera y comillas dobles para escapar; una tabla por conjunto. Valores estructurados como JSON en la celda, descritos en el diccionario de entrega."
  },
  "panelDownload": {
    "format": "application/json",
    "access": "Perfil y cuenta > Copia de tu carta",
    "root": { "restaurant": "object", "categories": "category[]", "dishes": "dish[]" },
    "restaurant": { "name": "string", "description": "string?", "languages": "string[]?", "defaultMenuView": "carta|reels?" },
    "category": {
      "id": "string", "restaurantId": "string", "name": "string", "name_en": "string?",
      "emoji": "string?", "description": "string?", "order": "number", "isVisible": "boolean",
      "showInWave": "boolean", "waveLayout": "string", "parentId": "string|null", "menuRole": "string"
    },
    "dish": {
      "id": "string", "restaurantId": "string", "categoryId": "string", "name": "string",
      "name_en": "string?", "description": "string?", "description_en": "string?", "price": "number|null",
      "variants": "{label:string,price:number|null}[]", "imageUrl": "string?", "videoUrl": "string?",
      "extraImages": "string[]", "origin": "string", "pairsWith": "string[]", "isDraft": "boolean",
      "allergens": "string[]", "tags": "string[]", "isAvailable": "boolean", "order": "number"
    },
    "relations": ["dish.categoryId = category.id", "category.parentId = category.id cuando exista una categoría padre", "restaurantId identifica el restaurante de origen"],
    "limits": ["No incluye platos eliminados lógicamente.", "Las URLs de fotos y vídeos son referencias, no archivos binarios.", "No incluye por sí sola traducciones independientes, originales de importación, publicaciones históricas ni contadores."]
  },
  "assistedExport": {
    "access": "Solicitud al email de contacto desde una cuenta autorizada. Entrega por canal restringido acordado.",
    "availability": "Solo datos y archivos conservados del restaurante solicitado. La ausencia de un conjunto se explica en el manifiesto.",
    "manifest": { "exportedAt": "ISO 8601", "restaurantId": "string", "datasets": "{name:string,file:string,format:string,recordCount:number}[]", "files": "{path:string,mediaType:string,sizeBytes:number,sha256:string,relatedType:string,relatedId:string}[]", "omissions": "{category:string,reason:string}[]" },
    "datasets": [
      {
        "name": "profile", "formats": ["JSON", "CSV"],
        "fields": "Datos aportados y configuración: id, name, slug, description, tagline, phone, address, currency, instagram, googleMaps, logoUrl, coverUrl, primaryColor, languages, defaultMenuView, template, isPublished. Campos adicionales aportados o generados conservados se identifican en el diccionario de entrega."
      },
      {
        "name": "menu", "formats": ["JSON", "CSV"],
        "fields": "Categorías y platos descritos en panelDownload, incluidos otros registros exportables conservados que no aparezcan en la descarga del panel. Se identifica el estado de los registros retirados."
      },
      {
        "name": "publications", "formats": ["JSON"],
        "fields": "id, restaurant_id, import_id, previous_publication_id, created_at, snapshot. snapshot contiene restaurant, categories y dishes de cada publicación conservada; se acompaña el diccionario de sus campos y relaciones."
      },
      {
        "name": "translations", "formats": ["JSON"],
        "fields": "restaurant_id, publication_id, language, status, created_at, content. content conserva las claves de las categorías/platos y sus textos traducidos; publication_id enlaza publications.id."
      },
      {
        "name": "imports", "formats": ["JSON"],
        "fields": "id, restaurant_id, status, draft, version, total_pages, completed_pages, created_at, updated_at, expires_at, sources_deleted_at. draft contiene categorías y platos extraídos, sus atributos, referencias a páginas y avisos de revisión. Archivos conservados en manifiesto enlazados mediante relatedId=imports.id."
      },
      {
        "name": "visits", "formats": ["JSON", "CSV"],
        "fields": "restaurant_id, day (YYYY-MM-DD UTC), views (entero). No hay identificador de visitante en el contador actual."
      },
      {
        "name": "usage", "formats": ["JSON", "CSV"],
        "fields": "restaurant_id, month (YYYY-MM-DD), pages para importación; restaurant_id, kind, period_start, count para otros contadores de uso conservados. Se describen unidad y periodo de cada contador."
      }
    ],
    "binaryFiles": "Originales y medios conservados, en su formato almacenado (por ejemplo JPEG, PNG, WebP, PDF o MP4). No se entregan únicamente enlaces caducables sin posibilidad de recuperar el archivo.",
    "interoperability": "JSON y CSV abiertos, sin formato binario propietario para los datos tabulares. No se promete compatibilidad automática con un destino concreto ni el traslado del QR/dominio del servicio. El diccionario de entrega refleja campos opcionales y variantes históricas sin omitir datos exportables."
  },
  "exclusions": ["Código fuente y componentes internos de plataforma.", "Claves, credenciales y secretos de infraestructura; contraseñas de acceso.", "Datos de otros clientes.", "Secretos empresariales y registros internos solo en la medida justificada en los términos, sin impedir el cambio.", "Datos ya suprimidos lícitamente conforme a conservación."],
  "separateChannels": "Facturas y evidencias contractuales se solicitan por sus canales de cuenta/soporte."
}
