01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Descrição do Cenário Atual

Descrição do Cenário Atual Identificamos que vendas realizadas no PDV Omni não estão sendo integradas ao Winthor devido a uma rejeição no WSH, que retorna a mensagem: "Matrícula do funcionário é obrigatória".

A investigação técnica apontou que o erro ocorre mesmo quando a matrícula parece estar presente. O problema reside na validação da API:

1. Se a tag CodFuncCx no cabeçalho contém um valor que não possui vínculo direto com um CODUSUR na tabela PCEMPR;

2. Se o parâmetro de fallback CODFUNCCXINTEGRACAOPDV (rotina 132) estiver nulo ou zerado;

3. Se a tag produtos.codfuncx estiver ausente ou inválida.

Atualmente, o sistema ignora a tag produtos.codusur (código do vendedor), que muitas vezes é a única informação válida enviada no JSON, resultando no travamento desnecessário da integração.

03. SOLUÇÃO

• Ajuste

  (Validação via Fallback CodUsur) Para garantir a fluidez da integração, foi implementada uma estrutura de "cascata" (fallback) mais robusta para a identificação da matrícula do funcionário. A API agora tenta localizar um responsável válido seguindo esta ordem de prioridade:

  1. Cabeçalho: Valida o codFuncCx enviado na tabela PCEMPR.

  2. Parâmetro (Fallback 1): Caso o cabeçalho seja inválido, busca o valor definido no parâmetro CODFUNCCXINTEGRACAOPDV.

  3. Item - CodFunc (Fallback 2): Se o parâmetro for nulo, tenta validar o codFuncCx dentro da tag de produtos.

  4. Item - CodUsur (Fallback 3 - Novo): Se todas as opções anteriores falharem, o sistema agora valida o codUsur do produto na PCEMPR e busca a matrícula vinculada a este usuário.

  Critérios de Aceite

  A venda deve ser processada com sucesso se um codUsur válido for enviado no item, mesmo que o codFuncCx do cabeçalho seja inválido ou o parâmetro da 132 esteja zerado.

  • O sistema deve priorizar o funcionário do cabeçalho caso ele seja válido (manutenção da regra de prioridade).

  • O campo de funcionário nas tabelas de venda deve refletir a matrícula encontrada via usuário.

  ---

  Benefícios Esperados

  • Redução drástica de rejeições de vendas por erro de matrícula inexistente.

  • Maior inteligência da API em interpretar os dados enviados pelo PDV Omni (usando o codUsur como âncora).

  • Eliminação de intervenções manuais para ajuste de parâmetros quando o dado já existe no JSON da venda.

04. DEMAIS INFORMAÇÕES

• Como atualizar as rotinas do WinThor?

• Link CCW: https://centraldecontrole.pcinformatica.com.br/

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>