Versions Compared

Old Version 1

changes.mady.by.user Ricardo Giglio (Deactivated)

Saved on

compared with

New Version 2

changes.mady.by.user Ricardo Giglio (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)
AreaLojaAreaLojaDespComumAreaLojaComMezanino
ÁguaÁrea despesa comumsnap_mall__AguaArea__cBooleano

Opções possiveis:

  • true
    • Nú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)
    		CRDDespComumData da
    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