Geração de Boleto do Tipo Ato no Sienge - Integrações e APIs

Este artigo descreve o fluxo completo para a geração de boleto do tipo Ato no Sienge, detalhando as configurações necessárias, pré-requisitos e o comportamento do sistema durante o processo.

Confira neste artigo:

• Habilitação da funcionalidade
• Configuração no Empreendimento
• Geração do boleto na ação no Workflow de Reservas
• Geração do boleto ao aprovar uma reserva
• Existência de parcela do tipo Ato na condição de pagamento
• Envio de Pessoa
• Envio da requisição ao Sienge
• Resumo do fluxo
• Observações importantes

Habilitação da funcionalidade

O primeiro passo é habilitar a geração do boleto do tipo Ato na base. Para isso, solicite ao Time Suporte via chat ou e-mail (atendimento@cvcrm.com.br).

Essa configuração é fundamental, pois sem ela o sistema não exibirá a opção de geração do boleto no fluxo de automação (workflow).

Configuração no Empreendimento

A geração do boleto pode ser feita de duas formas:

• Ao aprovar a Reserva
  Pode ser configurado no Empreendimento para que o Boleto seja gerado quando a Reserva for aprovada aqui no CV CRM. Esse ajuste é feito na aba Configurações do Empreendimento:

  
  

  
  
• Através de uma ação no Workflow de Reservas
  A geração de boleto também pode ser feita através da ação "Gerar boleto para parcela Ato" no Workflow de Reservas. Ou seja, o boleto só será gerado quando for feita a troca da situação.

Só deve ser escolhida uma das duas opções mencionadas acima.

Geração do boleto na ação no Workflow de Reservas

Quando a configuração é habilitada:

• Será disponibilizada no workflow a ação:
  “Gerar boleto para parcela Ato”

Essa ação é a responsável por:

• Disparar a requisição para o Sienge
• Solicitar a geração do boleto do tipo Ato, vinculada à reserva

Geração do boleto ao aprovar uma reserva

Também existe a possibilidade de gerar o boleto automaticamente quando a Reserva for aprovada.Caso a reserva ainda não tenha sido aprovada:

• A ação de gerar boleto não será executada
• Nenhuma integração com o Sienge ocorrerá

Esse controle garante que apenas reservas válidas e aprovadas tenham boletos financeiros gerados.

Existência de parcela do tipo Ato na condição de pagamento

Outro ponto essencial é a condição de pagamento da reserva:

• Deve existir ao menos uma parcela do tipo Ato

Comportamento do sistema:

• Se existir parcela Ato:
  O sistema executa a ação e envia a requisição ao Sienge para gerar o boleto.
• Se não existir parcela Ato:
  O fluxo segue normalmente, sem gerar boleto e sem travar o processo.

Ou seja, a ausência da parcela do tipo Ato não causa erro, apenas impede a geração do boleto específico.

Envio de Pessoa

Caso a geração do boleto seja anterior ao envio da proposta, deve ser utilizada a ação Enviar pessoas para sienge - Sienge. Essa ação será responsável por:

• Enviar o Cliente ao Sienge.
  Essa ação fará com que o Cliente seja cadastrado no Sienge para que fique vinculado ao boleto.
  

Envio da requisição ao Sienge

Com todos os requisitos atendidos:

1. Será executado a ação “Gerar boleto para parcela Ato”
2. O sistema envia a requisição ao Sienge
3. O boleto do tipo Ato é gerado conforme as regras financeiras configuradas no Sienge

Resumo do fluxo

Ordem correta do processo:

1. Solicitar a habilitação da configuração
2. Definir forma de geração
3. Configurações do Workflow/Empreendimento
4. Garantir parcela do tipo Ato na condição de pagamento
5. Executar a ação que envia a requisição ao Sienge

Observações importantes

• O fluxo não bloqueia a reserva caso não exista parcela Ato.
• Toda a comunicação financeira é centralizada no Sienge, após o disparo correto da ação.