# Perfil PDV

{% hint style="danger" %}

#### Pré-requisitos:

* **Versão 25.05.01.250 ou superior.**
* **Esta funcionalidade não está disponível para clientes com integração Hits**
  {% endhint %}

Use o perfil PDV para padronizar parâmetros entre terminais da mesma filial.

Esse recurso ajuda a replicar configurações com mais consistência entre os equipamentos.

{% stepper %}
{% step %}

### Acesse a configuração do perfil

1. Acesse **Retaguarda Cloud → Administrativo → Filiais**.
2. Selecione a filial desejada.
3. Abra a seção **Parâmetros**.
4. Localize a opção **Perfil PDV**.

<figure><img src="/files/erhv0GhvCrp4Tc4kmK4x" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Crie um perfil PDV

1. Dentro da seção **Perfil PDV**, clique no botão para criar um **Novo Perfil**.
2. Digite um **Nome** para o perfil, como `Padrão Loja` ou `Caixa Rápido`.
3. **Opcional:** Você pode associar terminais já existentes a este perfil durante a criação. Também pode criar o perfil sem associação e fazer esse vínculo depois.
4. Clique em **Gravar** para salvar o novo perfil.

<figure><img src="/files/2V1j42ngq3TLHdBtOzz8" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Configure o perfil

Após criar o perfil (ou selecionando um existente para editar), você terá acesso às abas de configuração.

#### Configuração de impressoras

{% hint style="warning" %}
**Atenção sobre Portas de Impressão:** Atualmente, o Perfil PDV aplica apenas a porta padrão **9100**. Se você utiliza servidores de impressão que exigem portas personalizadas, essa configuração específica **não será baixada automaticamente**. Neste caso, configure a porta manualmente diretamente no terminal físico.
{% endhint %}

{% hint style="info" %}
Se estiver configurando um terminal M10, Stone ou Cielo, consulte o [**manual de instalação do PDV Legal**](/pdv/instalacao-do-pdv-legal.md) para confirmar o nome correto da impressora Bluetooth interna.
{% endhint %}

Esta seção permite configurar as impressoras que serão utilizadas pelos PDVs associados a este perfil.

1. Localize a impressora que deseja configurar (ex: "Caixa").
2. Clique no ícone de **engrenagem** (⚙️) ao lado do nome da impressora.
3. **Marca da Impressora:** O padrão geralmente é "Modo Texto", mas pode ser alterado em casos de equipamentos que tem a impressora Built-In, entre outros.
4. **Interface:** Escolha como a impressora se conecta (Internet/Rede, Bluetooth, USB).
5. **Endereço (se Interface = Internet):** Informe o endereço IP da impressora na rede (ex: 192.168.1.100).
6. **Porta:** Mantenha o padrão, a menos que seja necessário alterar. (Ex: 9100)
7. **Características:**
   * Marque o **"Status da Impressora"** para habilitá-la no PDV.
   * Selecione as funcionalidades desejadas: Vale, Corte de Papel, Impressão de Vale, Margem Inferior/Superior.
   * Defina a **Largura** da impressão (ex: 72mm).
8. Clique em **Gravar** para salvar as configurações da impressora.
9. Repita o processo para outras impressoras necessárias (Cozinha, Bar, etc.). A impressora recém-configurada ficará destacada (ex: em amarelo).

<figure><img src="/files/qzjwxhLh9goMHYngXGQB" alt=""><figcaption></figcaption></figure>

#### Parâmetros gerais do PDV

Após configurar as impressoras individuais, volte à aba principal de parâmetros do perfil para definir configurações gerais.

1. **Impressoras Padrão:**
   * **Define Impressora Caixa:** Selecione a impressora configurada no passo anterior para ser o padrão do caixa.
   * **Define Impressora Conferência:** Selecione a impressora para cupons de conferência.
   * **Define Impressora Relatórios:** Selecione a impressora para relatórios do PDV.
2. **Ticket de Venda:**
   * Configure se a impressão do ticket será **automática** após a venda.
   * *Nota:* Pode haver um campo de tempo (ex: 10 segundos) que virá preenchido por padrão em versões futuras.
3. **Balança:** Configure os parâmetros se utilizar balança integrada ao PDV.
4. **Meio de Pagamento Integrado:**
   * Se utilizar maquininhas de cartão integradas (TEF, etc.), configure o provedor (ex: Stone, Cielo).
   * Defina o tipo de comunicação (ex: Cabinho, Rede/IP) e o endereço, se aplicável.
5. **Descontos:**
   * Defina o percentual **máximo de desconto permitido por item**.
   * Defina o percentual **máximo de desconto permitido na conta total**.
6. **Acréscimos:**
   * Habilite se deseja trabalhar com acréscimos (ex: taxa de serviço).
   * Defina o **modo** (ex: apenas no Ticket).
   * Defina o **valor percentual** do acréscimo (ex: 10%).
