O que esta Integração Faz?
As Contas a Receber no Omie serão automaticamente lançadas assim que as faturas de energia das instalações forem aprovadas na página do Financeiro do sistema Digital Grid. Além disso, os eventos de pagamento e cancelamento das faturas na Digital Grid resultarão, respectivamente, em baixas e exclusões automáticas das contas a receber correspondentes no Omie. Essa integração entre os sistemas garante maior eficiência e precisão no controle financeiro, reduzindo a necessidade de intervenções manuais e minimizando erros. Para garantir o correto funcionamento desse processo, é essencial que as configurações de integração entre a Digital Grid e o Omie estejam devidamente parametrizadas.
2. Requisitos Obrigatórios para a Integração
Os requisitos obrigatórios para a integração entre a Digital Grid e o Omie são:
Ter uma conta e um plano contratado junto ao Omie
Fornecer para a Digital Grid a API Key e a API Secret Key da conta do Omie. Podem ser criadas e obtidas neste link
Possuir a mesma conta corrente cadastrada no Omie e na Digital Grid
Informar para a Digital Grid em qual Código Categoria do Omie que serão lançadas as contas a receber
Uma instalação na Digital Grid corresponde a um cliente ativo no Omie. Dessa forma, os clientes precisam ser cadastrados previamente no Omie e relacionados às instalações cadastradas na Digital Grid. Para isso, escolha uma das diretrizes abaixo para realizar esse relacionamento:
Diretiva 1
Documentos dos Titulares (CNPJ ou CPF): Assegure-se de que os documentos dos titulares das instalações na Digital Grid coincidam exatamente com os documentos dos clientes cadastrados no Omie. Isso é fundamental para evitar problemas de validação e garantir a conformidade.
Instalação: No nome fantasia de cada cliente no Omie, deve-se incluir somente o número da instalação correspondente, exatamente no mesmo formato da instalação que está cadastrada no sistema da Digital Grid.
Diretiva 2 (Requer um desenvolvedor ou equipe de TI)
Defina um código de integração do cliente para cada cliente cadastrado no Omie. Isso pode ser feito alterando o campo codigo_cliente_integracao presente na rota api/v1/geral/clientes/ da API do Omie. O mesmo código deve ser inserido na instalação correspondente na Digital Grid, por meio do campo installation_integration_code presente na rota /api/v1/installations na API da Digital Grid.
Quando o campo installation_integration_code estiver preenchido na Digital Grid, a integração utilizará a Diretiva 2 para localizar o cliente no Omie e gerar a Conta a Receber. Se este campo não estiver preenchido, a integração recorrerá ao documento e ao nome fantasia (número da instalação), seguindo a Diretiva 1, para identificar o cliente no Omie e proceder com a geração da conta a receber.
Para garantir a conformidade com essas diretrizes, pode ser necessário desativar a configuração de documento como chave única no cadastro de clientes no Omie. Isso se deve ao fato de que um único documento pode estar associado a várias instalações, resultando na necessidade de cadastro de múltiplos clientes com o mesmo documento no sistema Omie.
Passo a Passo do Funcionamento da Integração
1. Criação de uma Conta a Receber no Omie: No sistema da Digital Grid, uma vez que as faturas sejam aprovadas na página Financeiro, a integração da DG será encarregada de efetuar uma solicitação para identificar o cliente registrado no Omie que é responsável pela fatura emitida. Este procedimento de identificação do cliente será conduzido conforme a Diretiva 1 ou a Diretiva 2, conforme detalhado acima.
Uma vez localizado o cliente, a integração da DG procederá com o lançamento da conta a receber no Omie com os dados da fatura apresentados na figura abaixo.
*Para Desenvolvedores e equipe de TI: O código lançamento integração de uma conta a receber é definido pela Digital Grid e pode ser obtido pela nossa API através do campo integration_code na rota /api/v1/bills/. Este código também pode ser encontrado na coluna Código de Integração no relatório de faturas, que pode ser exportado na página de Relatório na plataforma da Digital Grid.
2. Exclusão de Contas a Receber: O cancelamento de faturas previamente aprovadas na página Financeiro do sistema Digital Grid implicará na exclusão da conta a receber correspondente no Omie.
3. Baixa de uma Contas a Receber: Ao receber a confirmação do banco do pagamento ou quando o usuário marcar uma fatura como paga no sistema da Digital Grid, a integração procederá com o lançamento da baixa da conta a receber no Omie. A data de pagamento será definida como D+1 para pagamentos realizados na Segunda, Terça, Quarta e Quinta-feira, e D+3 para pagamentos efetuados na Sexta-feira.
*Feriados nacionais são contemplados nesta lógica
Para Desenvolvedores e equipe de TI: Assim como o Código Lançamento Integração da conta a receber, o Código Baixa Integração do lançamento da baixa é gerado pela Digital Grid.
4. Exclusão de Baixas de Contas a Receber: Através do suporte da Digital Grid, é possível solicitar o cancelamento de um pagamento de uma fatura. Isso pode ser necessário principalmente quando a informação de pagamento é gerada manualmente no sistema da Digital Grid. Com esta ação, a integração realizará a exclusão da baixa de uma conta a receber no Omie.
