Métodos de negócio

Métodos de Recebimento

        Métodos que tem como objetivo receber requisições da Imobiliar.

ContratoRest.Cancelar()

Descrição: Método responsável por cancelar um contrato de administração ou locação (snap_brok__Contrato__c).

Neste método será possível o cancelamento de um contrato , antes que tenha sido assinado. 

Tipo de parâmetro: Contrato.

Método Rest: Post

Tipo: Síncrono

Registros por requisição: 1

                <instância do cliente> : nome de instância da org salesforce que o cliente utiliza. 

Processamento SnapProperty

                1. SnapProperty realiza busca em contratos(snap_brok__Contrato__c) com base

                    no Id ou Id externo informado.

                2. Caso não encontrado contrato, retorna mensagem de erro informando que "Contrato não foi localizado".

                3. SnapProperty verifica se contrato já consta como cancelado: snap_brok__Cancelado__c igual a true.

4. SnapProperty verifica se contrato já consta como assinado: snap_brok__Assinado__c igual a true.

5. Se contrato já estiver cancelado ou assinado retornara erro, não atualizara o contrato.

6. Se não houver impedimento para o cancelamento o SnapProperty atualiza contrato: 

     6.1 Situação (Situacao__c) do contrato para "Cancelado".

     6.2 Cancelado (Cancelado__c) para verdadeiro(true).

     6.3 Data do cancelamento (Data_cancelamento__c) para data atual (Today).

     6.4 Demais informações como recebido no request.  

7. SnapProperty verifica tipo de registro do contrato:

     7.1 Se contrato é de Locação:

            7.1.1 Realiza busca no objeto de proposta (Proposta__c) , com base na proposta

                      do contrato(snap_brok__Proposta__c).

            7.1.2 Caso encontre a Proposta deve cancela-la: com as mesmas atualizações

              de cancelamento do contrato.

    7.2 Se contrato é de Administração: 

             7.2.1 Realiza busca no objeto de Captação (Captacao_imovel__c) , com base na proposta

                      do contrato(Captacao_2__c).

             7.2.2 Caso encontre a Captação deve cancela-la: com as mesmas atualizações

                      de cancelamento do contrato.

ContratoRest.distratarContratoAdministracao()

Descrição: Método responsável por distrato de um contrato de administração (snap_brok__Contrato__c).

Neste método será possível encerrar um contrato de administração, sem possuir ainda um contrato de Locação criado. 

Deve ser utilizado, por exemplo, quando o cliente quer encerrar o contrato com a administradora, por ter desistido de locar o imóvel.

Método Rest: Post

Tipo de parâmetro: Contrato.

Tipo: Síncrono

Registros por requisição: 1

<instância do cliente> : nome de instância da org salesforce que o cliente utiliza. 

Processamento SnapProperty

                1. SnapProperty realiza busca em contratos(snap_brok__Contrato__c) com base

                    no Id ou Id externo informado.

                 2. Caso não encontrado contrato, retorna mensagem de erro informando que contrato não foi localizado.

                 3. Se não houver impedimento para o distrato o SnapProperty atualiza contrato: 

                      3.1 "Situação" (snap_brok__Situacao__c) do contrato para "Distratado".

                 4. Pesquisar todos Imóveis do contrato:

                      4.1 Altera a "Situação" (snap_brok__Situacao__c) do imóvel para  "Indisponível". 

                      4.2 Altera o campo "Disponível para locação"(snap_brok__Disponivel_locacao__c) para falso(false).

ContratoRest.desocuparImovel()

Descrição: Método responsável por desocupação de um imóvel pelo locatário (snap_brok__Contrato__c).

Neste método será possível desocupar um imóvel, que ocasionará no distrato do contrato de locação

e disponibilizar um imóvel para uma nova locação.

Método Rest: Post

Tipo de parâmetro: Contrato.

Tipo: Síncrono

Registros por requisição: 1

<instância do cliente> : nome de instância da org salesforce que o cliente utiliza. 

