Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integração com OMIE

Use este fluxo para ativar a integração com a OMIE e sincronizar os dados com o PDV Legal.

A configuração exige atenção ao ambiente fiscal e ao modelo de operação.

Pontos importantes

  • Licença nova: a integração com a OMIE requer uma licença nova, não configurada ou 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.

1. Ativar o módulo OMIE

1

Ativar o módulo OMIE

  • Ative o módulo OMIE na licença do cliente.

2

Obter APP_KEY e APP_SECRET

  • Acesse o OMIE com as credenciais do cliente.

  • Clique no ícone de engrenagem.

  • Role a tela até encontrar APP_KEY e APP_SECRET.

  • Clique em Exibir para visualizar o APP_SECRET.

  • Copie ambos os códigos.

3

Configurar no PDV Legal

  • Acesse a licença PDV Legal no Cloud do cliente.

  • Cole os códigos nos campos respectivos.

  • Selecione o fluxo da integração.

Essa escolha só pode ser feita uma vez.

4

Definir o 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.

5

Confirmar a configuração

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

  • Clique no logo para verificar o status da integração.

Se houver erro no processamento, a mensagem será exibida em vermelho em vez de verde.

  • Force a sincronização dos dados da OMIE para o PDV pelo menos uma vez.

2. Ativar a sincronização automática

1

Configurar webhooks na OMIE

  • Acesse OMIE Developer.

  • Clique em Webhooks/Notificações do Webhook.

  • Selecione o nome do seu aplicativo.

  • Vá até Adicionar novo webhook.

  • Em EndPoint, digite https://admin.tabletcloud.com.br/omie/webhook.aspx.

  • Em Assuntos, marque todas as opções.

2

Salvar a configuração

  • A sincronização ocorrerá automaticamente sempre que os dados forem alterados na OMIE.

3. Configurar formas de pagamento

1

Acessar formas de pagamento

  • No Cloud, vá para Administrativo > Formas de Pagamentos.

2

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

4. Configurar parâmetros de integração

1

Acessar parâmetros de integração

No Cloud, vá para Administrativo > Filiais > Parâmetros.

2

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.

Erros comuns

Não consigo visualizar o APP_SECRET na OMIE

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.

Erros na sincronização de dados

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.

Formas de pagamento não sincronizam corretamente

Verifique se os tipos de documento foram configurados corretamente no Cloud e se correspondem às categorias de receitas e contas correntes na OMIE.

Boas práticas

  • Verifique a configuração do módulo OMIE antes de iniciar a integração.

  • Sincronize os dados pelo menos uma vez manualmente.

  • Mantenha as informações de impostos e produtos atualizadas na OMIE.

  • Teste a integração após cada alteração.

Atualizado

Isto foi útil?