Adicionamos o novo parâmetro “empreendimentos da conversão” no CVDW-API de conversões do lead e também no relatório de conversões.

O que essa coluna/parâmetro registra?
Salva os empreendimentos que forem enviados na requisição que está convertendo o lead.
Esse dado passa a ser um registro fixo, ou seja, mesmo que o lead troque de empreendimento depois, a informação não será alterada, mantendo o histórico fiel do momento em que a conversão ocorreu.

A partir de quando começa a registrar?
A coluna começará a ser preenchida somente após a data de disponibilização dessa melhoria, porque esses dados não existem armazenados anteriormente.
Ou seja, o sistema passará a salvar as informações daqui em diante.

Implementamos um novo controle para o uso das APIs públicas de comissão, destinado a clientes que integram com pagadorias não-nativas.
A partir de agora, o acesso a essas APIs será liberado apenas mediante acordo comercial, e a habilitação será feita pelo time do CV CRM.

Regras importantes:

• Só retornaremos a regra de comissão no endpoint de reserva, se tiver o Módulo comissão contratado + API.
• A API de comissões só será liberada com base em contratação paralela, mesmo com módulo de comissões habilitado.
• Para os antigos clientes que já tem comissão contratado, não se altera o formato de hoje.

Foi adicionado um novo campo na API /cvdw/leads/corretores
https://desenvolvedor.cvcrm.com.br/reference/leadscorretores

Novo campo:
data_associacao_corretor

Como funciona:
Sempre que um corretor for adicionado como responsável pelo lead, o sistema registrará automaticamente a data em que essa associação foi realizada.

Disponibilizamos um novo CVDW-API que permite consultar o histórico de possibilidade de venda do lead.

Ela retorna todas as alterações de possibilidade de venda feitas no lead, como:

• O usuário responsável por cada alteração
• O período em que cada possibilidade ficou ativa
• A situação do lead no momento em que cada possibilidade estava vigente

📘 Documentação completa:
https://desenvolvedor.cvcrm.com.br/reference/leadspossibilidade

Foi realizada uma atualização no comportamento do campo data_referencia do CVDW-API de tarefas do lead.

Antes:
O campo considerava sempre a data de cadastro da tarefa ou da visita.

Agora:
O campo passará a considerar a data da última alteração da tarefa e da visita.

Essa melhoria visa aumentar a precisão e a qualidade dos dados filtrados, refletindo de forma mais fiel a atualização real das interações com o lead.

💻 Para mais informações sobre as APIs do CV CRM, clique aqui.

Foram realizadas melhorias nas APIs de Atendimentos e Assistências para aprimorar a integração e o relacionamento entre os registros.

• API de Atendimentos
  Endpoint:
  https://{dominiodocliente}.cvcrm.com.br/api/v1/relacionamento/atendimentos/listar
  Agora exibe o campo idAssistencia, permitindo identificar a assistência vinculada ao atendimento.

• API de Assistências
  Endpoint:
  https://{dominiodocliente}.cvcrm.com.br/api/v1/relacionamento/assistencias/{idAssistencia}
  Agora exibe o campo idAtendimento, indicando o atendimento relacionado à assistência.

Foi adicionada uma melhoria no CVDW-API de Leads: agora o retorno inclui o campo submotivo_cancelamento, que traz o submotivo de cancelamento sempre que este estiver configurado dentro de um motivo de cancelamento.

Essa atualização garante mais detalhamento nas análises e integrações, permitindo compreender com maior precisão os motivos de cancelamento dos leads.

Foi adicionada uma nova funcionalidade para facilitar a análise dos leads: agora é possível filtrar pela data da última conversão nos seguintes relatórios:

• Relatório de Perfil de Leads
  

• Relatório de Interações dos Leads

Essa melhoria oferece mais precisão nas consultas e segmentações, ajudando a identificar leads convertidos dentro de períodos específicos.

No endpoint /simulacoes da API CVDW, foram adicionados os IDs dos seguintes elementos:

• Empreendimento
• Bloco
• Etapa
• Unidade
• Espaço Complementar

Essa melhoria amplia o nível de detalhamento retornado pela API, facilitando integrações e análises mais precisas dos dados de simulação.

Exemplo:

