> 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/integracoes/integracao-com-goomer.md).

# Integração com Goomer

Instale o Centralizador Windows, prepare o ambiente local e valide a integração com a Goomer.

Use este roteiro para integrar a Goomer ao PDV Legal com Centralizador Windows.

{% hint style="warning" %}
**Agende uma janela sem operação**

Faça a troca do centralizador fora do horário de uso. Não inicie com mesas, pré-vendas ou pedidos de delivery em aberto.
{% endhint %}

### Pré-requisitos

Antes de começar, confirme:

* um computador ou servidor dedicado, com Windows 10 ou Windows 11 atualizado, para executar o Centralizador;
* um IP fixo da rede do cliente atribuído a esse computador ou servidor;
* arquivo `Pdvapi_Central_Win_Goomer` fornecido pelo suporte Tablet Cloud;
* acesso remoto autorizado para a equipe da Goomer.

### 1. Preparar o ambiente

Se o cliente usa outro centralizador, faça o saneamento antes da instalação.

{% stepper %}
{% step %}

### Finalize a operação

Registre e finalize todas as mesas, pré-vendas e pedidos de delivery abertos.
{% endstep %}

{% step %}

### Encerre os operadores

Execute o encerramento dos operadores em todos os terminais.
{% endstep %}

{% step %}

### Confira a numeração fiscal

Quando houver emissão fiscal, registre a série e a numeração atual dos cupons.
{% endstep %}
{% endstepper %}

### 2. Instalar o Centralizador Windows

Instale o Centralizador Windows no servidor ou computador do cliente. Siga o roteiro de [Centralizador Windows (Servidor Local)](/integracoes/centralizador-windows-servidor-local.md).

{% hint style="info" %}
Defina um IP fixo para essa máquina. Os terminais do PDV usarão esse endereço para acessar o Centralizador.
{% endhint %}

### 3. Atualizar os arquivos da integração

Após concluir a instalação, atualize os arquivos locais da API.

1. Extraia o arquivo Pdvapi\_Central\_Win\_Goomer. Este arquivo deve ser solicitado para a Plataforma Suporte Técnico da Tablet Cloud.
2. Copie todo o conteúdo extraído para `C:\XAMPP\HTDOCS\PDVAPI\`.
3. Confirme a substituição das pastas `app`, `config`, `public`, `routers` e `script`.

{% hint style="warning" %}
Substitua as pastas existentes. Não copie apenas arquivos isolados.
{% endhint %}

### 4. Apontar os terminais para o Centralizador

Identifique o IP fixo da máquina onde o Centralizador foi instalado. Depois, altere cada PDV que acessará o ambiente local para usar esse IP.

Valide a comunicação de cada terminal antes de liberar a operação.

### 5. Liberar o acesso para a Goomer

Forneça acesso remoto autorizado à equipe da Goomer. A equipe cria o banco de dados da Goomer e realiza a normalização e integração dos produtos e demais dados.

Mantenha o ambiente disponível até a conclusão dessas atividades.

### 6. Validar a integração

Com a configuração concluída, execute testes conjuntos entre Goomer e PDV Legal.

Valide pelo menos os seguintes itens:

* envio e recebimento de pedidos no PDV local;
* impressão nas impressoras de produção;
* comunicação com Cloud e Migrate.

{% hint style="success" %}
Libere a operação somente após todos os testes funcionarem conforme esperado.
{% endhint %}

### Checklist de conclusão

* [ ] Centralizador Windows instalado e licenciado.
* [ ] IP fixo configurado no servidor.
* [ ] Arquivos da integração atualizados em `C:\XAMPP\HTDOCS\PDVAPI\`.
* [ ] Terminais apontados para o IP do Centralizador.
* [ ] Acesso remoto liberado para a Goomer.
* [ ] Banco de dados criado e produtos normalizados.
* [ ] Pedidos, impressoras, Cloud e Migrate validados.


---

# 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/integracoes/integracao-com-goomer.md?ask=<question>&goal=<endgoal>
```

`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.