> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como integrar o Groner com a Omie

Com a integração com a Omie, cada venda fechada no Groner (ou cada proposta aceita, se você preferir) vira um lançamento na Omie, sem digitar nada de novo. O cliente é cadastrado na Omie, e o valor entra como conta a receber ou como pedido de venda.

---

## Antes de começar

- Tenha em mãos o **App Key** e o **App Secret** da sua conta Omie. Eles ficam no portal de desenvolvedores da Omie, na área de aplicativos.
- Confira se os contatos têm **CPF ou CNPJ** cadastrado. Sem o documento, a Omie não aceita o cliente.
- A configuração é feita **por loja** e só por administradores.

## Passo a passo

1. Vá em **Configurações > Sistema & Desenvolvedor > Integrações** e abra a aba **Omie**.
2. Clique em **Adicionar configuração**.
3. Escolha a **Loja** e clique em **Confirmar**.
   Aparece a mensagem "Configuração Omie cadastrada com sucesso!".
4. Clique na configuração da loja e preencha os dados. Cada campo é salvo sozinho ao ser alterado pelo ícone de lápis:
   - **App Key** e **App Secret** da Omie. Preencha estes primeiro;
   - **Conta corrente** e **Categorias**, escolhidas nas listas que vêm da própria Omie. As listas só carregam depois das chaves;
   - **Gatilho do lançamento:** **Venda** (quando a venda é cadastrada) ou **Pré-proposta Aceita** (quando o cliente aceita a proposta);
   - **Tipo de integração:** **Conta a Receber** ou **Pedido Venda**;
   - **Tipo de valor:** **Valor total**, **Valor do produto** ou **Valor do serviço**;
   - **Tempo de vencimento em dias**, contado a partir da data da venda ou do aceite.

A cada alteração aparece "Configuração Omie atualizada com sucesso!".

Se você tem mais de uma loja, repita os passos para cada uma.

## O que é enviado para a Omie

Quando o gatilho acontece:

1. O **cliente** é cadastrado na Omie no primeiro envio. Nos envios seguintes, o Groner usa esse mesmo cadastro.
2. Com o gatilho **Venda** e o tipo **Conta a Receber**, é criado também um **projeto** na Omie.
3. É lançada a **conta a receber** (ou o **pedido de venda**), com o valor escolhido, a categoria, a conta corrente e o vencimento.

> **Bom saber:** o Groner usa a **loja do contato** para escolher qual configuração aplicar. Confira se o contato está na loja certa.

## Onde ver o resultado

Cada lançamento processado pela Omie fica registrado como uma atividade no histórico do negócio, com a mensagem e o código devolvidos pela Omie. Falhas de configuração e recusas da Omie não aparecem no histórico: se o lançamento não aparecer depois de alguns minutos, confira os pontos abaixo.

O que conferir quando o lançamento não aparece:

- **App Key** e **App Secret** preenchidos na configuração da loja do contato;
- **Conta corrente** e **Categorias** escolhidas na configuração;
- **CPF ou CNPJ** cadastrado no contato. Editar a venda não reenvia para a Omie: exclua e cadastre a venda de novo, ou faça o lançamento direto na Omie.

Se logo depois de um lançamento com sucesso aparecer um aviso de lançamento já existente, pode ignorar: o lançamento certo já foi feito.

## Excluir uma configuração

Clique no ícone **Excluir configuração do Omie** e confirme. Essa ação não pode ser desfeita. A partir daí, as vendas dessa loja deixam de ir para a Omie.

<!-- groner-suporte:veja-tambem:inicio -->

## Veja também

- [Como integrar a Groner com o Conta Azul](https://ajuda.groner.app/pt-br/article/como-integrar-a-groner-com-o-conta-azul-vria8c/)
- [Como Cadastrar uma Venda a Partir de uma Proposta na Groner](https://ajuda.groner.app/pt-br/article/como-cadastrar-uma-venda-a-partir-de-uma-proposta-na-groner-ut11j2/)
- [Como Editar ou Excluir uma Venda na Groner](https://ajuda.groner.app/pt-br/article/como-editar-ou-excluir-uma-venda-na-groner-tcu30t/)
- [Como criar e excluir contatos](https://ajuda.groner.app/pt-br/article/como-criar-e-excluir-contatos-1tctm7b/)

<!-- groner-suporte:veja-tambem:fim -->