Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Expandir
titleAPI de Validação de VPL
TítuloAPI de Validação de VPL
Endpointhttp://localhost:8051/api/imb/v1/Sales/{Cod Coligada}_{Número da Venda}/VPL
VerboGet

Parameters

no parameters
Descrição 

API que retornar o cálculo da análise da proposta do cliente comparando com a proposta padrão, entre os indicadores a VPL.

Baixe aqui a planilha excel com o cálculo

Para o  cálculo da VPL os campos da modalidade da proposta do TCGI → Portal do Imóveis

Ao validar a VPL  os campos da tabela  de venda e regras serão espelhados nas tabelas antigas do PI (XPIPROPOSTA, XPIPESSOA_PROPOSTA, XPIPROPOSTACOMPOSICAOHIST)

para manter o funcionamento dos relatórios e telas antigas

Modalidade

da Venda TCGI

image.pngImage Added

Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
No Body
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "codcoligada": 20,
    "numvenda": 1914,
    "valortabelaprecopadrao": "R$ 148.800,00",
    "valortabelaprecoproposta": "R$ 148.800,00",
    "valorfinanciadoatulizadopadrao": "R$ 263.867,02",
    "valorfinanciadoatulizadoproposta": "R$ 259.486,41",
    "valorpadraovpl": "R$ 187.885,42",
    "valorpropostavpl": "R$ 184.919,64",
    "percentualtma": "0,500000%",
    "percentualperdavplproposta": "158,000000%",
    "vrTabelaPrecoPadrao": 148800.0,
    "vrTabelaPrecoProposta": 148800.0,
    "vrFinanciadoAtulizadoPadrao": 263867.02,
    "vrFinanciadoAtulizadoProposta": 259486.41,
    "vrPadraoVpl": 187885.42,
    "vrPropostaVpl": 184919.64,
    "vrPercentualTma": 0.005,
    "vrPercentualPerdaVPLProposta": 1.58,
    "mensagem": "Proposta Reprovada",
    "log": "A taxa de perda do VPL da proposta 1,58% é superior ao máximo da(o) Modalidade 1,00%; ",
    "aprovada": false,
    "itensvpl": [
        {
            "nomeparametro": "Prazo de Financiamento",
            "valortabela": "160",
            "valorproposta": "160",
            "parametrodeaprovacao": " - "
        },
        {
            "nomeparametro": "% Captação a Vista",
            "valortabela": "10,00%",
            "valorproposta": "10,00%",
            "parametrodeaprovacao": "%Mín 1,00% - %Máx 50,00%"
        },
        {
            "nomeparametro": "% Captação até Entrega",
            "valortabela": "0,00%",
            "valorproposta": "0,00%",
            "parametrodeaprovacao": " - "
        },
        {
            "nomeparametro": "Nro Máx Meses Após Entrega",
            "valortabela": "285",
            "valorproposta": "285",
            "parametrodeaprovacao": " - "
        },
        {
            "nomeparametro": "% Captação até 1 mês Antes Entrega",
            "valortabela": "0,00%",
            "valorproposta": "0,00%",
            "parametrodeaprovacao": " - "
        },
        {
            "nomeparametro": "% Captação até Metade da proposta em relação a Entrega da Subunidade",
            "valortabela": "0,00%",
            "valorproposta": "0,00%",
            "parametrodeaprovacao": " - "
        },
        {
            "nomeparametro": "Valor m2",
            "valortabela": "R$ 586,37",
            "valorproposta": "R$ 576,64",
            "parametrodeaprovacao": " - "
        },
        {
            "nomeparametro": "Valor m2 VPL",
            "valortabela": "R$ 417,52",
            "valorproposta": "R$ 410,93",
            "parametrodeaprovacao": " - "
        },
        {
            "nomeparametro": "% Arrecadação",
            "valortabela": "77,33%",
            "valorproposta": "74,39%",
            "parametrodeaprovacao": "%Mín 50,00% - %Máx 100,00%"
        },
        {
            "nomeparametro": "% Desconto",
            "valortabela": "0,00%",
            "valorproposta": "1,66%",
            "parametrodeaprovacao": "%Máx 10,00%"
        },
        {
            "nomeparametro": "% Diferenca de Perda do VPL Modalidade",
            "valortabela": "0,00%",
            "valorproposta": "1,58%",
            "parametrodeaprovacao": "%Máx 1,00%"
        }
    ],
    "parcelaspadrao": [
        {
            "datavencimento": "2022-02-01T00:00:00",
            "valorparcela": 3720.0,
            "valorpresente": 3720.0
        },
        {
            "datavencimento": "2022-03-01T00:00:00",
            "valorparcela": 3720.0,
            "valorpresente": 3701.49
        }       
    ],
    "parcelasproposta": [
        {
            "datavencimento": "2022-02-01T00:00:00",
            "valorparcela": 3720.0,
            "valorpresente": 3720.0
        },
        {
            "datavencimento": "2022-03-01T00:00:00",
            "valorparcela": 3720.0,
            "valorpresente": 3701.49
        }    ]
}

Expandir
titleParâmetros do Response

