> 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/gestor-de-pedidos-autonomo.md).

# Gestor de Pedidos Autônomo

Opere o delivery só pelo Gestor de Pedidos, sem o PDV: os pedidos chegam, imprimem na produção, são despachados com NFC-e e ficam registrados no Cloud.

> Com o **Gestor de Pedidos Autônomo**, a loja opera os pedidos de entrega e retirada das plataformas integradas (iFood, Delivery Legal, 99Food e outras) só pelo Gestor de Pedidos, **sem precisar do PDV**.

O caminho de um pedido fica assim:

1. O cliente faz o pedido no iFood, no Delivery Legal, no 99Food ou em outra plataforma integrada.
2. O pedido entra sozinho no Gestor de Pedidos, em até 1 minuto.
3. A comanda sai na impressora de cada produto (cozinha, bar...) ou aparece na tela da cozinha (KDS).
4. Ao despachar, o sistema grava a venda no Cloud (Gestão Legal), emite a NFC-e e imprime o que estiver configurado.
5. A tela **Finalizados** mostra as vendas do dia e permite reimprimir ou estornar.

Quem imprime é o **Impressão Legal**, um programa instalado em um computador da loja, ligado à mesma rede das impressoras.

{% hint style="warning" %}
**Loja só gerencial (sem NFC-e):** por enquanto, o Gestor autônomo exige a emissão de NFC-e pelo Cloud (Gestão Legal). Lojas só gerenciais ficam para uma próxima etapa.
{% endhint %}

{% hint style="info" %}
Siga os passos na ordem. Cada passo depende do anterior.
{% endhint %}

***

## 1. Liberar o módulo no OEM

> A opção do Gestor autônomo só aparece no Gestão Legal depois que o módulo é liberado na licença da filial.

{% stepper %}
{% step %}
No **OEM**, abra **Todas as licenças** e pesquise o cliente pelo código, CNPJ ou nome.
{% endstep %}

{% step %}
Clique em **Editar** e, na aba **Filiais**, localize o grupo **Delivery e Marketplaces**.
{% endstep %}

{% step %}
Marque o módulo **Gestor de pedidos autônomo**.
{% endstep %}

{% step %}
Clique em **Grava Licenciamento**, confira os dados e clique em **Confirmar**.

![Liberar o módulo Gestor de pedidos autônomo no OEM](https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F2xwxsmHUtG3cJ9eMYzoY%2Fgpa-oem-modulo.gif?alt=media)
{% endstep %}
{% endstepper %}

***

## 2. O que a loja já precisa ter

Antes de ligar o Gestor autônomo, confira:

* **NFC-e pelo Cloud** habilitada e **certificado digital** válido na filial.
* **Integrações cadastradas** (iFood, Delivery Legal, 99Food etc.), cada uma com **usuário padrão** e **forma de pagamento padrão online** preenchidos.
* **Cardápio com os produtos vinculados ao cadastro:** o código do produto no Cloud deve ser o mesmo código externo usado na plataforma.

{% hint style="warning" %}
Consulte o manual de cada plataforma integrada para garantir que tudo foi configurado corretamente.
{% endhint %}

***

## 3. Cadastrar as impressoras no Perfil PDV

**Onde:** Gestão Legal → Administrativo → Filiais → editar a filial → aba **Parâmetros** → **Perfil PDV**

{% stepper %}
{% step %}
Use um perfil existente ou crie um novo (exemplo: **BALCÃO**). O perfil precisa estar ativo.
{% endstep %}

{% step %}
Inclua no perfil as impressoras da loja:

* **Impressora de rede:** interface Rede, IP da impressora e porta 9100.
* **Impressora USB:** interface USB. No Windows, a impressora precisa ter **o mesmo nome** cadastrado no Cloud. Exemplo: se você cadastrou a impressora **cozinha**, renomeie a impressora USB no Windows para **cozinha**.
* **Tela da cozinha (KDS):** marca KDS. Não precisa de IP.
  {% endstep %}

{% step %}
Em cada produto, preencha a **Impressora 1** (e a **Impressora 2**, se usar) com o local onde a comanda deve sair, como cozinha ou bar.
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
Se a impressora do produto não estiver no perfil, a comanda daquele item não sai, e **nenhum aviso aparece**. É a causa mais comum de "não imprimiu".
{% endhint %}

