Versions Compared

Old Version 4

changes.mady.by.user Estevão Fernandes (Deactivated)

Saved on

compared with

New Version 5

changes.mady.by.user Estevão Fernandes (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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__despesa_comum__cNúmero(10, 2)
AreaLojaDespComum
Área com mezaninosnap_mall__Area__mezanino__cNúmero(10, 2)
AreaLojaComMezanino
Á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
  • Deverá neste campo ser informado o Id do nível no sistema GShop
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}}apexrest/v1/sobjects/snap_mall__loja__c/criarLoja

                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.


 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
Request
{"loja":[
{
"Name":"Unidade
I
EFO - Teste - 1",
"RecordType":{"Name":"Loja"},
"snap_mall__Situacao_Comercial__c":"Vaga",
"
OwnerId":"0051J000004ppUV",
"
snap_mall__shopping__c":
{"snap_mall__ID_Externo__c":"123456"}
"40028922",
"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
40",
"snap_mall__Piso__c":{
"snap_mall__
ID_Externo__c":"3345678"},
"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": []
}

Telefonia_internet__c":"false",
"snap_mall
_
_
valor
_
condominio_m2__c":"1000000",
"snap_mall__
Rateio_condominio__c":"12",
"snap_mall__
Agua
valor_
_c":"true",
"snap_mall__Energia__
fp_m2__c":"
false
100000",
"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
Energia__c":"
true
false",
"snap_mall__
Complemento
Kva_
_c":"complexo",
"snap_mall__Area_
limite__c":"
50
3",
"snap_mall__
Piso
Complemento__c":"
a031J00000eeTp3QAE
complexo",
"snap_mall__
corredor__c":"a0P1J00000TXfLLUA1",
"snap_mall__Localizacao_geografica__c":"total",
"snap_mall__parametro_aluguel
parametro_cdu_m2__c":"
100000
1000887",
"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_
valor_aluguel_atual__c":"
a071J00000PoB46QAF
3200",
"snap_mall__
marca
ID_
atual
Externo__c":"
001o000000TcBeT
421456",
"snap_mall__
Cliente
corredor__c":"
0011J00001DtTOrQAN
40028922",
"snap_mall__
marca_anterior
Piso__c":"
0011J00001DwICF
40028922"
,
"snap_mall__lojista_anterior__c":"0011J00001DtTOr",
"snap_mall__ID_Externo__c":"777777"

}
]
}



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


Response

{
"idsucess" : "a041J000018PuMPQA0"false,
"successid" : truenull,
"errors" : [ ]
}

               Atualizar Unidade:

               Método : PATCH

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

"Insert failed. First exception on row 0; first error: DUPLICATE_VALUE, duplicate value found: 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

duplica o valor no registro com ID: a0Q0q000000uOCC: []" ] }