Histórico da Página
...
| draw.io Diagram | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Dores e necessidades | Efetuar a consulta de limite de crédito |
Negócio | No PDV e Pedido deve ser possível efetuar a consulta do saldo de crédito disponível para exibição em tela para o usuário |
Entrega de valor | usuário poderá consultar no sistema PDV Omni o saldo de crédito disponível para o consumidor no momento da venda |
...
4.1 Contrato de consulta de limite de crédito crédito online
- Endpoint: /api/pdvsyncserver/retaguarda/v2/processoonlinelimitecredito/{IdInquilino}/{IdRetaguardaLoja}
- Método: Get
- Autenticação: Bearer token
- Permissão: Client
...
4.2 Contrato de consulta de limite de crédito detalhado detalhado online
- Endpoint: /api/pdvsyncserver/retaguarda/v2/processoonlinelimitecreditodetalhes/{IdInquilino}/{IdRetaguardaLoja}
- Método: Get
- Autenticação: Bearer token
- Permissão: Client
...
- Adicionar o atributo "utilizaLimiteCredito" na API de POST de forma de pagamento (v3.2) - Forma de pagamento#2612513
- O atributo novo deve ser criado direto na no data do payload, conforme exemplo abaixo:
- O novo campo será opcional e booleano.
- O default desse campo será falso
- Caso a retaguarda/erp não envie esse campo, o mesmo será considerado false para o Sync e o PDV.
- O default desse campo será falso
- O novo campo será opcional e booleano.
- O atributo novo deve ser criado direto na no data do payload, conforme exemplo abaixo:
...
4.4 Contrato descida de dado tabela loja
- Adicionar o atributo "limiteCreditoFormaPagamento" na API de POST de loja (v3.2) - Cadastro de Loja#Vers%C3%A3o3.2
- O atributo novo deve ser criado direto na data do payload, conforme exemplo abaixo:
- O atributo novo deve ser criado direto na data do payload, conforme exemplo abaixo:
Campo | Tipo | Descrição | Obrigatório | Campo PDV | Observação |
|---|---|---|---|---|---|
| limiteCreditoFormaPagamento | bool | Indica se a loja trabalha com limite de crédito por forma de pagamento. | Não | Tabela - loja |
...
campo - limite_credito_forma_pagamento |
|
4.5 Contrato de consulta de limite de crédito por forma de pagamento online
- Endpoint: /api/pdvsyncserver/retaguarda/v2/processoonlinelimitecredito/{IdInquilino}/{IdRetaguardaLoja}
- Método: Get
- Autenticação: Bearer token
- Permissão: Client
Request:
Campo | Tipo | Descrição | Tipo Parâmetro | Obrigatório | Observação |
|---|---|---|---|---|---|
| IdInquilino | string | Identificador do Inquilino | Parameter/Path/Query Params | *Sim | *Usado apenas pelo PDV. Retaguarda não precisa criar API com esse parâmetro, pois o Sync já irá direcionar para o IP correto. |
| IdRetaguardaLoja | string | Identificador da loja na retaguarda | Parameter/Path/Query Params | Sim | |
| cpfCnpj | string | Documento do cliente | Header | Sim | |
| limitePgamentoForma | bool | Indica se a solicitação de limite de crédito deve ser retornada por tipo de forma de pagamento ou não. | Header | Não | Caso o parâmetro não seja enviado, o default desse parâmetro será false. Caso seja true, o retorno da retaguarda será de limite de crédito por tipo de forma de pagamento. |
Response:
Campo | Tipo | Descrição | Obrigatório | Observação |
|---|---|---|---|---|
| success | bool | Indica se a consulta de limite de crédito ocorreu corretamente | Sim | Exemplo: Se o cliente não foi encontrado, deve ser retornado "false", pois a partir disso o PDV sabe que não haverá objeto de limite de crédito para exibir e sim apenas a mensagem justificando a ausência efetiva do limite de crédito. |
| message | string | Mensagem de retorno de erros | Não | Sempre que possível em caso de erro justificar o erro nesse campo. |
| limitesCredito | Lista de objetos | Lista com dos limites de créditos retornados | Não | Deve ser enviado sempre que houver retorno de true no atributo "success". |
| limitesCredito.saldoDisponivel | double | Saldo do crédito disponível | Não | Deve ser enviado sempre que houver retorno de true no atributo "success". |
| limitesCredito.idRetaguardaLimiteCredito | string | Identificador do limite de crédito caso exista | Não | |
| limitesCredito.saldoDetalhadoFormaPagamento | Lista de objetos | Lista com os limites de créditos retornados por forma de pagamento | Não | Deve ser enviado sempre que for solicitada na requisição no atributo o atributo "limitePgamentoForma" como true e o valor do saldo for maior que zero. |
| limitesCredito.saldoDetalhadoFormaPagamento.valor | double | Valor por forma de pagamento do limite de crédito | Não | Deve ser enviado sempre que for solicitada na requisição no atributo o atributo "limitePgamentoForma" como true e o valor do saldo for maior que zero. |
| limitesCredito.saldoDetalhadoFormaPagamento.idRetaguardaPagamentoForma | string | idRetaguarda relacionado ao tipo de forma de pagamento disponível para o limite de crédito. | Não |
|
Exemplos
Sucesso:
{
"success": true,
"message": null,
"limitesCredito":
[
{
"saldo": 1000.00 ,
"idRetaguardaLimiteCredito": null
"saldoDetalhadoFormaPagamento":
[
{
"valor": 500.00,
"idRetaguardaPagamentoForma": "BL"
},
{
"valor": 500.00,
"idRetaguardaPagamentoForma": "CH"
}
]
}
]
}
Erro:
{
"success": false,
"message": "Cliente com XPTO não encontrado na base de dados da retaguarda"
}
4.6 Contrato de consumo/cancelamento de utilização de limite de crédito - INCOMPLETO - NÃO UTILIZAR
- Endpoint: /api/pdvsyncserver/retaguarda/v2/processoonlinelimitecredito
- Método: POST
- Autenticação: Bearer token
- Permissão: Client
Request:
Campo | Tipo | Descrição | Tipo Parâmetro | Obrigatório | Observação |
|---|---|---|---|---|---|
| IdInquilino | string | Identificador do Inquilino | Parameter/Path/Query Params | *Sim | *Usado apenas pelo PDV. Retaguarda não precisa criar API com esse parâmetro, pois o Sync já irá direcionar para o IP correto. |
| IdRetaguardaLoja | string | Identificador da loja na retaguarda | Parameter/Path/Query Params | Sim | |
| cpfCnpj | string | Documento do cliente | Header | Sim | |
| limitePgamentoForma | bool | Indica se a solicitação de limite de crédito deve ser retornada por tipo de forma de pagamento ou não. | Header | Não | Caso o parâmetro não seja enviado, o default desse parâmetro será false. Caso seja true, o retorno da retaguarda será de limite de crédito por tipo de forma de pagamento. |
{
"idInquilino": "123",
"limitePgamentoForma": true
"Limitescredito": [
{
"cpfCnpj": "45512547836",
"idRetaguardaLimiteCredito": "",
"idRetaguardaLojaBaixa": "",
"idRetaguardaUsuario": "12569",
"saldoDetalhadoFormaPagamento": [
{
"valor": 500.00,
"idRetaguardaPagamentoForma": "BL"
},
{
"valor": 500.00,
"idRetaguardaPagamentoForma": "CH"
}
],
"valorTotalBaixa": 1000.00
}
],
"idRetaguardaoperador": "125610",
"motivo": "Consumo Limite crédito PDV",
"numeroCaixa": "01",
"numeroVenda": "1",
"origemPDV": "PDVOmni",
"serieVenda": "1",
"tipoOperacao": "0"
}
4.5 Contrato utilização de saldo
4.6 Contrato cancelamento de venda
5. Premissas:
6. Restrições:
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas