Essa planilha segue um modelo semelhante ao exemplo apresentado, contendo informações como ID, categoria do extra, quantidade mínima e máxima, regra de seleção, obrigatoriedade, nome do item, código, preço, status de publicação, prioridade e produtos vinculados.
A exportação é indicada quando você deseja fazer uma cópia dos dados atuais, revisar as informações cadastradas ou editar muitos extras de uma só vez. Após exportar, a planilha pode ser alterada mantendo a mesma estrutura de colunas. É importante não remover ou renomear os cabeçalhos da planilha, pois eles são utilizados pelo sistema para identificar corretamente cada informação durante a importação.
Para realizar a importação, é necessário utilizar uma planilha no mesmo formato da exportada pelo sistema. Cada linha da planilha representa uma opção de uma categoria de extra. Campos como category_id e category_category identificam o grupo de extras, enquanto o campo name representa o nome da opção exibida para o cliente. O campo price define o valor adicional, quando houver, e o campo published indica se o item estará ativo no cardápio.
Quando a planilha for importada, o sistema irá ler os dados informados e cadastrar ou atualizar as categorias de extras conforme as informações preenchidas. Para atualizações, é recomendado manter os IDs originais exportados, pois eles ajudam o sistema a identificar quais registros já existem. Para novos itens, os campos de identificação podem ser preenchidos conforme a regra do modelo utilizado pela loja ou conforme orientação do suporte.
Entendendo os campos da planilha
A coluna id representa o identificador interno da linha ou do item dentro do sistema. Quando a planilha for usada para atualizar informações já cadastradas, é recomendado manter esse ID original, pois ele ajuda o sistema a localizar o registro correto. Em novos cadastros, esse campo pode ser preenchido conforme o padrão utilizado pela loja ou conforme orientação do suporte.
A coluna category_id identifica o grupo de extra ao qual a opção pertence. Todas as opções de uma mesma pergunta devem usar o mesmo category_id. Por exemplo, se o grupo for "Leite Vegetal?" e as opções forem "Sim, por favor!" e "Não", as duas linhas devem ter o mesmo category_id, pois pertencem à mesma categoria de escolha.
A coluna category_category é o nome da categoria de extra ou da pergunta que será exibida ao cliente. Ela pode ser preenchida com textos como "Leite Vegetal?", "Como prefere sua bebida?", "Deseja adoçar sua bebida?" ou "Escolha até 2 sabores". Normalmente, esse campo aparece preenchido na primeira linha do grupo, e as demais opções continuam ligadas a ele pelo mesmo category_id.
A coluna category_reference_id é uma referência interna da categoria de extra. Esse código é utilizado pelo sistema para identificar aquele grupo de complemento. Ao editar uma planilha exportada, recomenda-se manter esse valor quando ele já existir.
A coluna category_min define a quantidade mínima de opções que o cliente deve selecionar dentro daquele grupo. Se o grupo for obrigatório e o cliente precisar escolher uma opção, informe 1. Se a escolha for opcional, o mínimo pode ser 0, conforme a configuração desejada.
A coluna category_max define a quantidade máxima de opções que o cliente pode selecionar dentro do grupo. Em uma pergunta com apenas uma resposta, como "Sim" ou "Não", o máximo deve ser 1. Em um grupo como "Escolha até 2 sabores", o máximo deve ser 2.
A coluna category_rule é utilizada para regras específicas de cobrança ou comportamento da categoria de extra. Quando não houver uma regra especial definida, esse campo pode permanecer vazio, seguindo o padrão da planilha exportada pelo sistema.
A coluna category_required indica se o grupo de extras é obrigatório ou opcional. O valor 1 indica que o cliente precisa selecionar uma opção antes de continuar o pedido. O valor 0 indica que a escolha não é obrigatória.
A coluna name representa o nome da opção exibida para o cliente dentro do grupo de extras. Exemplos de opções são "Sim, por favor!", "Não", "Natural", "Gelada", "Sachê açúcar", "Sem adoçar" ou "Borda de doce de leite".
A coluna code representa o código ou SKU da opção. Esse campo pode ser usado para identificação interna, controle de produtos ou integração com outros sistemas. Ao atualizar itens já cadastrados, é recomendado manter o código original exportado.
A coluna desc pode ser utilizada para adicionar uma descrição à opção. Esse campo é opcional e pode ficar vazio caso não seja necessário apresentar uma explicação adicional para o cliente.
A coluna price define o valor adicional da opção. Se a opção tiver acréscimo, informe o valor correspondente. Por exemplo, se escolher "Sim, por favor!" em "Leite Vegetal?" acrescentar R$ 4,00 ao pedido, o campo deve ser preenchido com 4. Se a opção não tiver custo adicional, o campo pode ser preenchido com 0 ou seguir o padrão da planilha exportada.
A coluna image é utilizada quando a opção possui uma imagem vinculada. Caso o item não tenha imagem, esse campo pode permanecer vazio.
A coluna limit_free é utilizada quando existe uma quantidade de opções gratuitas dentro de uma categoria de extras. Esse campo pode ser útil em grupos de adicionais, sabores ou complementos onde parte da seleção não será cobrada. Quando não houver limite gratuito configurado, o campo pode permanecer vazio ou seguir o padrão da exportação.
A coluna published indica se a opção está publicada e disponível no cardápio. O valor 1 significa que o item está ativo e visível. O valor 0 indica que o item está inativo ou oculto.
A coluna priority define a ordem de exibição das opções dentro da categoria. Itens com prioridade menor aparecem primeiro. Por exemplo, uma opção com prioridade 0 será exibida antes de uma opção com prioridade 1.
A coluna products indica os produtos vinculados àquela categoria de extra. Quando houver mais de um produto relacionado, os IDs podem aparecer separados por vírgula, como 49,50,51,52,53,54. Esse vínculo garante que a categoria de complemento seja exibida apenas nos produtos corretos do cardápio.
Na prática, para criar uma pergunta como "Leite Vegetal?", é possível usar o mesmo category_id para as duas opções. A primeira linha pode conter o nome da categoria em category_category, com category_min igual a 1, category_max igual a 1 e category_required igual a 1. A opção "Sim, por favor!" pode ter valor adicional no campo price, enquanto a opção "Não" pode ficar com valor 0. Dessa forma, o cliente será obrigado a escolher apenas uma das duas opções.
As opções "Extras de produtos para categorias" e "Extras de categoria para produtos" são utilizadas para ajustar ou sincronizar os vínculos entre extras, categorias e produtos. Elas ajudam a relacionar os adicionais corretamente aos produtos do cardápio, garantindo que o cliente veja apenas as opções correspondentes ao item que está comprando.
Antes de importar uma nova planilha, recomenda-se sempre exportar os dados atuais como backup. Dessa forma, caso alguma informação seja preenchida incorretamente, será possível consultar ou restaurar os dados anteriores com mais segurança.