Parâmetros:

  • codcoligada: coligada do empreendimento;
  • numvenda : Número da venda;
  • valortabelaprecopadrao:  Valor da Tabela de Preço Padrão da modalidade padrão
  • valortabelaprecoproposta: Valor da Tabela de Preço Padrão da modalidade padrão
  • valorfinanciadoatulizadopadrao: Valor sumarizado dos componentes de Entrada e Principal da modalidade padrão
  • valorfinanciadoatulizadoproposta: Valor sumarizado dos componentes de Entrada e Principal da modalidade proposta
  • valorpadraovpl: Valor sumarizado das parcelas da modalidade padrão - Inclui todos os valores de todos os componentes
  • valorpropostavpl: Valor sumarizado das parcelas da modalidade proposta- Inclui todos os valores de todos os componentes
  • percentualtma: Percentual da TMA - Taxa mínima de atratividade. A TMA é basicamente uma taxa de desconto que representa o retorno mínimo que o investidor deseja obter.
  • aprovada:  O VPL foi aprovado, true ou false
  • mensagem: Proposta AProvada ou Reprovada
  • log: Detalhe da mensagem quando for reprovada
  • itensvpl: 
    • nomeparametro: Prazo de Financiamento;
    • valortabela: Nro de Meses do componente principal;
    • valorproposta:  Nro de Meses do componente principal;
    • parametrodeaprovacao: Não valida para esse tipo de parâmetro;

    • nomeparametro: % Captação a Vista;
    • valortabela: Percentual do componente de entrada;
    • valorproposta:  Percentual do componente de entrada;
    • parametrodeaprovacao: Pode validar entre %mínimo  e %máximo, se configurado com valor na modalidade;
    • nomeparametro: % Captação até Entrega;
    • valortabela: Percentual do valor previsto para receber até a entrega;
    • valorproposta:  Percentual do valor previsto para receber até a entrega;
    • parametrodeaprovacao: Não valida para esse tipo de parâmetro;
    • nomeparametro: % Captação até 1 mês Antes Entrega;
    • valortabela: Percentual do valor previsto para receber até um mês antes da entrega;
    • valorproposta:  Percentual do valor previsto para receber até um mês antes da entrega;
    • parametrodeaprovacao: Não valida para esse tipo de parâmetro;
    • nomeparametro: % Captação até Metade da proposta em relação a Entrega da Subunidade;
    • valortabela: Percentual do valor previsto para receber até a metade do tempo que falta para entrega;
    • valorproposta:  Percentual do valor previsto para receber até a metade do tempo que falta para entrega;
    • parametrodeaprovacao: Não valida para esse tipo de parâmetro;
    • nomeparametro: Valor m2;
    • valortabela: Valor do m2 ;
    • valorproposta:  Valor do m2 ;
    • parametrodeaprovacao: Não valida para esse tipo de parâmetro;
    • nomeparametro: Valor m2 VPL;
    • valortabela: Valor do m2 com a VPL;
    • valorproposta:  Valor do m2 com a VPL;
    • parametrodeaprovacao: Não valida para esse tipo de parâmetro;
    • nomeparametro: % Arrecadação;
    • valortabela: (Valor do total financiado / Valor Tabela Preço) - 1;
    • valorproposta:  (Valor do total financiado proposta / Valor Tabela Preço Proposta) - 1;
    • parametrodeaprovacao: Pode validar entre %mínimo  e %máximo, se configurado com valor na modalidade;
    • nomeparametro: % Desconto;
    • valortabela: 1- (Valor do total original / Valor Tabela Preço) ;
    • valorproposta:  1- (Valor do total original proposta / Valor Tabela Preço Proposta) ;
    • parametrodeaprovacao: Pode validar entre %mínimo  e %máximo, se configurado com valor na modalidade;
    • nomeparametro: % Diferença do VPL;
    • valortabela: Percentual de diferença da VPL em reação ao padrão, nesse caso sempre será 0, pois é a coluna do padrão;
    • valorproposta:  Percentual de diferença da VPL em reação ao padrão,  se for maior que 0, está abaixo da tabela padrão e se for maior que 0, está acima da padrão;
    • parametrodeaprovacao: Pode validar entre %mínimo  e %máximo, se configurado com valor na modalidade;
Expandir
titleAPI - Validação de Parametrização
TítuloAPI - Validação de Parametrização
Endpointhttp://localhost:8051/api/imb/v1/registrations/validate/pi/enterprises/{Cod Empreendimento}
VerboGET

Parameters

Não tem Parãmetros.
Descrição 

No preenchimento da proposta existem algumas validações ( parâmetro do financeiro sequência, corretor vinculado ao Cli/for, tabela de preço para unidade, modalidade de venda parametrizada) que ajudam o corretor a não continuar a proposta caso os mesmos já não estiverem já definidos. Essa API seria facilitadora para que o corretor não preencha cada campo para descobrir que falta parametrização padrão


Api geral - Valida todos Empreendimentos :  http://localhost:8051/api/imb/v1/registrations/validate/pi

Api por empreendimento : http://localhost:8051/api/imb/v1/registrations/validate/pi/enterprises/2057 Neste exemplo passando pelo Empreendimento 2057


Neste exemplo da API , passou pelo empreendimento 2057 e o Response mostrando as parametrizações que precisam sem feitas.

