Criada uma API para ser utilizada no Portal de Imóveis ( Clientes ).

Buscando cliente pelo CPF ou Nome.

Criando os dados na tabelas de FCFO, XCLIENTEPESSOAFISICA e XPESSOACONJUGE, se for informado o CPF, Caso contrário fica somente na tabela XPVICLIENTE.

Para consultar os dados das novas Tabelas do Portal Imóveis que foram criadas diretamente no banco do RM, utilize como base a API abaixo, substituindo o termo {nomedatabela} pelo nome da tabela desejada.

http://localhost:8051/api/imb/v1/registrations/{nomedatabela}

Esta API só pode ser utilizada com verbo do tipo get.

Exemplos de uso desta API:

Consultando as informações da Tabela XPIMIDIA, na qual estão as informações sobre as Mídias utilizadas para gerar as Propostas no PI (Portal de Imóveis):

http://localhost:8051/api/imb/v1/registrations/XPIMIDIA

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-10_13-29-33.png

Outras Tabelas disponíveis até o momento de edição deste documento são:

XPIESTADOCIVIL - Que controla o cadastro dos Estados Civis das Pessoas no PI; e
XPIPROFISSAO - Que controla o cadastro das Profissões das Pessoas no PI.

http://localhost:8051/rmsrestdataserver/rest/ImbPVIClienteData

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-22-49.png

Neste exempo , via Postman estou cadastrando um Novo Cliente com os seguintes dados:

Nome : CLIENTE NOVO ASTONI

Razão Social : CLIENTE NOVO ASTONI

CPF : 044.266.846-50

Pai: PAI ASTONI

Mãe : MAE ASTONI

Conjuge : ESPOSA ASTONI

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-25-12.png

Cadastro realizado e é retornado o Código ID do Cliente com seu ID ERP ( CODCFO )

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-27-5.png

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-27-42.png

Cadastros realizados na base de dados RM

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-49-34.png

Caso tente adiconar um cliente na qual já exista um com CPF já cadastro no sistema , é feita a validação da API retornando a mensagem que já existe cadastro para o CPF na base de dados.

http://localhost:8051/rmsrestdataserver/rest/ImbPVIClienteData/{Número do ID que deseja excluir}

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-29-4.png

Cliente foi gerado com ID = 35 e neste exemplo , informo o Código 35 do ID que desejo excluir.

http://localhost:8051/rmsrestdataserver/rest/ImbPVIClienteData?filter= ["nome like :nome and CPFCNPJ = :cpf", "%ASTONI%", "044.266.846-50"]

Neste exemplo é feita a consulta com Filtro , e esse exemplo é para buscar clientes com CPF acima e nome.

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-30-35.png

Neste exemplo é informado o Cliente conforme Filtro desejado, somente o CPF informado e que tenha ASTONI em seu nome.

http://localhost:8051/rmsrestdataserver/rest/ImbPVIClienteData

Neste caso a pesquisa não utiliza filtro.

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-33-45.png

Neste que não possui Filtros , informa a quantidade de Registros = 2 ( 2 Clientes ) com seus dados.

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-35-9.png

http://localhost:8051/rmsrestdataserver/rest/ImbPVIClienteData/34

Ambas APIS alteram dados de Cliente

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-36-16.png

Não se esquecendo de informar o número do ID que deseja alterar e os campso que serão feitas as alterações.

Alterando neste exemplo os campos:

Nome
Razão Social
Pai
Mãe
Nome da Esposa ( Conjuge )

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-38-30.png

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-39-1.png

Dados alterados no RM

ALTERANDO COM PATCH

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-39-57.png

Novamente informar o ID do Cliente que deseja alterar o cadastro e seus dados.

Alterando neste exemplo os campos:

Nome
Pai
Mãe
Nome da Esposa ( Conjuge )

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-41-45.png

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-1_14-42-9.png

RM PVI

