Agora no Bluesoft ERP, é possível incluir despesas de consumo de energia elétrica por meio da API Financeira, utilizando contratos financeiros previamente cadastrados com os modelos fiscais 06 e 66. Com essa melhoria, as integrações podem realizar a inclusão das despesas, gerando nota fiscal, escrita fiscal, duplicatas e registros contábeis, respeitando as configurações do contrato financeiro.

Como Era o Processo Antes?

Anteriormente, a inclusão das despesas de consumo de energia elétrica era realizada pela interface do ERP, mediante a seleção de um contrato financeiro e o preenchimento das informações fiscais, tributárias e financeiras.

Como Irá Funcionar a Partir de Agora?

Agora, além do procedimento manual já disponível, as empresas podem automatizar a inclusão dessas despesas por meio de uma API específica. Nesse caminho, o usuário poderá consultar ou cadastrar o contrato financeiro do tipo Consumo de Energia Elétrica que será utilizado pela integração. Sendo necessário a Permissão: 4753 — Inclusão de Despesa de Consumo de Energia Elétrica.

1. Configuração do contrato

Antes de utilizar a API, é necessário possuir um contrato financeiro de consumo de energia elétrica devidamente configurado, com modelo fiscal 06 ou 66, prestador, loja e contas contábeis correspondentes.

2. Inclusão da despesa pela integração

A integração deverá utilizar o seguinte endpoint:

POST /api/financeiro/contratos/{contratoFinanceiroKey}/despesas/consumo-energia-eletrica

A operação recebe os dados do documento fiscal, informações do consumo, valores, tributos, parcelas e loja pagadora.

3. Exemplo de utilização

Considere uma empresa que recebe mensalmente uma conta de energia elétrica no valor de R$ 500,00, referente à loja 1.
O contrato financeiro de energia elétrica já está cadastrado no ERP, com o modelo fiscal 06.

A integração deverá informar:

  • Contrato financeiro: 89071 (identificador ilustrativo).
  • Loja fiscal: obtida automaticamente do contrato.
  • Loja pagadora: 1.
  • Modelo fiscal: 06, configurado no contrato.
  • Número do documento: 123456.
  • Data de emissão: 15/10/2026.
  • Data de entrada: 16/10/2026.
  • Valor total: R$ 500,00.
  • Forma de pagamento: conforme configuração válida do ERP.
  • Parcela única de R$ 500,00, com vencimento em 15/11/2026.

Exemplo ilustrativo da requisição:

POST /api/financeiro/contratos/89071/despesas/consumo-energia-eletrica
Content-Type: application/json

A integração deverá enviar o corpo JSON com os campos obrigatórios do endpoint, incluindo documento fiscal, dados de energia elétrica, valores tributários e parcelas.

Exemplo simplificado do retorno esperado:

{
  "duplicatasKey": [2430847],
  "mensagemQuitacao": null
}

Os identificadores apresentados são fictícios. O exemplo demonstra o resultado da operação, não um payload completo pronto para execução.

4. Resultado da operação

Após validar as informações enviadas, o ERP realizará o processamento da despesa, contemplando:

  • Geração da nota fiscal de energia elétrica.
  • Registro da escrita fiscal.
  • Geração da fatura e das duplicatas.
  • Contabilização conforme as contas configuradas.
  • Tratamento dos créditos tributários aplicáveis.

A integração receberá os identificadores das duplicatas geradas, permitindo acompanhar os lançamentos financeiros.

5. Liquidação imediata opcional

A API também permite realizar a liquidação imediata quando a despesa possuir uma única parcela em dinheiro, com data de quitação e conta de caixa válida.

Quando essa opção não for solicitada, as duplicatas serão geradas sem quitação automática.

Observações importantes

  • A funcionalidade aceita os modelos fiscais 06 e 66.
  • O modelo fiscal 55 permanece fora do escopo desta API.
  • A loja fiscal é determinada pelo contrato, enquanto a loja pagadora é informada pela integração.
  • Contratos configurados para rateio entre lojas não são aceitos pela nova operação.
  • A integração respeita as validações fiscais, tributárias e financeiras do contrato.
  • O processo manual de inclusão de despesas permanece disponível.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r373.90