Parãmetros TCGINão tem Parãmetros no TCGI.
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
No Body
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "aprovado": false,
    "mensagemvalidacao": "Erro no Item Validar Pessoa PI Sincronizado com Cli/For.\r\n",
    "itensvalidados": [
        {
            "codcoligada": 0,
            "codempreendimento": 0,
            "aprovado": true,
            "itemvalidado": "Validar Tabela [XPISITUACAOPROPOSTA] com Dados no Portal de Imóveis.",
            "mensagemvalidacao": ""
        },
        {
            "codcoligada": 0,
            "codempreendimento": 0,
            "aprovado": true,
            "itemvalidado": "Validar Tabela [XPISITUACAOUNIDADE] com Dados no Portal de Imóveis.",
            "mensagemvalidacao": ""
        },
        {
            "codcoligada": 0,
            "codempreendimento": 0,
            "aprovado": true,
            "itemvalidado": "Validar Tabela [XPIPARAMETRO] com Dados no Portal de Imóveis.",
            "mensagemvalidacao": ""
        },
        {
            "codcoligada": 0,
            "codempreendimento": 0,
            "aprovado": true,
            "itemvalidado": "Validar Configuração de Forçar Proposta ",
            "mensagemvalidacao": ""
        },
        {
            "codcoligada": 0,
            "codempreendimento": 0,
            "aprovado": true,
            "itemvalidado": "Validar Venda Sequencial TCGI",
            "mensagemvalidacao": ""
        },
        {
            "codcoligada": 1,
            "codempreendimento": 2057,
            "aprovado": true,
            "itemvalidado": "Validar Código Sequencial Parâmetro Cli/For.",
            "mensagemvalidacao": ""
        },
        {
            "codcoligada": 1,
            "codempreendimento": 2057,
            "aprovado": true,
            "itemvalidado": "Validar Usuário PI Sincronizado com Cli/For.",
            "mensagemvalidacao": ""
        },
        {
            "codcoligada": 1,
            "codempreendimento": 2057,
            "aprovado": false,
            "itemvalidado": "Validar Pessoa PI Sincronizado com Cli/For.",
            "mensagemvalidacao": "A pessoa do PI [10-ADRIANO NOVO PVI]  do Tipo [Propesct] não está sincronizado com Cli/For da coligada [1]\r\n"
        },
        {
            "codcoligada": 1,
            "codempreendimento": 2057,
            "aprovado": true,
            "itemvalidado": "Validar Tabela de Preço Vinculado ao Empreendimento",
            "mensagemvalidacao": ""
        },
        {
            "codcoligada": 1,
            "codempreendimento": 2057,
            "aprovado": true,
            "itemvalidado": "Validar Modalidade de Venda Parametrizada e Vinculada ao Empreendimento",
            "mensagemvalidacao": ""
        },
        {
            "codcoligada": 1,
            "codempreendimento": 2057,
            "aprovado": true,
            "itemvalidado": "Validar Modalidade de Comissão Vinculada ao Empreendimento",
            "mensagemvalidacao": ""
        }
    ]
}
Expandir
titleAPI de Solicitação de Aprovação de Proposta Reprovada



TítuloAPI de Solicitação de Aprovação de Proposta Reprovada
Endpointhttp://localhost:8051/api/imb/v1/sales/proposals/{Cod Coligada}_{Número da Venda}/approval
VerboPost

Parameters

KeyValue
note


Informe a mensagem de observação do corretor para o supervisor

urlInforme o endereço da web para realizar a aprovação da proposta
Descrição 

Api para solicitar aprovação de proposta de venda quando a mesma foi reprovada pela validação.

Ao solicitar a aprovação da proposta o sistema enviára um e-mail para o supervisor do corretor solicitadando a sua aprovação, desde que o parâmetro "Permite Forçar Proposta" esteja marcado.

Para o envio do e-mail os campos dos parâmetros do TCGI → Portal do Imóvel→ Porposta de Venda devem ser preenchidos 

Baixe aqui o modelo do corpo do e-mail

Parâmetros

do TCGI

Image Added

Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
No Body
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
No Response
Expandir
titleAPI

...

Aprovar Proposta Forçada
TítuloAPI Aprovar Proposta Forçada
Endpointhttp://localhost:8051/api/imb/v1/sales/proposals/{Cod Coligada}_{Número da Venda}/forceapproval
VerboPost

Parameters

KeyValue
note

Informe a mensagem de observação do Supervisor para o Corretor

userldInforme Id do Superior vinculado ao Corretor da Proposta
Descrição 

Api para forçar a aprovação de uma Proposta reprovada, caso seja aprovada pelo Superior informado no cadastro dos parametros do Corretor.

Lembrando que o parâmetro no PI da Proposta ( Reprovada ) tem que estar marcada o parâmetro - Permite forçar proposta.

E-mail será enviado para Superior cadastrado configurado no cadastro do Corretor no Portal de Imóveis. 

Uma proposta que foi reprovada , o Corretor envia um e-mail para seu Supervisor , conforme API : API de Solicitação de Aprovação de Proposta Reprovada citada 

no exemplo acima , essa API força que uma proposta Reprovda possa se tornar APROVADA , fazendo que o e-mail possa ser enviado alterando a proposta de Reprovada para 

Aprovada.

Baixe TCGIRELPI0002 - Corpo de E-mail para Forçar Aprovação de Proposta.TotvsReport aqui 

Parâmetros

do TCGI

