SnapMall - CRM para administradores de shopping

Venda (snap_mall__Venda__c)

O objeto Venda (snap_mall__Venda__c) contém todas as informações de lançamentos de vendas diárias

Para criação de um lançamento de venda se faz necessário previamente possuir cadastrado na base : Conta, Contrato, Shopping, Unidade e Tipo de venda

Campos de Venda

Rótulo do CampoNome de APITipo de dadosObrigatórioDescrição
Contratosnap_mall__Contrato__cPesquisa(Contrato)XID do contrato cadastrado no objeto contrado
Criado porCreatedByIdPesquisa(Usuário)XID usuário de sistema salesforce ou usuário da integração
Data da vendasnap_mall__Data_venda__cDataXInformação da data da venda
ID Externosnap_mall__ID_Externo__cTexto(40) (ID externo)
ID do sistema ERP, que poderá ser informado no momento da inserção da conta, para futuras atualizações, através deste ID
Lojistasnap_mall__Lojista__cPesquisa(Conta)XID da conta cadastrado no objeto conta
Marcasnap_mall__Marca__cPesquisa(Conta)XID da arca cadastrado no objeto conta
Produtosnap_mall__Loja__cPesquisa(Unidade)XID da unidade locaticia cadastrado no objeto unidade
ProprietárioOwnerIdPesquisa(Usuário,Grupo)
ID do usuário de sistema salesforce
Shoppingsnap_mall__Shopping__cPesquisa(Shopping)XID do shopping cadastrado no objeto Shopping
Tipo de vendasnap_mall__Tipo_venda__cPesquisa(Tipo de venda)XID do tipo de venda cadastrado no objeto Tipo de venda
Valor das vendassnap_mall__Valor_vendas__cMoeda(14, 2)XInformação do valor da venda
VendaNameNumeração automáticaXPreenchimento automático de identificação do lançamento de vendas
Última modificação feita porLastModifiedByIdPesquisa(Usuário)XInformação do usuário de sistema que realizou a ultima modificação ou usuário da integração

 Criar Venda:

                 Método : POST

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

                 Descrição: Método de criação de uma Venda(snap_mall__Venda__c), informando todos os campos utilizados para uma Venda.

Request
{
"OwnerId":"0051J000004ppUV",
"snap_mall__Tipo_venda__c":"a0e1J00000Vtmly",
"snap_mall__ID_Externo__c":"123456789",
"snap_mall__Contrato__c":"a07o00000024EPz",
"snap_mall__Shopping__c":"a00o0000002HuOr",
"snap_mall__Loja__c":"a04o000000LQUXS",
"snap_mall__Marca__c":"001o0000005y8pP",
"snap_mall__Lojista__c":"001o0000005y8pP",
"snap_mall__Data_venda__c":"2033-01-01",
"snap_mall__Valor_vendas__c":"230000.00"
}
Response
{
"id": "a0d1J000004kZVJQA2",
"success": true,
"errors": []
}

Atualizar Venda:

               Método : PATCH

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

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

               Descrição: 

Método de atualização de uma Venda(snap_mall__Venda__c)  de qualquer tipo, informando no body apenas os  campos que se deseja atualizar. 

        Existem duas possibilidades de atualização da Venda: 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
{
"snap_mall__Data_venda__c":"2034-01-01",
"snap_mall__Valor_vendas__c":"250000.00"
}
Response

Response em caso de sucesso da atualização retornará vazio.

Deletar Venda:

Método : DELETE

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

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

Descrição: Método de deleção de uma Venda(snap_mall__Venda__c) de qualquer tipo.  Existem duas possibilidades de deleção da Venda : 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.