# Como Configurar um 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 %}

Para Configurar um perfil PDV, siga as etapas a seguir:

{% stepper %}
{% step %}

### Acesso à Configuração do Perfil PDV

1. Acesse o menu: **Retaguarda Cloud** > **Administrativo** > **Filiais**.
2. Selecione ou digite a **Filial** desejada.
3. Dentro das configurações da filial, localize e clique na seção **Parâmetros**.
4. Role a tela de parâmetros para baixo até encontrar a opção **Perfil PDV**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FpymgNWjVdhd1jhajw0Jw%2FFormato%20de%20edi%C3%A7%C3%A3o%20de%20Lives%20(28).gif?alt=media&#x26;token=c01e3d87-6df1-4f37-b08d-22a25ba0e01e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Criação de um Novo 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 (ex: "Padrão Loja", "Caixa Rápido").
3. **Opcional:** Você pode associar terminais já existentes a este perfil durante a criação, selecionando-os na lista ou usando a opção "Adicionar Todos". Alternativamente, pode criar o perfil sem associar terminais e fazer a vinculação posteriormente.
4. Clique em **Gravar** para salvar o novo perfil.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2Fy0Ycurystt1dnXj05vWf%2FFormato%20de%20edi%C3%A7%C3%A3o%20de%20Lives%20(29).gif?alt=media&#x26;token=e65f55af-d147-4bee-a57f-958c480f2990" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Configuração Detalhada do Perfil

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

#### 3.1. Configuração de Impressoras (Ponto de Impressão) <a href="#id-31configuraodeimpressoraspontodeimpresso" id="id-31configuraodeimpressoraspontodeimpresso"></a>

{% 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 etc, consulte o[ manual específico do equipamento](https://ajuda.pdvlegal.com.br/pdv/instalacao-do-pdv) 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FaeuaMf9sQ6uPtDAYvspI%2FFormato%20de%20edi%C3%A7%C3%A3o%20de%20Lives%20(30).gif?alt=media&#x26;token=325c96ac-0a27-4b3e-89c9-9a4403b274b5" alt=""><figcaption></figcaption></figure>

#### 3.2. Parâmetros Gerais do PDV <a href="#id-32parmetrosgeraisdopdv" id="id-32parmetrosgeraisdopdv"></a>

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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F9ZfefNU1M1q3fQ3MdrJR%2FFormato%20de%20edi%C3%A7%C3%A3o%20de%20Lives%20(31).gif?alt=media&#x26;token=c152cf18-10a3-4155-91c9-de85cdb7d457" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}

### &#x20;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 %}

### Associação do Perfil a um Terminal PDV

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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F330Ljd27iPKb8GgeynaL%2FFormato%20de%20edi%C3%A7%C3%A3o%20de%20Lives%20(32).gif?alt=media&#x26;token=c895f80a-7830-4afe-a695-f03875a4f0b6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Aplicação e Comportamento no PDV

1. No terminal PDV físico ou virtual, clique nos "três pontinhos" e em seguida: "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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FD209XBvfv2Ej3Mq9nlvy%2FDesign%20sem%20nome%20(62).gif?alt=media&#x26;token=6d1a34af-a239-4f9c-94a0-505bafb27a80" alt="" width="188"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Desvinculação de Perfil e Edição Manual

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.

  <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Dica de Uso:</strong> Utilize essa função se você precisa configurar rapidamente um terminal novo. Associe o perfil para "baixar" toda a configuração padrão da loja e, em seguida, desvincule se precisar fazer algum ajuste fino local (ex: mudar apenas o IP de uma impressora específica).</p></div>

{% endstep %}

{% step %}

### Modo 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: 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/como-configurar-um-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.
