# Integração com OMIE

{% hint style="danger" %}

### **Pontos Importantes:** <a href="#pontosimportantes" id="pontosimportantes"></a>

* **Licença Nova:** A integração com a OMIE requer uma licença nova, não configurada/utilizada anteriormente.
* **Ambiente 100% Fiscal:** Todas as regras de impostos e produtos devem ser configuradas no OMIE.
* **Mono Loja:** A integração é mono loja, ou seja, um CNPJ por integração OMIE X PDV Legal.
* **Ambiente por Grupo Econômico:** A estrutura da integração respeita o limite de um ambiente por grupo econômico.
* **Produtos e Formas de Pagamento:** Devem ser configurados no OMIE e sincronizados com o PDV Legal.
  {% endhint %}

## **Como configurar a Integração com OMIE?** <a href="#passoapassoparaconfiguraraintegrao" id="passoapassoparaconfiguraraintegrao"></a>

### **1. Ativação do Módulo OMIE** <a href="#id-1ativaodomduloomie" id="id-1ativaodomduloomie"></a>

{% stepper %}
{% step %}

### **Ativar Módulo OMIE:**

* Ative o módulo OMIE na licença do cliente.
  {% endstep %}

{% step %}

### **Obter APP*****KEY e APP*****SECRET:**

* Acesse o OMIE com as credenciais do cliente.
* Clique no ícone de engrenagem.

<figure><img src="/files/Mot8wsRO2ou1oqIiiiOT" alt=""><figcaption></figcaption></figure>

* Role a tela para encontrar **APP*****KEY** e **APP*****SECRET**.
* Clique em **Exibir** para visualizar o APP\_SECRET.
* Copie ambos os códigos.

<figure><img src="/files/kvF8AJytyjYuim8HhO3S" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Configurar no PDV Legal:**

* Acesse a licença PDV Legal (Cloud) do cliente.
* Cole os códigos nos campos respectivos.
* Selecione o fluxo da integração (<mark style="background-color:red;">**esta escolha só pode ser feita uma vez**</mark>).
  {% endstep %}

{% step %}

### **Configuração do Fluxo da Integração**

* **Grupos e Produtos Cadastrados no PDV Legal:**
  * Use essa opção apenas com orientação.
* **Grupos e Produtos Cadastrados na OMIE:**
  * Todas as informações serão cadastradas na OMIE e sincronizadas para o PDV Legal.

<figure><img src="/files/w0qzOisQAOGNxVZbXf8m" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Confirmar Configuração:**

* Após inserir as informações e selecionar o tipo de integração, o logo da OMIE será exibido na tela inicial.

<figure><img src="/files/6mRaOCrPDatc82voTOEJ" alt=""><figcaption></figcaption></figure>

* Clique no logo para verificar o status da integração.&#x20;

<figure><img src="/files/jNLPawA6vtDlEZO3oOn7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Se houver algum erro no processamento, a mensagem será exibida em **vermelho** ao invés de **verde**. Fique atento para corrigir eventuais problemas antes de continuar a operação.
{% endhint %}

* Forçar a sincronização dos dados da OMIE para o PDV pelo menos uma vez.

<figure><img src="/files/HQSOyKFoxR43m0vBd3jx" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## **2. Ativação da Sincronização Automática** <a href="#id-3ativaodasincronizaoautomtica" id="id-3ativaodasincronizaoautomtica"></a>

{% stepper %}
{% step %}

### **Configurar Webhooks na OMIE:**

* Acesse [OMIE Developer](http://developer.omie.com.br/).
* Clique em **Webhooks/Notificações do Webhook**.
* Selecione o nome do seu aplicativo.
* Vá até a opção **Adicionar novo webhook**.
* Em **EndPoint**, digite: `https://admin.tabletcloud.com.br/omie/webhook.aspx`.
* Em **Assuntos**, marque todas as opções.
  {% endstep %}

{% step %}

### **Salvar Configuração:**

* A sincronização ocorrerá automaticamente sempre que os dados forem alterados na OMIE.
  {% endstep %}
  {% endstepper %}

***

## **3. Configurar Formas de Pagamento** <a href="#id-4configurarformasdepagamento" id="id-4configurarformasdepagamento"></a>

{% stepper %}
{% step %}

### **Acesse Formas de Pagamento:**

* No Cloud, vá para **Administrativo > Formas de Pagamentos**.
  {% endstep %}

{% step %}

### **Configurar Tipos de Documento:**

* Selecione as opções adequadas para cada tipo de pagamento:
  * **BOL**: Boleto
  * **DIN**: Dinheiro
  * **CRE**: Crediário
  * **CRT**: Cartão
  * **CRC**: Cartão de Crédito
  * **CRD**: Cartão de Débito
  * **CHQ**: Cheque
  * **CHT**: Cheque de Terceiros
  * **PIX**: Cartão de Débito
  * **99999**: Outros

<figure><img src="/files/xn6NGIIPtxO8aMkrCd9e" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## 4. Configurar Parâmetros de Integração

{% stepper %}
{% step %}

### **Acesse Parâmetros de Integração:**

No Cloud, vá para **Administrativo > Filiais > Parâmetros**.
{% endstep %}

{% step %}

### **Relacionar Campos entre Cloud e OMIE:**

* **Grupos de Produtos:** Família de Produtos
* **Produtos:** Produtos e Impostos
* **Forma de Pagamento:** Conta Corrente
* **Forma de Pagamento:** Categoria de Receitas
* **Gorjeta:** Categoria de Despesas
* **Turno:** Projetos
* **Usuários PDV:** Vendedores
* **Tipo de Documento:** Associado à conta corrente e informado nas parcelas do cupom fiscal.

<figure><img src="/files/34xGABKkQWrNeU3IUqqf" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## <mark style="background-color:red;">**Preciso de Ajuda**</mark> <a href="#precisodeajuda" id="precisodeajuda"></a>

{% hint style="danger" %}
**Problema:** Não consigo visualizar o APP\_SECRET na OMIE.

* **Solução:** Certifique-se de estar logado com as credenciais corretas e clique em **Exibir** para visualizar o APP\_SECRET. Caso o problema persista, entre em contato com o suporte da OMIE.

**Problema:** Erros na sincronização de dados.

* **Solução:** Verifique as mensagens de erro exibidas na tela inicial do PDV Legal e siga as orientações. Certifique-se de que todas as informações foram inseridas corretamente.

**Problema:** Formas de pagamento não estão sincronizando corretamente.

* **Solução:** Verifique se os tipos de documento foram configurados corretamente no Cloud e se correspondem às categorias de receitas e contas correntes na OMIE.
  {% endhint %}

## <mark style="background-color:green;">**Dicas Rápidas**</mark> <a href="#dicasrpidas" id="dicasrpidas"></a>

{% hint style="success" %}

* **Verifique a configuração do módulo OMIE** antes de iniciar a integração.
* **Sincronize os dados** pelo menos uma vez manualmente para garantir que tudo esteja funcionando corretamente.
* **Mantenha as informações de impostos e produtos atualizadas** na OMIE para evitar problemas fiscais.
* **Teste a integração** após cada alteração para garantir que os dados estão sendo sincronizados corretamente.
  {% 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/integracoes/integracao-com-omie.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.