DMANESTOQ-13732 - DT - Saldo Alocado na Integração Atendimento/Devolução x WMS SaaS

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Foi indentificada a necessidade de alocar e desalocar a quantidade atendida no fluxo de integração de Atendimento e Devolução de Requisição com o WMS SaaS.

03. SOLUÇÃO

Para que o controle de alocação e desalocação passe a funcionar nas integrações de Atendimento e Devolução de Requisições, é necessário informar o Lote de Alocação do WMS Externo no novo campo disponível no programa CE0101 – Manutenção de Parâmetros de Estoque.

Ao informar o Lote de Alocação do WMS Externo e confirmar será ajustada a quantidade alocada no lote generico para os atendimentos que já estão em andamento.

O campo Lote Alocação WMS Externo será habilitado somente quando o parâmetro "WMS Externo", localizado na aba "Integr II" do programa CD0101 - Manutenção de Parametros Globais, estiver marcado.

CD1409 - Atendimento Requisição Material

Alocação de estoque com WMS SaaS no atendimento de requisição

Ao utilizar um depósito WMS Externo no atendimento da requisição de material, o sistema aloca a quantidade atendida (pelo programa CD1409) no saldo de estoque, vinculando-a ao lote informado no campo “Lote Aloc WMS Ext” do programa CE0101 – Manutenção de Parâmetros de Estoque.

Para que a alocação ocorra corretamente, é necessário que os seguintes requisitos sejam atendidos:

• CD0101 - Atualização de Parâmetros Globais: Na aba “Integr”, o campo “WMS Externo” deve estar marcado.
• CD0601 - Manutenção de Depósitos: Os campos “Depósito WMS Externo” e “Aloca Saldo Dep Externo” devem estar marcados.
• CE0101 - Manutenção de Parâmetros de Estoque: O campo “Lote Aloc WMS Ext” deve estar preenchido.
• O lote informado deve ser diferente do campo “Lote Alocação WMS” do próprio CE0101 e do campo “Lote Alocação WMS” do EQ0301, quando o parâmetro “WMS Externo” estiver ativo no CD0101.

API REST: atendDevolRequis (endpoint: ItensAtendProcessoOK)

Na API de integração é realizada a validação das alocações geradas para o WMS Externo (WMS SaaS).

Para que a validação ocorra, é necessário que, no programa CD0601 – Manutenção de Depósitos, os campos Depósito WMS Externo e Aloca Saldo Dep Externo estejam marcados.

Quando esse requisito for atendido, o sistema permite o recebimento de uma quantidade diferente da previamente alocada. Nesses casos, o comportamento será o seguinte:

• Se a quantidade recebida for superior à alocada:
  O sistema verifica se há saldo disponível para cobrir toda a quantidade. Se houver, a alocação é ajustada e a movimentação de estoque é gerada.

• Se a quantidade recebida for inferior à alocada:
  O sistema desconta a quantidade recebida do saldo previamente alocado e gera a movimentação de estoque correspondente.

Sempre que for recebido a informação para finalizar o atendimento, o saldo ainda alocado é automaticamente desalocado, liberando-o para uso em outros processos.

API REST: atendDevolRequis (endpoint: ItensExclusaoProcessoWms)

Criado o endpoint ItensExclusaoProcessoWms para exclusão da alocação de saldo da integração com WMS Externo.

Esse endpoint pode ser utilizado somente se o atendimento ainda não foi concluído e não houve nenhuma baixa registrada. Nessa situação, a alocação poderá ser excluída com sucesso.

Caso o atendimento esteja vinculado a um depósito com o campo Aloca Saldo Dep Externo marcado no programa CD0601 – Manutenção de Depósitos, a execução do endpoint também irá desalocar automaticamente a quantidade associada à requisição.

Payload de exemplo:

{                
     "nrRequisicao": 792,               
     "seqItRequisicao": 10,  
     "codItem": ".compras",    
     "seqAtendimento": 10,             
     "tipoMovto": 1
}

Mensagens de erro:

O sistema emitirá uma mensagem de erro caso o endpoint seja executado para uma requisição que:

• Já tenha alguma baixa registrada, ou

• Já esteja com o processo concluído.

04. ASSUNTOS RELACIONADOS

• CD0101 - Parâmetro Global
• CE0101 - Manutenção Parâmetros do Estoque
• CD0601 - Manutenção de Depósitos
• EQ0301 - Manutenção de Parâmetros de Embarque
• CD1409 - Atendimento Requisição Material
• CD1407 - Consulta Requisição do Requisitante