01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:

Vendas

Função:API B2C
País:Brasil
Requisito/Story/Issue (informe o requisito relacionado) :DDVENDAS-57182


02. SITUAÇÃO/REQUISITO

Identificou-se a necessidade de ajustar o comportamento da API B2C para pedidos cuja origem seja Balcão Reserva. Anteriormente, esses pedidos eram gravados com a posição 'L' (Liberado). No entanto, para alinhar com o processo operacional esperado, a posição correta para esse tipo de pedido deve ser 'M' (Montado), desde que não existam bloqueios ou status intermediários (como validações fiscais ou comerciais) que impeçam essa definição.

03. SOLUÇÃO

Foi implementada uma validação ao final do fluxo de gravação do pedido na API B2C. O sistema agora verifica se:

  1. O pedido possui número de carregamento (NUMCAR) preenchido;

  2. A posição atual do pedido ainda é 'L' (Liberado);

  3. A origem do pedido é Balcão Reserva (saleOrigin = 'R').

Caso todas as condições sejam verdadeiras, a API altera automaticamente a posição do pedido para 'M' (Montado). Essa lógica foi aplicada ao fim do processo para garantir que validações anteriores (bloqueios, pendências, etc.) sejam respeitadas e não forcem indevidamente o status de montado.


Para a utilização correta desta funcionalidade, certifique-se de que o ambiente esteja atualizado com as seguintes versões mínimas:

Serviço: winthor-pedido-venda - Versão 1.38.6.11 ou superior

  • Realize a autenticação na API (WTA).

  • Monte o payload de inclusão de pedido para o endpoint da API B2C (/api/wholesale/v1/orders/).

  • No corpo da requisição, certifique-se de enviar a tag de origem como Balcão Reserva:

    • "saleOrigin": "R"

  • Envie a requisição.

  • Ao receber o retorno de sucesso (200 OK), verifique o campo orderStatus.

    • Para pedidos Balcão Reserva (sem bloqueios), o status retornado será "M".

    • Na tabela PCPEDC, a coluna POSICAO também estará gravada como 'M'.

Exemplo de Payload (Trecho):

{
  "branchId": "1",
  "intermediaryCompanyName": "EMPRESA XXXX",
  "saleOrigin": "R",  <-- Origem Balcão Reserva
  "TotalPrice": 59.99,
  ...
}

Exemplo de Retorno Esperado:

{
  "orderId": "10000203",
  "orderStatus": "M", <-- Gravado como Montado
  "saleOrigin": "R",
  ...
}


04. DEMAIS INFORMAÇÕES


Importante!

As versões estarão disponíveis para download no CCW. 

https://centraldecontrole.pcinformatica.com.br/


Mantenha suas rotinas sempre atualizadas!



05. ASSUNTOS RELACIONADOS