Image Added

Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
No Body
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
No Response
Expandir
titleAPI - Inserir - Pessoas Adicionais
TítuloAPI - Inserir - Pessoas Adicionais
Endpointhttp://localhost:8051/rmsrestdataserver/rest/ImbPVIClienteData
VerboPost

Parameters

Não tem Parãmetros.
Descrição 

Api para tratamento para criar um Fiador.

Tabela XPIPESSOA.TIPO

Incluído esses Típos de Fiadores.

5 = Procurador
6 = Procurador Cônjuge
7 = Representante Legal
8 = Fiador


No exemplo do Código Body - Inserindo um Fiador com código = 8 ( Fiador ) TIPO = 8

Cadastro de Pessoas Adicionais:

Contrato de Venda | Anexo | Pessoas Adicionais

Parãmetros TCGINão tem Parãmetros no TCGI.
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
[
 
{"ID":-1,
"NOME": "CLIENTE FIADOR 01",
"RAZAOSOCIAL": " CLIENTE FIADOR 01",
"CPFCNPJ": "46185793237",
"TELEFONE": "999999999",
"PAI": "PAI FIADOR 01",
"MAE": "MAE FIADOR 01",
"CONJUGE_NOME": "ESPOSA FIADOR 01",
"CONJUGE_CPF": "53976044610",
"TIPO": 8,
"TIPOPESSOA": 0,
"DATAHORACADASTRO":"2023-05-18T11:09:58.52-03:00"
}
]
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "messages": [],
    "length": 1,
    "data": {
        "id": "111",
        "RESTDS_TEMP_ID": 111,
        "ID_ERP": "1;001457",
        "COMUNHAODEBENS_ID": null,
        "EMPREENDIMENTO_ID": null,
        "ESTADOCIVIL_ID": null,
        "ESTANDEVENDA_ID": null,
        "MIDIA_ID": null,
        "MORADIA_ID": null,
        "PROFISSAO_ID": null,
        "SITUACAOPESSOA_ID": null,
        "TIPOIMOVEL_ID": null,
        "TIPOLOGIA_ID": null,
        "USUARIO_ID": null,
        "TIPO": 8,
        "TIPOPESSOA": 0,
        "DATAHORACADASTRO": "2023-05-18T11:09:58.52-03:00",
        "NOME": "CLIENTE FIADOR 01",
        "RAZAOSOCIAL": " CLIENTE FIADOR 01",
        "CPFCNPJ": "46185793237",
        "RGNUMERO": null,
        "RGORGAO": null,
        "RGUF": null,
        "INSCRICAOESTADUAL": null,
        "INSCRICAOMUNICIPAL": null,
        "TELEFONE": "999999999",
        "CELULAR": null,
        "FAX": null,
        "EMAIL": null,
        "SALT": null,
        "HASH": null,
        "LOGRADOUROCOBRANCA": null,
        "NUMEROCOBRANCA": null,
        "COMPLEMENTOCOBRANCA": null,
        "BAIRROCOBRANCA": null,
        "CIDADECOBRANCA": null,
        "UFCOBRANCA": null,
        "CEPCOBRANCA": null,
        "MESMOENDERECOCOBRANCA": null,
        "LOGRADOURO": null,
        "NUMERO": null,
        "COMPLEMENTO": null,
        "BAIRRO": null,
        "CIDADE": null,
        "UF": null,
        "CEP": null,
        "SEXO": null,
        "DATANASCIMENTO": null,
        "CEI": null,
        "NATURALIDADE": null,
        "NACIONALIDADE": null,
        "PAI": "PAI FIADOR 01",
        "MAE": "MAE FIADOR 01",
        "RENDA": null,
        "CARTORIOFIRMA": null,
        "LIVROREGISTRO": null,
        "FOLHAREGISTRO": null,
        "EMPRESA_NOME": null,
        "EMPRESA_LOGRADOURO": null,
        "EMPRESA_NUMERO": null,
        "EMPRESA_COMPLEMENTO": null,
        "EMPRESA_BAIRRO": null,
        "EMPRESA_CIDADE": null,
        "EMPRESA_UF": null,
        "EMPRESA_CEP": null,
        "EMPRESA_TELEFONE": null,
        "EMPRESA_FAX": null,
        "EMPRESA_RAMAL": null,
        "EMPRESA_DATAADMISSAO": null,
        "EMPRESA_CARGO": null,
        "CONJUGE_PROFISSAO_ID": null,
        "CONJUGE_NOME": "ESPOSA FIADOR 01",
        "CONJUGE_EMAIL": null,
        "CONJUGE_DATANASCIMENTO": null,
        "CONJUGE_CPF": "53976044610",
        "CONJUGE_RGNUMERO": null,
        "CONJUGE_RGORGAO": null,
        "CONJUGE_RGUF": null,
        "CONJUGE_SEXO": null,
        "CONJUGE_PAI": null,
        "CONJUGE_MAE": null,
        "CONJUGE_TELEFONE": null,
        "CONJUGE_CELULAR": null,
        "CONJUGE_NATURALIDADE": null,
        "CONJUGE_NACIONALIDADE": null,
        "CONJUGE_CARTORIOFIRMA": null,
        "CONJUGE_RENDA": null,
        "CONJUGE_EMPRESA_NOME": null,
        "CONJUGE_EMPRESA_CARGO": null,
        "CONJUGE_EMPRESA_DATAADMISSAO": null,
        "CONJUGE_EMPRESA_TELEFONE": null,
        "CONJUGE_EMPRESA_LOGRADOURO": null,
        "CONJUGE_EMPRESA_NUMERO": null,
        "CONJUGE_EMPRESA_COMPLEMENTO": null,
        "CONJUGE_EMPRESA_BAIRRO": null,
        "CONJUGE_EMPRESA_CIDADE": null,
        "CONJUGE_EMPRESA_UF": null,
        "CONJUGE_EMPRESA_CEP": null,
        "OBSERVACOES": null,
        "FAIXAVALORPRETENDIDO_ID": null,
        "FORMACONTATO_ID": null,
        "USUARIOCRIACAO_ID": null,
        "DATA_ULTIMA_INTERACAO": null,
        "IMPORTPARTICIPANTECAMP_ID": null,
        "PESSOA_NATURALIDADE_ID": null,
        "ID_CONJUGE_NATURALIDADE": null,
        "SITUACAOCADASTROPESSOA_ID": null,
        "MEX_NSS": null,
        "MEX_RFC": null,
        "MEX_CURP": null,
        "MEX_CONJUGE_NSS": null,
        "MEX_CONJUGE_RFC": null,
        "MEX_CONJUGE_CURP": null,
        "TEMPOMORADIA": null,
        "DATACASAMENTO": null,
        "RENDACOMPROMETIDA": null,
        "TIPORENDA_ID": null,
        "CREDITO_FINANCIAMENTO": null,
        "CREDITO_FGTS": null,
        "CREDITO_SUBSIDIO": null,
        "CREDITO_RECURSO_PROPRIO": null,
        "VALOR_PARCELA_APROVADA": null,
        "PRAZO_MAXIMO_FINANCIAMENTO": null,
        "TIPO_AMORTIZACAO": null,
        "VIGENCIA_AVALIACAO": null,
        "VALOR_RENDA_INFORMAL": null,
        "JSON_LEAD_RD": null,
        "SDR_ID": null,
        "CORRESPONDENTE_ID": null,
        "MOTIVO_REPROVACAO": null,
        "LEAD": null,
        "LEAD_POTENCIAL": null,
        "COD_INTEG_EXTERNO": null,
        "RD_UUID": null,
        "DATA_MUDANCA_SITUACAO": null,
        "DATA_CONSULTA_SERASA": null,
        "RESPOSTA_API_SERASA": null,
        "POSSUI_VENDA_ERP": null,
        "RECCREATEDBY": null,
        "RECCREATEDON": null,
        "RECMODIFIEDBY": null,
        "RECMODIFIEDON": null
    }
}

