> ## 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. # importar casos por planilha a planilha cria e atualiza casos em massa, uma linha por caso. para atualizar casos que já existem, o caminho é [exportar no modelo de importação](/docs/casos/exportar-casos), editar o arquivo e importar de volta. a importação não segue o fluxo de atendimento configurado, e isso tem três consequências. ela não envia e-mail, não registra no histórico do caso e não notifica as integrações, nem ao criar nem ao mudar a etapa. quem acompanha o caso não é informado da alteração. ela define a etapa diretamente, sem verificar quem pode avançar, sem seguir a ordem configurada, e reabre caso fechado. nada bloqueia a importação em marca com integração ativa, então a planilha pode sobrescrever dados que vieram do seu sistema de gestão. ## importar 1. **baixe o modelo** acesse **configurações** → **importações de arquivo**, clique em **baixar modelo** e escolha **casos `{nome do tipo}`**. o modelo é gerado no momento do download para aquele tipo de caso, com a lista de etapas válidas e as colunas de campo personalizado dele. o modelo de um tipo não serve para outro. 2. **entenda a aba dados** o arquivo tem duas abas, orientações e dados, e o preenchimento acontece na segunda. a linha 1 traz os nomes das colunas e a linha 2 as obrigatoriedades. os dados começam na linha 3, onde o modelo já vem com duas linhas de exemplo: apague as duas antes de importar. a aba precisa manter o nome dados. 3. **decida, linha por linha, entre criar e atualizar** a coluna nº do caso é o que determina isso. * para criar um caso novo, deixe nº do caso em branco. * para atualizar um caso que já existe, preencha nº do caso com o número dele. quando o número não localiza nenhum caso, a busca tenta o código externo. o número do caso é único por marca, não por tipo: informar o número de um caso de outro tipo faz a linha falhar. 4. **identifique o cliente nas linhas de criação** preencha código teceo de cliente ou n° do documento. a busca tenta o código primeiro e o documento depois. a planilha nunca cria cliente: o cliente precisa existir antes. nas linhas de atualização essas colunas são apenas referência, e o cliente do caso não é trocado. 5. **preencha os dados do caso** tipo do caso vale em toda linha, criando ou atualizando, e é ele que define qual configuração se aplica. tipo do caso e status do caso são resolvidos pelo nome exato cadastrado na sua marca, e espaço e sublinhado são equivalentes. ao atualizar, status do caso em branco mantém a etapa atual do caso. 6. **importe o arquivo** em **importações de arquivo**, clique em **importar arquivo**, escolha **casos `{nome do tipo}`** e envie o arquivo em xlsx. 7. **acompanhe o processamento** a tela de detalhe exibe o progresso e lista as linhas que falharam, com o nome da coluna e a mensagem. cada linha é processada de forma independente: linha com erro não impede as demais. o relatório é exibido apenas em tela, sem opção de download. 8. **complete na plataforma o que a planilha não define** abra os casos importados e preencha os produtos, as notas fiscais de devolução, os arquivos, o contato e o dono do caso. ## célula vazia limpa o campo coluna presente com a célula vazia grava vazio e limpa o campo no caso. coluna removida do arquivo não altera aquele campo em nenhuma linha. a exceção são assunto e descrição: os dois aceitam valor, e não aceitam vazio. deixar um deles em branco em uma linha de atualização faz a linha falhar. ## o que é obrigatório em cada linha | coluna | criando | atualizando | | - | - | - | | tipo do caso | obrigatório | obrigatório | | assunto | obrigatório | mantém o valor atual quando preenchido igual, e falha quando vazio | | descrição | obrigatório | mantém o valor atual quando preenchido igual, e falha quando vazio | | status do caso | obrigatório | em branco mantém a etapa atual | | código teceo de cliente ou n° do documento | obrigatório | ignorado | | campo personalizado que a etapa exige | obrigatório | obrigatório quando a linha traz uma etapa | ## as colunas fixas treze colunas, ou catorze quando o tipo de caso tem um campo de código externo configurado, nesta ordem. as sete primeiras são de referência e não podem ser removidas do arquivo. | coluna | o que preencher | pode sair do arquivo | | - | - | - | | nº do caso | em branco cria um caso novo, preenchido atualiza aquele caso | não | | código externo (`{nome do campo}`) | existe apenas quando o tipo tem campo de código externo. serve para localizar o caso | não | | data de abertura | referência, dado somente informativo | não | | data de atualização | referência, dado somente informativo | não | | código teceo de cliente | o código do cliente na teceo, para identificar o cliente na criação | não | | nome da loja | referência. qualquer alteração nesta coluna é ignorada | não | | razão social da loja | referência. qualquer alteração nesta coluna é ignorada | não | | tipo de documento | CNPJ, CPF, TAX\_ID, NIF, PASSAPORTE ou OUTROS | sim | | n° do documento | o número do documento do cliente, para identificar o cliente na criação | sim | | tipo do caso | o nome exato do tipo, com espaço ou sublinhado | sim | | assunto | o assunto do atendimento | sim | | descrição | a descrição da ocorrência | sim | | status do caso | o nome exato de uma das etapas daquele tipo | sim | não é possível acrescentar coluna própria ao arquivo: coluna que não existe no modelo faz a linha falhar. ## as colunas de campo personalizado depois das fixas, o modelo traz uma coluna por campo personalizado importável do tipo. entram os campos de texto, texto longo, data e seleção. campos de upload e de informação ficam fora. | tipo do campo | o que a célula aceita | | - | - | | texto e texto longo | texto livre | | data | apenas o formato DD/MM/AAAA | | seleção | o texto exato de uma das opções, listado na linha 2 | os campos personalizados são gravados por junção: apenas as colunas presentes no arquivo são sobrescritas, e as demais mantêm o valor que já tinham. ## o que a planilha não define produtos devolvidos, notas fiscais de devolução, arquivos, contato do caso e dono do caso. nada disso é importado por planilha, e casos importados são criados sem responsável. a exportação de dados traz os produtos, o nº da nota fiscal de devolução, o contato e o responsável do caso, e os arquivos não são exportados em nenhum formato. a data de abertura é definida na criação do caso, e a coluna do arquivo é apenas referência. o autor do caso é sempre quem executou a importação. ## conteúdos relacionados
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.