Integração via APIs – Módulo Comercial
O Boleto Ato é utilizado para reservar uma unidade junto à incorporadora ou loteadora antes da geração do contrato ou da aprovação de crédito do cliente.
No Sienge, essa geração pode ocorrer de duas formas:
Via contrato
Via reserva
Este artigo explica as configurações necessárias e o funcionamento de cada modalidade na integração com o Sienge.
Pré-requisito
Para utilizar a integração de Boleto Ato, é necessário que o cliente possua:
Construtor de Vendas (CV) contratado
Sienge + APIs
Módulo Comercial – Vendas
Módulo Financeiro – Contas a Receber
Connector de Recebimentos Instantâneos ou VAN Bancária configurado
Sem esses itens, a geração do boleto não ocorre corretamente.
Passo a passo
- Modalidades de uso
O Registro de Reserva com Boleto Ato pode ser utilizado de duas formas:
| Modalidade | Quando usar |
|---|---|
| Via Contrato | Quando o boleto é gerado diretamente no envio do contrato |
| Via Reserva | Quando o boleto é gerado na reserva da unidade, antes do contrato |
- Configurações necessárias
Parâmetro 49
Localização: Segurança > Administração > Parâmetros
Esse parâmetro define qual o tipo de condição no SIENGE referente ao ATO, habilitando o uso do Boleto Ato na integração.
Ele deve estar presente apenas uma vez no JSON enviado ao Sienge, independentemente da modalidade (via contrato ou via reserva).
Connector de Integração Bancária
É necessário que o connector de integração bancária esteja configurado para permitir a geração e liquidação dos boletos.
Configuração de Documento ( Atenção! apenas para boleto via reserva)
Para a geração do boleto via reserva, é necessário:
Criar um documento em:
Apoio > DocumentosDefinir o documento como Adiantamento
Em Contas a Receber, marcar a opção:
“As baixas realizadas pela leitura do arquivo de retorno serão do tipo ‘Adiantamento’”
Configuração do Registro de Reserva
Localização: Apoio > Obras/Centros de Custo > Cadastros > Aba Vendas > Registro de Reserva
Via contrato:
Preencher apenas:Conta corrente
Condição de recebimento
Tipo de registro
Via reserva:
A figura abaixo apresenta a localização desses campos.
Todos os campos da sessão devem estar preenchidos.
Funcionamento
Boleto Ato via Contrato
O Registro de Reserva Boleto Ato via contrato tem o seguinte fluxo de integração exclusiva com o Construtor de Vendas (CV).
Boleto Ato via Reserva
O Registro de Reserva Boleto Ato via reserva tem o seguinte fluxo de integração subdividido em 2 fluxos: o envio da reserva e depois o envio do contrato.
a) Envio da reserva
É necessário enviar um POST de reserva da unidade, informando:
Valor do boleto
Data de vencimento
Essas informações devem seguir a documentação da API.
Na sequência o seguinte fluxo será iniciado:
b) Envio automático do contrato (integração exclusiva Construtor de Vendas – CV)
A realização do pagamento por parte do cliente será recebida pelo Sienge como uma baixa por adiantamento e o CV conseguirá verificar o pagamento desse boleto e enviar o contrato com a configuração de reserva vinculado seguindo a segunda parte do fluxo.
Atenção! Regras importantes
O valor do título avulso da reserva deve ser o mesmo valor da condição Ato do contrato, com apenas uma parcela.
O título avulso:
É gerado com o documento e plano financeiro configurados no Registro de Reserva
Utiliza o indexador REAL
Não sofre correção monetária nem aplicação de juros ou mora
Esperamos que este artigo tenha ajudado!