Expandir
titleAPI - Associar Pessoa na Proposta
TítuloAPI - Associar Pessoa na Proposta
Endpoint

...

Validações:

  • Situação da proposta não ser possível forçar proposta

Parâmetro: permite_forcar_proposta

Mensagem retornada: A situação em que a proposta se encontra não permite que ela seja forçada, portanto não há necessidade de solicitar aprovação.

  • Usuário não ter superior configurado

Campo do usuário: id_superior

Mensagem retornada: Não foi encontrado nenhum superior ou gerente do empreendimento para solicitar aprovação

.Habilita solicitação de aprovação:

  • Usuário ter superior configurado: id_superior
  • Situação da proposta permiti forçar proposta: situacao_permite_forcar_proposta

...

...

Exemplo abaixo uma API configurada para ( Gmail )

{Cod Coligada}_{Número da Venda}
VerboPut ou Post

Parameters

Não tem Parãmetros.
Descrição 

API para inserir a Pessoa cadastrada na API http://localhost:8051/rmsrestdataserver/rest/ImbPVIClienteData em uma proposta no TCGI.


No BODY , informo :

[
{
"idcliente": 4,
"clienteprincipal": 1,
"pessoasadicionais": [{"idpessoa": 111,"tipopessoa": 8},
{"idpessoa": 112,"tipopessoa": 7}

]


IDPESSOA cadastrada na API Pessoas Adicionais com seu TIPO. 

Ao inserir uma Pessoa Adicional via API , retorna seu ID como mostra o cadastro da API acima.

Parãmetros TCGINão tem Parãmetros no TCGI.
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
{
    "codcoligada": 1,
    "idpropostapvi": 19,
    "idpropostavenda": 10013,
    "datavenda": "2023-03-20T00:00:00",
    "idmodalidade": 906,
    "numtabpreco": 144,
    "statuspvi": 1,
    "descricaostatuspvi": "Aprovada",
    "corletra": "#FFFFFF",
    "corfundo": "#5CB85C",
    "valorproposta": 500000.0000,
    "valortabelapreco": 500000.0000,
    "datacriacao": "2023-03-20T11:15:44.313",
    "dataalteracao": "2023-03-20T11:16:42",
    "diasdaproposta": "59 dia(s)",
    "diasdapropostaporextenso": "59 dia(s) 0 hora(s) 53 minuto(s)",
    "clientes": [
        {
            "idcliente": 4,
            "clienteprincipal": 1,
            "pessoasadicionais": [{"idpessoa": 111,"tipopessoa": 8},
                                  {"idpessoa": 112,"tipopessoa": 7}
            
            ]
        }
    ],
    "codempreendimento": 2057,
    "nomeempreendimento": "Emp Nova API Automação",
    "dataentrega": "2022-01-01T00:00:00",
    "codunidade": "1",
    "nomeunidade": "Bloco 01",
    "codsubunidade": "000005",
    "nomesubunidade": "Apto 000005",
    "nrovagas": 0,
    "areasubunidade": 180.0000,
    "idcorretorpvi": 1,
    "idusuariopropostapvi": 1,
    "idimobiliariapvi": 1,
    "nomecorretorpvi": "Corretor",
    "idsuperiorpvi": 2,
    "nomesuperiorpvi": "Superior",
    "idmidia": 1,
    "idmotivocompra": 1,
    "valordesconto": 0.0000,
    "propostaforcada": 0,
    "propostaforcadadata": "0001-01-01T00:00:00",
    "propostaforcadaobs": ""
}
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "codcoligada": 1,
    "idpropostapvi": 19,
    "idpropostavenda": 10013,
    "datavenda": "2023-03-20T00:00:00",
    "idmodalidade": 906,
    "numtabpreco": 144,
    "statuspvi": 1,
    "descricaostatuspvi": "Aprovada",
    "corletra": "#FFFFFF",
    "corfundo": "#5CB85C",
    "valorproposta": 500000.0000,
    "valortabelapreco": 500000.0000,
    "datacriacao": "2023-03-20T11:15:44.313",
    "dataalteracao": "2023-05-19T11:33:49",
    "diasdaproposta": "60 dia(s)",
    "diasdapropostaporextenso": "60 dia(s) 0 hora(s) 18 minuto(s)",
    "clientes": [
        {
            "idcliente": 4,
            "clienteprincipal": 1,
            "pessoasadicionais": [
                {
                    "idpessoa": 111,
                    "tipopessoa": 8
                },
                {
                    "idpessoa": 112,
                    "tipopessoa": 7
                }
            ]
        }
    ],
    "codempreendimento": 2057,
    "nomeempreendimento": "Emp Nova API Automação",
    "dataentrega": "2022-01-01T00:00:00",
    "codunidade": "1",
    "nomeunidade": "Bloco 01",
    "codsubunidade": "000005",
    "nomesubunidade": "Apto 000005",
    "nrovagas": 0,
    "areasubunidade": 180.0000,
    "idcorretorpvi": 1,
    "idimobiliariapvi": 1,
    "nomecorretorpvi": "Corretor",
    "idsuperiorpvi": 2,
    "nomesuperiorpvi": "Superior",
    "idmidia": 1,
    "idmotivocompra": 1,
    "valordesconto": 0.0000,
    "propostaforcada": 0,
    "propostaforcadadata": "0001-01-01T00:00:00",
    "propostaforcadaobs": ""
}
Expandir
titleAPI de Usuário Portal de Imóveis
TítuloAPI de Usuário Portal de Imóveis - GET
Endpointhttp://localhost:8051/rmsrestdataserver/

...

Configurando TCGI :

Image Removed

Image Removed

Exemplo de como configurar os parâmetros do Portal de Imóveis.

Image Removed

Acima , segue modelo do E-mail enviado.

rest/ImbPIUsuarioData
VerboGet

Parameters

No parameters
Descrição 

Utilizando esta API com o verbo Get, o sistema retorna a lista de usuários cadastrados na Tabela XPIUSUARIO do Portal de Imóveis.

Parâmetros

do TCGI


Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
No Body
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "messages": [],
    "length": 1,
    "data": [
        {
            "id": "1",
            "RESTDS_TEMP_ID": 1,
            "ID_ERP": "1;01455",
            "ID_SUPERIOR": null,
            "GRUPOUSUARIO_ID": 1,
            "NOME": "mestre",
            "SOBRENOME": "totvs",
            "EMAIL": "[email protected]",
            "CELULAR": "3134940000",
            "SALT": "Ay3+rprtuHjBQjA3vAqlJn8SyfqYovB7",
            "HASH": "wsCmCTzMluub+Hls5oNDCc6O2zXevPBm",
            "RESERVAS": 3,
            "ATIVO": 1,
            "DATAHORACADASTRO": "2023-03-13T16:33:06-03:00",
            "DATAHORAULTIMOLOGIN": "2023-03-22T08:31:08.863-03:00",
            "DATAHORAALTERACAO": "2023-03-22T08:31:08.917-03:00",
            "PERGUNTAR_NOTIFICAR_SUPERIOR": 1,
            "LISTAS_DISPOSICAO": 2,
            "LISTAS_VISAO": 3,
            "PERCENTUAL_COMISSAO": 2.0000,
            "CRECI": null,
            "IMOBILIARIA_ID": null,
            "PODE_ATUALIZAR_SISTEMA": 1,
            "TIPOPESSOA": 1,
            "CPFCNPJ": "34360165510",
            "FORCAR_ALTERAR_SENHA": 0,
            "DATA_VIGENCIA_CRECI": null,
            "QTD_MAX_PROSPECTS": 0,
            "RECCREATEDBY": null,
            "RECCREATEDON": null,
            "RECMODIFIEDBY": null,
            "RECMODIFIEDON": null
        }
}
TítuloAPI de Usuário Portal de Imóveis - POST
Endpointhttp://localhost:8051/rmsrestdataserver/rest/ImbPIUsuarioData
VerboPost

Parameters

No parameters

Descrição 

Utilizando esta API com o verbo Post, o sistema irá cadastrar o usuário do Portal de Imóveis alimentando as seguintes tabelas:

  • XPIUSUARIO: Tabelas que armazena os dados dos usuários do PI;
  • FCFO: Tabela (principal) que armazena os dados dos Clientes no financeiro;
  • XPESSOACONJUGE: Tabela que  armazena os dados do cônjuge dos clientes no TCGI; e
  • XCLIENTEPESSOAFISICA: Tabela que armazena os dados complementares dos clientes no TCGI;

Parâmetros

do TCGI


Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
[
    {        
          "ID":-1,
         "NOME": "Itamar",         
         "SOBRENOME": "Morais",    
         "ID_SUPERIOR": 1,
         "GRUPOUSUARIO_ID": 1,
         "CPFCNPJ": "860.672.580-30",
         "celular": "999999999",         
          "EMAIL" : "[email protected]",         
         "TIPOPESSOA": 0
         
    }
]
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "messages": [],
    "length": 1,
    "data": {
        "id": "37",
        "RESTDS_TEMP_ID": 37,
        "ID_ERP": "1;001456",
        "ID_SUPERIOR": 1,
        "GRUPOUSUARIO_ID": 1,
        "NOME": "Itamar",
        "SOBRENOME": "Morais",
        "EMAIL": "[email protected]",
        "CELULAR": "999999999",
        "SALT": null,
        "HASH": null,
        "RESERVAS": null,
        "ATIVO": null,
        "DATAHORACADASTRO": null,
        "DATAHORAULTIMOLOGIN": null,
        "DATAHORAALTERACAO": null,
        "PERGUNTAR_NOTIFICAR_SUPERIOR": null,
        "LISTAS_DISPOSICAO": null,
        "LISTAS_VISAO": null,
        "PERCENTUAL_COMISSAO": null,
        "CRECI": null,
        "IMOBILIARIA_ID": null,
        "PODE_ATUALIZAR_SISTEMA": null,
        "TIPOPESSOA": 0,
        "CPFCNPJ": "86067258030",
        "FORCAR_ALTERAR_SENHA": null,
        "DATA_VIGENCIA_CRECI": null,
        "QTD_MAX_PROSPECTS": null,
        "RECCREATEDBY": null,
        "RECCREATEDON": null,
        "RECMODIFIEDBY": null,
        "RECMODIFIEDON": null
    }
}



