# CH140620210724 Pesquisa de clientes e leads por documentos

## Histórico de Versionamento

| Versão | Data | Descrição | Autor |
| -------- | -------- | -------- |-----|
| 1.0 | 20/07/2021 | Criação do documento | Vinícius Hoffmann Fontoura
| 1.1 | 13/01/2022 | Remoção da informação do endereço | Marco Sartori

## Descrição
Num passado próximo, foi aprimorada a visualização da pesquisa de clientes e leads em diversas telas do sistema e aplicativo, de forma que a experiência para o usuário final fosse a mesma em qualquer lugar do sistema. Esta ação focou na visualização dos dados, entretanto existem diferentes endpoints para a consulta, e alguns desses não estão preparados para aceitar a pesquisa por documentos do lead ou cliente, o que prejudica a usabilidade da funcionalidade.

## Detalhamento

### Plataforma
É necessário que nas telas abaixo sejam padronizadas as pesquisas para que considerem sempre os mesmos critérios de pesquisa, para leads e clientes: Nome, Nome fantasia, Código e Documento (com e sem formatação), ordenados em ordem alfabética

1. Oportunidades > Cadastro de oportunidade
1. Atividades > Cadastro de atividade
1. Títulos financeiros > Cadastro de título financeiro
2. Ordens de venda > Cadastro de Ordem de venda
3. Contatos
4. Cadastro de clientes > Campo: Conta pai
5. ~~Cadastro de viagem > Aba Clientes~~ **Descontinuado**
6. Agenda > Cadastro de evento
7. Cadastro de tabela de preço > Configurações > Permissões
a. Esta tela deve também ser padronizada visualmente como as demais

### Mobile
É necessário que nas telas abaixo sejam padronizadas as pesquisas para que considerem sempre os mesmos critérios de pesquisa, para leads e clientes: Nome, Nome fantasia, Código e Documento (com e sem formatação), ordenados em ordem alfabética

1. Ordens de venda
1. Oportunidade
1. Contato
1. Atividade
1. ~~Viagens -> Validar se será descontinuado ou não.~~ **Descontinuado**
1. Agenda
1. Atendimentos

## Critérios de Aceite
### Plataforma
* Deve ser possível a qualquer usuário de sistema com acesso ao um determinado cliente ou lead pesquisá-lo pelos parâmetros *Nome, Nome fantasia, Código e Documento (com e sem formatação)* nas telas *Oportunidades > Cadastro de oportunidade, Atividades > Cadastro de atividade, Títulos financeiros > Cadastro de título financeiro, Ordens de venda > Cadastro de Ordem de venda, Contatos, Cadastro de viagem > Aba Clientes, Agenda > Cadastro de evento, Cadastro de tabela de preço > Configurações > Permissões*.
* A pesquisa por um desses parâmetros deve trazer apenas os registros cujo usuário tem acesso ordenados de forma alfabética pelo nome.
* Caso não hajam resultados o usuário deve ser informado que nenhum resultado válido foi encontrado.

### Mobile
* Deve ser possível a qualquer usuário de sistema com acesso ao um determinado cliente ou lead pesquisá-lo pelos parâmetros *Nome, Nome fantasia, Código e Documento (com e sem formatação)* nas telas *Ordens de venda, Oportunidade, Contato, Atividade, Viagens, Agenda, Atendimentos*.
* A pesquisa por um desses parâmetros deve trazer apenas os registros cujo usuário tem acesso ordenados de forma alfabética pelo nome.
* Caso não hajam resultados o usuário deve ser informado que nenhum resultado válido foi encontrado.

## Próximos passos?
Ter componente único para aplicação nas diversas telas da plataforma e mobile

## Serviços
* Sales
* Product
* Opportunity
* Activities
* Customer
* Financial
* ~~Expenses~~
* Calendar

## Tasks relacionadas
https://app.clickup.com/t/5b9by0
https://app.clickup.com/t/4q6qz3

## Identificador
CH140620210724
ME270620210808
CH231020201149