Column_name	Type	Nullable	Length	Coluna	tipo	Nullable	Length	Tabela	Id_erp
CODCOLIGADA	DCODCOLIGADA	no	2	id_erp	varchar	yes	255
CODCFO	varchar	no	25	id_erp	varchar	yes	255
NOMEFANTASIA	varchar	yes	100	razaosocial	varchar	yes	100
NOME	varchar	yes	100	nome	varchar	yes	100
CGCCFO	varchar	yes	20	cpfcnpj	varchar	yes	14
INSCRESTADUAL	varchar	yes	20	inscricaoestadual	varchar	yes	15
PAGREC	smallint	no	2
RUA	varchar	yes	100	logradouro	varchar	yes	100
NUMERO	varchar	yes	8	numero	varchar	yes	10
COMPLEMENTO	DCOMPLEMENTO	yes	60	complemento	varchar	yes	50
BAIRRO	DBAIRRO	yes	80	bairro	varchar	yes	50
CIDADE	DCIDADE	yes	32	cidade	varchar	yes	50
CODETD	varchar	yes	2	uf	varchar	yes	2
CEP	DCEP	yes	9	cep	varchar	yes	8
TELEFONE	varchar	yes	15	telefone	varchar	yes	15
RUAPGTO	varchar	yes	100	logradourocobranca	varchar	yes	100
NUMEROPGTO	varchar	yes	8	numerocobranca	varchar	yes	10
COMPLEMENTOPGTO	DCOMPLEMENTO	yes	60	complementocobranca	varchar	yes	50
BAIRROPGTO	DBAIRRO	yes	80	bairrocobranca	varchar	yes	50
CIDADEPGTO	DCIDADE	yes	32	cidadecobranca	varchar	yes	50
CODETDPGTO	varchar	yes	2	ufcobranca	varchar	yes	2
CEPPGTO	DCEP	yes	9	cepcobranca	varchar	yes	8
FAX	varchar	yes	15	fax	varchar	yes	15
TELEX	varchar	yes	15	celular	varchar	yes	15
EMAIL	varchar	yes	60	email	varchar	yes	50
INSCRMUNICIPAL	varchar	yes	20	inscricaomunicipal	varchar	yes	15
ESTADOCIVIL	varchar	yes	1	estadocivil_id	int	yes	4	estadocivil	sim
DTNASCIMENTO	datetime	yes	8	datanascimento	datetime	yes	8
RECCREATEDBY	varchar	yes	50	usuariocriacao_id	int	yes	4	usuario	não
RECCREATEDON	datetime	yes	8	datahoracadastro	datetime	yes	8		não
RECMODIFIEDON	datetime	yes	8	data_ultima_interacao	date	yes	3	10
COD_SEXO	char	yes	1	sexo	smallint	yes	2
CODETDMUNICIPIO	varchar	yes	2	naturalidade	varchar	yes	50
NAT_CFO	varchar	yes	30	nacionalidade	varchar	yes	50
NOM_PAI	varchar	yes	45	pai	varchar	yes	50
NOM_MAE	varchar	yes	45	mae	varchar	yes	50
EMPR_RENDA	RMDVALOR4	yes	15,4	renda	decimal	yes	9
EMPR_NOME	varchar	yes	100	empresa_nome	varchar	yes	100
EMPR_ENDERECO	varchar	yes	30	empresa_logradouro	varchar	yes	100
EMPR_NUMERO	varchar	yes	8	empresa_numero	varchar	yes	10
EMPR_COMPL	varchar	yes	20	empresa_complemento	varchar	yes	30
EMPR_BAIRRO	varchar	yes	30	empresa_bairro	varchar	yes	50
EMPR_CIDADE	varchar	yes	30	empresa_cidade	varchar	yes	50
EMPR_UF	varchar	yes	2	empresa_uf	varchar	yes	2
EMPR_CEP	varchar	yes	9	empresa_cep	varchar	yes	8
EMPR_TEL_COM	varchar	yes	15	empresa_telefone	varchar	yes	15
EMPR_RAMAL	varchar	yes	8	empresa_ramal	varchar	yes	10
EMPR_FAX	varchar	yes	15	empresa_fax	varchar	yes	15
EMPR_DATA_ADM	datetime	yes	8	empresa_dataadmissao	datetime	yes	8
EMPR_CARGO	varchar	yes	25	empresa_cargo	varchar	yes	50
CODPROF	varchar	no	3	conjuge_profissao_id	int	yes	4
NOME	varchar	yes	250	conjuge_nome	varchar	yes	100
				conjuge_email	varchar	yes	50