TítuloAPI de Usuário Portal de Imóveis - PUT
Endpointhttp://localhost:8051/rmsrestdataserver/rest/ImbPIUsuarioData/{ID_do_Usuário_na_XPIUSUARIO]
VerboPut

Parameters

No parameters
Descrição 

Utilizando esta API com o verbo Put, o sistema irá atualizar os dados informados, para o usuário repassado na ID, na tabela XPIUSUARIO, que armazena os dados dos usuários do PI.

Ao utilizar este verbo é preciso informar todos os campos/tags do cadastro do usuário porque os campos que não forem informados serão setados como nulos.

Para atualizar somente um campo/tag, utilize o verbo Patch descrito mais abaixo.

Parâmetros

do TCGI


Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
[
    {        
         "id": "37",
        "RESTDS_TEMP_ID": 37,
        "ID_ERP": "1;001456",
        "ID_SUPERIOR": 1,
        "GRUPOUSUARIO_ID": 1,
        "NOME": "Itamar",
        "SOBRENOME": "Morais",
        "EMAIL": "[email protected]",
        "CELULAR": "31934940000",
        "SALT": null,
        "HASH": null,
        "RESERVAS": null,
        "ATIVO": null,
        "DATAHORACADASTRO": null,
        "DATAHORAULTIMOLOGIN": null,
        "DATAHORAALTERACAO": null,
        "PERGUNTAR_NOTIFICAR_SUPERIOR": null,
        "LISTAS_DISPOSICAO": null,
        "LISTAS_VISAO": null,
        "PERCENTUAL_COMISSAO": null,
        "CRECI": null,
        "IMOBILIARIA_ID": null,
        "PODE_ATUALIZAR_SISTEMA": null,
        "TIPOPESSOA": 0,
        "CPFCNPJ": "86067258030",
        "FORCAR_ALTERAR_SENHA": null,
        "DATA_VIGENCIA_CRECI": null,
        "QTD_MAX_PROSPECTS": null,
    }
]
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "messages": [],
    "length": 1,
    "data": {
        "id": "37",
        "RESTDS_TEMP_ID": 37,
        "ID_ERP": "1;001456",
        "ID_SUPERIOR": 1,
        "GRUPOUSUARIO_ID": 1,
        "NOME": "Itamar",
        "SOBRENOME": "Morais",
        "EMAIL": "[email protected]",
        "CELULAR": "31934940000",
        "SALT": null,
        "HASH": null,
        "RESERVAS": null,
        "ATIVO": null,
        "DATAHORACADASTRO": null,
        "DATAHORAULTIMOLOGIN": null,
        "DATAHORAALTERACAO": null,
        "PERGUNTAR_NOTIFICAR_SUPERIOR": null,
        "LISTAS_DISPOSICAO": null,
        "LISTAS_VISAO": null,
        "PERCENTUAL_COMISSAO": null,
        "CRECI": null,
        "IMOBILIARIA_ID": null,
        "PODE_ATUALIZAR_SISTEMA": null,
        "TIPOPESSOA": 0,
        "CPFCNPJ": "86067258030",
        "FORCAR_ALTERAR_SENHA": null,
        "DATA_VIGENCIA_CRECI": null,
        "QTD_MAX_PROSPECTS": null,
        "RECCREATEDBY": null,
        "RECCREATEDON": null,
        "RECMODIFIEDBY": null,
        "RECMODIFIEDON": null
    }
}



