Preparando a integração no Sienge - Integração CV e SIENGE

Confira neste artigo:

• Preparando a integração no Sienge

• Passo a passo da configuração da integração CV e Sienge

• Liberação de APIs

Para aprimorar o controle e monitorar o consumo de suas APIs por parceiros, integrações e empresas do grupo, a solicitação de conexão com o Sienge exigirá o preenchimento de um formulário específico.

A integração será ativada somente após o recebimento da confirmação por e-mail, enviada para o endereço informado no formulário.

Como preencher o formulário? 

• Link do formulário
• Informe seu e-mail: A confirmação da ativação da integração será enviada para esse endereço.
• Marque a opção CV: Para identificar que o canal correto é o CV.
• Preencha o seu endereço no Sienge:

Formato: cliente.sienge.com.br
Exemplo: https://curyempreendimentos.sienge.com.br/

Atenção! O preenchimento e envio neste momento é obrigatório. 

⚓Preparando a integração no Sienge

Após ter feito os cadastros necessários no Sienge (empreendimentos, unidades, corretores...), será necessário, fazer a ativação dos recursos de integração de cada API. Para isto, acesse o seu painel Sienge, clique no menu do canto superior esquerdo e em "Integrações". 

Acesse a opção "Usuários de API" > "Novo Usuário de API" e preencha os campos necessários. 

Obs.: o usuário preenchido no campo "Nome de acesso" deverá ser enviado ao seu implantador, juntamente com a senha, que será exibida assim que clicar no botão "Salvar".

Obs.: é importante que seja mantido apenas um usuário de API ativo.

Obs.: atente-se para o prazo de expiração, pois é ele que determina o período de tempo que este acesso à API funcionará. Você poderá configurar para expirar em uma data específica, em um determinado período, ou nunca expirar (indicado).

Após clicar em "Salvar", sua senha será mostrada na tela. Guarde essa senha para enviar ao seu implantador.

Obs.: esta senha só será exibida neste momento, após fechar a janela não será possível exibi-la de novo. Caso ainda tenha perdido a senha e ainda não tenha enviado ao seu implantador, será necessário gerar uma nova senha.

Após ter criado o usuário e senha da API, devemos autorizar os recursos que serão disponibilizados pela API, ou seja, quais recursos funcionarão na integração entre o CV e o Sienge

Para o correto funcionamento da integração com o CV, será necessário autorizar os seguintes recursos na API no Sienge:

• CLIENTES 
  Liberar todos os serviços
• CONTRATOS DE VENDAS (transacional e massivo) 
  Liberar todos os serviços
• GERAÇÃO DE BOLETO SEGUNDA VIA POR E-MAIL 
  GET /payment-slip-notification/
• MUNICÍPIOS 
  GET /cities
• UNIDADES 
  Liberar todos os serviços
  
• COMISSÕES DE VENDAS 
  Liberar todos os serviços
• ESTADOS CIVIS      
  /civis-status    
  
• TIPOS DE IMÓVEIS
  Liberar todos os serviços
• EMPRESAS
  Liberar todos os serviços
• CENTRO DE CUSTOS 
  Liberar todos os serviços
• PORTADORES PARA O CONTAS A RECEBER
  Liberar todos os serviços
• PLANOS FINANCEIROS
  Liberar todos os serviços
• EMPREENDIMENTOS 
  Liberar todos os serviços
• INDEXADORES 
  Liberar todos os serviços
• PROFISSÕES 
  Liberar todos os serviços
• GERENCIAMENTO DE WEBHOOK 
  Liberar todos os serviços
• CREDORES
  Liberar todos os serviços
• UNIDADES DE IMÓVEIS
  Liberar todos os serviços
• TIPOS DE CONDIÇÃO DE PAGAMENTO
  Liberar todos os serviços

Para que seu cliente possar gerar extrato no portal do cliente CV, é necessário liberar os seguintes recursos na API no Sienge:

• GERAR SALDO DEVEDOR DO CLIENTE
  Liberar todos os serviços
• GERAR EXTRATO
  Liberar todos os serviços
• TÍTULO DE CONTAS A RECEBER
  Liberar todos os serviços
• TÍTULO DE CONTAS A PAGAR
  Liberar todos os serviços
• SALDO DEVEDOR DO CLIENTE
  Liberar todos os serviços
• SALDO DEVEDOR TOTAL
  Liberar todos os serviços
• 2ª VIA DE BOLETO
  Liberar todos os serviços

Para ativar os recursos da API, siga o modelo abaixo. Neste modelo utilizaremos como exemplos a API Webhooks e Unidades de Imóveis.

⚓Liberação de APIs

Atenção!É necessário liberar todos os tipos de Get, Post e Put para o uso das APIs.

• API Portadores para as contas a receber: necessário para baixar os portadores que são necessários na condição de pagamento para envio do Contrato;

• API Tipos de condição de pagamento: necessário para baixar as séries que são as condições de pagamento;

• API Tipo de imóveis: necessário para vincular o tipo de imóvel que é o tipo da unidade no CV, serve para trazer as unidades corretas do CV;

• API Contratos de vendas: necessário para enviar as reservas e baixar as reservas do Sienge, todos as opções precisam está liberada;

• API Comissões de vendas: necessário caso deseje enviar comissão para o Sienge;

• API Credores: necessário para enviar o corretor para o Sienge;

• API Estados civis: necessário para vincular os estados civis dos clientes com Sienge;

• API Empresas: necessário para vincular a empresa ao Empreendimento;

• API Indexadores: necessário para trazer e enviar o indexador para o Sienge;

• API Municípios: necessário para vincular o Município no Cliente no CV e no Sienge;

• API Planos financeiros: necessário para vincular o plano financeiro no Contrato para enviar a reserva para o Sienge;

• API Profissões: necessário para vincular a profissão no Cliente para enviar a reserva para o Sienge;

• API Extrato cliente histórico: necessário para visualizar os extratos disponíveis do cliente no portal do cliente;

• API Empreendimentos (Obras): necessário para trazer os empreendimentos do Sienge para o CV;

• API Geração de boleto (Segunda via): necessário para trazer os boletos gerados do Sienge para o CV;

• API Saldo devedor presente do cliente (Total): necessário para trazer os valores do saldo para exibir no painel do cliente;

• API Informe de rendimentos - Imposto de renda: necessário para trazer os impostos de renda para o painel do cliente;

• API Unidades de imóveis: necessário para trazer os dados das unidades, sua disponibilidade e tipos de unidade;

• API Cliente: necessário para trazer os clientes para o CV e enviar para o Sienge;

• API Gerenciamento de Webhooks: necessário para gerenciar os Webhooks de situação de reserva e do cliente.
  
  
• API Centro de Custos: necessário para buscar buscar os centro de custos no Sienge.

⚓Passo a passo da configuração da integração CV e Sienge

1. Introdução: Integração CV e Sienge
2. Preparando a integração no Sienge✅
3. Configuração de Webhooks
4. Sincronias iniciais
5. Sincronia de empreendimentos
6. Sincronia de unidades e vendas
7. Envio da reserva/contrato
8. Envio de corretores, clientes e associados
9. Envio das comissões

Acompanhe o webinar e veja todos os benefícios da integração CV CRM + Sienge: