> ## 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.

# referência de campos do caso

o formulário do caso é definido pela configuração do tipo de caso, que determina quais seções e quais campos aparecem, e em que ordem.

<Note>
  nada no formulário é padrão, exceto a seção de dados gerais. produtos, notas fiscais de devolução, campos personalizados e seções de informação existem quando o tipo de caso, configurado pela teceo, inclui essas seções. uma seção deixa de ser exibida quando o status oculta todos os campos dela. o título de cada seção também vem dessa configuração: os nomes usados aqui são os padrões da plataforma, e uma marca pode ver outros.
</Note>

## a obrigatoriedade dos campos

a obrigatoriedade é definida pelo status, não pelo campo: o mesmo campo é opcional em um status e obrigatório em outro.

| o que define | efeito no campo |
| - | - |
| o status atual | marca o campo como oculto, somente leitura, editável ou obrigatório |
| o status de destino | os campos que ele marca como obrigatórios precisam estar preenchidos antes da transição |
| o perfil de quem abre o caso | o campo fica bloqueado quando o perfil não está entre os que podem editar aquele status |
| o nível de edição do status | cada status permite nenhuma edição, apenas a mudança de etapa, ou edição total. nos dois primeiros o campo fica bloqueado, mesmo para quem pode editar |

o avanço entre status está descrito em [o ciclo de vida dos casos](/docs/casos/o-ciclo-de-vida-de-um-caso).

## dados gerais

a única seção fixa do formulário.

| campo | tipo | obrigatório | comportamento |
| - | - | - | - |
| número do caso | preenchido pela plataforma | não se aplica | o código do caso, sequencial por marca |
| código externo | texto | não se aplica | o código do caso no seu sistema de gestão, descrito na seção o campo de código externo |
| criado por | preenchido pela plataforma | não se aplica | o nome e o e-mail de quem abriu o caso |
| data de abertura | preenchido pela plataforma | não se aplica | o dia em que o caso foi aberto |
| tipo de caso | seleção | escolhido antes da abertura | define as seções, os campos e as etapas do caso, e não muda depois |
| cliente | seleção de um cliente já cadastrado | obrigatório em todo caso: não existe caso sem cliente cadastrado | |
| contato | seleção | quando o status escolhido na abertura marca o campo como obrigatório | um dos contatos do cliente do caso |
| dono do caso | seleção | quando o status escolhido na abertura marca o campo como obrigatório | registra o nome e o e-mail vigentes no momento da atribuição |
| assunto (máx. 60 caracteres) | texto de até 60 caracteres | quando o status escolhido na abertura marca o campo como obrigatório | o limite aparece no rótulo do campo |
| descrição | texto | quando o status escolhido na abertura marca o campo como obrigatório | |

o status atual do caso é exibido como um selo no canto da seção, com o nome do status configurado e o status base que o classifica.

os dados gerais não podem ser alterados após a abertura do caso, comportamento descrito em [editar casos](/docs/casos/editar-casos).

o autor do caso segue a mesma regra do dono do caso: registra o nome e o e-mail vigentes na abertura, e uma alteração de e-mail posterior não modifica o caso.

## dados de devolução

a seção é exibida quando o tipo de caso inclui uma seção de dados de devolução.

| campo | tipo | obrigatório | comportamento |
| - | - | - | - |
| local da devolução | seleção entre os endereços cadastrados do cliente | quando o status de destino marca o campo como obrigatório | onde o produto devolvido é recebido. o campo fica bloqueado enquanto não há cliente no caso |
| nº da nota fiscal de devolução | texto | quando o status de destino marca o campo como obrigatório | o número da nota emitida para a devolução |
| envie a nota fiscal de devolução do produto | upload, até 7 notas fiscais de devolução por caso. aceita PDF, imagem e XML | quando o status de destino marca o campo como obrigatório | enquanto nenhum arquivo é enviado, o caso exibe nota de devolução não enviada |
| código de rastreamento | texto | quando o status de destino marca o campo como obrigatório | acompanha o envio do produto devolvido |

## produtos do caso

a seção é exibida quando o tipo de caso inclui uma seção de produtos. os produtos são adicionados pela busca em adicionar produtos e ficam listados em produtos adicionados. cada campo abaixo se aplica a cada produto do caso.