TítuloAPI de Usuário Portal de Imóveis - PATCH
Endpointhttp://localhost:8051/rmsrestdataserver/rest/ImbPIUsuarioData/{ID_do_Usuário_na_XPIUSUARIO]
VerboPatch

Parameters

No parameters
Descrição 

Utilizando esta API com o verbo Patch, o sistema irá atualizar os dados informados, para o usuário repassado na ID, na tabela XPIUSUARIO, que armazena os dados dos usuários do PI.

Este verbo deve ser utilizado para atualizar os campos especificados, sem alterar o valor dos demais campos da tabela.

Parâmetros

do TCGI


Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
[
    {        
         "id": "37",
        "CELULAR": "31934940000"
    }
]
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "messages": [],
    "length": 1,
    "data": {
        "id": "37",
        "RESTDS_TEMP_ID": 37,
        "ID_ERP": "1;001456",
        "ID_SUPERIOR": 1,
        "GRUPOUSUARIO_ID": 1,
        "NOME": "Itamar",
        "SOBRENOME": "Morais",
        "EMAIL": "[email protected]",
        "CELULAR": "31934940000",
        "SALT": null,
        "HASH": null,
        "RESERVAS": null,
        "ATIVO": null,
        "DATAHORACADASTRO": null,
        "DATAHORAULTIMOLOGIN": null,
        "DATAHORAALTERACAO": null,
        "PERGUNTAR_NOTIFICAR_SUPERIOR": null,
        "LISTAS_DISPOSICAO": null,
        "LISTAS_VISAO": null,
        "PERCENTUAL_COMISSAO": null,
        "CRECI": null,
        "IMOBILIARIA_ID": null,
        "PODE_ATUALIZAR_SISTEMA": null,
        "TIPOPESSOA": 0,
        "CPFCNPJ": "86067258030",
        "FORCAR_ALTERAR_SENHA": null,
        "DATA_VIGENCIA_CRECI": null,
        "QTD_MAX_PROSPECTS": null,
        "RECCREATEDBY": null,
        "RECCREATEDON": null,
        "RECMODIFIEDBY": null,
        "RECMODIFIEDON": null
    }
}
TítuloAPI de usuário Portal de Imóveis - DELETE
Expandir
titleAPI de Solicitação de Aprovação de Proposta Reprovada
TítuloAPI de Solicitação de Aprovação de Proposta Reprovada
Endpointhttp://localhost:8051/apirmsrestdataserver/imbrest/v1/sales/proposals/ImbPIUsuarioData/{ID_do_Usuário_na_XPIUSUARIO]
VerboPostDelete