DATNASC	datetime	yes	8	conjuge_datanascimento	datetime	yes	8
CPF	varchar	yes	20	conjuge_cpf	varchar	yes	11
CI	varchar	yes	20	conjuge_rgnumero	varchar	yes	50
ORGEMISCI	varchar	yes	8	conjuge_rgorgao	varchar	yes	20
ORGEMISCI	varchar	yes	8	conjuge_rguf	varchar	yes	2
				conjuge_sexo	varchar	yes	1
NOMPAI	varchar	yes	45	conjuge_pai	varchar	yes	100
NOMEMAE	varchar	yes	45	conjuge_mae	varchar	yes	100
TELEFONE	varchar	yes	15	conjuge_telefone	varchar	yes	15
CELULAR	varchar	yes	15	conjuge_celular	varchar	yes	15
				conjuge_naturalidade	varchar	yes	50
NAT_PESS	varchar	yes	30	conjuge_nacionalidade	varchar	yes	50
				conjuge_cartoriofirma	varchar	yes	50
				conjuge_renda	decimal	yes	9
LOCALTRAB	varchar	yes	40	conjuge_empresa_nome	varchar	yes	100
				conjuge_empresa_cargo	varchar	yes	50
				conjuge_empresa_dataadmissao	datetime	yes	8
TELCOMER	varchar	yes	15	conjuge_empresa_telefone	varchar	yes	15
LOGRADOURO	varchar	yes	45	conjuge_empresa_logradouro	varchar	yes	100
NUMEROEND	varchar	yes	6	conjuge_empresa_numero	varchar	yes	10
COMPLEMENTOEND	varchar	yes	15	conjuge_empresa_complemento	varchar	yes	50
BAIRRO	varchar	yes	25	conjuge_empresa_bairro	varchar	yes	50
CIDADE	varchar	yes	30	conjuge_empresa_cidade	varchar	yes	50
UF	varchar	yes	2	conjuge_empresa_uf	varchar	yes	2
CEP	varchar	yes	8	conjuge_empresa_cep	varchar	yes	8
DATACASAMENTO	datetime	yes	8	datacasamento	datetime2	yes	8

API para inclusão de Proposta : http://localhost:8051/api/imb/v1/sales/proposals

Exemplo da API para inclusão de Proposta:

{
    "codcoligada": 1,
    "statuspvi": 1,
    "codempreendimento": 100,
    "codunidade": "01",
    "codsubunidade": "000502",
    "idcorretorpvi": 1,
    "idclienteprincipalpvi": 17,
    "idclientespvi": [
                17,
                18
                 ]

}

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_15-59-18.png

Idclientepvi : ( 17 e 18 ) estão cadastrados.

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-0-21.png

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-0-35.png

IDclientePrincipal = 17 ( ADRIANO ASTONI FERREIRA 01 )

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-1-10.png

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-3-34.png

Proposta 61 incluída na Base de Dados RM.

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-4-32.png

Proposta com os Dois compradores inserida e a SubUnidade .

API para consultar Propostas : http://localhost:8051/api/imb/v1/sales/proposals

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-7-5.png

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-8-17.png

API Alterando Proposta PUT : http://localhost:8051/api/imb/v1/sales/proposals/1_61 ( 1_61 = Coligada e número da Proposta que deseja alterar os dados )

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-11-38.png

Neste exemplo estou alterando o Comprador principal 17 para 18.

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-13-37.png

Foi alterado para o Adriano Astoni Ferreira 02 o Comprador Principal.

API Alterando Proposta PATCH : http://localhost:8051/api/imb/v1/sales/proposals/1_61

Mesmo critério de PUT - Inserindo a coligada e numero da Proposta.

{
    "codcoligada": 1,
    "idpropostavenda": 61,
    "statuspvi": 1,
   "codempreendimento": 100,
    "codunidade": "01",
    "codsubunidade": "000502",
    "idcorretorpvi": 1,
    "idclienteprincipalpvi": 18,
    "idclientespvi": [
                18

                 ]

}

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-17-31.png

Excluíndo o ID 17 da Proposta.

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-18-39.png

Comprador ID 17 Excluído.

API para Deletar Proposta : http://localhost:8051/api/imb/v1/sales/proposals/1_61

Inserir o número da Proposta que deseja excluir via API .

Linha RM > TOTVS Gestão Construção de Imóveis - API Cadastro de Cliente / Propostas > image2022-11-4_16-23-25.png

Proposta excluída da Base de Dados RM.