> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.
# cadastrar catálogos por importação
a importação monta um ou mais catálogos a partir de uma planilha. é a forma mais rápida de colocar uma coleção grande no ar, mantendo a organização já definida pela marca.
a planilha vale como a lista completa do catálogo. importar sobre um código que já existe apaga as seções e os produtos atuais e grava o que está no arquivo: linha apagada é produto que sai do catálogo.
## importar
para começar do zero, acesse **configurações** → **importações de arquivo** → botão de ação → **modelos de importação** → **catálogo**.
para editar um catálogo que já existe, abra o catálogo → **exportar** → **modelo de importação**. o arquivo baixa com os dados atuais.
preencha uma linha por produto e cor, com os códigos da plataforma teceo. as colunas que descrevem o catálogo se repetem em todas as linhas, sempre com o mesmo valor.
em **importações de arquivo**, envie a planilha em xlsx. código de catálogo que ainda não existe cria um catálogo novo.
a tela de detalhe da importação mostra o andamento e lista as linhas com erro, com a coluna e a mensagem de cada uma.
abra o catálogo e configure acesso, capa, banners, compartilhamento público e experiência de navegação. em seguida, selecione o catálogo na listagem e clique em **ativar catálogos**.
## o que cada coluna recebe
| coluna | o que preencher | obrigatória |
| - | - | - |
| cód catálogo | o código do catálogo na plataforma, em todas as linhas | sim |
| nome catálogo | o nome que aparece na listagem e dentro do catálogo | sim |
| data inicial | a data em que o catálogo passa a ficar visível, em DD/MM/AAAA | não |
| horário de início | o horário de início, em HH:MM | com a data inicial preenchida |
| data final | a data em que o catálogo deixa de ficar visível, em DD/MM/AAAA | não |
| horário de fim | o horário de fim, em HH:MM | com a data final preenchida |
| URL live shop | o endereço da live shop | não |
| agrupar seções | manual, coleção, categoria, subcategoria ou classificação do produto. define como as seções do catálogo são criadas | não |
| cód tipo classificação do agrupamento | o código do tipo de classificação usado no agrupamento | com o agrupamento por classificação do produto |
| ordenar seções | manual, nome do produto, código do produto, referência do produto ou tipo de classificação do produto. define a ordem dos produtos no catálogo; a ordem das seções entre si vem de **posição seção** | não |
| cód tipo classificação | o código da classificação usada como critério de ordenação | com o critério tipo de classificação do produto |
| ativo | sim ou não | sim |
| nome seção | o nome da seção que recebe o produto | não |
| posição seção | a posição da seção no catálogo | com a seção nomeada |
| cód produto | o código do produto na plataforma | sim |
| referência produto | a referência do produto, apenas para leitura | não |
| cód cor | o código da cor, entre as variações daquele produto | sim |
coluna renomeada, faltando ou a mais reprova o arquivo antes de qualquer linha ser processada.
com **agrupar seções** diferente de manual, as colunas **nome seção** e **posição seção** precisam ficar em branco: é o critério que decide em qual seção cada produto entra.
## o que acontece em cada caso
| na planilha | resultado |
| - | - |
| um código que ainda não existe na marca | cria um catálogo novo com esse código |
| um código que já existe | substitui as seções e os produtos daquele catálogo pelo conteúdo do arquivo |
| a célula apagada em uma linha | o processamento não conclui. o código precisa estar preenchido em todas as linhas |
| um código que perdeu o zero à esquerda ao virar número | não encontra o catálogo e cria um novo |
| códigos diferentes entre as linhas | o arquivo inteiro é reprovado |
| na planilha | resultado |
| - | - |
| o nome alterado em um catálogo que já existe | o catálogo é renomeado |
| o nome apagado | erro de campo obrigatório |
| as datas apagadas | o catálogo fica sem vigência e segue visível enquanto estiver ativo |
| a data inicial preenchida e o horário de início apagado | erro na linha |
| a data final preenchida e o horário de fim apagado | erro na linha |
| a data final sem a data inicial | aceito |
| a data inicial no passado | aceito. o catálogo entra fora da vigência |
| qualquer um desses campos com valor diferente entre as linhas | o arquivo inteiro é reprovado |
| na planilha | resultado |
| - | - |
| ativo apagado | o catálogo fica inativo |
| ativo alterado para não em um catálogo no ar | o catálogo é inativado |
| ordenar seções apagado | assume manual |
| o critério escrito sem o acento correto | erro de valor inválido |
| o critério tipo de classificação do produto sem o cód tipo classificação | erro na linha |
| o cód tipo classificação preenchido com outro critério | ignorado, sem erro |
| o critério manual | os produtos entram em ordem alfabética por nome, e a ordem das linhas não é considerada |
| na planilha | resultado |
| - | - |
| nome seção apagado | o produto vai para a seção padrão |
| uma seção nomeada sem posição seção | erro na linha |
| posições com lacuna, como 1, 2 e 4 | o arquivo inteiro é reprovado. a sequência não precisa começar em 0 |
| a mesma seção com posições diferentes entre as linhas | o arquivo inteiro é reprovado |
| linhas sem nome seção | não entram na contagem das posições |
| a posição alterada em uma reimportação | as seções são reordenadas e recriadas com novos identificadores |
| a mesma seção escrita com espaços diferentes | são criadas duas seções |
| uma seção que existia no catálogo e não está no arquivo | a seção deixa de existir |
| na planilha | resultado |
| - | - |
| uma linha apagada | o produto e a cor daquela linha saem do catálogo |
| cód produto ou cód cor apagado | erro de campo obrigatório na linha |
| o cód cor alterado em uma linha | a cor antiga sai do catálogo e a nova entra |
| um código de produto ou de cor que não existe na marca | erro na linha |
| uma cor que existe na marca e não é variação daquele produto | erro na linha |
| um produto inativo ou arquivado na marca | entra normalmente |
| um produto sem foto, ou uma cor sem estoque | entra normalmente |
| a mesma combinação de produto e cor repetida | o arquivo inteiro é reprovado |
| a referência alterada | nada, a coluna é ignorada na gravação |
planilha sem nenhuma linha de produto não altera nada, e a importação aparece como concluída.
## conteúdos relacionados
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.