Como configurar a integração do Flash com o ERP Omie?

A integração nativa entre o Flash Despesas e o ERP Omie automatiza o envio de relatórios de reembolso aprovados e prestações de conta via API. Este guia destina-se aos Administradores do Flash que precisam ativar, configurar ou solucionar divergências no envio de dados para o Omie.

A integração com a OMIE é ativa e pode ser configurada por você diretamente pela sua plataforma de ERP, acesse Documentação Oficial de API da Flash.


ESCOPO DE INTEGRAÇÃO - Plataforma Flash Despesas x OMIE

O que integra: Reembolsos submetidos e aprovados; prestações de conta de cartão corporativo.

O que NÃO integra automaticamente: Saldo do Flash Cash corporativo e despesas de quilometragem. A quilometragem e ajustes de saldo devem ser lançados de forma manual no ERP Omie.

Tempo de Sincronização: O envio não ocorre em tempo real, mas sim em lotes periódicos com janela de até 24 horas.


PRÉ-REQUISITOS PARA ATIVAÇÃO
Para conectar as plataformas, garanta que você atende aos seguintes critérios antes do início:

  • Plano Ativo: A empresa precisa possuir um plano pago ativo compatível com integrações ERP no Flash.

  • Perfil de Acesso: O seu usuário deve ter acesso de Admin de Despesas no Flash (perfis exclusivos de Benefícios ou Pessoas não possuem visualização da API).

  • Acesso ao Omie: Permissão de administrador no ERP Omie.


PASSO A PASSO DE CONFIGURAÇÃO API

Passo 1: Obter as credenciais na Plataforma Flash

  1. Acesse o painel do Flash Despesas como Administrador.

  2. Vá até a seção de Configurações > Integrações.

  3. Localize o ERP Omie e gere suas credenciais: App Key e App Secret.

Passo 2: Configurar a conta e parâmetros no Omie

  1. No Omie, cadastre a Flash como uma Conta Corrente.

  2. Insira a App Key e o App Secret gerados na plataforma Flash nos campos correspondentes do ERP.

  3. Garanta que o nome da conta corrente, as categorias contábeis e os planos de contas estejam cadastrados com a nomenclatura exatamente idêntica nos dois sistemas.


DIAGNÓSTICO DE ERROS E DIVERGÊNCIAS FREQUENTES
Se os relatórios de reembolso ou despesas não forem importados para o Omie:

  1. A opção de liberação de API não aparece no painel Flash


    Ação: Confirme se a sua conta tem o perfil Admin de Despesas e se a empresa utiliza um plano pago. Se o perfil e o plano estiverem corretos e o campo continuar ausente, tire um print da tela de integrações para anexar ao chamado de suporte.

  2. Perdi a App Key ou o App Secret

    Ação: As chaves não podem ser recuperadas após serem fechadas na tela. Você precisará acessar as configurações de integração na Flash para gerar e salvar um novo par de credenciais e atualizá-lo no Omie.

  3. Erro: "Categoria não pode ser utilizada" (ou Categoria Agrupadora): O ERP Omie rejeita lançamentos em categorias agrupadoras (ex: "Outras despesas"). O sistema exige o vínculo direto a uma subcategoria válida.


    Ação: Na Flash, acesse o relatório do colaborador, edite a despesa afetada selecionando uma subcategoria válida e reenvie para integração.

  4. Reembolsos e relatórios aprovados não aparecem no Omie

    • Centros de Custo: Acesse Despesas > Preferências > Centros de custo e garanta que o centro de custo do relatório esteja com o status Ativo. Centros inativos bloqueiam o lote.

    • Categorias Contábeis: Verifique se todas as despesas do relatório possuem categoria preenchida. Se uma única despesa estiver sem categoria, o relatório inteiro não é enviado.

    • Status do Relatório: Certifique-se de que o relatório não ficou preso com o status "Aguardando processamento".

  5. Código de projeto ou ID externo do colaborador inválido

  • Projeto Inválido: Abra o relatório na Flash, edite a prestação de contas
    re-selecionando o projeto ativo e clique em "Enviar" para atualizar os parâmetros no Omie.

  • ID do Colaborador: Verifique se os dados do colaborador (nome completo, e-mail e telefone) na Flash estão idênticos ao cadastro do colaborador no Omie, sem abreviações ou divergências de espaço.






ARTIGOS ÚTEIS
Como funciona a integração de ERP e API na Flash?
Como configurar categorias de despesas dentro da plataforma?
Como cadastrar centro de custo na Flash?