> For the complete documentation index, see [llms.txt](https://docs.wave.pt/wave-trade-x/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wave.pt/wave-trade-x/app/estrutura/clientes.md).

# Clientes

Na página dos Clientes irá ter a possibilidade de visualizar os clientes aos quais terá acesso assim como *<mark style="color:blue;">**Iniciar Visita**</mark>*<mark style="color:red;">(1)</mark>  .

Na barra de pesquisa poderá pesquisar por:

* Abreviatura
* Contribuinte
* Localidade
* Nome
* Número
* Vendedor
* Telefone | Telemóvel
* Saldo em Aberto
* Zona
* Nome + abreviatura + Nº Cliente
* Zona + Vendedor
* Código Postal

<mark style="color:$primary;">**Zona + Vendedor**</mark> -> Apresenta, no lado esquerdo, a lista de zonas. À medida que as zonas são selecionadas, o lado direito é preenchido com os vendedores que têm clientes nessas zonas. O filtro devolve os clientes que pertencem a uma das zonas selecionadas e estão atribuídos a um dos vendedores selecionados.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2F7H2WJLesq1IrkrPZkQfk%2Fimage.png?alt=media&amp;token=09f92832-21b2-41c5-ae52-7265a3bc957c" alt=""><figcaption></figcaption></figure>

Temos também a Pesquisa Avançada <mark style="color:red;">(2),</mark> por Rotas <mark style="color:red;">(3)</mark> e pesquisa de clientes por data de visita <mark style="color:red;">(4)</mark>.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FcUcOSY1YiWCVcWUHVT3u%2FclientsFrontPage.png?alt=media&amp;token=6b468947-7f34-487d-a88b-1fe402ded10c" alt=""><figcaption><p>Clientes</p></figcaption></figure>

### <mark style="color:$primary;">Pesquisa avançada</mark>

A pesquisa avançada é uma pesquisa com um conjunto de filtros, temos a Pesquisa por proximidade (<mark style="color:$danger;">5</mark>), o alcance em km de clientes (<mark style="color:$danger;">6</mark>) a partir da localização selecionada e o filtro pesquisa de clientes sem visitas em dias já pré-definidos no filtro (<mark style="color:$danger;">7</mark>).

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FZwE1sxNM77OIrRWYmor6%2Fpesquisaavan%C3%A7ada.png?alt=media&amp;token=5ec5b5bf-6144-477c-9ffc-b73f40faa937" alt=""><figcaption></figcaption></figure>

Ao selecionar a pesquisa por proximidade de forma a escolhermos uma localização (<mark style="color:$danger;">5</mark>), vai abrir um ecrã novo. Este ecrã permite escolher a localização atual ou pesquisar uma localização.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FKOKYCqB9tGy4HJKVk8ZA%2Fimage.png?alt=media&amp;token=682ffa9e-11ba-4eab-8339-836193f2c52f" alt=""><figcaption></figcaption></figure>

### <mark style="color:$primary;">Pesquisa por rotas</mark>

A pesquisa por Rotas apenas retornará clientes associados à rota selecionada <mark style="color:red;">(3)</mark>.

{% hint style="info" %}
A pesquisa por Rotas é uma funcionalidade online.
{% endhint %}

### <mark style="color:$primary;">Clientes Por Data de Visita</mark>

Esta pesquisa permite filtrar a lista de clientes pela sua atividade de visitas num determinado período <mark style="color:red;">(4)</mark>.

Além de filtrar a lista, apresenta um resumo com taxa de cobertura do período, quantos clientes foram visitados e quantos faltam visitar.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FFpZ5JYHeNu8XuL0VGUHx%2Fimage.png?alt=media&amp;token=d065138e-93b3-41d2-b56f-af856eafcc4e" alt=""><figcaption></figcaption></figure>

#### <mark style="color:$primary;">Como Funciona</mark>

A pesquisa é acedida pelo botão de pesquisa por data de visita <mark style="color:red;">(4)</mark>, e desenrola-se em três passos:

1. O utilizador escolhe o **período** a analisar.
2. A opção **Apenas clientes por visitar**, já vem selecionada por defeito de forma a restringir a lista  aos clientes sem visitas no período. Desativada, a lista mostra os clientes visitados no período.
3. Ao confirmar, a lista de clientes é recarregada e é apresentado o resumo dp período.

O filtro fica ativo até ser explicitamente limpo.

{% hint style="info" %}
A pesquisa avançada de visitas **combina-se com a pesquisa normal**. Se estiver ativo um filtro de pesquisa — por nome, zona, vendedor ou outro — as duas condições aplicam-se em conjunto, e os valores do resumo são calculados apenas sobre os clientes que satisfazem esse filtro.
{% endhint %}

#### <mark style="color:$primary;">Períodos disponíveis</mark>

| Período          | Intervalo considerado                                                            |
| ---------------- | -------------------------------------------------------------------------------- |
| Mês              | Do primeiro ao último dia do mês corrente.                                       |
| Trimestre        | Trimestre civil que contém a data de hoje: Jan-Mar, Abr-Jun, Jul-Set ou Out-Dez. |
| Ano              | De 1 de janeiro a 31 de dezembro do ano corrente.                                |
| Data selecionada | Intervalo definido manualmente pelo utilizador.                                  |
| Tudo             | Sem limite de datas                                                              |

## <mark style="color:$primary;">Clientes Online</mark>

Com esta funcionalidade é possível criar <mark style="color:red;">(1)</mark> e alterar <mark style="color:red;">(2)</mark> clientes diretamente no erp a partir do tablet. O cliente fica logo disponível no tablet, sem ser necessário esperar pela sincronização.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FPlBlth2EVo7Y6RxijNhq%2Feditcreatc.png?alt=media&amp;token=c4f52f3d-3ec8-4359-8ce0-2158b621f19c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
De momento, a funcionalidade está disponível para o ERP PHC.
{% endhint %}

### <mark style="color:blue;">Configuração</mark>

#### <mark style="color:blue;">1. Terminal</mark>

Na configuração do terminal (tabela `X_Config_terminals`) estão disponíveis os seguintes campos:

| Campo                                 | Descrição                                                                                                                                |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `allow_customer_creation`             | Com o valor True, permite criar clientes online neste terminal.                                                                          |
| `customer_creation_disallowed_fields` | Campos que **não** podem ser preenchidos na criação, separados por vírgulas (ex.: `seller,price_table`). Os restantes ficam disponíveis. |
| `allow_customer_update`               | Com o valor True, permite alterar clientes online neste terminal.                                                                        |
| `customer_update_allowed_fields`      | Campos que **podem** ser alterados, separados por vírgulas (ex.: `email,phone,mobile,seller`). Os restantes ficam bloqueados.            |
| `price_table_newcustomer`             | Tabela de preços sugerida para os clientes novos.                                                                                        |

Nomes a usar nas listas de campos:

| Nome                            | Campo no tablet       |
| ------------------------------- | --------------------- |
| `name`                          | Nome da empresa       |
| `name_alt`                      | Abreviatura           |
| `vat_number`                    | NIF                   |
| `type`                          | Setor                 |
| `country`                       | País                  |
| `address`                       | Morada                |
| `zip_code`                      | Código postal         |
| `local`                         | Localidade            |
| `region`                        | Zona                  |
| `phone`                         | Telefone              |
| `mobile`                        | Telemóvel             |
| `email`                         | Email                 |
| `seller`                        | Vendedor              |
| `price_table`                   | Tabela de preços      |
| `payment_details`               | Condição de pagamento |
| `obs`                           | Observações           |
| `custom_txt_1` a `custom_txt_5` | Campos livres         |

Independentemente das listas, aplicam-se sempre as seguintes regras:

* **Criação:** o NIF, o Nome da empresa, a Morada, o Código postal e a Localidade são obrigatórios.
* **Alteração:** o NIF nunca pode ser alterado. O Nome da empresa e a Morada, quando podem ser alterados, não podem ficar vazios.
* **Condição de pagamento:** é obrigatória sempre que pode ser preenchida.
* **Vendedor:** quando não é escolhido, ou está bloqueado na criação, o cliente fica com o vendedor do terminal.
* **Campos livres:** os títulos são definidos nos parâmetros do terminal `label_for_custom_txt_1_customer` a `label_for_custom_txt_5_customer`, os mesmos da ficha do cliente. Só aparecem os campos que têm título.

#### <mark style="color:$primary;">2. Connected</mark>

Em **Integração > Mapeamentos** configure os mapeamentos de cada operação:

| Mapeamento       | Tipo             | Operação                                                                                |
| ---------------- | ---------------- | --------------------------------------------------------------------------------------- |
| `customers_add`  | Tablet → ERP     | Criação de clientes no ERP                                                              |
| `customers_edit` | Tablet → ERP     | Alteração de clientes no ERP                                                            |
| `potentials`     | Tablet → ERP     | Conversão de potenciais em clientes no ERP                                              |
| `X_Customers`    | ERP → Middlwware | Cópia do cliente gravado no ERP para a middleware, para ficar logo disponível no tablet |

O mapeamento `X_Customers` é o mesmo que o Connected já usa para copiar os clientes do ERP para a middleware.

Campos de origem para `customers_add` e `customers_edit`:

`name`, `name_alt`, `vat_number`, `address`, `zip_code`, `local`, `region`, `country_iso2`, `country`, `phone`, `mobile`, `email`, `type`, `seller_number`, `seller_name`, `price_table`, `payment_details`, `payment_condition_code`, `obs`, `custom_txt_1` a `custom_txt_5`.

| Campo Ori.               | Campo Dest.    |
| ------------------------ | -------------- |
| `name`                   | `nome`         |
| `name_alt`               | `nome2`        |
| `vat_number`             | `ncont`        |
| `address`                | `morada`       |
| `zip_code`               | `codpost`      |
| `local`                  | `local`        |
| `region`                 | `zona`         |
| `country_iso2`           | `cl2.codpais`  |
| `country`                | `cl2.descpais` |
| `phone`                  | `telefone`     |
| `mobile`                 | `tlmvl`        |
| `email`                  | `email`        |
| `type`                   | `tipo`         |
| `seller_number`          | `vendedor`     |
| `seller_name`            | `vendnm`       |
| `price_table`            | `preco`        |
| `payment_details`        | `tpdesc`       |
| `payment_condition_code` | `tpstamp`      |
| `obs`                    | `obs`          |
| `'0'`                    | `estab`        |
| `'30'`                   | `vencimento`   |

### <mark style="color:blue;">Utilização</mark>

#### <mark style="color:blue;">Criar cliente</mark>

* Na página de **Clientes**, carregue no ícone de criar cliente online, na barra superior.
* Preencha os dados. Os campos obrigatórios estão assinalados com `*` e cada secção indica quantos faltam (ex.: **Falta 1**). Com o botão **Consultar VIES** pode preencher os dados da empresa a partir do NIF.
* Carregue em **Criar Cliente**.
* Se já existir um cliente com o mesmo NIF, o cliente não é criado e é indicado qual é. E indica se está inativo ou não.

No lado esquerdo do ecrã temos a pre-visualização e as secções e ao lado direito temos os campos para o preenchimento.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2FjszxRHC3PQdZuMHZi5Ko%2Fimage.png?alt=media&amp;token=55c6cc9a-d326-4b54-af90-2de1039acabd" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">Alterar cliente</mark>

* Na página de **Clientes**, selecione o cliente.
* Carregue no ícone de alterar cliente online, à esquerda do ícone de criar.
* Altere os campos disponíveis e Carregue em **Atualizar Cliente**.

<figure><img src="https://2604970429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlwGyVBVyBdZOzOkKRFs8%2Fuploads%2Fbh6aoAfhfZ0QCLGlzNQc%2Fimage.png?alt=media&amp;token=d82a1a54-c5be-487f-b864-068601fa91c5" alt=""><figcaption></figcaption></figure>
