> 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-jotaja.md).

# Integração com JotaJá

Habilite o módulo, gere o Merchant ID no PDV Legal, informe o Client Id e o Client Secret enviados pela JotaJá e conclua a validação da integração.

> Use este fluxo para habilitar a integração com a **JotaJá** e finalizar a configuração no **PDV Legal**.
>
> A **JotaJá** envia o **Client Id** e o **Client Secret**. O **Merchant ID** é gerado no próprio **Gestão Legal** e precisa ser informado à JotaJá para o vínculo da loja.

{% hint style="warning" %}
**Importante:** ao utilizar esta integração, manter equipamento exclusivo para recepcionar pedidos; não utilizar maquininhas de cartão; certificar-se de que o equipamento não esteja em ambiente compartilhado via Raspberry.
{% endhint %}

### 1. Liberar o módulo JotaJá no OEM

{% stepper %}
{% step %}

### Acessar o OEM

* Acesse o sistema **OEM**.
* Pesquise o cliente pelo **Código, CNPJ ou Nome**.
* Clique no ícone **Filiais** e localize a filial desejada.
* Clique no ícone **Editar**.
  {% endstep %}

{% step %}

### Habilitar o módulo

* Role a tela para baixo.
* Marque o módulo **JotaJá**.
* Clique em **Gravar**.
  {% endstep %}
  {% endstepper %}

***

### 2. Gerar o Merchant ID no Gestão Legal

{% stepper %}
{% step %}

### Acessar a filial

* No **Gestão Legal**, vá para **Administrativo > Filiais**.
* Localize a filial desejada.
* Clique no ícone de **edição**.
  {% endstep %}

{% step %}

### Abrir a integração

* Vá para a aba **Integrações**.
* Selecione **Open Delivery**.
* No campo **Empresa Parceira**, selecione **JotaJá**.
  {% endstep %}

{% step %}

### Gerar o código

* Localize o campo **Merchant ID**.
* Clique no ícone ao lado para gerar o código.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FmpomuJn8TzJo9eiJBV8S%2Fimage.png?alt=media&amp;token=8d790945-ba9c-40de-beff-888023176087" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Guardar o código

* Copie o **Merchant ID** gerado e guarde em um local de fácil acesso.
* Ele será enviado à JotaJá na próxima etapa.
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
Gere o **Merchant ID** antes de falar com a JotaJá. Assim você envia o código na mesma solicitação e o vínculo da loja pode ser feito enquanto as credenciais são preparadas.
{% endhint %}

***

### 3. Solicitar as credenciais à JotaJá

{% hint style="danger" %}

#### Processo provisório

A tela em que o lojista informa o **Merchant ID** ainda está em desenvolvimento do lado da **JotaJá**.

Até ela ficar pronta, o envio do código e o vínculo da loja são feitos manualmente pela equipe da JotaJá, conforme os passos abaixo.
{% endhint %}

{% stepper %}
{% step %}

### Entrar em contato com a JotaJá

* Oriente o cliente a entrar em contato com a equipe da **JotaJá**.
* Solicite o **Client Id** e o **Client Secret**.
  {% endstep %}

{% step %}

### Enviar o Merchant ID

* Na mesma solicitação, envie o **Merchant ID** gerado na etapa anterior.
* Peça que a JotaJá registre esse código para vincular a loja.
  {% endstep %}

{% step %}

### Aguardar o retorno

* Aguarde o envio do **Client Id** e do **Client Secret**.
* Mantenha os dois códigos em mãos para a próxima etapa.
  {% endstep %}
  {% endstepper %}

{% hint style="warning" %}
O retorno das credenciais pode levar alguns dias. Enviar o **Merchant ID** já no primeiro contato evita uma segunda espera só para o vínculo.
{% endhint %}

***

### 4. Informar as credenciais e validar

{% stepper %}
{% step %}

### Abrir a integração

* No **Gestão Legal**, volte para **Administrativo > Filiais** e edite a filial.
* Vá para a aba **Integrações**, selecione **Open Delivery** e, em **Empresa Parceira**, selecione **JotaJá**.
  {% endstep %}

{% step %}

### Informar os códigos

* Preencha os campos **Client Id** e **Client Secret** com os códigos enviados pela **JotaJá**.
* Confirme se o **Merchant ID** gerado anteriormente continua no campo correspondente.
  {% endstep %}

{% step %}

### Validar e gravar

* Clique em **Validar**.
* Depois, clique em **Gravar**.
  {% endstep %}
  {% endstepper %}

{% hint style="success" %}
Depois de validar e gravar, a integração da **JotaJá** fica pronta para seguir com a operação no **PDV Legal**.
{% endhint %}

{% hint style="warning" %}
Se a validação não for concluída, confirme com a JotaJá se o **Merchant ID** enviado já foi vinculado à loja do lado deles.
{% endhint %}

***

### 5. Vincular os produtos no portal JotaJá

{% stepper %}
{% step %}

### Acessar o portal JotaJá

* Acesse o portal **JotaJá**.
  {% endstep %}

{% step %}

### Abrir a lista de produtos

* No menu **Cardápio**, clique em **Produtos**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FVpWGxtEStISbvhiJEC6A%2FProdutoJota1.jpeg?alt=media&#x26;token=d3f3db97-c454-41a2-896c-18139846ffc0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Editar o produto

* Localize o produto desejado.
* Clique no ícone de **edição**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FRwsVl7kAINO1SVS5yKhN%2FProdutoJota2.jpeg?alt=media&#x26;token=0b013f01-2c52-498d-81b8-a16613d1eb9c" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Informar o SKU

* No campo **SKU**, informe o código do produto no **PDV Legal**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F4aBqkLBD07ZmGWejGYd1%2FProdutoJota3.jpeg?alt=media&#x26;token=ab6835b1-1a97-4080-8b0b-fc48c83c62b4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Salvar a alteração

* Clique em **Salvar**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F8PiAsy3zkdghjoDFejAz%2FProdutoJota4.jpeg?alt=media&#x26;token=039feeb0-c791-4a68-b0ae-5ce2778e3518" alt=""><figcaption></figcaption></figure>

* Repita o processo para os demais produtos que precisam de vinculação.
  {% endstep %}
  {% endstepper %}

***

### Manuais relacionados

* [Gestor de Pedidos](https://ajuda.pdvlegal.com.br/retaguarda/administrativo/gestor-de-pedidos)
* [Integração com Cardápio Web](https://ajuda.pdvlegal.com.br/integracoes/integracao-com-cardapio-web)
* [Integração com Keeta](https://ajuda.pdvlegal.com.br/integracoes/integracao-com-keeta)


---

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