| campo | tipo | obrigatório | comportamento |
| - | - | - | - |
| código do produto | busca de produto, com o texto de apoio buscar produtos por código | não se aplica | adiciona o produto à lista de produtos adicionados |
| NF de origem | seleção entre as notas fiscais do cliente | quando o status de destino marca o campo como obrigatório | aceita também um número digitado que não corresponde a nenhuma nota cadastrada, e não tem vínculo com o pedido |
| data de emissão | data | quando o status de destino marca o campo como obrigatório | a data de emissão da nota de origem |
| número do pedido | texto | quando o status de destino marca o campo como obrigatório | não tem vínculo com o pedido |
| cor | seleção entre as cores do produto | quando o status de destino marca o campo como obrigatório | |
| tamanho | seleção entre os tamanhos do produto | quando o status de destino marca o campo como obrigatório | |
| quantidade | numérico | quando o status de destino marca o campo como obrigatório | quantas peças daquele produto entram no caso |
| motivo da devolução | seleção, com as opções configuradas para a marca | quando o status de destino marca o campo como obrigatório | o preenchimento libera o campo tipo do defeito |
| tipo do defeito | seleção, com as opções configuradas para a marca | quando o status de destino marca o campo como obrigatório | aceita valor apenas depois que motivo da devolução está preenchido. sem o motivo, o campo exibe preencha um motivo de devolução para preencher este campo |
| valor | numérico, com o símbolo da moeda no rótulo | quando o status de destino marca o campo como obrigatório | |
| produto vendido ao consumidor final | opção | não se aplica | quando está marcado, nome do cliente e data da compra passam a ser obrigatórios |
| nome do cliente | texto | obrigatório quando produto vendido ao consumidor final está marcado | o consumidor final que comprou o produto, não o cliente do caso |
| CPF | texto | obrigatório quando produto vendido ao consumidor final está marcado | o CPF de quem comprou na loja |
| data da compra | data | obrigatório quando produto vendido ao consumidor final está marcado | a data em que o consumidor final comprou o produto |
| fotos do problema do produto | upload de mídias, até 15 por produto. aceita imagem e vídeo, nos formatos mp4, webm e ogg | quando o status de destino marca o campo como obrigatório | 5 MB por arquivo, imagem ou vídeo. o campo exibe os dois limites |

## análise do produto

| campo | tipo | obrigatório | comportamento |
| - | - | - | - |
| aprovar, reprovar | ação por produto do caso | não se aplica | registra o resultado da análise. **reprovar** e **aprovar** são os verbos dos botões, e o estado exibido depois da decisão é aprovado ou não aprovado |
| conclusões da análise | texto de várias linhas | quando o status de destino marca o campo como obrigatório | registra o resultado da conferência do produto |

## campos personalizados

o rótulo de cada campo personalizado vem da configuração do tipo de caso, não de uma lista fixa da plataforma. são seis tipos.

| tipo | o que aceita | obrigatório |
| - | - | - |
| texto | texto livre | quando o status de destino marca o campo como obrigatório |
| texto longo | texto livre, para conteúdo mais extenso | quando o status de destino marca o campo como obrigatório |
| data | uma data | quando o status de destino marca o campo como obrigatório |
| seleção | uma opção da lista configurada para o campo | quando o status de destino marca o campo como obrigatório |
| upload | arquivos | quando o status de destino marca o campo como obrigatório |
| informação | não recebe preenchimento: exibe um texto de apoio configurado no campo, em um bloco de aviso com **mostrar mais** para exibir o texto inteiro | não se aplica |

### o campo de código externo

o tipo de caso pode definir um dos seus campos personalizados como referência do código externo. o campo continua no formulário com o rótulo configurado, e o valor dele é replicado no campo código externo dos dados gerais: é por ele que a [planilha de importação](/docs/casos/importar-casos-por-planilha) localiza o caso, e é por ele que o seu sistema de gestão o consulta. o tipo que não define nenhum campo não tem código externo.

## conteúdos relacionados

<div className="relacionados">
  <CardGroup cols={1}>
    <Card title="criar um caso" icon="file-lines" href="/docs/casos/criar-um-caso" horizontal />

    <Card title="editar casos" icon="file-lines" href="/docs/casos/editar-casos" horizontal />

    <Card title="o ciclo de vida dos casos" icon="file-lines" href="/docs/casos/o-ciclo-de-vida-de-um-caso" horizontal />

    <Card title="importar casos por planilha" icon="file-lines" href="/docs/casos/importar-casos-por-planilha" horizontal />
  </CardGroup>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.