> ## 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 e exportar > Baixe uma cópia do seu catálogo, edite no Excel ou leve para outro ambiente, e revise cada alteração antes de ela ser gravada. Cadastrar centenas de produtos um a um, ou mover o catálogo de um ambiente para outro à mão, é onde nascem os erros que só aparecem para o cliente no caixa. **Importar e exportar** tira uma cópia dos seus dados, deixa você alterá-la fora do backoffice e, antes de gravar qualquer coisa, mostra exatamente o que seria criado, atualizado e excluído. > [!NOTE] > > **O mínimo que você precisa saber** > > * Importar **nunca grava na hora**: primeiro o arquivo é analisado, você revisa as alterações e só então as aplica. > * Antes de aplicar, o Fire guarda um **backup** dos dados atuais. > * Importar **não sincroniza**: as alterações chegam às lojas e aos canais quando você sincroniza em [Atribuição de menus](https://docs.fire.rest/pt/manuals/backoffice/menu-assignments.md). ## Pré-requisitos * Acesso ao backoffice do Fire em **[app.fire.rest](https://app.fire.rest)**, com permissão na conta e no vendor. * A conta, o país e o vendor escolhidos no header. Sem eles a tela pede que você os selecione. * Hoje é possível exportar e importar o **Catálogo**. Quando outros dados forem incluídos, aparecerão no mesmo seletor. ## O caminho simples Abra **Operação → Importar e exportar** e escolha **Catálogo** em **Dados**. No alto há duas abas, **Exportar** e **Importar**, e abaixo delas o **Histórico** de tudo o que foi feito. ![Tela Importar e exportar com o seletor de dados, as abas Exportar e Importar e o Histórico](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) O fluxo mais comum é exportar, corrigir e importar de volta: 1. Em **Exportar**, escolha o formato e toque em **Solicitar exportação**. 2. Quando a linha do **Histórico** passar para **Pronta**, toque em **Baixar**. 3. Edite o arquivo. 4. Em **Importar**, envie o arquivo e toque em **Analisar arquivo**. 5. Revise **O que mudaria** e toque em **Aplicar**. > [!TIP] > > Se você só quer corrigir preços ou nomes de muitos produtos, use a **Planilha editável (Excel)** no modo **Mesclar**. Com isso você já terminou: não precisa do resto desta página. ## Exportar O arquivo é preparado em segundo plano: você pode continuar trabalhando e baixá-lo pelo **Histórico** quando estiver pronto. ![Cartão Exportar com os dois formatos disponíveis e o botão Solicitar exportação](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) Há dois formatos e eles servem para coisas diferentes: | Formato | Para que serve | O que inclui | | - | - | - | | **Backup completo (JSON)** | Guardar uma cópia fiel ou levar o catálogo para outro ambiente | Categorias, modificadores, listas de preços, produtos e menus. **Não** inclui atribuições, lojas nem itens esgotados | | **Planilha editável (Excel)** | Alterar muitos dados de uma vez | Categorias, produtos e preços em linhas simples. **Não** inclui combos, modificadores nem menus | O arquivo exportado fica disponível para baixar por **30 dias**. Depois disso o **Histórico** deixa de oferecer **Baixar** e é preciso solicitar uma nova exportação. ## Importar ![Cartão Importar com os campos Formato, Modo e Arquivo e o botão Analisar arquivo](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) Escolha o **Formato**, o **Modo** e o **Arquivo**, e toque em **Analisar arquivo**. O arquivo pode ter até 64 MB. Os modos decidem o que acontece com o que **não** está no arquivo: | Modo | O que faz | | - | - | | **Mesclar** | Cria e atualiza. Não exclui nada | | **Substituir** | Deixa os dados exatamente como estão no arquivo e exclui o que não está nele | > [!WARNING] > > **Substituir** só pode ser usado por um administrador da plataforma e apenas com um **Backup completo (JSON)**. A planilha é sempre **Mesclar**. ## Revisar antes de aplicar Ao enviar o arquivo, a importação passa por **Analisando** e fica **Pronta para revisar**. Toque em **Revisar** no **Histórico** para abrir o detalhe. Até aqui nada foi gravado. ![Detalhe de uma importação pronta para revisar com o resumo O que mudaria](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) O detalhe tem até quatro abas: * **Prévia**: cada registro do arquivo e o que aconteceria com ele (**Criar**, **Atualizar**, **Sem alterações**, **Excluir**). **Ver alterações** mostra o valor **Antes** e **Depois** de cada campo. * **Observações**: o que a análise encontrou no arquivo. * **Combinações afetadas**: as combinações de loja × canal × Tipo de Fulfillment que usam um menu ou uma lista de preços que muda. * **Imagens**: as imagens que serão copiadas ao aplicar. Aparece quando a análise encontra imagens no arquivo, por exemplo em um backup. ![Aba Prévia com as alterações de um produto, com o valor Antes e Depois](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) ### As observações Cada observação é de um de três tipos: | Tipo | O que significa | | - | - | | **Impede aplicar** | Nada pode ser aplicado até corrigir no arquivo e enviá-lo de novo | | **Linha omitida** | Essa linha não é aplicada; o resto do arquivo é. Corrija na planilha e envie de novo | | **Aviso** | Não impede aplicar, mas revise | ![Aba Observações com duas linhas omitidas, cada uma com o problema, o registro e onde está no arquivo](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) ### Quando o arquivo não é válido Se o arquivo não tem o formato esperado, a importação fica em **Arquivo inválido**. O detalhe não tem abas: mostra apenas **O arquivo não é válido** e as **Observações da análise**, com observações **Impede aplicar** que indicam a aba e o campo do problema. Nada foi gravado. Corrija o arquivo e toque em **Enviar novamente**. ![Importação inválida com o aviso O arquivo não é válido, o botão Enviar novamente e duas observações Impede aplicar com a aba e o 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 ou descartar Se a análise não tem erros que impeçam aplicar, toque em **Aplicar**, revise o resumo de quantos registros serão criados e atualizados e confirme. No modo **Substituir** o botão se chama **Substituir dados** e pede mais confirmação (mais abaixo). Se algo não convencer, toque em **Descartar**: nada é gravado e, para importar depois, você terá que enviar o arquivo de novo. ![Janela Aplicar esta importação? com a quantidade de registros que serão criados e atualizados](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] > > A análise vale por **24 horas**: o detalhe mostra até quando. Se esse prazo passar, a importação fica **Expirada**, nada é gravado e é preciso enviar o arquivo de novo. ## Depois de aplicar ### Sincronize o que mudou Importar não sincroniza. A aba **Combinações afetadas** lista quais combinações continuam com a versão anterior até você sincronizá-las. Toque em **Ir para Atribuição** para fazer isso em [Atribuição de menus](https://docs.fire.rest/pt/manuals/backoffice/menu-assignments.md). ![Aba Combinações afetadas com o aviso de que importar não sincroniza e o botão Ir para Atribuição](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) ### As imagens Se o arquivo vem de outro ambiente, as imagens são copiadas para este depois de aplicar, em segundo plano: você pode sair da página. Uma imagem que não puder ser copiada **não interrompe a importação**; o registro mantém a referência. Se alguma falhar, toque em **Tentar novamente**. A aba mostra quantas estão **Copiadas**, **Pendentes**, **Com falha** e quantas **Já estão neste ambiente**. ![Aba Imagens durante a cópia: o aviso de que você pode sair da página e os contadores A copiar e Já estão neste 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) ### Substituir e desfazer (administradores) Um administrador da plataforma pode substituir os dados de um vendor. Antes de aplicar ele vê o que será excluído e precisa digitar o nome do vendor para confirmar. ![Janela Substituir os dados deste vendor? com o aviso do que é excluído e o campo para digitar o nome do 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 é removido fisicamente. No detalhe de uma importação aplicada, **Baixar backup anterior** baixa o backup guardado antes de gravar e **Desfazer** cria uma nova importação que devolve os dados a esse backup. Essa importação também precisa ser revisada e aplicada. ## O Histórico Cada exportação e importação fica no **Histórico** com data, usuário, formato, **Status** e **Resumo**. Ele atualiza sozinho enquanto houver algo em andamento. Filtre por tipo ou por status: **Em andamento**, **Para revisar**, **Concluídas** ou **Com problemas**. ![Histórico com exportações e importações em diferentes status e os filtros por tipo e status](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) | Status | O que significa | | - | - | | **Na fila** | Esperando a vez | | **Gerando** | A exportação está sendo preparada | | **Pronta** | A exportação pode ser baixada | | **Analisando** | O arquivo importado está sendo revisado | | **Pronta para revisar** | A análise terminou; falta você revisar | | **Arquivo inválido** | O arquivo não tem o formato esperado. Nada foi gravado | | **Na fila para aplicar** / **Aplicando** | As alterações estão sendo gravadas | | **Aplicada** | As alterações já estão gravadas | | **Desatualizada** | Os dados mudaram desde a análise. Envie o arquivo de novo | | **Descartada** / **Expirada** | Nada foi gravado | | **Falhou** | Não foi possível concluir. Tente de novo; se continuar, fale com o suporte | *** ## Receitas > **Aumentar o preço de muitos produtos** > > 1. Em **Exportar**, solicite a **Planilha editável (Excel)** e baixe-a do **Histórico** quando estiver **Pronta**. > 2. Abra o arquivo e altere os preços de que precisar na aba **Precios**. Não altere os códigos de produto: o Fire os usa para encontrar cada linha. > 3. Em **Importar**, escolha **Planilha editável (Excel)**, modo **Mesclar**, envie o arquivo e toque em **Analisar arquivo**. > 4. No detalhe, deixe a **Prévia** em **Somente alterações** e confirme que só mudam os preços que você alterou. > 5. Toque em **Aplicar** e confirme. > 6. Sincronize em [Atribuição de menus](https://docs.fire.rest/pt/manuals/backoffice/menu-assignments.md) para que os canais recebam os preços. > **Levar o catálogo de um ambiente para outro** > > 1. No ambiente de origem, solicite o **Backup completo (JSON)** e baixe-o. > 2. No ambiente de destino, abra **Importar**, escolha **Backup completo (JSON)**, modo **Mesclar**, e envie o arquivo. > 3. Revise as **Observações**: elas avisam se o arquivo vem de outro país ou se um identificador já pertence a outra conta. > 4. Toque em **Aplicar**. > 5. As imagens são copiadas sozinhas a partir do ambiente de origem: veja a aba **Imagens** e tente de novo as que falharem. > 6. O backup não traz atribuições nem lojas: atribua o menu a cada loja e sincronize em **Atribuição de menus**. > **Deixar um vendor igual a outro (administradores)** > > 1. Solicite o **Backup completo (JSON)** do vendor que você quer copiar. > 2. No vendor que você quer igualar, abra **Importar**, escolha **Backup completo (JSON)** e o modo **Substituir**. > 3. Toque em **Analisar arquivo** e veja na **Prévia** quais registros aparecem como **Excluir**. > 4. Toque em **Substituir dados**, revise quantos registros serão excluídos e digite o nome do vendor. > 5. Revise as **Combinações afetadas** e sincronize. As que ficaram sem menu ou lista de preços precisam ser atribuídas à mão. > **Errei ao aplicar** > > 1. No **Histórico**, toque na importação **Aplicada** para abrir o detalhe. > 2. Se quiser guardar a cópia anterior, toque em **Baixar backup anterior**. > 3. Toque em **Desfazer** e confirme. > 4. Uma nova importação no modo **Substituir** é criada com o backup guardado antes de aplicar. Espere até ela ficar **Pronta para revisar**. > 5. Revise e toque em **Substituir dados**. > 6. Se você já tinha sincronizado as alterações, sincronize de novo em **Atribuição de menus**. > > **Desfazer** só aparece para administradores. Se você não for um, peça a um deles. ## Um exemplo com números Com o Sandbox Brasil, foi exportada a **Planilha editável (Excel)**: 1404 preços, 280 produtos e 14 categorias. No arquivo, 12 preços e a descrição de 1 produto foram alterados, 1 produto novo (**Limonada de la casa**) foi adicionado e ficaram duas linhas com dados que não existem: a categoria **Bebidas de temporada**, cujo pai não está no catálogo, e um preço para o código `NO-EXISTE-0000`. A análise mostrou isto: | Item | Criar | Atualizar | Sem alterações | Ignorado | | - | - | - | - | - | | Preços | 0 | 12 | 1392 | 1 | | Produtos | 1 | 1 | 279 | 0 | | Categorias | 0 | 0 | 14 | 1 | Ao tocar em **Aplicar**, a janela diz "Serão criados 1 e atualizados 13 registros": o produto novo, o produto atualizado e os 12 preços. As 2 linhas omitidas não são aplicadas; o resto do arquivo é. ## Erros que custam caro > [!WARNING] > > **Achar que importar já chegou às lojas.** Importar não sincroniza. Até você sincronizar em **Atribuição de menus**, as lojas e os canais continuam com a versão anterior. > [!WARNING] > > **Usar Substituir para "adicionar alguns produtos".** **Substituir** exclui tudo o que não está no arquivo. Para adicionar ou corrigir, use **Mesclar**. > [!WARNING] > > **Importar um backup de outra conta ou de outro país sem conferir.** Revise as **Observações**: elas avisam se o arquivo vem de outro país ou se um identificador já pertence a outra conta. > [!WARNING] > > **Aplicar com avisos sem lê-los.** Eles não impedem aplicar, mas podem alertar sobre produtos que parecem duplicados ou listas de preços filhas que são recalculadas a partir da lista mãe. ## Glossário | Termo | O que significa | | - | - | | **Exportação** | Um arquivo com uma cópia dos seus dados | | **Importação** | Enviar um arquivo para alterar seus dados | | **Backup** | A cópia dos seus dados que o Fire guarda antes de aplicar uma importação | | **Combinação** | Uma combinação de loja × canal × Tipo de Fulfillment | | **Vendor** | A marca ou negócio dentro da conta em que você trabalha | ## Perguntas frequentes > **Enviei o arquivo e aparece Arquivo inválido** > > O arquivo não tem o formato esperado. Baixe uma exportação nova no mesmo formato, edite e envie de novo. Nada foi gravado. > **Diz que os dados mudaram desde a análise** > > Alguém alterou o catálogo entre a análise e o momento de aplicar. Envie o arquivo de novo para analisá-lo com os dados atuais. > **Não consigo solicitar outra exportação** > > Há um máximo de 5 exportações ou importações em andamento ao mesmo tempo. Espere alguma terminar. > **Não vejo a opção Substituir** > > Ela é reservada a administradores da plataforma. > **Até quando posso baixar uma exportação?** > > Por 30 dias a partir de quando ela foi gerada. Depois disso, o **Histórico** deixa de oferecer **Baixar** e é preciso solicitar outra. ## O que vem por aí * Hoje só o **Catálogo** é exportado e importado. Outros dados serão incluídos nesta mesma tela. * Importar **não sincroniza** e não inclui atribuições de menus, lojas nem itens esgotados. * A **Planilha editável (Excel)** não exclui dados nem inclui combos, modificadores ou menus. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.