{

  "pagina": 1,

  "registros": 30,

  "total_de_registros": 1054,

  "total_de_paginas": 36,

  "dados": [

    {

      "referencia": "193 ou 193_30",

      "referencia_data": "2023-01-15 15:26:15",

      "ativo": "S",

      "idsimulacao": 12414,

      "data_cad": "2021-01-01 00:00:00",

      "data_vencimento": "2021-01-01 00:00:00",

      "data_email_venc_corretor": "2021-01-01 00:00:00",

      "situacao_simulacao": "Vendida",

      "idsituacao": 3,

      "idusuario": 1,

      "idusuario_imobiliaria": 589,

      "idreserva": 123,

      "idcorretor": 14,

      "corretor": "Corretor CV",

      "idimobiliaria": 14,

      "imobiliaria": "Imob CV",

      "lead": "Lead CV",

      "idempreendimento": 123,

      "empreendimento": "Empreendimento CV",

      "idetapa": 1,

      "etapa": "Etapa CV",

      "idbloco": 1,

      "bloco": "Bloco CV",

      "idunidade": 1222,

      "unidade": "Unidade CV",

      "idtabela": 30491,

      "data_alteracao_situacao": "2022-11-17 12:24:30",

      "quantidade_mensagens": 1,

      "solicitacao_aprovacao": "Não",

      "condicao_aprovada": "Sim",

      "data_primeira_aprovacao": "2022-11-17 12:24:30",

      "previsao_entrega": "2022-11-17 12:24:30",

      "data_entrega": "2024-08-01",

      "data_base_calculo_juros": "2024-08-01",

      "descricao_motivo_reprovacao": "",

      "idmotivo_cancelamento": 1,

      "descricao_motivo_cancelamento": "",

      "juros_vpl": 0.5,

      "juros_vpl_apos_entrega": 0.5,

      "juros_futuro": 0.5,

      "juros_vpl_fixa_adicional": 0,

      "renda_familiar": 7900,

      "sla_vencimento": "2024-08-01",

      "data_condicao_aprovada": "2024-08-01",

      "idusuario_condicao_aprovada": 12,

      "idtabela_condicao_aprovada": 13,

      "juros_condicao_aprovada": 0,

      "juros_apos_entrega_condicao_aprovada": 0,

      "aprovacao_vpl_valor": 0,

      "aprovacao_vpl": 0,

      "aprovacao_absoluto": 0,

      "aprovacao_absoluto_percentual": 0,

      "aprovacao_margem": 0,

      "desconto": 0,

      "idalcada": 1,

      "percentual_custa_escrituracao": 0,

      "juros": "Não",

      "juros_embutido": "Não",

      "quantidade_parcelas_min": 1,

      "quantidade_parcelas_max": 2,

      "data_base_juros_futuro_cadastro": "2022-06-20",

      "data_base_calculo_pv": "2022-06-20",

      "data_base_calculo_pv_alterada": "Não",

      "data_contrato_aprovacao_comercial": "2022-06-20",

      "usuario_preencheu_data_contrato": "Não",

      "porcentagem_total_comissao": 0,

      "pagamento_total_comissao": "VGV",

      "porcentagem_total_premiacao": 100,

      "pagamento_total_premiacao": "VGV",

      "adimplencia_premiada": 2300,

      "ignorar_validacao_adimplencia_premiada": "Não",

      "calculo_juros_price_baseado_em": "DB",

      "porcentagem_total_contrato": 10,

      "pagamento_total_contrato": "VGV",

      "porcentagem_total_fora_contrato": 20,

      "pagamento_total_fora_contrato": "VGV",

      "idtipovenda": 1,

      "data_modificacao": "2024-02-14 16:41:57",

      "simulacaov2": "S",

      "idprecadastro": 123,

      "idlead": 244,

      "valor_contrato": 130995.95,

      "valor_presente": 101834.95,

      "condicoes_pagamento": [

        {

          "referencia": 2288,

          "idsimulacoescondicoes": 2288,

          "nome": "Ato",

          "idserie": 123,

          "qtd_parcelas": 1,

          "valor": 15000,

          "valor_com_juros": 17000,

          "vencimento": "2022-11-30",

          "idportador": 1,

          "idindexador": 1,

          "data_base_juros_futuro": "2023-01-01",

          "juros_futuro": 1.00005

        }

      ],

      "espaco_complementar": [

        {

          "idespaco": 1223

        }

      ]

    }

  ]

}

Foi disponibilizada uma nova API responsável por anexar documentos ao(s) pagamento(s) da comissão.

Método: POST
Endpoint: /v3/financeiro/comissoes/{idComissao}/documentos/{idPagamento}

Body:

Response 200: