> 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;**
* credenciais de acesso da integração à Tablet Cloud, fornecidas pelo suporte Tablet Cloud;
* **Grupo econômico**, **Secret** e **Código da loja** do cliente, consultados no OEM;
* 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)](https://ajuda.pdvlegal.com.br/integracoes/centralizador-windows-servidor-local).

{% 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.

{% stepper %}
{% step %}

### Extrair o arquivo

Extraia o arquivo `Pdvapi_Central_Win_Goomer`, solicitado à Plataforma Suporte Técnico da Tablet Cloud.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FAJuv1hxoAJJsrFlDMN9y%2F01_extrair_arquivo.png?alt=media&amp;token=019989ab-43f7-4200-865d-85818d8b9676" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Abrir a pasta da API

1 - Acesse **Este Computador > Disco Local (C:) > xampp > htdocs**
{% endstep %}

{% step %}

### Copiar os arquivos

1 - Copie todo o conteúdo extraído para `C:\XAMPP\HTDOCS\`.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FefFP6WYdOqRWyYFexwQW%2F03_xampp_htdocs.png?alt=media&amp;token=ead8d945-4875-48df-94f3-9ec8ee41d804" alt=""><figcaption></figcaption></figure>

2 - Inclua toda a pasta `pdvapi` (que contem os arquivos: `app`, `config`, `public`, `routers` e `script)`.
{% endstep %}
{% endstepper %}

### 4. Configurar a API da integração

Com os arquivos no lugar, configure a conexão da API pelo navegador do próprio computador onde o Centralizador foi instalado.

{% stepper %}
{% step %}

### Abrir a tela de configuração

No navegador, acesse `localhost/pdvapi`.

A tela **Setup Inicial Obrigatório** será exibida. Enquanto ela não for preenchida, a API fica bloqueada.
{% endstep %}

{% step %}

### Preencher os dados do banco

* **Host do banco de dados:** o IP fixo definido para o Centralizador.
* **Nome do banco de dados:** `walinux`.
* **Usuário do banco de dados:** `root`.
* **Senha do banco de dados:** opcional, mas recomendada. Defina uma senha e guarde-a com a documentação do cliente.
*

```
<figure><img src="/files/pM6U2S1HKHErS9G3Ou6q" alt=""><figcaption></figcaption></figure>
```

{% endstep %}

{% step %}

### Preencher os dados da Tablet Cloud

* **Username** e **Senha para Tablet Cloud:** as credenciais da integração, fornecidas pelo suporte Tablet Cloud.
* **Empresa Tablet Cloud:** o grupo econômico da loja, consultado no OEM.
* **Secret para Tablet Cloud:** o secret da loja, consultado no OEM.
* **Loja para Tablet Cloud:** o código da loja, consultado no OEM.

{% hint style="danger" %}
As credenciais da integração são de uso restrito. Não compartilhe esses dados com o cliente final nem os registre em locais públicos.
{% endhint %}
{% endstep %}

{% step %}

### Salvar

Preencha todos os campos e clique em **Salvar configuração**.

Você será direcionado para a área de testes.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FFt648BNXhgoy72GfWi9Q%2F05_setup_preenchido.png?alt=media&amp;token=ec1b3399-855a-4e16-b732-9067559f9b50" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 5. Testar a conexão da API

Os testes ficam na página **Documentação da API**, em `localhost/pdvapi/docs.php`.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FYazJJzmCYI36dO8XU62y%2F06_testes_sync_all.png?alt=media&amp;token=de64a1ca-9fa5-4fea-8f7b-0013ad04b4aa" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Testar a sincronização com a Tablet Cloud

* Localize **GET /tabletcloud/sync-all**.
* Clique na seta para baixo para expandir as informações.
* Desça até **Teste rápido** e clique em **Executar**.
* Aguarde o retorno.

{% hint style="info" %}
O retorno esperado é **HTTP 200**, com `"success": true`.
{% endhint %}
{% endstep %}

{% step %}

### Corrigir o erro HTTP 500, se aparecer

Se o teste retornar **HTTP 500**, com erro interno no servidor e a mensagem *"Nenhuma conexão pôde ser feita porque a máquina de destino as recusou ativamente"*, a API está tentando acessar o banco pela porta errada.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FnaGZU9l1H7VdUGaX8EZD%2F08_erro_http_500.png?alt=media&amp;token=8bfbf305-b0b5-456a-b222-dc69811f832d" alt=""><figcaption></figcaption></figure>

Ajuste a porta do banco:

1. Acesse a pasta `C:\XAMPP\HTDOCS\PDVAPI\config`.
2. Clique com o botão direito no arquivo `env.php` e abra com o **Bloco de Notas**.
   \*

   ```
   <figure><img src="/files/ic93UIPFAjQFQxhYrZbR" alt=""><figcaption></figcaption></figure>
   ```
3. Altere o valor de **DB\_PORT** de `3307` para `3306`.
   \*

   ```
   <figure><img src="/files/zaLgytAAO1i5unGl7cu0" alt=""><figcaption></figcaption></figure>
   ```
4. Salve o arquivo.
5. Volte para `localhost/pdvapi` e execute o **Teste rápido** novamente.

O retorno deve passar a ser **HTTP 200**.

{% hint style="warning" %}
Altere somente a linha **DB\_PORT**. As demais linhas do `env.php` são geradas automaticamente pela tela de configuração e contêm credenciais da integração.
{% endhint %}
{% endstep %}

{% step %}

### Verificar a estrutura das tabelas

* Localize **GET /verificar-estrutura-tabelas**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FEcmvgYnP4RkKOoMtUxNx%2F11_testes_estrutura_tabelas.png?alt=media&amp;token=8c908bbb-b6d8-4960-8c2d-d085e0e8a5d2" alt=""><figcaption></figcaption></figure>

* Clique na seta para baixo e execute o **Teste rápido.**

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2Fsuj2YEqqX1vSr3JfFPXC%2F12_estrutura_tabelas_ok.png?alt=media&amp;token=d72e3a5b-a2c7-4e75-9a87-c61eab019c29" alt=""><figcaption></figcaption></figure>

* Confirme o retorno **HTTP 200**, com cada tabela indicando **estrutura correta**.
  {% endstep %}
  {% endstepper %}

{% hint style="success" %}
Com os dois testes aprovados, a integração entre o PDV Legal, o Centralizador e a API da Goomer está vinculada.
{% endhint %}

### 6. 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.

### 7. Liberar o acesso para a Goomer

A partir deste ponto, a equipe da **Goomer** assume a configuração e os testes do ambiente.

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.

{% hint style="info" %}
Durante essa etapa, a equipe da Goomer pode solicitar informações ao técnico responsável pela implantação do PDV Legal. Mantenha o ambiente disponível até a conclusão dessas atividades.
{% endhint %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FUliR1VscQ8ENYys836Ll%2F07_sync_all_http_200.png?alt=media&amp;token=37ed9b37-f9c8-4e3d-b199-d38eee537860" alt=""><figcaption></figcaption></figure>

### 8. 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\`.
* [ ] API configurada em `localhost/pdvapi`.
* [ ] Teste **sync-all** com retorno HTTP 200.
* [ ] Teste **verificar estrutura tabelas** aprovado.
* [ ] 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 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/integracoes/integracao-com-goomer.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.