Veja como cadastrar impressoras em [Perfil PDV](https://ajuda.pdvlegal.com.br/retaguarda/administrativo/perfil-pdv) e [Configuração de impressão de produção](https://ajuda.pdvlegal.com.br/pdv/funcionalidades-de-vendas/configuracao-de-impressao-de-producao).

***

## 4. Ligar o Gestor autônomo na filial

**Onde:** Gestão Legal → Administrativo → Filiais → editar a filial → aba **Integrações** → quadro **Gestor de pedidos**

{% stepper %}
{% step %}
Marque **Gestor autônomo (a loja opera os pedidos pelo Gestor, sem o PDV)**.

![Opção Gestor autônomo no quadro Gestor de pedidos](https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FvmEjgtpFknQ31ASDVK1j%2Fgpa-ativar.png?alt=media)
{% endstep %}

{% step %}
Leia o aviso e clique em **Confirmar**.
{% endstep %}

{% step %}
Clique em **Gravar**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**O que acontece depois de ligar**

* O PDV dessa loja **não baixa mais** os pedidos das plataformas. Tudo passa pelo Gestor.
* Aparecem, no mesmo quadro, o botão para **baixar o Impressão Legal** e as opções de **impressão automática**: romaneio quando o pedido chega, romaneio ao despachar e NFC-e ao despachar.
* Aparece também o campo **Token do servidor de impressão (Impressão Legal)**. Use o botão **Copiar** para levar o token ao próximo passo. O token também é o código no fim do link **Abrir gestor de pedidos**, depois de `token=`.
  {% endhint %}

![Token do servidor de impressão no quadro Gestor de pedidos](https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FLqVM3HfjND7kVPE9rNZV%2Fgpa-token.png?alt=media)

Se faltar algum item do passo 2, a tela mostra a lista do que falta, com o caminho de cada campo, e a opção não é ligada. Os campos com problema ficam destacados em vermelho. Corrija e marque de novo.

![Lista de pendências e campos destacados em vermelho](https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FiqYfVCVEegZY4J2Wzbwf%2Fgpa-pendencias.gif?alt=media)

***

## 5. Instalar o Impressão Legal

**Onde:** computador da loja, na mesma rede das impressoras

{% stepper %}
{% step %}
Baixe o instalador pelo botão do Impressão Legal, no quadro **Gestor de pedidos** da filial.

Se o navegador avisar que o arquivo não é baixado com frequência, escolha **Manter**.
{% endstep %}

{% step %}
Execute o instalador. Se o Windows avisar **Editor desconhecido**, clique em **Mais informações** e depois em **Executar assim mesmo**.
{% endstep %}

{% step %}
**Token:** cole o token da loja. O instalador confere na hora e só avança com token válido e internet funcionando.
{% endstep %}

{% step %}
**Perfil de impressão:** escolha o perfil cadastrado no passo 3. Se ele não aparecer, confira se está ativo no Cloud e clique em **Atualizar lista**.
{% endstep %}

{% step %}
Conclua a instalação. O programa abre sozinho e passa a iniciar junto com o Windows.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Para trocar o perfil depois, clique com o botão direito no ícone da impressora, perto do relógio do Windows, e escolha **Configurar...**. Mudanças de IP ou de impressora feitas no Cloud valem em poucos segundos, sem reinstalar.
{% endhint %}

***

## 6. Conferir se está tudo ligado

### No computador da loja

Veja a cor do ícone da impressora, perto do relógio:

* **Verde:** tudo certo.
* **Amarelo:** token inválido. Refaça a configuração com o token correto.
* **Vermelho:** servidor fora do ar, impressora sem resposta ou loja sem perfil. Passe o mouse sobre o ícone para ver o motivo.

Clique com o botão direito no ícone e escolha **Status...**: deve aparecer **Perfil NOME (código)** e a lista das impressoras.

### No Gestão Legal

Em **Perfil PDV**, o perfil escolhido aparece com a etiqueta verde **Servidor de impressão**. Esse perfil não pode ser excluído enquanto estiver em uso.

### No Gestor de Pedidos

No menu lateral aparecem os ícones **Finalizados** e, se houver impressora KDS no perfil, **KDS**.

***

## 7. Fazer um pedido de teste

Faça um pedido real pelo iFood ou pelo Delivery Legal, com produtos que tenham impressora definida. Sem clicar em nada, o esperado é:

1. Em até 1 minuto, o pedido aparece no Gestor.
2. **iFood:** o pedido é confirmado sozinho, sem o cronômetro de 5 minutos.
3. A comanda sai na impressora de cada produto. Itens de impressoras diferentes saem em comandas separadas.
4. O pedido aparece no histórico do Impressão Legal (botão direito no ícone → **Status...**).

***

## 8. KDS: a cozinha em tela

Para a cozinha que trabalha com monitor ou TV em vez de comanda em papel. Basta ter no perfil uma impressora com marca **KDS** e produtos apontando para ela: o ícone **KDS** aparece no menu do Gestor.

{% stepper %}
{% step %}
Abra o KDS no computador ou na TV da cozinha e clique em **Tela cheia**.
{% endstep %}

{% step %}
Cada pedido em produção vira um cartão com os itens daquela estação.
{% endstep %}

{% step %}
Quando o prato ficar pronto, toque em **Pronto** e o cartão sai da tela. Tocou por engano? Use **Desfazer último pronto**.
{% endstep %}
{% endstepper %}

![Tela do KDS com os cartões dos pedidos](https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FgthyhBhl4WydqFlzjbt4%2Fgpa-kds.png?alt=media)

Pedido cancelado aparece no KDS com a faixa **PEDIDO CANCELADO** e os itens riscados. Use **Dispensar** para tirá-lo da tela.

{% hint style="info" %}
Quando o pedido é despachado, ele também sai da tela do KDS. A loja pode usar impressora e KDS ao mesmo tempo, por exemplo: bar com comanda em papel e cozinha em tela.
{% endhint %}

***

## 9. Despachar o pedido

**Onde:** Gestor de Pedidos → abrir o pedido → **Despachar**

Na tela do pedido ficam o endereço, os itens, o resumo financeiro e a forma de pagamento. O botão **Despachar** fica no rodapé, ao lado do aviso **Loja configurada para operação automática**. O **Histórico de interações** mostra cada mudança de status do pedido, com data, hora e autor (a plataforma ou o Cloud).

![Tela do pedido no Gestor, com o histórico de interações e o botão Despachar](https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FiauKFXPsIJF16yZjBWyr%2Fgpa-gestor.png?alt=media)

Ao despachar, o sistema:

1. grava a venda no Cloud, com a forma de pagamento escolhida pelo cliente;
2. emite a NFC-e, com o CPF se o cliente informou;
3. imprime o romaneio e o cupom fiscal, conforme as opções de impressão automática da filial;
4. mostra na barra do pedido onde e a que horas imprimiu, ou o erro, se houver.

{% hint style="info" %}
**Romaneio:** traz a tarja **PAGO ONLINE** ou **COBRAR NA ENTREGA** e o número do pedido em destaque, para facilitar a conferência com o entregador. Para esse modelo, use o Impressão Legal na versão 1.6.1 ou superior (reinstale se estiver em versão anterior).
{% endhint %}

{% hint style="warning" %}
**Pedido de retirada** não passa pelo Despachar. Nesse caso, use o botão **Imprimir NFC-e**, que grava a venda e emite a nota sem despachar.
{% endhint %}

### Cancelar um pedido

Um pedido aceito que ainda não saiu pode ser cancelado no próprio Gestor, pelo botão **Cancelar pedido**. No iFood, o sistema pede o motivo do cancelamento. Como a venda só é gravada no despacho, nada é lançado no Cloud.

***

## 10. Tela Finalizados: o fechamento do dia

**Onde:** Gestor de Pedidos → menu → **Finalizados**

Mostra as vendas do dia com pedido, plataforma, cliente, hora e valor, além da situação. No topo ficam o total vendido, separado por plataforma, e o filtro de data com o botão **Atualizar**.

![Tela Pedidos finalizados](https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FN2pFjynfSQ5k1V9jbRUB%2Fgpa-fin.png?alt=media)

A situação de cada pedido:

* **Venda:** gravada, com erro ou estornada.
* **NFC-e:** autorizada, em contingência ou pendente.

Pedidos cancelados aparecem com a etiqueta **cancelado**. Se a venda continuar gravada, aparece também o aviso **Pedido cancelado — venda ativa**.

Use o ícone de visualização para ver o pedido completo antes de imprimir ou estornar. Ações de cada pedido:

* **Reimprimir romaneio:** o cliente ou o entregador pediu outra via.
* **Imprimir NFC-e:** reimprime o cupom fiscal ou emite a nota que ficou pendente.
* **Gravar venda:** grava de novo uma venda que deu erro.
* **Estornar:** estorna a venda no Cloud (com o estoque), cancela a NFC-e e envia o cancelamento do pedido para a plataforma (iFood, 99Food etc.). Pede dois cliques, para evitar engano.

{% hint style="info" %}
Use o estorno para desfazer um pedido que já foi despachado, por exemplo, quando o pedido volta da entrega. A NFC-e só pode ser cancelada dentro do prazo permitido pela Sefaz do seu estado. Se o cancelamento der erro, o Gestor avisa.
{% endhint %}

***

## 11. Testes de segurança (recomendado)

1. **Impressora desligada:** desligue uma impressora de rede e faça um pedido. O Impressão Legal tenta 3 vezes e avisa, e no Gestor o pedido ganha um aviso vermelho. Religue, clique em **Reimprimir** no Gestor, e o aviso some sozinho.
2. **PDV ligado na mesma loja:** ele não deve baixar nenhum pedido.
3. **Troca de IP:** altere o IP da impressora no Cloud. Em poucos segundos o Impressão Legal já imprime no novo endereço, sem reinstalar.

***

## Como desligar o Gestor autônomo

**Onde:** Gestão Legal → Administrativo → Filiais → editar a filial → aba **Integrações** → quadro **Gestor de pedidos**

Desmarque **Gestor autônomo** e clique em **Gravar**. O PDV volta a baixar os pedidos em aberto das últimas 6 horas.

{% hint style="warning" %}
Desligue sem pedido em andamento, para não gerar venda em dobro.
{% endhint %}

***

## <mark style="color:red;">Resolver problemas comuns</mark>

{% hint style="danger" %}

* **A opção Gestor autônomo não aparece na filial:** libere o módulo **Gestor de pedidos autônomo** no OEM (passo 1).
* **Ao marcar a opção, aparece uma lista de pendências:** corrija os itens listados (NFC-e, certificado digital, usuário padrão ou forma de pagamento padrão online da integração) e marque de novo.
* **Ao gravar, aparece "modificadores relacionados mais de uma vez no mesmo produto":** o mesmo adicional está em dois grupos do mesmo produto. Tire a repetição no cadastro dos produtos listados.
* **A comanda de um item não saiu, mas o ícone está verde:** a impressora do produto não está no perfil escolhido. Inclua a impressora no perfil ou corrija o produto.
* **Ícone vermelho:** passe o mouse sobre o ícone e veja o motivo: impressora desligada, sem rede, servidor fora ou loja sem perfil.
* **Ícone amarelo:** token inválido. Abra **Configurar...** e informe o token correto.
* **Impressora USB não imprime:** confira se a impressora no Windows tem o mesmo nome cadastrado no Cloud.
* **Acabou o papel e a comanda não saiu:** troque o papel e use **Reimprimir**, no Gestor ou no histórico do Impressão Legal.
* **Pedido de retirada sem NFC-e:** abra o pedido e clique em **Imprimir NFC-e**.
  {% endhint %}

***

## Manuais relacionados

* [Gestor de Pedidos](https://ajuda.pdvlegal.com.br/retaguarda/administrativo/gestor-de-pedidos)
* [Perfil PDV](https://ajuda.pdvlegal.com.br/retaguarda/administrativo/perfil-pdv)
* [Configuração de impressão de produção](https://ajuda.pdvlegal.com.br/pdv/funcionalidades-de-vendas/configuracao-de-impressao-de-producao)
* [Certificado digital](https://ajuda.pdvlegal.com.br/retaguarda/administrativo/certificado-digital)
* [Integração com iFood](https://ajuda.pdvlegal.com.br/integracoes/integracao-com-ifood)
* [Integração com 99Food](https://ajuda.pdvlegal.com.br/integracoes/integracao-com-99food)
* [Delivery Legal (Integração)](https://ajuda.pdvlegal.com.br/integracoes/delivery-legal-delivery-vip/delivery-legal-integracao)
* [KDS Legal (Monitor de Pedidos e Gestor de Filas)](https://ajuda.pdvlegal.com.br/modulo-fiscal/kds-legal-monitor-de-pedidos-e-gestor-de-filas)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.pdvlegal.com.br/retaguarda/administrativo/gestor-de-pedidos-autonomo.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