Parameters

No parameters.
Descrição 

Utilizando esta API com o verbo Delete, o sistema irá excluir os dados do usuário repassado no ID, na tabela XPIUSUARIO.

No exemplo de resposta abaixo, excluímos o usuário de ID 37, criado nos exemplos acima:

http://localhost:8051/rmsrestdataserver/rest/ImbPIUsuarioData/37

Parâmetros

do TCGI

Descrição Parâmetros


Bloco de código
rootModelo Json Solicitação Geração Comissão
titleBody
collapsetrue
No Body
Bloco de código
rootModelo Json Solicitação Geração Comissão
titleRESPONSE
collapsetrue
{
    "messages": [],
    "length": 1,
    "data": {
        "id": "37",
        "RESTDS_TEMP_ID": 37,
        "ID_ERP": "1;001456",
        "ID_SUPERIOR": 1,
        "GRUPOUSUARIO_ID": 1,
        "NOME": "Itamar",
        "SOBRENOME": "Morais",
        "EMAIL": "[email protected]",
        "CELULAR": "31934940000",
        "SALT": null,
        "HASH": null,
        "RESERVAS": null,
        "ATIVO": null,
        "DATAHORACADASTRO": null,
        "DATAHORAULTIMOLOGIN": null,
        "DATAHORAALTERACAO": null,
        "PERGUNTAR_NOTIFICAR_SUPERIOR": null,
        "LISTAS_DISPOSICAO": null,
        "LISTAS_VISAO": null,
        "PERCENTUAL_COMISSAO": null,
        "CRECI": null,
        "IMOBILIARIA_ID": null,
        "PODE_ATUALIZAR_SISTEMA": null,
        "TIPOPESSOA": 0,
        "CPFCNPJ": "86067258030",
        "FORCAR_ALTERAR_SENHA": null,
        "DATA_VIGENCIA_CRECI": null,
        "QTD_MAX_PROSPECTS": null,
        "RECCREATEDBY": "mestre",
        "RECCREATEDON": "2023-03-22T10:02:45-03:00",
        "RECMODIFIEDBY": "mestre",
        "RECMODIFIEDON": "2023-03-22T10:02:45-03:00"
    }
}