SnapMall - CRM para administradores de shopping

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

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__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.

  • No labels