7. **Venda / Fiscal:**
   * Configure opções como aproximação de NFC-e, código de barras, autoatendimento.
   * *Nota:* Alguns campos relacionados a timeouts (ex: consulta NFC-e) podem ter valores padrão (ex: 10 segundos) em versões futuras.
8. Clique em **Gravar** para salvar todas as alterações nos parâmetros do perfil.

<figure><img src="/files/ThpdhzvySfNZk91Qa0Lx" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}

### Limitação para KDS

* Por questão de funcionamento do sistema, **cada loja pode cadastrar apenas UMA impressora do tipo KDS** em seus perfis de PDV.
* Ao tentar configurar mais de uma impressora KDS para a mesma loja, o sistema impedirá o salvamento e exibirá uma mensagem de erro. Essa restrição vale mesmo se perfis distintos estiverem sendo utilizados dentro da loja.
* Se houver a necessidade de configurar uma KDS em outra loja, isso será permitido, pois a limitação se aplica individualmente a cada loja.
  {% endhint %}
  {% endstep %}

{% step %}

### Associe o perfil ao terminal

Após configurar o perfil, você precisa associá-lo aos terminais desejados.

1. Acesse a configuração de **Terminais** (geralmente dentro de Administrativo > Filiais ou um menu dedicado).
2. Localize e **edite** o terminal PDV desejado.
3. No campo **Perfil PDV**, selecione o perfil que você criou/configurou anteriormente.
4. Clique em **Gravar Equipamento**.

<figure><img src="/files/9edO4w4Z3l8uvgjkaQoB" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Aplique o perfil no PDV

1. No terminal PDV físico ou virtual, clique nos **três pontinhos** e depois em **Baixar tabelas**.
2. Após atualização, acesse a tela de **Configurações/Parâmetros**.
3. O sistema identificará automaticamente o perfil vinculado ao dispositivo e aplicará as configurações definidas (impressoras, descontos, etc.).

{% hint style="warning" %}
A função "Baixar Tabelas" atualiza cadastros de produtos, mas **não** força a atualização do Perfil PDV. É obrigatório entrar na tela de Parâmetros para ativar o perfil pela primeira vez.
{% endhint %}

{% hint style="warning" %}
**Importante:** Quando um perfil está ativo, os campos de configuração no PDV ficam **bloqueados (somente leitura)**. O nome do perfil ativo é exibido na tela.
{% endhint %}

<figure><img src="/files/jXkqljTbAAjvSBPkXh6V" alt="" width="188"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Desvincule o perfil, se necessário

Caso seja necessário realizar ajustes específicos em um terminal que não devem ser replicados para os demais, você pode desvincular o perfil.

1. Acesse **Retaguarda Cloud** > **Administrativo** > **Filiais** (ou Meus Terminais).
2. Localize o terminal desejado e clique em **Editar**.
3. No campo **Perfil PDV**, clique no "X" para remover o perfil selecionado.
4. Clique em **Gravar Equipamento**.

**Comportamento no PDV:**

* Ao entrar novamente na tela de Parâmetros no PDV, o sistema identificará que não há mais vínculo.

{% hint style="warning" %}
**Importante:** As configurações **não serão apagadas**. O PDV manterá os últimos parâmetros baixados (impressoras, descontos, etc.).
{% endhint %}

* A diferença é que agora os campos ficarão **desbloqueados**, permitindo que você faça alterações manuais exclusivas para aquele aparelho.

{% hint style="success" %}
Use essa estratégia para configurar rapidamente um terminal novo e depois ajustar apenas o que for local, como o IP de uma impressora.
{% endhint %}
{% endstep %}

{% step %}

### Entenda o comportamento offline

1. Se o terminal PDV perder a conexão com o servidor (ficar offline), o sistema permitirá a **alteração local** dos parâmetros.
2. Nesse caso, os campos ficarão editáveis e botões como "Salvar" e "Cancelar" aparecerão.
3. Uma indicação de "Perfil Offline" ou similar será exibida.
4. Assim que a conexão for restabelecida, o perfil online voltará a ser aplicado, sobrescrevendo possíveis alterações locais feitas durante o período offline.
   {% endstep %}
   {% endstepper %}

{% hint style="success" %}
**Dica:**

**Estratégia de Perfis por Hardware:** Se a loja possui equipamentos mistos (ex: 5 máquinas Stone e 2 Terminais Windows), **crie perfis separados pelo nome do equipamento** (ex: "Perfil Stone" e "Perfil Windows"). Isso evita conflitos de drivers de impressão, já que máquinas SmartPOS usam "Modo Gráfico/Bluetooth" e computadores usam "Modo Texto/USB".
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.pdvlegal.com.br/retaguarda/administrativo/perfil-pdv.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.