> For the complete documentation index, see [llms.txt](https://ajuda.pdvlegal.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.pdvlegal.com.br/retaguarda/administrativo/perfil-pdv.md).
# 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 reduz configuração manual terminal por terminal.
Ele é útil em operações com vários equipamentos.
Você também pode criar perfis diferentes por hardware ou adquirente.
{% 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**.
{% 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 um ou mais terminais já existentes a este perfil durante a criação.
4. Também pode criar o perfil sem associação e fazer esse vínculo depois.
5. Clique em **Gravar** para salvar o novo perfil.
{% endstep %}
{% step %}
### Configure o perfil
Após criar o perfil (ou selecionando um existente para editar), você terá acesso às abas de configuração.
Essa tela replica as mesmas opções disponíveis no PDV.
#### 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).
#### 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.
* Informe se deseja habilitar:
* Impressão detalhada para conta
* Se irá Imprimir ticket de venda (*Nota:* Pode haver um campo de tempo (ex: 10 segundos) que virá preenchido por padrão em versões futuras.)
* Botão pesquisa de cliente
* Imprimir cancelamento de produção
* Defina o tempo de retenção de impressões (5 a 120 min)
2. **Balança:** Configure os parâmetros se utilizar balança integrada ao PDV.
3. **Meio de Pagamento Integrado:**
* Informe a empresa de meio de pagamento
* Pareamento bluetooth (se necessário)
* Timeout checagem adicional PIX(s)
* Marque se Solicita Impressão Via Cliente
* Informe os módulos com meios de pagamento (Balcão/Ticket/Delivery)
4. **Descontos:**
* Defina o percentual **máximo de desconto permitido por item**.
* Defina o percentual **máximo de desconto permitido na conta total**.
5. **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%).
6. **Venda:**
* Ative se o terminal utilizará NFC por aproximação
* Ative se terá Identificação do Ticket/Mesa
* Ative se Digita observação no Balcão com ou sem preenchimento obrigatório.
7. **Código de Barras:**
* Ative para Validar Código de Barras
* Selecione o tipo de Beep
8. **Auto Atendimento:**
* Defina a Mensagem padrão para suporte Auto Atendimento
* Ative para Venda Touch AutoAtendimento
* Selecione a Interface de acionamento de dispositivos: (Nenhum/Bluetooth e IGOPass)
9. **Fiscal:**
* Configure opções fiscais do terminal conforme a operação da filial.
* *Nota:* Alguns campos relacionados a timeouts de consulta fiscal podem ter valores padrão em versões futuras.
10. Clique em **Gravar** para salvar todas as alterações nos parâmetros do perfil.
{% 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 **Retaguarda Cloud → Administrativo → Filiais → Meus Terminais**.
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**.
Na listagem de **Meus Terminais**, use a coluna **Perfil PDV** para conferir:
* quais terminais já têm perfil vinculado
* qual perfil está aplicado em cada equipamento
* quais terminais ainda estão sem associação
{% endstep %}
{% step %}
### Aplique o perfil no PDV
1. Repita este processo em **cada terminal** vinculado ao perfil.
2. No terminal PDV físico ou virtual, acesse **Configurar**.
3. Informe a senha e abra **Parâmetro do Sistema Novo**.
4. O sistema validará o perfil vinculado ao dispositivo e aplicará as configurações definidas, como impressoras, descontos e o uso de **NFC por aproximação**.
{% hint style="warning" %}
A função **Baixar Tabelas** atualiza cadastros, mas **não** aplica o Perfil PDV. A aplicação inicial e qualquer atualização posterior do perfil exigem acesso à tela **Parâmetro do Sistema Novo** em cada terminal.
{% 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 %}
{% 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 em **Parâmetro do Sistema Novo** 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.
5. Se o perfil tiver sido alterado no Cloud, entre novamente em **Parâmetro do Sistema Novo** para buscar a versão atualizada.
{% 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, and the optional `goal` query parameter:
```
GET https://ajuda.pdvlegal.com.br/retaguarda/administrativo/perfil-pdv.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.