Formatos de exportación de tus datos

Puedes llevarte los datos de tu estudio cuando quieras, gratis: para tener una copia o para cambiar de proveedor. Aquí explicamos qué te llevas, en qué formato va cada cosa y qué normas sigue, para que lo pueda leer cualquier programa.

Versión del formato: 3, del 17/10/2026. Si cambia, lo avisaremos antes y subiremos este número (va dentro de cada archivo JSON con cabecera, en version_formato).

1. Cómo se pide

• En la aplicación: Ajustes › Datos y baja › «Exportar todo el estudio». Lo pide el titular del estudio, después de confirmar que es él (con su llave de acceso; si todavía no tiene ninguna, con un código que le llega por correo). No cuesta nada. La prepara MideMatic y, cuando está lista, te avisa arriba, en los avisos: se descarga ahí mismo, con «Descargar (ZIP)».
• Por la API, desde un programa, con un token (apartado 5).
• Plazos:
  • te la entregamos en 30 días como máximo (normalmente, en unos segundos); guardamos la fecha en que la pides y la fecha en que te la entregamos;
  • puedes descargarla durante 30 días desde la entrega;
  • después borramos el archivo (mientras tengas la cuenta, tus datos siguen en ella: puedes pedir otra exportación).
• Como mucho, 10 exportaciones al día por estudio.
• El archivo se guarda cifrado mientras está disponible, y solo lo descarga el titular (con su sesión) o un programa con un token del estudio.

Cambiar de proveedor

En Ajustes › Datos y baja › «Cambiar de proveedor». Lo pide el titular, después de confirmar que es él. No hace falta preaviso y no cuesta nada.

1. El día que lo pides empieza el cambio. Te lo confirmamos por correo y preparamos tus datos: son los mismos que con «Exportar todo el estudio».
2. Durante 30 días tienes el servicio completo, para que te lo lleves todo con calma. La suscripción ya no se renueva.
3. Cuando se completa el cambio, el contrato termina (te lo confirmamos por correo) y el estudio queda al menos 30 días más en solo lectura: todas sus personas pueden verlo y descargarlo todo, pero no cambiar nada.
4. Al final, lo borramos todo (las obras, sus archivos, el registro de obras, los criterios y las personas) y te enviamos por correo un certificado de borrado.

Mientras no se haya borrado, puedes exportar y descargar tus datos las veces que haga falta, en Ajustes › Datos y baja o por la API. Y mientras dura el cambio, el titular puede, en Ajustes › Datos y baja:

• dejarlo sin efecto: todo vuelve a estar como antes;
• alargar una vez los 30 días de servicio completo, el tiempo que le convenga (Reglamento (UE) 2023/2854, art. 25.5). El contrato termina entonces al acabar ese plazo, y los 30 días en solo lectura empiezan después.

Si por algo técnico no pudiéramos entregártelo todo en 30 días, te lo diríamos en los 14 días hábiles siguientes, con el porqué y un plazo nuevo de 7 meses como mucho, y el servicio seguiría. Si nos das el contacto de tu nuevo proveedor, le ayudamos a recibir tus datos.

Con un plan de pago, el cambio sigue sin costar nada: al terminar el contrato, en el plan anual te devolvemos lo pagado menos los meses empezados; y si el periodo que has pagado acaba antes de que termine el cambio, se cobran solo los días de más.

Lo único que no borramos es lo que tenemos que guardar (por ley, o como prueba de lo que aceptaste), que queda bloqueado, sin uso, solo para eso:

• si has pagado algo, las facturas y los cobros, 4 años, y los libros y sus justificantes, 6 años, nunca con el nombre de las obras;
• en los dos casos, hasta 6 años después de acabar el contrato, lo que aceptaste y declaraste (también cuándo se encendió o se apagó la IA), con tu correo, tu empresa y tu NIF: es la prueba de que aceptaste el acuerdo y el contrato de encargo;
• y durante 5 años, tus reclamaciones y la constancia: de cada cambio del plazo de conservación, de los planos que nos pediste guardar para investigar un fallo (cada petición, cada vez que se abrieron para investigarlo y cuándo se borraron: fecha, aviso, obra y quién; nunca los planos) y de cada vez que el soporte de MideMatic entró en tu cuenta (cada permiso que diste, y cada vez que alguien lo usó: fecha, para qué y quién). La constancia cuenta sus 5 años desde cada anotación.

