# 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FStoW5Pjh2lEicjBJkapx%2Fomie01.png?alt=media&#x26;token=8843d308-e269-4c08-99c8-2d00d4dbb1a8" 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F0vuFoVyheWYUi12ZqvBp%2Fomie02.png?alt=media&#x26;token=2a1c9bf3-e9d5-42b5-b129-eeffb6b1c3b1" 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FLw96pJ5VZfHi161WybnN%2Fomie03.png?alt=media&#x26;token=07fe2367-5b5c-4be8-92c7-f8915aa87d77" 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FTklxsi4mEF0Ydk9WLMks%2Fomie04.png?alt=media&#x26;token=34c7ce8e-4ff4-4562-8a30-5b3ff5b74212" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F63SjY6f6J2y5Lq8ZFtly%2Fomie05.png?alt=media&#x26;token=a7b178fc-ffd5-4201-ae1d-ec3fe5a7edf8" 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FuC8hEvie2x3UzZ3bgVNy%2Fomie06.png?alt=media&#x26;token=eab1da12-3695-407d-a5cf-970323bd6732" 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FaMTTgdWJwZ0FPep1WUUs%2Fomie07.png?alt=media&#x26;token=b69db2e1-e7a6-43f7-8532-ad0cdf7bb34d" 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="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2Fb4y4B4okQ4skv3wdW5XR%2Fomie08.png?alt=media&#x26;token=9ac33907-8f1e-4a8d-96e8-8903024924c0" 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 %}