CV + UAU
A integração do sistema de Controle de Vendas (CV) com o ERP UAU é um processo contínuo e eficiente, realizado por meio de APIs. Este processo inicia-se no ERP UAU, onde é configurado o acesso à API.
O construtor de vendas está habilitado para realizar essa integração de duas formas: envio de propostas e envio de vendas. No envio de propostas, as alterações podem ser realizadas dentro do ERP UAU, permitindo uma posterior conversão em venda. No caso do envio de vendas, o contrato é enviado já na condição de vendido, sem possibilidade de alterações nos valores e dados correlatos.
A escolha entre esses formatos depende das regras de negócios do cliente e da disponibilidade do módulo CRM no ambiente do ERP UAU, necessário para a recepção de propostas. Se você não possuir o módulo CRM, somente o envio direto da venda é possível.
O processo de integração realizado no ambiente do CV é realizado em conjunto com o nosso time, porém, precisamos que você nos envie suas credenciais da API da UAU (Usuário, Senha, URL e Token), além dos dados dos empreendimentos, imobiliárias e demais dados que serão tratados neste artigo.
Para tal, disponibilizamos um modelo de preenchimento desses códigos, clique aqui para baixá-lo. Após baixar e preencher os códigos e credenciais da API da UAU, nos envie o arquivo preenchido para que possamos dar andamento ao processo de integração no ambiente do CV.
Dispomos de um artigo que o ajudará a identificar e corrigir os os erros de integração, clique aqui para acessá-lo.
Obs.: é importantíssimo que ao nos fazer a solicitação de integração, nos informe qual dos módulos do UAU será integrado, UAU Vendas ou UAU CRM, pois só é possível se integrar a um deles.
Para conferir todas as APIs públicas do CV, consulte a nossa documentação em https://desenvolvedor.cvcrm.com.br
Clique aqui para conferir a Base de Conhecimento da UAU.Confira neste artigo:
- Quais dados são integrados?
- Inserindo as credenciais
- Permissões no CV
- Preenchendo os dados básicos
- Sincronizando as unidades
- Sincronizando as vendas
- Sincronizando corretores
- Inserindo as siglas das séries de tabela de preço
- Sincronizando Tipos de Cobrança
- Modelo de Vendas
- Preenchendo as datas de contrato
- Configurando o modelo de disparo ao ERP UAU
- Enviando as pessoas
- Enviando Proposta
- Enviando Venda
- Enviando de Comissão
Quais dados são integrados?
- Envio de Propostas
- Clientes
- Corretores
- Comissão
- Boleto Ato
- Portal do Cliente
- Segunda via de Boleto
- Extrato
- IR (Imposto de Renda)
Webhook:
- Distrato
- Cessão
Habilitando a integração
O processo de integração começa com a solicitação, registrada em um ticket através do e-mail suporte@cvcrm.com.br, expressando o desejo de integrar o sistema com o ERP UAU. A equipe do CV, então, procede com a ativação e a inserção das credenciais necessárias para a integração.
Inserindo as credenciais
Para utilizar a integração entre o ERP UAU e o CV CRM, o cliente deve designar o Construtor de Vendas como o desenvolvedor responsável pela integração. Para isso, é necessário fornecer os seguintes dados:
- Nome: Construtor de Vendas
- CNPJ: 11.224.696/0001-56
- Site: http://www.cvcrm.com.br
- Login: Manzano
Com os pontos mencionados acima concluídos, os dados abaixo poderão ser inseridos no CV.
- URL da API
- Usuário da API
- Senha da API
- Token
Obs.: o usuário passado acima deverá ter permissão de acesso à API do UAU.
O CV também é compatível com a autenticação em servidores utilizando o Active Directory (AD) do sistema operacional Windows. Para esse tipo de acesso, o usuário deve fornecer seu login após indicar que utiliza a autenticação via AD.
Permissões CV
Algumas permissões serão habilitadas juntamente com a liberação da integração, servindo como premissas para a futura configuração do CV.
Antes de realizar qualquer configuração no CV, é essencial solicitar a integração à nossa equipe e verificar se o seu perfil de usuário possui as permissões necessárias. As seguintes permissões são exigidas para que você possa configurar o sistema:
Obs.: as permissões relacionadas ao UAU só aparecerão depois que o nosso time liberar a integração.
Preenchendo os dados básico
Para que o CV possa importar os dados corretamente, é necessário preencher três campos: código da empresa, código do empreendimento e produto.
- Código da Empresa: este campo deve ser preenchido no cadastro da empresa (SPE) associada ao empreendimento;
- Código do Empreendimento: este código deve ser preenchido ao finalizar o cadastro do empreendimento no CV;
- Produto: o produto deve ser cadastrado dentro das configurações do empreendimento.
É crucial seguir essa ordem de cadastro, pois o empreendimento só aparecerá nas integrações se o código interno estiver preenchido.
Você pode utilizar o link abaixo para cadastrar um produto no ERP UAU: [clique aqui].
Sincronizando as unidades
A integração do CV foi projetada para automatizar o cadastro das unidades, eliminando a necessidade de inserir etapas e blocos manualmente. Para realizar essa ação, é necessário configurar o formato do bloco em "Configurações" > "Integrações" > "UAU". Todas as unidades serão então inseridas de acordo com essa configuração. O campo inclui um breve resumo explicando como definir o padrão do nome dos blocos.
As unidades serão registradas com as informações correlatas ao CV. No entanto, é possível adicionar detalhes adicionais utilizando a função de importação de unidades por meio de planilhas.
Após a sincronização, as unidades terão seus códigos internos preenchidos. É importante destacar que as unidades serão criadas, não atualizadas.
Sincronizando as vendas
A atualização do espelho de vendas é realizada por meio da sincronização de vendas, exigindo que os campos de imobiliária padrão e corretor padrão sejam preenchidos antecipadamente. É essencial definir o período das vendas para especificar o intervalo de tempo desejado. No entanto, é importante inserir essas datas com cuidado, já que períodos muito longos podem resultar em atrasos na resposta da integração.
Este processo deve ser executado somente após a conclusão de todas as etapas de parametrização. O espelhamento ocorre por empreendimento, e pode ser realizado selecionando a opção de sincronizar vendas no menu de integrações do UAU.
Sincronizando corretores
Os corretores desempenham um papel fundamental no CV, sendo eles pessoas físicas ou jurídicas, e podem ser integrados ao sistema por meio da sincronização com o ERP UAU.
Essa ação é realizada utilizando a funcionalidade "Sincronizar Corretores", localizada na seção de integrações do UAU dentro das configurações do sistema. Ao realizar essa integração, todas as pessoas com a categoria "Corretores" definida no ERP UAU serão retornadas e incorporadas ao CV.
Na base de conhecimento da UAU, você pode ajustar as pessoas às categorias corretas no seguinte link: Cadastro de Pessoas - Clientes e Fornecedores.
Caso um corretor seja novo e a integração já esteja operacional, o CV também incluirá automaticamente novos corretores na UAU. Isso é feito por meio de uma ação dentro do Workflow de Reservas, que envia os corretores diretamente para a UAU.
Inserindo as siglas das séries de tabela de preço
As séries de tabelas de preço no CV estão vinculadas aos tipos de parcelas na UAU por meio de suas siglas correspondentes. É importante ressaltar que as parcelas na UAU precisam estar associadas aos modelos de vendas que serão mencionados a seguir.
Sincronizando Tipos de Cobrança
No ERP UAU, existem modelos de cobrança que estão diretamente ligados ao sistema financeiro de contas a receber e contas a pagar. O CV está configurado para recuperar todos os tipos de cobrança cadastrados no UAU, específicos para cada empreendimento.
Para capturar esses dados, basta acessar o menu "Configurações" > "Integrações" > "UAU", selecionar o empreendimento desejado e, em seguida, clicar em "Sincronizar Tipos de Cobrança".
Modelos de Vendas
Para obter os modelos de vendas, o CV disponibiliza a sincronização por meio do menu de integrações do UAU.
Para informações detalhadas sobre como criar, configurar e manter o modelo de vendas, consulte a base de conhecimento do ERP UAU neste link: Modelos de Venda - Globaltec Ajuda.
Além disso, é importante ressaltar que o modelo de venda pode ser alterado dentro da reserva no CV, caso o gestor opte por uma condição de pagamento diferente.
Preenchendo as datas de contrato
Para quem tem o módulo CRM no ERP UAU e cujo disparo do CV ocorre por meio do envio de propostas, é essencial preencher as datas de contrato. Essas datas são cruciais para que o ERP possa calcular corretamente os prazos de recebimento no módulo financeiro - contas a receber.
Para garantir o cumprimento dessa exigência, o CV oferece uma configuração padronizada por empreendimento no menu de "Configurações" > "Integrações" > "UAU". No entanto, esses campos podem ser editados dentro da reserva, permitindo personalização de acordo com as necessidades específicas de cada proposta, especialmente se houver alteração no fluxo de pagamento.
Na reserva:
Configurando o modelo de disparo ao ERP UAU
O CV oferece dois modelos de envio de reservas para o ERP UAU: proposta e venda direta. Por padrão, o modelo de venda direta está habilitado. No entanto, para quem tem o módulo CRM ativado no ERP UAU e deseja que o envio seja realizado como proposta, é necessário habilitar a configuração de envio de reserva como proposta. Este ajuste deve ser solicitado através de um ticket para o time de suporte CV: suporte@cvcrm.com.br.
Além disso, o CV também oferece a opção de enviar a proposta como ativa. Por padrão, o envio das propostas segue a situação "confirmada", indicando que todos os dados foram definidos e aprovados comercialmente no CV. No entanto, as propostas que forem enviadas apenas como "ativas" não podem ser automaticamente convertidas em vendas de acordo com as regras do ERP UAU. Portanto, é necessário que um usuário confirme manualmente essas propostas no ERP UAU.
Enviando as pessoas
O CV permite o envio de clientes e associados para o ERP UAU. No CV, essas pessoas são consideradas únicas, com a obrigatoriedade de possuir um documento.
É importante ressaltar que o CV não envia pessoas estrangeiras para o ERP UAU, pois este não suporta contratos para estrangeiros.
O processo de envio de pessoas pelo CV varia de acordo com a seleção de envio de reservas, seja por proposta ou venda direta. Se o cliente optar por enviar uma proposta, o CV enviará os clientes como prospects e, após receber retorno na integração, preencherá o campo de código interno com o código correspondente.
Para os envios de vendas diretas, o CV utiliza a rota de envio de pessoas do ERP UAU, seguindo o mesmo processo de gravação do código retornado no campo de código interno.
Quando uma proposta é transformada em venda no CV, o sistema irá transformar o prospect em uma pessoa via integração, atualizando assim o novo código interno do cliente no CV. No ERP UAU, esse cliente terá dois códigos distintos, um para prospect e outro para cliente, porém esses códigos estarão relacionados.
Enviando Proposta
Para enviar a reserva, caso você possua o módulo CRM no ERP UAU e tenha optado pelo envio em formato de proposta, é necessário incluir a ação de envio da pessoa no Workflow de Reservas. Essa configuração deve ser feita durante a mudança de situação que precede a automação do processo de faturamento.
O envio da proposta ocorre quando a situação da reserva é alterada para a flag "Pode Faturar". Essa mudança de situação deve ocorrer após a aprovação comercial da reserva no CV.
Após o envio bem-sucedido, o CV preenche automaticamente o campo de código interno da reserva. Este dado é essencial para os processos de pós-vendas no painel do cliente posteriormente.
Para proporcionar conforto e controle, o CV oferece uma flag no Workflor de Reservas que automatiza a progressão da reserva para uma nova situação, juntamente com o preenchimento do campo de código interno. A flag "Devolução do ERP" possui a inteligência de receber o retorno do ERP UAU com o código da proposta, modificando assim a reserva para a situação pré-estabelecida com a flag "Devolução do ERP".
Enviando Venda
O envio da reserva do CV para o ERP UAU no formato de venda direta acontece quando a reserva é alterada para a situação configurada com a flag "Pode Faturar".
Neste mesmo processo, o CV envia os clientes, associados e a venda. No entanto, o envio do corretor só ocorre se essa ação estiver configurada no Workflow de Reservas.
Após o envio bem-sucedido, o CV preencherá automaticamente o campo de código interno da reserva, o número da venda e moverá a reserva para a situação "Vendida".
O cliente tem a opção de usar a flag do Workflow de reserva chamada "Faturada", se desejar executar alguma ação dentro da reserva antes de colocá-la na situação "Vendida". Vale ressaltar que a situação "Vendida" só pode ser movida para a situação "Distrato".
Enviando Comissão
O comissionamento pode ser enviado tanto no cenário de proposta quanto de venda direta.
Se você deseja enviar comissões para o ERP UAU devem especificar um modelo de comissão padrão em "Configurações" > "Integrações" > "UAU", dentro do empreendimento. Esse modelo padrão estará disponível também na reserva, caso seja desejado optar por um modelo diferente.
Na reserva:
O CV é capaz de acessar toda a estrutura de comissão do ERP UAU, desde que a opção correspondente denominada "Usar estrutura de comissão da UAU" esteja ativada na configuração. Para ativar/desativar essa opção, é necessário abrir um ticket para o time de suporte CV: suporte@cvcrm.com.br.
Quando esta opção está habilitada, o ignorará as regras de comissão aplicadas ao empreendimento e adotará as regras do ERP UAU, utilizando o valor do contrato da reserva.
O modelo de comissão e estrutura no ERP UAU abrange pagamentos diretos, onde o valor da comissão é deduzido diretamente do contrato, e pagamentos indiretos, onde o valor não é subtraído do subtotal do contrato no CV. O CV também contempla os cenários direto e indireto, ajustando cada linha da regra de comissão de acordo com o modelo.
Para que essa funcionalidade funcione perfeitamente, é essencial que a equipe de corretagem tenha um código interno. Caso as pessoas beneficiárias não estejam cadastradas no CV, o sistema as cadastrará automaticamente como personas. A associação dessas personas no CV requer uma configuração adequada de acordo com suas funções no ERP UAU. Esse cadastro é realizado na funcionalidade de cargos da estrutura de comissão no ERP UAU, disponível em "Configurações" > "Integrações" > "UAU".
É necessário vincular todos os cargos aos tipos de beneficiários no CV. Se um cargo estiver com uma nomenclatura diferente, o CV não cadastrará a regra na reserva.
É importante destacar que esta ação não cadastra comissões no CV, apenas envia a comissão para o ERP UAU.
Pós-vendas – Portal do Cliente
O CV oferece aos clientes que possuem o serviço de pós-vendas contratado a conveniência de permitir que os clientes finais da incorporadora tenham autonomia para acessar seus boletos, consultar seu extrato financeiro e obter seu demonstrativo de imposto de renda.
Para habilitar essa funcionalidade, é necessário utilizar uma extensão que se integra ao ERP UAU. Ao acessar a gestão de extensões, o nome da extensão é flexível, mas é obrigatório que o link contenha "/plugins/uau/" e que esteja marcado como visível para o cliente com a opção "Sim".
A ordenação desta extensão pode ser ajustada de acordo com as suas preferências, através da tela "Configuração do Portal do Cliente" > "Configurar Exibição Menu".
No Portal do Cliente, os boletos são separados do extrato e do demonstrativo de IR, apresentando-os de forma individualizada para facilitar a navegação e acesso do usuário.
Por padrão, os boletos com data inferior à data atual não são exibidos. Contudo, se desejar, é possível solicitar ao time de suporte CV, através do e-mail suporte@cvcrm.com.br, que habilite a configuração para que os clientes visualizem os boletos vencidos.
BOAS VENDAS!
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo