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


Campos de Unidade

Rótulo do campoNome de APITipo de dadoObrigatórioGroup ShoppingDescriçã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 registroRecordTypeIdX
Tipo de registro da Unidade  
UnidadeNameTexto(80)XNumLoja
ABLsnap_mall__Area__cNúmero(10, 2)
AreaLoja
Área despesa comumsnap_mall__Area__cNúmero(10, 2)
AreaLojaDespComumEstamos enviando a mesma informação de ABL
Área com mezaninosnap_mall__Area__cNúmero(10, 2)
AreaLojaComMezaninoEstamos enviando a mesma informação de ABL
Á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)
CRDDespComum
CRD se vagasnap_mall__CRD__cPorcentagem(10, 4)
CRDSeVagaEstamos enviando a mesma informação de CRD
CRD co mezaninosnap_mall__CRD__cPorcentagem(10, 4)
CRDComMezaninoEstamos enviando a mesma informação de CRD
Data da inauguraçãosnap_mall__Data_inauguracao__cData

Apenas o número
Data de entradasnap_mall__Data_entrada__cData
DataEntrada
Data de desativaçãosnap_mall__Data_desativacao__cData
DataDesativacao
Energiasnap_mall__Energia__cBooleano

Opções possíveis:

  • true
  • false
Fase


Fase
Grupo SAPsnap_mall__Grupo_sap__cPesquisa(Grupo)


ID Externosnap_mall__ID_Externo__cTexto(50)
ChaveExternaId 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)
Localizacao
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)
Nivel
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)
IdFilial
Situaçãosnap_mall__Situacao_Comercial__cLista de opçõesX
  • 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
Subgruposnap_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)XTipoDeLoja
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.

Este artigo identifica e descreve os módulos do SnapMall que podem ser integrados com outros sistemas.

Integração de faturas

  • No labels