La invitación al piloto, con tu correo, se borra con la cuenta (y, si no la aceptas, cuando caduca). Las copias de seguridad que todavía llevan tus datos caducan solas en 30 días como mucho: el certificado de borrado te dice el día.

2. Qué te llevas

Un archivo ZIP (midematic_datos_AAAA-MM-DD.zip) con:

Lo que va dentro son los datos de tu estudio tal como están en MideMatic en el momento de preparar la exportación. Lo que no va, y por qué, está en el apartado 6.

3. Normas que siguen

Las celdas de los CSV, sin trampa. Un texto que escribió alguien (el nombre de una obra, un comentario) puede empezar por =, +, - o @, y una hoja de cálculo lo tomaría por una fórmula. Por eso, en los CSV, una celda de texto que empieza por uno de esos signos (o por un tabulador o un retorno de carro) lleva un apóstrofo (') delante: '=SUMA(A1). Si tu programa necesita el texto tal cual, quita ese apóstrofo. Un número escrito como texto (-2,50) no es una fórmula y va como está. En los JSON no hace falta: el texto va siempre tal cual.

4. Estructura de cada archivo

Tipos: texto, entero, número, euros (número con dos decimales), fecha (ISO 8601 en UTC), sí/no, objeto y lista. Cualquier campo puede venir vacío (null) si no hay dato.

Los JSON de la raíz del ZIP y los de memoria/ empiezan con la misma cabecera de cinco campos: formato, version_formato, generada, exportacion y documentacion.

estudio.json

Ejemplo (recortado):

{
  "formato": "midematic-exportacion",
  "version_formato": 3,
  "generada": "2026-10-13T08:15:30Z",
  "exportacion": "exp_1d67bdf2f2314921",
  "documentacion": "https://midematic.com/formatos-de-exportacion/",
  "estudio": {"id": "est_097402b155464adb", "nombre": "Estudio de Ejemplo SL", "tipo": "sociedad",
              "actividad": "arquitectura", "nif": "B12345674", "pais": "ES", "alta": "2026-10-01T09:00:00Z", "piloto": true},
  "ajustes": {"conservacion": "90_dias", "conservacion_cambiada": null, "ia_activa": true},
  "suscripciones": [{"id": "sus_3c72365194684ce4", "plan": "piloto", "periodo": "mes", "estado": "piloto"}]
}

El estudio (estudio)

Los ajustes del estudio (ajustes)

Cada suscripción (suscripciones)

Cada anotación del historial (historial)

Cada incidencia (incidencias)

Cada exportación pedida (exportaciones)

usuarios.csv

Una fila por persona del estudio, también las que ya no están. No lleva llaves de acceso, códigos, tokens ni sesiones.

Ejemplo:

usuario_id,correo,nombre,papel,estado,desde,hasta
usu_8a566fcef38c4aab,ana@estudio.example,Ana García,titular,activa,2026-10-01T09:00:00Z,
usu_3ac94f5d57cb4c8e,luis@estudio.example,Luis Pérez,usuario_adicional,activa,2026-10-02T10:30:00Z,

aceptaciones.csv

Lo que aceptó y declaró cada persona del estudio, del más antiguo al más reciente: los documentos (con su versión y la huella del texto que vio), las declaraciones de que el estudio es profesional o empresa, cada vez que se encendió o se apagó la IA y las acreditaciones (cada vez que MideMatic te pidió que acreditaras que eres profesional o empresa, y cómo acabó). Es la misma constancia que guardamos bloqueada (apartado 1): aquí va una copia.

memoria/criterios.json

Lo que me has enseñado: los criterios de medición, las convenciones de dibujo y las notas del estudio, tal como están hoy. De cada uno, de dónde sale, en cuántas obras se ha aplicado y si está activo. No lleva números de una obra (salvo los que fijó el estudio o escribió en una nota) ni nombres de estancias: MideMatic nunca los recuerda para otra obra.

datos es el formato propio de MideMatic (versión 3): reglas (por cada criterio, una lista de reglas con su id, su condicion, su valor, su origen y si está activa), convenciones (convenciones de dibujo del estudio, con su origen), notas (las notas del estudio, con sus palabras; hoy, una lista vacía: llegan con «Explícamelo») e historial (cambios).

Ejemplo (recortado):

{
  "version": 4, "actualizada": "2026-10-10T10:02:11Z",
  "datos": {"version": 3, "id": "principal", "reglas": {"desglose": [{"id": "R1", "condicion": {}, "valor": "total"}]},
            "convenciones": [], "notas": [], "historial": []},
  "aplicado": {"desglose": 3}
}

memoria/historial.json

El historial de los criterios del estudio: cada versión que han tenido, de la más antigua a la más reciente.

Cada versión (versiones)

propuestas_regla.json

Las propuestas de criterio: lo que MideMatic propuso guardar como criterio del estudio y lo que una persona decidió. Ninguna propuesta se guarda como criterio sin que una persona del estudio lo acepte.

Cada propuesta (propuestas)

obras.csv

El registro de obras: una fila por obra, por su número. La fila sigue aunque los archivos de la obra ya se hayan borrado.

Ejemplo (recortado: solo las primeras columnas):

numero,obra_id,nombre,creada,creada_por,responsable,estado,bc3_listo
3,obr_5f2c…,Reforma vivienda 2026-17,2026-10-10T09:14:02Z,ana@estudio.example,ana@estudio.example,abierta,2026-10-10T09:41:55Z

obras/<n.º>/obra.json

La ficha de la carpeta de una obra. Hay una carpeta obras/<n.º>/ por cada obra cuyos archivos todavía se guardan (en obras.csv, las que tienen carpeta).

Ejemplo:

{"numero": 3, "nombre": "Reforma vivienda 2026-17",
 "archivos": {"plano.dxf": "planta-reforma.dxf", "presupuesto.bc3": "presupuesto.bc3", "medido-v1.bc3": "presupuesto_medido.bc3"}}

El plano, el presupuesto y el BC3 medido

En la carpeta de cada obra van, tal cual:

• plano.dwg o plano.dxf: el plano que subiste;
• presupuesto.bc3: el presupuesto que subiste;
• medido-v1.bc3, medido-v2.bc3…: su BC3 medido, si la obra ya se ha descargado. Es el mismo archivo que descargas en la aplicación. Una obra que aún no se ha descargado va con sus originales (el plano y el presupuesto) y mediciones.csv, sin el BC3 medido. Exportar no cuenta la obra;
• recortes/: los dibujos (PNG) que acompañaban a las preguntas de la obra.

obras/<n.º>/mediciones.csv

Las mediciones de la obra como están hoy, línea a línea: una fila por cada línea de medición de cada partida. Una partida pendiente (sin ninguna línea) lleva una sola fila, con linea vacía y el motivo en comentario. Las columnas de la partida se repiten en cada una de sus filas.

Ejemplo:

capitulo,partida,unidad,resumen,cantidad,origen_partida,sin_confirmar,linea,comentario,unidades,longitud,anchura,altura,parcial,origen,propuesto_por,ia_modelo,ia_fecha
01,01.01,ud,Toma de corriente 16A,10,medido_en_plano,false,1,Salón,6,,,,6,medido_en_plano,,,
01,01.01,ud,Toma de corriente 16A,10,medido_en_plano,false,2,Cocina,4,,,,4,medido_en_plano,,,
03,03.01,m2,Pavimento porcelánico,27.92,propuesto_por_ia,true,1,Salón,1,5.2,4.1,,21.32,propuesto_por_ia,ia,eu.anthropic.claude-opus-5-5,2026-10-10T09:30:12Z
03,03.02,m,Rodapié cerámico,,pendiente,false,,No está en el plano,,,,,,pendiente,,,

El origen de cada línea (origen)

Cada línea dice de dónde sale su medición, con una de estas cinco palabras, siempre las mismas, para que lo lea un programa:

obras/<n.º>/historial.csv

El historial de la obra, del hecho más antiguo al más reciente.

obras/<n.º>/conversacion.json

Lo hablado con la IA en la obra: en «Explícamelo» (de una pregunta o de una partida) y en el chat de la obra. Una lista, de lo más antiguo a lo más reciente. Lo que dijo la IA en una tarjeta «He entendido» lleva lo que enseñó (propuesta) y si se aplicó.

obras/<n.º>/preguntas.json

Las preguntas que la obra tiene abiertas en ese momento. Solo está si la obra espera a que el estudio conteste. Va en el formato propio de MideMatic (versión 1), tal como se guarda.

obras/<n.º>/respuestas.json

Lo que el estudio ha contestado en esa obra. Va en el formato propio de MideMatic, tal como se guarda: sus fechas (at) no van en ISO 8601, sino en segundos desde el 1 de enero de 1970 (UTC), y quien contestó (por) va con su usuario_id de usuarios.csv.

Cada respuesta lleva r (la respuesta), corta (cómo se lee), por (quién) y at (cuándo).

consumo_ia.csv

El uso de la IA de cada obra, sin el contenido: una fila por día, obra, fase y modelo, con los tokens y el coste. No lleva nada de lo que se envió ni de lo que contestó.

auditoria.csv

El registro de quién hizo qué en el estudio, del hecho más antiguo al más reciente.

facturas.csv

Solo si el estudio tiene facturas. Una fila por factura. Las rectificativas (serie R) llevan los importes en negativo y el número de la factura que rectifican.

Ejemplo:

codigo,serie,fecha,concepto,base,impuesto,tipo,cuota,total,nota,rectifica,cliente_razon_social,cliente_nif,cliente_direccion,cliente_codigo_postal,cliente_poblacion,cliente_pais,huella_anterior,huella,archivo_pdf
F2026-000001,F,2026-10-13T08:15:30Z,"MideMatic Estudio, mensual (desde el 13/10/2026)",279.00,IVA,21,58.59,337.59,,,Estudio de Ejemplo SL,B12345674,Calle Mayor 1,46001,Valencia,ES,,3d67bbe0…,facturas/F2026-000001.pdf

facturas/

Cada factura en PDF (facturas/F2026-000001.pdf), la misma que recibiste por correo.

manifiesto.json

Cada archivo (archivos)

5. La interfaz abierta (API)

Los datos de tu estudio también se descargan desde un programa, gratis, con una interfaz abierta.

• Dirección: https://api.midematic.com/api/v1/exportaciones. Todo por HTTPS.
• Autenticación: siempre con un token de la API de exportación, en la cabecera Authorization: Bearer mmx_…. No vale ninguna sesión. El token lo crea el titular en Ajustes › Datos y baja › «Tokens de la API de exportación» › «Crear», con un nombre para saber para qué es («Copia semanal»). Se enseña una sola vez; se puede revocar cuando quieras, y deja de valer en el momento. Solo sirve para esto: ver las exportaciones del estudio, descargarlas y pedir una nueva. Un estudio puede tener hasta 5 tokens activos. Quien tenga el token puede descargarlo todo: guárdalo como una contraseña.
• Límites: 60 peticiones por minuto y 10 exportaciones nuevas al día por estudio.

POST no lleva cuerpo. Normalmente responde en unos segundos, con la exportación ya disponible; si no se ha podido preparar en el momento, responde con el estado preparando y MideMatic lo vuelve a intentar solo: pregunta por ella con GET /api/v1/exportaciones/{id}.

Si algo va mal, la respuesta es un JSON con error (un código) y texto (la causa, en español):

La exportación en la API (exportacion)

Ejemplo:

curl -H "Authorization: Bearer mmx_…" https://api.midematic.com/api/v1/exportaciones
curl -X POST -H "Authorization: Bearer mmx_…" https://api.midematic.com/api/v1/exportaciones
curl -H "Authorization: Bearer mmx_…" -o mis_datos.zip https://api.midematic.com/api/v1/exportaciones/exp_1d67bdf2f2314921/archivo

6. Lo que no se exporta y por qué

• El funcionamiento interno de MideMatic: su programa, sus reglas, sus instrucciones a la IA y sus modelos de medición. Es secreto comercial (art. 25.2.f del Reglamento de Datos). No te impide llevarte tus datos: va cada medición, con su origen.
• La constancia que guardamos aparte: los permisos que diste a MideMatic (los accesos de soporte y los permisos para mirar una obra por un aviso tuyo) y tus reclamaciones con nuestras respuestas. Son la prueba de lo que se permitió y se reclamó, y por eso se guardan aparte y bloqueados (apartado 1). Las reclamaciones que hiciste en la aplicación, con sus respuestas, están en Ayuda › Reclamaciones, y las demás, en tu correo. Lo que aceptaste y declaraste, y las acreditaciones, sí van, en aceptaciones.csv.
• Los archivos de las obras que ya se borraron. El plano, el presupuesto, el BC3 medido, las preguntas, las mediciones y la conversación de una obra se guardan, cifrados, solo el plazo que elige tu estudio (por defecto, 90 días desde que el BC3 medido está listo; también «al descargar», 72 horas después de la primera descarga, o «mientras tenga la cuenta») y después se borran. De una obra borrada queda su fila en obras.csv, sin su carpeta. Las copias de seguridad no llevan los archivos de las obras.
• Las credenciales: las llaves de acceso, los códigos de recuperación, los códigos que enviamos por correo, los tokens de la API y las sesiones. No salen nunca de MideMatic, tampoco hacia ti.
• Las huellas técnicas de cada obra (la del plano y la del presupuesto, las dos sin su contenido). Solo sirven para reconocer si una obra es la misma que otra reciente y se borran a los 61 días.
• Algunos registros internos de la cuenta: los cobros y los pagos pendientes (las facturas sí van) y lo que nos dice el proveedor de correo sobre tu dirección.
• Lo técnico: los registros del servidor (sin contenido ni nombres de archivo; se borran a los 30 días; la lista de sesiones, a los 90), lo que se envió a la IA (de la IA va su uso, sin el contenido, en consumo_ia.csv), la cola de trabajos y los correos que te hemos enviado (ya los tienes).

7. Limitaciones conocidas

• La exportación es una foto del momento en que se prepara: lo que cambie después no está dentro. En la aplicación, mientras hay una exportación lista para descargar (30 días), se ofrece esa; para tener otra antes, pídela por la API.
• Lo enseñado, las propuestas, las preguntas y las respuestas usan el formato propio de MideMatic. No hay una norma común para guardar criterios de medición ni preguntas sobre un plano: otro programa tendrá que convertirlos. Son texto JSON legible, y sus campos principales están explicados arriba.
• En obras/<n.º>/respuestas.json las fechas van en segundos, no en ISO 8601, y las personas, por su identificador (apartado 4).
• El correo de cada persona es el que tiene hoy: donde se dice quién hizo algo (quien, creada_por, actor…), va el correo que esa persona tiene hoy en MideMatic, también si ya no es del estudio; si lo cambió, no sale el que tenía entonces.
• Las mediciones van como están hoy, no versión a versión: de cada versión anterior de una obra ya descargada tienes su BC3 medido (medido-v1.bc3…).
• Las facturas en PDF son copias en PDF 1.4, no facturas electrónicas estructuradas (Facturae o similares) ni PDF/A. Los datos de cada factura, para un programa, están en facturas.csv.
• Hojas de cálculo: los CSV van con coma y punto decimal, como pide la norma. Una hoja de cálculo en español puede abrirlos mal con doble clic: impórtalos («Datos» → «Desde texto/CSV»), con origen UTF-8 y la coma como separador. Y una celda de texto que empezaba por =, +, - o @ lleva un apóstrofo delante (apartado 3).
• El ZIP sin cifrar. Se guarda cifrado en el servidor y viaja por HTTPS, pero una vez descargado es tu copia: lleva los planos y los presupuestos de tus obras. Guárdalo en un sitio seguro.
• Una exportación grande (muchas obras con sus planos) puede tardar en prepararse y ocupar bastante.