Agora no Bluesoft ERP, é possível notificar automaticamente via webhook sempre que duplicatas do tipo 5 – Convênio Cliente/Empresa forem geradas durante a conciliação da Tesouraria Loja.

O objetivo desta novidade é otimizar e automatizar a gestão dos convênios de funcionários, garantindo a integração direta, aumentando a rastreabilidade e eliminando o acompanhamento manual.

Como Irá Funcionar?

1. Configuração do Webhook

Para habilitar a integração, acesse o menu: Administração > Integrações > Cadastro de Webhooks.

  1. Inclua ou edite um cadastro de webhook e selecione o tipo referente a Duplicata de convênio Cliente/Empresa
  2. Informe a URL de destino do Sistema.
  3. Preencha o campo E-mail para notificar em caso de erro (obrigatório).
  4. Opcionalmente, configure o Tipo de Autenticação (Header/API key) quando exigido.
  5. Defina o status como Ativo e salve.

Nota: A configuração do webhook é geral para este envio e não exige seleção ou separação por loja.

2. Conciliação na Tesouraria Loja

No menu Financeiro > Tesouraria Loja / Conciliação da Tesouraria:

  1. Ao realizar a conciliação dos movimentos de convênio, o ERP processa a operação e gera as duplicatas de cobrança do tipo 5 – Convênio Cliente/Empresa.
  2. Ao finalizar o processamento, o ERP envia automaticamente um payload JSON contendo a lista das chaves geradas (duplicataKeys) para a URL cadastrada no webhook: JSON{ "duplicataKeys": [17460] }
  3. O Sistema recebe a notificação e consome a API de Duplicatas do ERP (/financeiro/duplicatas) informando a duplicataKey para obter todos os detalhes da duplicata e operacionalizar o desconto em folha.

Observações Importantes!

  • Escopo Restrito: O webhook é disparado exclusivamente para duplicatas do tipo 5 – Convênio Cliente/Empresa. Não haverá disparos para outros tipos de duplicatas gerados na conciliação.
  • Estrutura de Payload: O payload contém estritamente o atributo duplicataKeys. Nenhum dado adicional da duplicata é enviado na notificação, mantendo o tráfego leve e seguro.
  • Tratamento de Falhas: Caso ocorra falha de comunicação, o evento ficará gravado na estrutura de webhooks para retentativas automáticas sem necessitar de reprocessamento na Tesouraria Loja. Excedido o limite de tentativas, uma mensagem será enviada ao e-mail cadastrado.

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 r371.09