> ## Documentation Index > Fetch the complete documentation index at: https://docs.fire.rest/llms.txt > Use this file to discover all available pages before exploring further. # Importar y exportar > Descarga una copia de tu catálogo, edítala en Excel o llévala a otro ambiente, y revisa cada cambio antes de que se escriba. Cargar cientos de productos uno por uno, o mover el catálogo de un ambiente a otro a mano, es donde se cometen errores que se descubren con el cliente en la caja. **Importar y exportar** saca una copia de tus datos, te deja cambiarla fuera del backoffice y, antes de escribir nada, te muestra exactamente qué se crearía, qué se actualizaría y qué se eliminaría. > [!NOTE] > > **Lo mínimo que hay que saber** > > * Importar **nunca escribe de inmediato**: primero se analiza el archivo, tú revisas los cambios y solo entonces los aplicas. > * Antes de aplicar, Fire guarda un **respaldo** de los datos actuales. > * Importar **no sincroniza**: los cambios llegan a las tiendas y a los canales cuando sincronizas desde [Asignación de menús](https://docs.fire.rest/es/manuals/backoffice/menu-assignments.md). ## Requisitos previos * Acceso al backoffice de Fire en **[app.fire.rest](https://app.fire.rest)**, con permiso sobre la cuenta y el vendor. * La cuenta, el país y el vendor elegidos en el header. Sin ellos la pantalla pide que los selecciones. * Hoy se puede exportar e importar el **Catálogo**. Cuando se sumen otros datos, aparecerán en el mismo selector. ## El camino simple Abre **Operación → Importar y exportar** y elige **Catálogo** en **Datos**. Arriba hay dos pestañas, **Exportar** e **Importar**, y debajo el **Historial** de todo lo que se hizo. ![Pantalla Importar y exportar con el selector de datos, las pestañas Exportar e Importar y el Historial](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/01-page.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=0b1df6ac8b7995e0fd2c315edc2533a0) Lo más común es exportar, corregir y volver a importar: 1. En **Exportar**, elige el formato y toca **Solicitar exportación**. 2. Cuando la fila del **Historial** pase a **Lista**, toca **Descargar**. 3. Edita el archivo. 4. En **Importar**, sube el archivo y toca **Analizar archivo**. 5. Revisa **Qué cambiaría** y toca **Aplicar**. > [!TIP] > > Si solo quieres corregir precios o nombres de muchos productos, usa la **Planilla editable (Excel)** en modo **Combinar**. Con eso ya terminaste: no necesitas el resto de esta página. ## Exportar El archivo se prepara en segundo plano: puedes seguir trabajando y descargarlo desde el **Historial** cuando esté listo. ![Tarjeta Exportar con los dos formatos disponibles y el botón Solicitar exportación](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/02-export.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=377c5381175f1cf5a1dfd7d30deb4d63) Hay dos formatos y sirven para cosas distintas: | Formato | Para qué sirve | Qué incluye | | - | - | - | | **Respaldo completo (JSON)** | Guardar una copia fiel o llevar el catálogo a otro ambiente | Categorías, modificadores, listas de precios, productos y menús. **No** incluye asignaciones, tiendas ni agotados | | **Planilla editable (Excel)** | Cambiar muchos datos a la vez | Categorías, productos y precios en filas planas. **No** incluye combos, modificadores ni menús | El archivo exportado queda disponible para descargar **30 días**. Pasado ese plazo el **Historial** ya no ofrece **Descargar** y hay que solicitar una exportación nueva. ## Importar ![Tarjeta Importar con los campos Formato, Modo y Archivo y el botón Analizar archivo](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/03-import-form.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=dfb4198fbca4b2d3a135e7a2e1ae8b61) Elige el **Formato**, el **Modo** y el **Archivo**, y toca **Analizar archivo**. El archivo puede pesar hasta 64 MB. Los modos deciden qué pasa con lo que **no** está en el archivo: | Modo | Qué hace | | - | - | | **Combinar** | Crea y actualiza. No elimina nada | | **Reemplazar** | Deja los datos exactamente como están en el archivo y elimina lo que no está en él | > [!WARNING] > > **Reemplazar** solo lo puede usar un administrador de la plataforma y solo con un **Respaldo completo (JSON)**. La planilla siempre es **Combinar**. ## Revisar antes de aplicar Al subir el archivo, la importación pasa por **Analizando** y queda **Lista para revisar**. Toca **Revisar** en el **Historial** para abrir el detalle. Hasta aquí no se escribió nada. ![Detalle de una importación lista para revisar con el resumen Qué cambiaría](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/04-run-planned.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=9d3862ff2737f3b839efc497567eedb2) El detalle tiene hasta cuatro pestañas: * **Vista previa**: cada registro del archivo y qué pasaría con él (**Crear**, **Actualizar**, **Sin cambios**, **Eliminar**). **Ver cambios** muestra el valor **Antes** y **Después** de cada campo. * **Observaciones**: lo que el análisis encontró en el archivo. * **Ternas afectadas**: las combinaciones de tienda × canal × Tipo de Fulfillment que usan un menú o una lista de precios que cambia. * **Imágenes**: las imágenes que se copiarán al aplicar. Aparece cuando el análisis encuentra imágenes en el archivo, por ejemplo en un respaldo. ![Pestaña Vista previa con los cambios de un producto, con el valor Antes y Después](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/05-preview.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=9a0c1640d0732efc72525461c2805764) ### Las observaciones Cada observación es de uno de tres tipos: | Tipo | Qué significa | | - | - | | **Impide aplicar** | No se puede aplicar nada hasta corregirlo en el archivo y volver a subirlo | | **Fila omitida** | Esa fila no se aplica; el resto del archivo sí. Corrígela en la planilla y vuelve a subirla | | **Advertencia** | No impide aplicar, pero revísala | ![Pestaña Observaciones con dos filas omitidas, cada una con el problema, el registro y dónde está en el archivo](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/06-issues.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=c06daaa0448ab949738a3e04ec715dfc) ### Cuando el archivo no es válido Si el archivo no tiene el formato esperado, la importación queda en **Archivo inválido**. El detalle no tiene pestañas: solo muestra **El archivo no es válido** y las **Observaciones del análisis**, con observaciones **Impide aplicar** que indican la hoja y el campo del problema. No se escribió nada. Corrige el archivo y toca **Subir de nuevo**. ![Importación inválida con el aviso El archivo no es válido, el botón Subir de nuevo y dos observaciones Impide aplicar con la hoja y el campo](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/12-invalid.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=b6c3b75e437a315d4192d9109e91dd37) ### Aplicar o descartar Si el análisis no tiene errores que impidan aplicar, toca **Aplicar**, revisa el resumen de cuántos registros se crearán y actualizarán, y confirma. En modo **Reemplazar** el botón se llama **Reemplazar datos** y pide más confirmación (más abajo). Si algo no te convence, toca **Descartar**: no se escribe nada y, para importar después, tendrás que subir el archivo de nuevo. ![Ventana ¿Aplicar esta importación? con la cantidad de registros que se crearán y actualizarán](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/07-apply-confirm.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=dd943e064e2c4338cce4a4f728dcac48) > [!NOTE] > > El análisis vale **24 horas**: el detalle muestra hasta cuándo está vigente. Si pasa ese plazo, la importación queda **Vencida**, no se escribe nada y hay que subir el archivo de nuevo. ## Después de aplicar ### Sincroniza lo que cambió Importar no sincroniza. La pestaña **Ternas afectadas** lista qué combinaciones siguen con la versión anterior hasta que las sincronices. Toca **Ir a Asignación** para hacerlo desde [Asignación de menús](https://docs.fire.rest/es/manuals/backoffice/menu-assignments.md). ![Pestaña Ternas afectadas con el aviso de que importar no sincroniza y el botón Ir a Asignación](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/08-ternas.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=62c9acc5960aec8e269372820a30ece5) ### Las imágenes Si el archivo viene de otro ambiente, las imágenes se copian a este después de aplicar, en segundo plano: puedes salir de la página. Una imagen que no se pueda copiar **no detiene la importación**; el registro conserva su referencia. Si alguna falla, toca **Reintentar**. La pestaña muestra cuántas están **Copiadas**, **Pendientes**, **Fallidas** y cuántas **Ya están en este ambiente**. ![Pestaña Imágenes mientras se copian: el aviso de que puedes salir de la página y los contadores Por copiar y Ya están en este ambiente](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/09-images.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=1cfef723dcf53a6b5db0d1467478b0cd) ### Reemplazar y deshacer (administradores) Un administrador de la plataforma puede reemplazar los datos de un vendor. Antes de aplicar ve qué se eliminará y tiene que escribir el nombre del vendor para confirmar. ![Ventana ¿Reemplazar los datos de este vendor? con el aviso de lo que se elimina y el campo para escribir el nombre del vendor](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/10-replace-confirm.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=1a0903246fd03a7ce3c89b978f4c4c29) Nada se borra físicamente. En el detalle de una importación aplicada, **Descargar backup anterior** baja el respaldo guardado antes de escribir y **Deshacer** crea una importación nueva que devuelve los datos a ese respaldo. Esa importación también hay que revisarla y aplicarla. ## El Historial Cada exportación e importación queda en el **Historial** con fecha, usuario, formato, **Estado** y **Resumen**. Se actualiza solo mientras haya algo en curso. Filtra por tipo o por estado: **En curso**, **Por revisar**, **Terminadas** o **Con problemas**. ![Historial con exportaciones e importaciones en distintos estados y los filtros por tipo y estado](https://mintcdn.com/firepos/2QVkPvzzilOw2-K5/images/manuals/backoffice/data-transfers/11-history.png?fit=max\&auto=format\&n=2QVkPvzzilOw2-K5\&q=85\&s=8097b18a7e313e5ba6aad55a7c4c0c63) | Estado | Qué significa | | - | - | | **En cola** | Esperando su turno | | **Generando** | Se está preparando la exportación | | **Lista** | La exportación se puede descargar | | **Analizando** | Se está revisando el archivo importado | | **Lista para revisar** | El análisis terminó; falta que lo revises | | **Archivo inválido** | El archivo no tiene el formato esperado. No se escribió nada | | **En cola para aplicar** / **Aplicando** | Se están escribiendo los cambios | | **Aplicada** | Los cambios ya están escritos | | **Desactualizada** | Los datos cambiaron desde el análisis. Sube el archivo de nuevo | | **Descartada** / **Vencida** | No se escribió nada | | **Falló** | No se pudo completar. Vuelve a intentarlo; si sigue pasando, contacta a soporte | *** ## Recetas > **Subir el precio de muchos productos** > > 1. En **Exportar**, solicita la **Planilla editable (Excel)** y descárgala del **Historial** cuando esté **Lista**. > 2. Abre el archivo y cambia los precios que necesites en la hoja **Precios**. No cambies los códigos de producto: con ellos Fire encuentra cada fila. > 3. En **Importar**, elige **Planilla editable (Excel)**, modo **Combinar**, sube el archivo y toca **Analizar archivo**. > 4. En el detalle, deja la **Vista previa** en **Solo cambios** y confirma que solo cambian los precios que tocaste. > 5. Toca **Aplicar** y confirma. > 6. Sincroniza desde [Asignación de menús](https://docs.fire.rest/es/manuals/backoffice/menu-assignments.md) para que los canales reciban los precios. > **Llevar el catálogo de un ambiente a otro** > > 1. En el ambiente de origen, solicita el **Respaldo completo (JSON)** y descárgalo. > 2. En el ambiente de destino, abre **Importar**, elige **Respaldo completo (JSON)**, modo **Combinar**, y sube el archivo. > 3. Revisa las **Observaciones**: avisan si el archivo viene de otro país o si un identificador ya pertenece a otra cuenta. > 4. Toca **Aplicar**. > 5. Las imágenes se copian solas desde el ambiente de origen: mira la pestaña **Imágenes** y reintenta las que fallen. > 6. El respaldo no trae asignaciones ni tiendas: asigna el menú a cada tienda y sincroniza desde **Asignación de menús**. > **Dejar un vendor igual a otro (administradores)** > > 1. Solicita el **Respaldo completo (JSON)** del vendor que quieres copiar. > 2. En el vendor que quieres igualar, abre **Importar**, elige **Respaldo completo (JSON)** y el modo **Reemplazar**. > 3. Toca **Analizar archivo** y revisa en la **Vista previa** qué registros aparecen como **Eliminar**. > 4. Toca **Reemplazar datos**, revisa cuántos registros se eliminan y escribe el nombre del vendor. > 5. Revisa las **Ternas afectadas** y sincroniza. Las que quedaron sin menú o lista de precios hay que asignarlas a mano. > **Me equivoqué al aplicar** > > 1. En el **Historial**, toca la importación **Aplicada** para abrir su detalle. > 2. Si quieres conservar la copia anterior, toca **Descargar backup anterior**. > 3. Toca **Deshacer** y confirma. > 4. Se crea una importación nueva en modo **Reemplazar** con el respaldo guardado antes de aplicar. Espera a que esté **Lista para revisar**. > 5. Revísala y toca **Reemplazar datos**. > 6. Si ya habías sincronizado los cambios, vuelve a sincronizar desde **Asignación de menús**. > > **Deshacer** solo lo ven los administradores. Si no lo eres, pídele a uno que lo haga. ## Un ejemplo con números Con el Sandbox Brasil se exportó la **Planilla editable (Excel)**: 1404 precios, 280 productos y 14 categorías. En el archivo se cambiaron 12 precios y la descripción de 1 producto, se agregó 1 producto nuevo (**Limonada de la casa**) y se dejaron dos filas con datos que no existen: la categoría **Bebidas de temporada**, cuyo padre no está en el catálogo, y un precio para el código `NO-EXISTE-0000`. El análisis dio esto: | Elemento | Crear | Actualizar | Sin cambios | Omitido | | - | - | - | - | - | | Precios | 0 | 12 | 1392 | 1 | | Productos | 1 | 1 | 279 | 0 | | Categorías | 0 | 0 | 14 | 1 | Al tocar **Aplicar**, la ventana dice "Se crearán 1 y se actualizarán 13 registros": el producto nuevo, el producto actualizado y los 12 precios. Las 2 filas omitidas no se aplican; el resto del archivo sí. ## Errores que salen caros > [!WARNING] > > **Creer que importar ya llegó a las tiendas.** Importar no sincroniza. Hasta que sincronices desde **Asignación de menús**, las tiendas y los canales siguen con la versión anterior. > [!WARNING] > > **Usar Reemplazar para "agregar unos productos".** **Reemplazar** elimina todo lo que no está en el archivo. Para agregar o corregir, usa **Combinar**. > [!WARNING] > > **Importar un respaldo de otra cuenta o de otro país sin revisar.** Revisa las **Observaciones**: avisan si el archivo viene de otro país o si un identificador ya pertenece a otra cuenta. > [!WARNING] > > **Aplicar con advertencias sin leerlas.** No impiden aplicar, pero pueden avisar de productos que parecen duplicados o de listas de precios hijas que se recalculan a partir de su lista madre. ## Glosario | Término | Qué significa | | - | - | | **Exportación** | Un archivo con una copia de tus datos | | **Importación** | Subir un archivo para cambiar tus datos | | **Respaldo** | La copia de tus datos que Fire guarda antes de aplicar una importación | | **Terna** | Una combinación de tienda × canal × Tipo de Fulfillment | | **Vendor** | La marca o negocio dentro de la cuenta sobre el que trabajas | ## Preguntas frecuentes > **Subí el archivo y dice Archivo inválido** > > El archivo no tiene el formato esperado. Descarga una exportación nueva del mismo formato, edítala y vuelve a subirla. No se escribió nada. > **Dice que los datos cambiaron desde el análisis** > > Alguien modificó el catálogo entre el análisis y el momento de aplicar. Sube el archivo de nuevo para analizarlo con los datos actuales. > **No me deja solicitar otra exportación** > > Hay un máximo de 5 exportaciones o importaciones en curso a la vez. Espera a que termine alguna. > **No veo la opción Reemplazar** > > Está reservada a administradores de la plataforma. > **¿Hasta cuándo puedo descargar una exportación?** > > Durante 30 días desde que se generó. Después, el **Historial** ya no ofrece **Descargar** y tienes que solicitar otra. ## Lo que viene * Hoy solo se exporta e importa el **Catálogo**. Otros datos se sumarán en esta misma pantalla. * Importar **no sincroniza** y no incluye asignaciones de menús, tiendas ni agotados. * La **Planilla editable (Excel)** no elimina datos ni incluye combos, modificadores ni menús. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.