TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • DDWMISSI-3801 - DT - winthor-integracao-varejo- API de venda - Ajuste o status code em venda já existente

01. DADOS GERAIS


Produto:

TOTVS Distribuição e Varejo

Linha de Produto:

Linha Winthor

Segmento:

Distribuição

Módulo:8 - Ferramentas do sistema
Função:801 - Autorização de serviços WEB
Requisito/Story/Issue:

DDWMISSI-3801

02. SITUAÇÃO/REQUISITO

Descrição do Cenário Atual

Atualmente, o endpoint POST /movimentacao/venda retorna um erro impeditivo quando uma venda já foi processada anteriormente. Isso gera um efeito cascata de falsos negativos no monitoramento da integração.

  1. O WSH envia a venda.
  2. A API identifica o registro nas tabelas PCFILAMENSAGEM ou PCFILAMENSAGEMHISTORICO.
  3. A API retorna HTTP 400 (Bad Request) com a mensagem: "A venda informada já existe na tabela PCFILAMENSAGEM ou PCFILAMENSAGEMHISTORICO."
  4. O WSH marca a integração como erro (PCINTEGRACAOCORE.STATUS = 3).
  5. O PDV Omni exibe o status de "Falha de Integração", gerando chamados desnecessários para o suporte.

03. SOLUÇÃO

  • Ajuste

    Quando a API http://\host:port/winthor/varejo/v1/movimentacao/venda receber uma venda e essa venda já existe na PCFILAMENSAGEM ou PCFILAMENSAGEMHISTORICO retornar a mensagem abaixo:

    "A venda informada já existe na tabela PCFILAMENSAGEM ou PCFILAMENSAGEMHISTORICO." com status code 200 (OK)

    Critérios de Aceite

    • Alteração de Status Code: O retorno deve ser alterado de 400 (Bad Request) para 200 (OK), se venda já existe na PCFILAMENSAGEM ou PCFILAMENSAGEMHISTORICO.
    • Caso contrário, mantém o comportamento atual.
    • Tratar em ambas as versões.


    Benefícios Esperados

    • Redução de falsos positivos no monitoramento do PDV Omni.
    • Eliminação de retrabalho da equipe de suporte para "limpar" erros de integração que, na verdade, já foram processados.


Na rotina 801 atualizar serviço winthor-integracao-varejo para uma das versões abaixo ou superior:

  • 1.37.16.89

Exemplo de Response:

Status code = 200 OK

{
    "sucesso": false,
    "observacao": [
        "A venda informada já existe na tabela PCFILAMENSAGEM ou PCFILAMENSAGEMHISTORICO."
    ],
    "idWinthor": 0
}


04. DEMAIS INFORMAÇÕES



IMPORTANTE!

As versões estarão disponíveis para download no CCW. Mantenha suas rotinas sempre atualizadas!