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 Campo | Nome de API | Tipo de dados | Obrigatório | Descrição |
|---|---|---|---|---|
| Contrato | snap_mall__Contrato__c | Pesquisa(Contrato) | X | ID do contrato cadastrado no objeto contrado |
| Criado por | CreatedById | Pesquisa(Usuário) | X | ID usuário de sistema salesforce ou usuário da integração |
| Data da venda | snap_mall__Data_venda__c | Data | X | Informação da data da venda |
| ID Externo | snap_mall__ID_Externo__c | Texto(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 | |
| Lojista | snap_mall__Lojista__c | Pesquisa(Conta) | X | ID da conta cadastrado no objeto conta |
| Marca | snap_mall__Marca__c | Pesquisa(Conta) | X | ID da arca cadastrado no objeto conta |
| Produto | snap_mall__Loja__c | Pesquisa(Unidade) | X | ID da unidade locaticia cadastrado no objeto unidade |
| Proprietário | OwnerId | Pesquisa(Usuário,Grupo) | ID do usuário de sistema salesforce | |
| Shopping | snap_mall__Shopping__c | Pesquisa(Shopping) | X | ID do shopping cadastrado no objeto Shopping |
| Tipo de venda | snap_mall__Tipo_venda__c | Pesquisa(Tipo de venda) | X | ID do tipo de venda cadastrado no objeto Tipo de venda |
| Valor das vendas | snap_mall__Valor_vendas__c | Moeda(14, 2) | X | Informação do valor da venda |
| Venda | Name | Numeração automática | X | Preenchimento automático de identificação do lançamento de vendas |
| Última modificação feita por | LastModifiedById | Pesquisa(Usuário) | X | Informaçã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 Conta:
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.