Objetivo

Este documento tem como objetivo explicar o funcionamento de reserva de estoque do PDVSync. 

Pré-Requisitos e Restrições

• Necessário a instalação do  serviço winthor-integracao-matcon 
• Para reservar o estoque o campo situacaoPreVenda deve está igual a DISPONIVEL.
• Caso o atributo "idOperadorRetaguarda" não seja enviado na requisição, a API consultará o RCA definido no parâmetro "4012 - Código do RCA para cadastro de clientes" da rotina 132- Parâmetros da Presidência.
• A tabela PCLOGPEDIDOAPI, é responsável por guardar os retornos dos pedidos importados via integração, sendo Operação (I - inclusão, A - alteração, C - cancelamento) e Status (A - Aceito, R - Rejeitado, P - Processando).
• No envio do JSON deve-se enviar no campo  preVendaItens.idProdutoRetaguarda o código auxiliar seguido do código do produto. Exemplo: 100-1. Lembrando que o IdRetaguarda dos produtos na base do PDV já seguem esse padrão e são enviadas pelo WSH assim.
• No atributo preVendaItens.entrega.idLojaEntregaRetaguarda deverá constar a filial de onde será realizada a retirada da mercadoria;
• API criada com base da documentação fornecida pelo PDVSync: https://pdvsync-core-controle-dev-aadivv24nq-ue.a.run.app/swagger/index.html?urls.primaryName=V2
• Caso o cadastro do cliente esteja completo o cliente já vai ser inserido neste processo de reserva de estoque, porém a alteração de dados do cadastro do cliente só será possível no envio do pedido pago.
• Ao enviar o cliente, será validado o parâmetro  4672 - Aceita validar CEP online nas APIs do WinThor da rotina 132 permite validar se o CEP informado está valido em API terceiros (ViaCEP e ByJG). Caso falso, essa validação não ocorrerá. O padrão do parâmetro é "Sim";
• Para alterar a reserva, basta enviar o json completo da reserva considerando a alteração realizada (inclusão de item, exclusão de item, adição ou subtração de quantidades de um item, etc), e o número da reserva gerada inicialmente no campo idRetaguarda. Internamente, a api irá cancelar a reserva gerada inicialmente e realizará uma nova reserva. O número da nova reserva será retornado no campo idPedidoRetaguarda do response;

• Para gravação do campo PCPEDC.CODCOB.

  - Se no JSON estiver vazio o campo "vendaPagamentos.pagamentoForma.idRetaguarda" a API vai buscar na base de dados na tabela PCCOB.CODCOB = 'D' a cobrança default e caso ele não exista vai retornar uma validação.
  - Se no JSON estiver preenchido o campo "vendaPagamentos.pagamentoForma.idRetaguarda" a API vai buscar na base de dados na tabela PCCOB.CODCOB a cobrança enviada e caso ele não exista vai retornar uma validação.
  - Se no JSON estiver vazio o campo "vendaPagamentos.pagamentoForma.idRetaguarda" e o parâmetro CODCOBPADRAORESERVAINT estiver preenchido com a cobrança default a API vai inserir o que estiver no CODCOBPADRAORESERVAINT no pedido.
  - Se no JSON estiver preenchido o campo "vendaPagamentos.pagamentoForma.idRetaguarda" e o parâmetro CODCOBPADRAORESERVAINT estiver preenchido com a cobrança default a API vai inserir o que estiver no CODCOBPADRAORESERVAINT no pedido.

• Para gravação do campo PCPEDC.CODPLPAG.

  O plano de pagamento tem que está ativo PCPLPAG.STATUS = 'A'

  - Se no JSON estiver vazio o campo "vendaPagamentos.pagamentoCondicao.idRetaguarda" a API vai buscar na base de dados na tabela PCPLPAG.CODPLPAG = 1 o plano de pagamento default e caso ele não exista vai retornar uma validação.
  - Se no JSON estiver preenchido o campo "vendaPagamentos.pagamentoCondicao.idRetaguarda" a API vai buscar na base de dados na tabela PCPLPAG.CODPLPAG o plano de pagamento enviado e caso ele não exista vai retornar uma validação.

'

 Integração

method: 'POST',
url: '/winthor/varejo/matcon/v1/orders/pdvsync'

{
    "situacaoPreVenda": "DISPONIVEL",
    "id": {{numPedHube}},
    "numero": {{numPedHube}},
    "observacoes": "venda de teste",
    "idOperadorRetaguarda": "1",
    "idLojaRetaguarda": "1",
    "preVendaItens": [
        {
            "quantidade": 1.0,
            "preco": 24.9,
            "desconto": 0.0,
            "descontoPercentual": 0.0,
            "idProdutoRetaguarda": "303-13",
            "idVendedorRetaguarda": "1",
            "entrega": {
                "idRetaguardaLojaEntrega": "1"
            },
            "itensKit": [
                {
                    "idProdutoRetaguarda": "7891045008397-75110",
                    "sequencial": 1,
                    "preco": 100.0,
                    "quantidade": 2
                },
                {
                    "idProdutoRetaguarda": "7897595903693-77300",
                    "sequencial": 2,
                    "preco": 12.00,
                    "quantidade": 4
                }
            ]
        }
    ]
}

{
   "success": true,
   "hasNext": false,
   "message": "",
   "data": {
      "idRetaguardaPedido": "54434",
      "message": "",
      "success": true
   }
}