> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.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.uplaces.com.br/integracoes/omie/configuracao-da-integracao.md).

# Conectar a Omie

Informe a App Key e o App Secret da sua conta da Omie na Uplaces, cadastre o usuário de integração, teste a conexão e ative a integração.

Informe a App Key e o App Secret da sua conta da Omie, cadastre o usuário de integração e teste a conexão. É o primeiro passo para importar produtos e clientes para a loja.

{% stepper %}
{% step %}

## Gere as chaves de acesso na Omie

A Uplaces fala com a Omie por meio de duas chaves da sua conta: a **App Key** e o **App Secret**. Quem gera é você, dentro da Omie.

1. Acesse o portal de desenvolvedores da Omie, em [developer.omie.com.br](https://developer.omie.com.br), e abra **Aplicativos**;
2. Se precisar, siga o passo a passo da Omie em [Obtendo a chave de acesso para integrações de API](https://ajuda.omie.com.br/pt-BR/articles/499061-obtendo-a-chave-de-acesso-para-integracoes-de-api);
3. Copie a **App Key** e o **App Secret** e deixe os dois à mão. O App Secret aparece mascarado: clique no ícone de olho para ver.

{% hint style="info" %}
A Omie cobra uma mensalidade por aplicativo de API contratado fora da Omie.Store. Confira as condições na [ajuda da Omie](https://ajuda.omie.com.br/pt-BR/articles/15959035).
{% endhint %}

{% hint style="warning" %}
Trate o App Secret como uma senha: não envie por e-mail nem por mensagem.
{% endhint %}
{% endstep %}

{% step %}

## Cadastre o usuário de integração

A integração usa um usuário próprio da Uplaces, só para ela.

1. No menu, acesse **Usuários** e clique em **Incluir**;
2. Preencha os campos obrigatórios;
3. Selecione o perfil **Integração** e salve.
   {% endstep %}

{% step %}

## Informe as credenciais na Uplaces

1. No menu, acesse **Integração ERP** e clique em **Nativa**;
2. Escolha a **Omie**;
3. Em **Nome da integração**, informe um nome, por exemplo *Integração Omie*;
4. No campo **App Key**, cole a App Key;
5. No campo **App Secret**, cole o App Secret;
6. Salve e clique em **Testar**.

Se a conexão estiver certa, a tela mostra a mensagem **Teste de integração com Omie executado com sucesso**, com a razão social e o CNPJ da conta da Omie. Confira se são os da sua empresa.

{% hint style="info" %}
Depois que a integração é salva, a tela libera o botão **Importar do Omie** e o interruptor **Integração ativa**.
{% endhint %}

{% hint style="info" %}
Se o teste falhar, espere um minuto antes de tentar de novo: a Omie recusa a mesma chamada repetida em menos de 60 segundos, e muitas falhas seguidas bloqueiam a conexão por 30 minutos.
{% endhint %}
{% endstep %}

{% step %}

## Ative a integração

1. Ligue o interruptor **Integração ativa**;
2. Clique em **Salvar**.

Com a integração ativa, siga para [Importar produtos e clientes da Omie](https://ajuda.uplaces.com.br/integracoes/omie/importacao-de-produtos-e-clientes.md).
{% endstep %}
{% endstepper %}

Para enviar pedidos à Omie, fale com o suporte da Uplaces.

## Problemas comuns

<details>

<summary>Erro de credencial no teste</summary>

Confira se a App Key está no campo **App Key** e o App Secret no campo **App Secret**. Os dois não podem ficar trocados.

</details>

<details>

<summary>A Omie recusou a chamada</summary>

Espere um minuto e teste de novo. A Omie recusa a mesma chamada repetida em menos de 60 segundos.

</details>

<details>

<summary>Conexão bloqueada</summary>

A Omie bloqueia por 30 minutos depois de muitas requisições incorretas. Aguarde e confira as chaves antes de tentar.

</details>

<details>

<summary>A Omie diz que não localizou as informações da sua empresa</summary>

Em empresa recém-criada, a Omie responde **Não foi possível localizar as informações da sua empresa** até o primeiro acesso ao ERP. Na Omie, em **Meus aplicativos**, clique em **Acessar** uma vez e teste de novo.

</details>

<details>

<summary>Conta de avaliação da Omie: limite do dia atingido</summary>

A empresa de teste da Omie aceita poucas requisições por dia, e uma importação pode passar do limite (a Omie responde **API\_TRIAL\_DAILY\_QUOTA\_EXCEEDED**). O limite reinicia à meia-noite.

</details>

<details>

<summary>O botão Importar do Omie não aparece</summary>

Salve primeiro o nome, a App Key e o App Secret.

Se nada resolver, fale com o suporte da Uplaces e informe o horário do teste e a mensagem exibida.

</details>

## Perguntas frequentes

<details>

<summary>Onde vejo o resultado do teste?</summary>

A tela mostra a mensagem de sucesso com a razão social e o CNPJ da conta da Omie. Em caso de erro, o [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md) ajuda a achar a causa.

</details>

## Veja também

* [Integração com a Omie](https://ajuda.uplaces.com.br/integracoes/omie.md)
* [Importar produtos e clientes da Omie](https://ajuda.uplaces.com.br/integracoes/omie/importacao-de-produtos-e-clientes.md)
