SnapMall - CRM para administradores de shopping

Período do contrato (snap_mall__periodo_contrato__c)

O objeto Período do contrato (snap_mall__periodo_contrato__c) contém todas as informações de cadastro do período do contrato.

Possuem dois tipos de contrato (Tipo de registro), que terão suas particulares obrigatoriedades, e que serão delimitados seus métodos individualmente.

Para criação de um Período do contrato se faz necessário previamente possuir cadastrado na base : Contrato

Tipos de registro

Rótulo tipo de registro
Nome de API
Locação Temporária
Leasing

Está informação dos tipos de registros é importante, pois para o cadastro e atualização de cada contrato, dependendo do tipo de registro existem diferentes campos a serem obrigatoriamente informados,e campos que podem ser informados ou não. 

Campos de Período do contrato

Rótulo de campoNome de APIDescriçãoObrigatórioDescrição
Contratosnap_mall__contrato__cDetalhes do mestre(Contrato)XID do contrato cadastrado no objeto contrato
Criado porCreatedByIdPesquisa(Usuário)XPreenchimento automático com o usuário de sistema que realizou a criação do cadastro ou usuário da integração
Ordemsnap_mall__ordem__cNúmero(2, 0)XInformação da ordem do período 
PeríodoNameTexto(80)XInformação de identificação do período 
Tipo de condomíniosnap_mall__tipo_condominio__cLista de opções

Tipo de cálculosnap_mall__tipo_calculo__cLista de opções

Tipo de fundo de promoçãosnap_mall__tipo_fundo_promocao__cLista de opções

Tipo de registroRecordTypeIdTipo de registroX

ID do Tipo de registro ou Nome de API do tipo de registro *

Necessário informar o tipo de registro no cadastro

Tipo valor do aluguelsnap_mall__tipo__cLista de opçõesX

Lista do tipo de valor de aluguel

Opções disponiveis

  • m2
  • Total
Valor do aluguel %snap_mall__valor_aluguel_percentual__cPorcentagem(10, 4)
Informação do % do valor do aluguel
Valor do AMMsnap_mall__valor_amm__cFórmula (Moeda)

Valor do AMMsnap_mall__Valor_amm_locacao_temporaria__cMoeda(10, 2)
Informação do valor do AMM
Valor do AMM/m2snap_mall__valor_amm_m2__cMoeda(10, 4)

Valor do CTOsnap_mall__valor_cto__cFórmula (Moeda)

Valor do CTO %snap_mall__valor_cto_percentual__cPorcentagem(10, 4)

Valor do CTO/m2snap_mall__valor_cto_m2__cMoeda(10, 4)

Valor fixo do condomíniosnap_mall__valor_fixo_condominio__cMoeda(10, 2)XInformação do valor fixo de condomínio
Valor fixo do fundo de promoçãosnap_mall__valor_fixo_fundo_promocao__cMoeda(10, 2)

Valor fixo totalsnap_mall__valor_fixo_total__cMoeda(16, 2)XInformação do valor fixo total
Última modificação feita porLastModifiedByIdPesquisa(Usuário)XInformação do usuário de sistema que realizou a ultima modificação ou usuário da integração
  • Apesar de existir dois tipos de registros de Períodos os campos informados são os mesmos, a diferença deve ser no RecordType para diferenciação de Locação Temporária e Leasing.

Criar Período do contrato:

                Método : POST

                URI: https://{{dominio}}/services/data/{{versao}}/sobjects/snap_mall__periodo_contrato__c/

                Descrição: Método de criação de um Período do contrato(snap_mall__periodo_contrato__c), informando todos os campos utilizados por um período do contrato.

Request
{
"Name":"Intermédio",
"snap_mall__contrato__c":"a07o00000024EPz",
"snap_mall__ordem__c":"2",
"snap_mall__Valor_amm_locacao_temporaria__c":"16000.00",
"snap_mall__valor_aluguel_percentual__c":"3",
"snap_mall__valor_fixo_condominio__c":"23000.00",
"snap_mall__valor_fixo_total__c":"23000.00"
}
Response
{
"id": "a0T1J00000ACBnNUAX",
"success": true,
"errors": []
}

Atualizar Período do contrato:

               Método :PATCH

               URI com ID salesforce:https://{{dominio}}/services/data/{{versao}}/sobjects/snap_mall__periodo_contrato__c/ (Id do registro salesforce)

               Descrição: 

Método de atualização de um Período (snap_mall__periodo_contrato__c) , informando no body apenas os  campos que se deseja atualizar. 

Request
{
"Name":"Intermédio",
"snap_mall__ordem__c":"3"
}
Response

Response em caso de sucesso da atualização retornará vazio.

Deletar Período do contrato:

Método : DELETE

URI com ID salesforce: https://{{dominio}}/services/data/{{versao}}/sobjects/snap_mall__periodo_contrato__c/ (Id do registro salesforce)

Descrição: Método de deleção de um Período do contrato(snap_mall__periodo_contrato__c) de qualquer tipo.


Request

Body de deleção é vazio.

Response

Response de deleção retorna vazio.