SnapMall - CRM para administradores de shopping

Fatura (snap_mall__Fatura__c)

O objeto Fatura (snap_mall__Fatura__c) contém todas as informações de cadastro da fatura.

Para criação de uma Fatura se faz necessário previamente possuir cadastrado na base : Shopping, Contrato, Conta e Unidade.

Campos de Fatura

Rótulo do campoNome de APITipo de dadosObrigatórioDescrição
Contratosnap_mall__Contrato__cPesquisa(Contrato)XID do contrato cadastrado no objeto contrato
Criado porCreatedByIdPesquisa(Usuário)XPreenchimento automático com o usuário de sistema que realizou a criação do cadastro ou usuário da integração
Data da faturasnap_mall__Data_fatura__cDataXInformação da data de emissão da fatura
Data de pagamentosnap_mall__Data_pagamento__cData
Informação da data de pagamento da fatura
Data de vencimentosnap_mall__Data_vencimento__cDataXInformação da data de vencimento da fatura
FaturaNameNumeração automáticaX
Preenchimento automático no momento da geração da fatura
ID externosnap_mall__ID_externo__cTexto(50) (ID externo) (Não-diferenciação exclusiva de maiúsculas e minúsculas)
ID do sistema ERP, que poderá ser informado no momento da inserção da conta, para futuras atualizações, através deste Id.
Locatáriosnap_mall__Locatario__cPesquisa(Conta)XID locatário cadastrado no objeto Conta
Marcasnap_mall__Marca__cPesquisa(Conta)
ID marca cadastrada no objeto Conta
ProprietárioOwnerIdPesquisa(Usuário,Grupo)
ID usuário de sistema salesforce
Shoppingsnap_mall__Shopping__cPesquisa(Shopping)XID shopping cadastrado no objeto shopping
Situaçãosnap_mall__Situacao__cLista de opçõesX

Lista de opções com a situação do fatura

Opções disponíveis

  • Pendente
  • Paga
  • Cancelada
Unidadesnap_mall__Produto__cPesquisa(Unidade)XID unidade locaticia cadastrado no objeto unidade
Valor da faturasnap_mall__Valor_fatura__cMoeda(14, 2)XInformação do valor da fatura
Valor da multasnap_mall__Valor_multa__cMoeda(14, 2)
Informação do valor da multa
Valor de jurossnap_mall__Valor_juros__cMoeda(14, 2)
Informação do valor de juros
Valor do descontosnap_mall__Valor_desconto__cMoeda(14, 2)
Informação do valor do desconto
Valor pagosnap_mall__Valor_pago__cMoeda(14, 2)
Informação do valor pago
Ú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 Fatura:

                 Método : POST

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

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

Request
{
"OwnerId":"0051J000004ppUV",
"snap_mall__Locatario__c":"001o0000005y8pP",
"snap_mall__Shopping__c":"a00o0000002HuOr",
"snap_mall__Contrato__c":"a07o00000024EPz",
"snap_mall__Produto__c":"a04o000000LQUXS",
"snap_mall__Situacao__c":"Pendente",
"snap_mall__Marca__c":"001o0000005y8pP",
"snap_mall__ID_externo__c":"123456789",
"snap_mall__Tipo_unidade_planejamento__c":"a0q1J000004xLUV",
"snap_mall__Data_fatura__c":"2017-09-04",
"snap_mall__Data_vencimento__c":"2017-09-04",
"snap_mall__Data_pagamento__c":"2017-09-04"
}
Response

{
"id": "a0f1J00000ALCEoQAP",
"success": true,
"errors": []
}

Atualizar Fatura:

               Método :PATCH

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

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

               Descrição: 

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

               Existem duas possibilidades de atualização da Fatua: 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__Situacao__c":"Paga"
}

Response

Response de atualização em caso de sucesso retorna vazio.


Deletar Fatura:

Método : DELETE

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

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

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