Saltar para o conteúdo principal
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.
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.

​
Pré-requisitos

  • Acesso ao backoffice do Fire em 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
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.
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
Há dois formatos e eles servem para coisas diferentes: 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
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:
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
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

​
As observações

Cada observação é de um de três tipos:
Aba Observações com duas linhas omitidas, cada uma com o problema, o registro e onde está no arquivo

​
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

​
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
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.
Aba Combinações afetadas com o aviso de que importar não sincroniza e o botão Ir para Atribuição

​
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

​
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
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

​
Receitas

  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 para que os canais recebam os preços.
  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.
  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.
  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: 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

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.
Usar Substituir para “adicionar alguns produtos”. Substituir exclui tudo o que não está no arquivo. Para adicionar ou corrigir, use Mesclar.
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.
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

​
Perguntas frequentes

O arquivo não tem o formato esperado. Baixe uma exportação nova no mesmo formato, edite e envie de novo. Nada foi gravado.
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.
Há um máximo de 5 exportações ou importações em andamento ao mesmo tempo. Espere alguma terminar.
Ela é reservada a administradores da plataforma.
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.