CD_OPERDEVREQ — Parâmetro de Operação de Devolução de Requisição
Tela de configuração: MEQ001 — Parâmetros de Estoque Localização: Aba &Requisição / Recebimento Tabela:
PARMESTOQUE.CD_OPERDEVREQTipo:INTEGER(código da operação de estoque) Valor padrão: Nenhum (campo opcional)
Descrição
Define a operação de estoque utilizada para registrar a devolução de requisições. Quando um item previamente requisitado é devolvido ao estoque, o sistema utiliza esta operação para gerar o respectivo lançamento de entrada na tabela de estoque (via GERA_ESTOQUE).
O código informado corresponde a um registro da tabela OPERACAO (CD_OPERACAO) e, portanto, deve atender a três validações obrigatórias:
| Restrição | Detalhe |
|---|---|
| Operação Ativa | ST_ATIVO = 'S' na tabela OPERACAO |
| Tipo Entrada | TP_OPERACAO = 'E' (não pode ser Saída) |
| Custo Médio | ST_PRECOMEDIO = 'S' |
Telas impactadas
| Tela | Como utiliza o parâmetro |
|---|---|
| MEQ004 — Devolução de Empréstimo/Requisição | Lê CD_OPERDEVREQ para gerar estoque de devolução (GERA_ESTOQUE). Se vazio, exibe erro "Operação de Devolução não Cadastrada. Verifique[MEQ001]" |
| MEQ007 — Requisição de Estoque | Lê CD_OPERDEVREQ como operação de devolução complementar ao ciclo de requisição |
| MEQ015 — Requisição de Estoque (Visualização) | Lê CD_OPERDEVREQ em conjunto com CD_OPERREQUISICAO |
| MEQ058 — Balanço de Estoque | Lê CD_OPERDEVREQ para operações de devolução durante o balanço |
| MEQ071 — Requisição de Estoque (Filtro) | Lê CD_OPERDEVREQ em conjunto com CD_OPERREQUISICAO |
| MCO006 — Compras / Acerto de Estoque | Lê CD_OPERDEVREQ como operação de entrada no acerto |
| MCO008 — Compras / Acerto de Estoque | Lê CD_OPERDEVREQ como operação de entrada no acerto |
| ROF006 — Orçamento / Acerto de Estoque | Lê CD_OPERDEVREQ como operação de entrada no acerto |
| TOF007 — Orçamento Técnico / Acerto de Estoque | Lê CD_OPERDEVREQ como operação de entrada no acerto |
Campos envolvidos
| Campo | Tabela | Descrição |
|---|---|---|
CD_OPERDEVREQ | PARMESTOQUE | Código da operação de estoque (FK → OPERACAO.CD_OPERACAO) |
DS_OPERACAO | OPERACAO | Descrição da operação (exibida no campo auxiliar DS_OPERDEVREQ) |
TP_OPERACAO | OPERACAO | Tipo da operação — deve ser 'E' (Entrada) |
ST_ATIVO | OPERACAO | Status ativo — deve ser 'S' |
ST_PRECOMEDIO | OPERACAO | Indica se utiliza custo médio — deve ser 'S' |
Opções disponíveis
Este parâmetro não possui lista fixa de opções. Trata-se de um campo numérico editável que aceita o código de qualquer operação de estoque cadastrada em TEQ001 (Operações de Estoque), desde que atenda às três validações acima.
Simulação passo a passo
Configuração do parâmetro
| O que faz | Detalhe |
|---|---|
| Campo editável | Aceita código de operação de estoque digitado ou pesquisado via <F9> |
| Obrigatório para devolução | Se vazio, telas como MEQ004 exibirão erro ao tentar salvar devolução |
| FK para OPERACAO | Valida existência, status ativo, tipo entrada e custo médio |
Simulação passo a passo
- Acesse MEQ001 — Parâmetros de Estoque.
- Clique na aba Requisição / Recebimento.
- Localize o campo Requisição / Empréstimo (rótulo do campo
CD_OPERDEVREQ). - Digite o código de uma operação de estoque de entrada com custo médio (ex:
15) ou pressione<F9>para abrir a pesquisa.- Na pesquisa, serão listadas apenas operações com
ST_ATIVO = 'S',TP_OPERACAO = 'E'eST_PRECOMEDIO = 'S'.
- Na pesquisa, serão listadas apenas operações com
- Selecione a operação desejada e confirme.
- O sistema preencherá automaticamente a descrição da operação no campo auxiliar ao lado.
- Salve o registro.
Resultado esperado: O código da operação é gravado em PARMESTOQUE.CD_OPERDEVREQ. As telas de devolução (MEQ004, etc.) utilizarão esta operação para gerar o lançamento de entrada no estoque.
Exceção / Importante:
- Se o campo ficar vazio, a tela MEQ004 (Devolução de Empréstimo/Requisição) exibirá o erro: "Operação de Devolução não Cadastrada. Verifique[MEQ001]!" ao tentar salvar.
- A operação deve ser do tipo Entrada (
TP_OPERACAO = 'E'). Operações de Saída ou inativas são rejeitadas na validação.- A operação deve ter Custo Médio habilitado (
ST_PRECOMEDIO = 'S'). Operações com preço de nota fiscal ou outro tipo de custo são rejeitadas.
Regra de validação
Ao digitar ou selecionar um código no campo, o sistema executa as seguintes validações (implementadas em tabPARMESTOQUECD_OPERDEVREQValidate):
- Existência: O código deve existir na tabela
OPERACAO. - Status Ativo: A operação deve estar ativa (
ST_ATIVO = 'S'), caso contrário: "A Operação de Estoque não está Ativa [TEQ001]!". - Tipo Entrada: A operação deve ser de entrada (
TP_OPERACAO = 'E'), caso contrário: "A Operação de Estoque deve ser de Entrada [TEQ001]!". - Custo Médio: A operação deve ter custo médio habilitado (
ST_PRECOMEDIO = 'S'), caso contrário: "O Valor da Operação de Estoque deve ser pelo Custo Médio [TEQ001]!".
Procedures impactadas
Rotinas Delphi com referência direta ao campo
| Rotina | Arquivo | Evidência |
|---|---|---|
tabPARMESTOQUECD_OPERDEVREQValidate | source/MEQ001/UdmMEQ001.pas:708 | Valida o código digitado contra a tabela OPERACAO |
TfrmMEQ001.edtCD_OPERDEVREQKeyDown | source/MEQ001/UMEQ001.pas:1104 | Handler de <F9> para pesquisa de operações |
Busca_Parametros (MEQ004) | source/MEQ004/UdmMEQ004.pas:138 | Lê CD_OPERDEVREQ para uso em devoluções |
TfrmMEQ004.btnSalvarClick | source/MEQ004/UMEQ004.pas:456 | Usa iCD_OPERDEVREQ na chamada de GERA_ESTOQUE |
Busca_Parametros (MEQ007) | source/MEQ007/UdmMEQ007.pas:122 | Lê CD_OPERDEVREQ para operação de devolução |
Busca_Parametros (MEQ015) | source/MEQ015/UdmMEQ015.pas:106 | Lê CD_OPERDEVREQ para operação de devolução |
Busca_Parametros (MEQ058) | source/MEQ058/UdmMEQ058.pas:81 | Lê CD_OPERDEVREQ para operação de devolução |
Busca_Parametros (MEQ071) | source/MEQ071/UdmMEQ071.pas:123 | Lê CD_OPERDEVREQ para operação de devolução |
TdmMCO006.buscaParametrosEstoque | source/MCO006/UdmMCO006.pas:1433 | Lê CD_OPERDEVREQ como operação de entrada no acerto |
TdmMCO008.buscaParametrosEstoque | source/MCO008/UdmMCO008.pas:1527 | Lê CD_OPERDEVREQ como operação de entrada no acerto |
TdmROF006.buscaParametrosEstoque | source/ROF006/UdmROF006.pas:243 | Lê CD_OPERDEVREQ como operação de entrada no acerto |
TdmTOF007.buscaParametrosEstoque | source/TOF007/UdmTOF007.pas:822 | Lê CD_OPERDEVREQ como operação de entrada no acerto |
Referências SQL diretas ao campo
Não foram encontradas referências diretas ao campo CD_OPERDEVREQ em scripts SQL (Scripts/). O campo é lido exclusivamente via queries Delphi nas rotinas listadas acima.
Candidatas por uso da tabela
As procedures/views abaixo acessam a tabela PARMESTOQUE mas não citam o campo CD_OPERDEVREQ literalmente. Não há impacto funcional direto identificado para este parâmetro específico nessas rotinas.