Processamento SnapProperty

                1. SnapProperty realiza busca em contratos(snap_brok__Contrato__c) com base

                    no Id ou Id externo informado.

 2. Caso não encontrado contrato, retorna mensagem de erro informando que contrato não foi localizado.

                3. Se não houver impedimento para a desocupação SnapProperty atualiza contrato de locação:

       3.1 "Situação"(snap_brok__Situacao__c) para "Encerrado".

       3.2 "Ativo" (snap_brok__Ativo__c) igual a falso(false).

       3.3 "Faturar" (snap_brok__Faturar__c) igual a falso(false).

       3.4 Atualiza "Valor do condomínio" (snap_brok__Valor_Condominio__c) para o valor recebido no request.

       3.5 Atualiza "Valor mensal do IPTU" (snap_brok__Valor_IPTU__c) para o valor recebido no request.  

       4.3 "Data de encerramento" igual a data do sistema(Today).

  4. Pesquisar todos Imóveis do contrato:

                      4.1 Altera a "Situação" (snap_brok__Situacao__c) do imóvel para  "Disponivel". 

                      4.2 Altera "Disponível para locação" para verdadeiro (true).               

ContratoRest.desocuparImovelComDistratoAdm()

Descrição: Método responsável por desocupação de um imóvel e término do contrato de administração(snap_brok__Contrato__c).

Neste método será possível desocupar um imóvel, que ocasionará no distrato do contrato de locação

e cancelará também o contrato de administração.

Método Rest: Post

Tipo de parâmetro: Contrato.

Tipo: Síncrono

Registros por requisição: 1

<instância do cliente> : nome de instância da org salesforce que o cliente utiliza. 

Processamento SnapProperty

                1. SnapProperty realiza busca em contratos(snap_brok__Contrato__c) com base

                    no Id ou Id externo informado.

 2. Caso não encontrado contrato, retorna mensagem de erro informando que contrato não foi localizado.

         3. Se não houver impedimento para a desocupação do imóvel e distrato do contrato de administração

              o SnapProperty atualiza contrato de locação:

       3.1 "Situação"(snap_brok__Situacao__c) para "Encerrado".

       3.2 "Ativo" (snap_brok__Ativo__c) igual a falso(false).

       3.3 "Faturar" (snap_brok__Faturar__c) igual a falso(false).

       3.4 "Data de encerramento" igual a data do sistema(Today).

  4. Pesquisar todos Imóveis do contrato:

                      4.1 Altera a "Situação" (snap_brok__Situacao__c) do imóvel para  "Indisponivel". 

                      4.2 Altera "Disponível para locação" para falso(false).

                  5. Pesquisa os contratos de administração dos Imóveis do contrato:

                      5.1 Altera Situação(snap_brok__Situacao__c) igual "Distratado".

Métodos de Envio

Métodos que tem como objetivo enviar requisições para a Imobiliar.

EnviarContratoAdministracao()

Descrição: Método responsável por enviar, após o término da captação,

o contrato de Administração criado para a Imobiliar.

O contrato de Administração deve ser enviado após ser atualizado para "Arquivado", pois sinaliza que está em vigor.

Método Rest: Post

Tipo: Síncrono

Registros por requisição: 1 

Processamento SnapProperty

                1. A trigger (after update) de Contrato seleciona o contrato que foi atualizado para "Arquivado".

                2. Trigger invoca método API_Imobiliar_Envio.enviarConta() informando o contrato selecionado.

                3. O método enviarContas() deve realizar os seguintes processamentos:

                     3.1 Realiza busca nos Participantes do contrato para obter todos os Participantes daquele contrato.

                     3.2 Realiza busca nos Depositários do contrato para obter todos os Depositários daquele contrato.

                     3.3 Remove possíveis duplicatas de contas entre depositários e participantes.

                     3.4 Com os dados das contas selecionados, realiza composição de payload JSON, para requisição a Imobiliar.

    Mapeamento de campos: Inserção de Conta/Pessoa

Obervação: O endereço deve ser enviado como uma lista.

Será enviado duas vezes para os endereços dos layouts de "Cliente pessoa física",

e uma vez para o endereço do layout de "Cliente pessoa jurídica".

3.5 Após compor o request, requisita o método exposto da API Imobiliar "Cadastro_Pessoa_Incluir", com o método rest Post

para incluir as contas.

3.6 Atualiza contas com os "Ids Externos" do sistema Imobiliar.

3.7 Executa método enviarImoveis().

4. O método enviarImoveis() deve realizar os seguintes processamentos: