SnapMall - CRM para administradores de shopping

Unidade (snap_mall__loja__c)

Owned by Estevão Fernandes (Deactivated)
Last updated: 18 May 2018 by Lilian Fanticelli (Deactivated)
3 min read

Representa uma unidade locatícia de um shopping (loja, quiosque, banner, etc.)

Para criação de uma Unidade Locatícia se faz necessário previamente possuir cadastrado na base : Shopping e Tipo de Unidade


Tipos de registro

Rótulo tipo de registro
Nome de API
Descrição 
LojaLoja
Locação temporáriaLocacao_temporaria
MerchandisingMerchandising

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


Campos de Unidade

Rótulo do campoNome de APITipo de dadoObrigatórioDescrição
ProprietárioOwnerPesquisa(Usuário,Fila)X
  • Id do usuário salesforce que será detentor do registro
  • Caso não preenchido será o usuário de integração
Tipo de registroRecordTypeIdXTipo de registro da Unidade  
UnidadeNameTexto(80)X
ABLsnap_mall__Area__cNúmero(10, 2)

Águasnap_mall__Agua__cBooleano

Opções possiveis:

  • true
  • false
Área de fachadasnap_mall__area_fachada__cNúmero(10, 2)

Ativasnap_mall__ativa__cBooleano

Atividade SAPsnap_mall__Atividade_sap__cPesquisa(Atividade
Id da atividade
Complementosnap_mall__Complemento__cTexto(10)

Contrato atualsnap_mall__Contrato_atual__cPesquisa(Contrato)
Id, para caso se aplique, pesquise por um contrato existente.
Corredorsnap_mall__corredor__cPesquisa(Corredor)

CRDsnap_mall__CRD__cPorcentagem(10, 4)

Data da inauguraçãosnap_mall__Data_inauguracao__cData
Apenas o número
Energiasnap_mall__Energia__cBooleano

Opções possíveis:

  • true
  • false
Grupo SAPsnap_mall__Grupo_sap__cPesquisa(Grupo)

ID Externosnap_mall__ID_Externo__cTexto(50)
Id informado para futuras alterações no registro
Inauguradasnap_mall__inaugurada__cBooleano

Opções possíveis:

  • true
  • false
KVA limitesnap_mall__Kva_limite__cNúmero(8, 0)

Locadasnap_mall__Alugada__cBooleano

Opções possíveis:

  • true
  • false
Localização geográficasnap_mall__Localizacao_geografica__cTexto(255)

Lojista anteriorsnap_mall__lojista_anterior__cPesquisa(Conta)
Id de uma conta existente 
Lojista atualsnap_mall__Cliente__cPesquisa(Conta)
Id de uma conta existente
Marca anteriorsnap_mall__marca_anterior__cPesquisa(Conta)
Id de uma conta existente
Marca atualsnap_mall__marca_atual__cPesquisa(Conta)
Id de uma conta existente
Parâmetro de aluguel por m2snap_mall__parametro_aluguel_m2__cMoeda(10, 2)

Parâmetro de CDU por m2snap_mall__parametro_cdu_m2__cMoeda(10, 2)

Pisosnap_mall__Piso__cPesquisa(Piso)

Preço de referênciasnap_mall__Preco_referencia__cMoeda(10, 2)

Rateio do condomíniosnap_mall__Rateio_condominio__cPorcentagem(12, 4)

Shoppingsnap_mall__shopping__cPesquisa(Shopping)

Situaçãosnap_mall__Situacao_Comercial__cLista de opções
  • Opções possíveis:
  • Assuntos especiais
  • Ativa
  • Com proposta
  • Contrato assinado
  • Contrato assinado pela empresa
  • Contrato assinado pelo lojista
  • Despejo
  • Em locação
  • Em prospecção
  • Nova proposta
  • Proposta aprovada
  • Prospecção
  • Repasse
  • Reserva técnica
  • Vaga
Subgrupo SAPsnap_mall__Subgrupo_sap__cPesquisa(Subgrupo)

Telefonia e internetsnap_mall__Telefonia_internet__cBooleano

Tipo de condomíniosnap_mall__tipo_condominio__cLista de opções 

Opções possíveis:

  • Fixo
  • Rateio
Tipo de FPsnap_mall__tipo_fp__cLista de opções

Opções possíveis:

  • 20% do AMM
  • Rateio
  • Fixo
  • 20% do AMM com limitador
Tipo de unidadesnap_mall__Tipo_unidade__cPesquisa(Tipo de unidade)

ULsnap_mall__UL__cTexto(18)

Unidade relacionadasnap_mall__Unidade_relacionada__cTexto(20)

Valor do aluguel atualsnap_mall__valor_aluguel_atual__cMoeda(10, 2)

Valor do CDU por m2snap_mall__valor_cdu_m2__cMoeda(10, 2)

Valor do condomínio por m2snap_mall__valor_condominio_m2__cMoeda(10, 2)

Valor do FP por m2snap_mall__valor_fp_m2__cMoeda(10, 2)

 Criar Loja:

                Método : POST

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

                Descrição: Método de criação de uma Unidade(snap_mall__loja__c) do tipo Loja, informando todos os campos utilizados por uma Loja.

Request
{
"Name":"Unidade I",
"RecordType":{"Name":"Loja"},
"snap_mall__Situacao_Comercial__c":"Vaga",
"OwnerId":"0051J000004ppUV",
"snap_mall__shopping__c":"a001J00001Kw3TI",
"snap_mall__Alugada__c":"true",
"snap_mall__Tipo_unidade__c":"a0g1J00000DHJmr",
"snap_mall__ativa__c":"true",
"snap_mall__inaugurada__c":"false",
"snap_mall__Area__c":"50",
"snap_mall__Piso__c":"a031J00000eeTp3QAE",
"snap_mall__area_fachada__c":"200000.12",
"snap_mall__Localizacao_geografica__c":"parcial",
"snap_mall__corredor__c":"a0P1J00000TXfLLUA1",
"snap_mall__valor_condominio_m2__c":"1000000",
"snap_mall__tipo_condominio__c":"Fixo",
"snap_mall__Rateio_condominio__c":"12",
"snap_mall__valor_fp_m2__c":"100000",
"snap_mall__parametro_cdu_m2__c":"1000887",
"snap_mall__Contrato_atual__c":"a071J00000PoB46QAF",
"snap_mall__marca_atual__c":"001o000000TcBeT",
"snap_mall__valor_aluguel_atual__c":"1200",
"snap_mall__Cliente__c":"0011J00001DwI9T",
"snap_mall__marca_anterior__c":"0011J00001DwICF",
"snap_mall__lojista_anterior__c":"0011J00001DtTOr",
"snap_mall__ID_Externo__c":"321456"
}
Response

{
"id": "a041J000018PuHqQAK",
"success": true,
"errors": []
}


 Criar Locação temporária:

                Método : POST

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

                Descrição: Método de criação de uma Unidade(snap_mall__loja__c) do tipo Locação temporária, informando todos os campos utilizados por uma Locação temporária.

Request
{
"Name":"Unidade II",
"RecordTypeId":"0121J000001DbQC",
"snap_mall__Unidade_relacionada__c":"Outra localizacao",
"OwnerId":"0051J000004ppUV",
"snap_mall__shopping__c":"a001J00001Kw3TI",
"snap_mall__Situacao_Comercial__c":"Vaga",
"snap_mall__Tipo_unidade__c":"a0g1J00000DHJmr",
"snap_mall__Alugada__c":"false",
"snap_mall__Complemento__c":"2° andar",
"snap_mall__ativa__c":"true",
"snap_mall__Grupo_sap__c":"a0E1J00000KdqA5UAJ",
"snap_mall__Subgrupo_sap__c":"a0H1J00000L0E2yUAF",
"snap_mall__Atividade_sap__c":"a0G1J00003FZCb7UAH",
"snap_mall__parametro_aluguel_m2__c":"1000",
"snap_mall__valor_condominio_m2__c":"1000000",
"snap_mall__Rateio_condominio__c":"12",
"snap_mall__Agua__c":"true",
"snap_mall__Energia__c":"false",
"snap_mall__Kva_limite__c":"3",
"snap_mall__Telefonia_internet__c":"false",
"snap_mall__Contrato_atual__c":"a071J00000PoB46QAF",
"snap_mall__marca_atual__c":"001o000000TcBeT",
"snap_mall__marca_anterior__c":"0011J00001DwICF",
"snap_mall__lojista_anterior__c":"0011J00001DtTOr",
"snap_mall__ID_Externo__c":"888888"
}
Response

{
"id": "a041J000018PuMAQA0",
"success": true,
"errors": []
}

Criar Merchandising:

               Método : POST

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

               Descrição: Método de criação de uma Unidade(snap_mall__loja__c) do tipo Merchandising, informando todos os campos utilizados por uma Merchandising.

Request
{
"Name":"Unidade I",
"RecordType":{"Name":"Merchandising"},
"snap_mall__Situacao_Comercial__c":"Vaga",
"OwnerId":"0051J000004ppUV",
"snap_mall__shopping__c":"a001J00001Kw3TI",
"snap_mall__Alugada__c":"false",
"snap_mall__Tipo_unidade__c":"a0g1J00000DHJmr",
"snap_mall__ativa__c":"false",
"snap_mall__Data_inauguracao__c":"2018-01-01",
"snap_mall__inaugurada__c":"true",
"snap_mall__Complemento__c":"complexo",
"snap_mall__Area__c":"50",
"snap_mall__Piso__c":"a031J00000eeTp3QAE",
"snap_mall__corredor__c":"a0P1J00000TXfLLUA1",
"snap_mall__Localizacao_geografica__c":"total",
"snap_mall__parametro_aluguel_m2__c":"100000",
"snap_mall__Agua__c":"true",
"snap_mall__Energia__c":"false",
"snap_mall__Kva_limite__c":"3",
"snap_mall__Telefonia_internet__c":"false",
"snap_mall__Contrato_atual__c":"a071J00000PoB46QAF",
"snap_mall__marca_atual__c":"001o000000TcBeT",
"snap_mall__Cliente__c":"0011J00001DtTOrQAN",
"snap_mall__marca_anterior__c":"0011J00001DwICF",
"snap_mall__lojista_anterior__c":"0011J00001DtTOr",
"snap_mall__ID_Externo__c":"777777"
}
Response

{
"id": "a041J000018PuMPQA0",
"success": true,
"errors": []
}

               Atualizar Unidade:

               Método : PATCH

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

               URI com ID externo: https://{{dominio}}/services/data/{{versao}}/sobjects/snap_mall__loja__c/snap_mall__ID_Externo__c/ (Id externo)

                Descrição: 

Método de atualização de uma unidade(snap_mall__loja__c)  de qualquer tipo, informando no body apenas os  campos que se deseja atualizar. Lembrando que devem ser     informados   apenas campos pertinentes ao tipo de registro escolhido (Loja, Locação temporária e Merchandising).

               Existem duas possibilidades de atualização da Unidade: Um com Id Salesforce o outro com o Id Externo, a diferenciação desta chamada vai ser na URI.

               O método PATCH pode ser utilizado par Upsert, em caso do Id externo informado não existir na base e contiver todos os campos obrigatórios no body.

Request
{
"Name":"Unidade I - Espetacúlo",
"snap_mall__ativa__c":"false"
}
Response

Response de atualização em caso de sucesso retorna vazio.

Deletar Unidade:

Método : DELETE

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

URI com ID externo: https://{{dominio}}/services/data/{{versao}}/sobjects/snap_mall__loja__c/snap_mall__ID_Externo__c/ (Id externo)

Descrição: Método de deleção de uma Unidade(snap_mall__ID_Externo__c) de qualquer tipo.  Existem duas possibilidades de deleção da Unidade: Um com Id Salesforce o outro com o Id Externo, a diferenciação desta chamada vai ser na URI.

Request

Body de deleção é vazio.

Response

Response de deleção retorna vazio.