1. Alteração de jornada:

       2. O que fazer?

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

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 online

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

Request:

Response:

Exemplos

Sucesso:

{
    "data": [
        {
            "idRetaguardaLimiteCredito": null,
            "saldoDisponivel": 1000.0
        }
    ],
    "detailedMessage": null,
    "errors": null,
    "message": "",
    "numberOfRecords": 0,
    "success": true,
    "totalTime": 0
}

Erro:

{
    "success": false,
    "message": "Cliente com XPTO não encontrado na base de dados da retaguarda",
    "detailedmessage": "",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

4.2 Contrato de consulta de limite de crédito detalhado online

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

Dúvidas:

•  Levantadas pelo time Sync
  • Não é importante ter a data ou o período considerado para trazer os "detalhes" do que esta compondo o limite de crédito ?
  • O nome da da API como detalhes não esta muito sugestivo a um extrato ?
    • O nome não poderia ser processoonlinelimitecreditosintetico ?

Request:

Response:

Exemplos

Sucesso:

{
  "success": true,
  "message": "",
    "detailedMessage": null,
    "data": [
        {
            "saldoDisponivel": 800.0,
            "idRetaguardaLimiteCredito": "01PSH00000005033CR",
            "valorUtilizado": 264.0,
            "valorTotal": 372.0,
            "detalhesValorUtilizado": [
                {
                    "total": 532.0,
                    "tipo": "credito total"
                }
            ]
        }
    ],
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Erro:

{
  "success": false,
  "message": "Não foi possível encontrar limite de crédito para o cliente selecionado.",
  "detailedmessage": "",
  "data": null,
  "errors": null,
  "totalTime": 0,
  "numberOfRecords": 0
}

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 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.

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

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:

Response:

Exemplos

Sucesso:

{
    "data": [
        {
            "idRetaguardaLimiteCredito": null,
            "saldoDisponivel": 1000.0,
            "saldoDetalhadoFormaPagamento": [
                {
                    "idRetaguardaPagamentoForma": "BL",
                    "valor": 500.0
                },
                {
                    "idRetaguardaPagamentoForma": "CH",
                    "valor": 500.0
                }
            ]
        }
    ],
    "detailedMessage": null,
    "errors": null,
    "message": "",
    "numberOfRecords": 0,
    "success": true,
    "totalTime": 0
}

Erro:

{
    "success": false,
    "message": "Cliente com XPTO não encontrado na base de dados da retaguarda",
    "detailedMessage": null,
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

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:

{
    "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"
}

5. Premissas:

6. Restrições:

Nessa primeira versão não está sendo previsto o desenvolvimento de integração de pedidos com status de analise de credito, para o fluxo financeiro ode é feita a analise e liberação de limite de credito sobre pedidos pendentes. 

7. Pontos de atenção: 

• desenvolvimento na issue DPDVSUPER-2560 - Obtendo detalhes do item... STATUS 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