Histórico da Página

1. Alteração de jornada:

       2. O que fazer?

Desenvolver integração de para consulta e utilização de saldo de limite de crédito com a retaguarda

...

Por que fazer?

3. Tabelas e campos novos - PDV Omni

3.1 Tabela: pagamento_forma

3.2 Tabela: loja

4. Definição de contratos de API:

4.1 Contrato de consulta de limite de crédito 

• Endpoint: /api/pdvsyncserver/retaguarda/v2/processoonlinelimitecredito/{IdInquilino}/{IdRetaguardaLoja}
• Método: Get
• Autenticação: Bearer token
• Permissão: Client

Request:

Response:

Exemplos

Sucesso:

{
  "success": true,
  "message": null,
  "limitesCredito":
  [
    {
      "saldo": 1000.00 ,
      "idRetaguardaLimiteCredito": null
    }
  ]
}

Erro:

{
  "success": false,
  "message": "Cliente com XPTO não encontrado na base de dados da retaguarda"
}

4.2 Contrato de consulta de limite de crédito detalhado 

• Endpoint: /api/pdvsyncserver/retaguarda/v2/processoonlinelimitecreditodetalhes/{IdInquilino}/{IdRetaguardaLoja}
• Método: Get
• Autenticação: Bearer token
• Permissão: Client

Request:

Response:

...

Exemplos

Sucesso:

{
  "success": true,
  "message": null,
  "limitesCredito":
  [
    {
      "saldoDisponível": 1000.00,
      "idRetaguardaLimiteCredito": null,
      "valorUtilizado": 3000.00,
      "valorTotal": 4000.00,
      "DetalhesValorUtilizado":
      [
        {
          "":1000.00
          "tipo": "Contas a receber"
        },
        {
          "total":2000.00
          "tipo": "Pedidos a faturar"
        }
      ]
    }
  ]
}

Erro:

{
  "success": false,
  "message": "Não foi possível encontrar limite de crédito para o cliente selecionado."
}

4.3 Contrato descida de dado forma de pagamento

• 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 data do payload, conforme exemplo abaixo:
    • Image Added
      • 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.

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:
    • Image Added

4.5 Contrato utilização de saldo 

4.6 Contrato cancelamento de venda 

5. Premissas:

6. Restrições:

7. Pontos de atenção: 

• desenvolvimento na issue

  Jira
  server JIRA serverId 0c783de1-186e-383b-975c-a1acd7d76cb5 key DPDVSUPER-2560

  onde para calcular o valor do limite de crédito disponível, deverá ser feito da seguinte forma
  • (Limite de Crédito *  % Exceção) - Valor títulos em aberto - Valor venda pendente
• Para QA, considerar:
  • cenários com e sem parâmetro da finalizadora (132)
  • cenários com cliente não cadastrado
  • cenários de limite de crédito de cliente:
    • cenários de margem da 132 (% máximo para exceder limite de crédito) passando e nao passando o limite
    • cenários de limite por cobrança 
    • cenários com titulo em aberto passando e nao passando o limite
    • cenários com venda pendente passando e nao passando o limite
    • cenários com cliente válido com a venda aberta
    • cenários com cliente válido com a venda fechada
    • cenários com cliente com saldo negativo
  • cenários de limite de crédito de cliente principal:
    • cenários de margem da 132 (% máximo para exceder limite de crédito) passando e não passando o limite
    • cenários de limite por cobrança 
    • cenários com titulo em aberto passando e não passando o limite
    • cenários com venda pendente passando e não passando o limite
    • cenários com cliente principal válido com a venda aberta
    • cenários com cliente principal válido com a venda fechada
    • cenários com cliente principal com saldo negativo
    • Cenários com limite de crédito com saldo com mais de 7 digitos 
  • comparar cenários com a 2030
• verificar o fluxo para não validação do limite para cartão (crédito, débito, etc)
• verificar qual parâmetro habilita o limite de crédito na cobrança no PDV e no Pedido: "Validar Limite de Crédito ECF" ou "Validar Limite de crédito", conforme 522