Pular para o conteúdo principal

CD_LOCALDESTINO — Local Destino

Tela de configuração: MEQ001 — Parâmetros de Estoque Componente na tela: edtIdLocalDest (campo editável) Tabela / Coluna: PARMESTOQUE.CD_LOCALDESTINO (DOM_INTEGER, nullable) Aba: (nenhuma — campo fica no corpo principal da tela) Valor padrão: nenhum (campo inicia vazio)


Finalidade​

Define o local de estoque destino padrão utilizado em processos de transferência de estoque, produção e requisições para a empresa configurada. O código informado aqui será usado automaticamente como destino em rotinas que leem PARMESTOQUE, como geração de notas fiscais de transferência (GERA_NOTAFISCALESTOQUE) e views de requisição (VIEW_REQ012TRANSFERENCIA).

O campo funciona em conjunto com CD_TPLOCALDESTINO (Tipo de Local Destino) — ambos apontam para a tabela LOCALESTOQUE através da foreign key RPARMESTOQUE_LOCAL.


Campos envolvidos​

CampoTabelaFunção
CD_LOCALDESTINOPARMESTOQUECódigo do local de estoque destino
CD_TPLOCALDESTINOPARMESTOQUECódigo do tipo de local destino (obrigatório antes de informar o local)
DS_LOCALDESTINOPARMESTOQUEDescrição do local destino (preenchida automaticamente pelo sistema)
CD_LOCAL / CD_TIPOLOCALLOCALESTOQUETabela referenciada pela FK RPARMESTOQUE_LOCAL

Telas impactadas​

TelaUso do campo
MEQ001Tela de configuração — edição direta do parâmetro
MEQ035Movimentação de estoque — usa CD_LOCALDESTINO como destino na transferência
MEQ052Consulta de itens — valida destino com CD_LOCALORIGEM/CD_LOCALDESTINO
MEQ057Lista de transporte — preenche destino a partir do cadastro do item
MEQ070Transferência de etapas de produção — grava destino na separação
MFA001Parâmetros de faturamento — campo equivalente CD_LOCALDESTINO
MFA011Parâmetros de entrega — pré-carrega local destino para NF de transferência
MNF002 / MNF008 / MNF019Emissão de NF — lê CD_LOCALDESTINO de PARMESTOQUE para movimentações de transferência

Regra de dependência: Tipo de Local​

O campo CD_LOCALDESTINO exige que CD_TPLOCALDESTINO esteja preenchido. Tanto a pesquisa (F9) quanto a validação lançam erro se o tipo de local não foi informado:

"É Obrigatório informar o Tipo de Local para Listar os Locais." (pesquisa F9) "É Obrigatório informar o Tipo de Local para Validar o Local." (validação)

Além disso, o código digitado/pesquisado deve existir na tabela LOCALESTOQUE vinculado ao tipo de local informado. Caso contrário:

"O Local não está Cadastrado [TEQ003]!"


Opções disponíveis​

Este campo é um código numérico livre — não possui lista fixa de opções. O valor depende dos cadastros existentes na tabela LOCALESTOQUE.

O que fazDetalhe
EditávelSim — campo digitável ou pesquisável via <F9>
ExigeCD_TPLOCALDESTINO preenchido antes de informar o local
RestriçãoO código deve existir em LOCALESTOQUE para o tipo de local selecionado
Auto-preenchimentoDS_LOCALDESTINO é preenchido automaticamente após validação

Simulação passo a passo​

  1. Acesse a tela MEQ001 (Parâmetros de Estoque).
  2. Selecione a empresa desejada no campo CD_EMPRESA.
  3. Localize o campo Tipo Local Destino (CD_TPLOCALDESTINO) e informe o código do tipo de local (ex.: código 1 para "Almoxarifado").
  4. Clique no campo Local Destino (edtIdLocalDest).
  5. Digite o código do local de estoque destino (ex.: 5) ou pressione <F9> para abrir a tela de pesquisa. A pesquisa exibirá apenas locais do tipo previamente informado.
  6. Selecione o local desejado na lista de pesquisa (ex.: "Depósito Central").
  7. Salve o registro com <F3> ou botão Salvar.

Resultado esperado: O campo CD_LOCALDESTINO recebe o código do local selecionado (ex.: 5) e o campo DS_LOCALDESTINO é preenchido automaticamente com a descrição (ex.: "Depósito Central"). Este local será utilizado como destino padrão em transferências de estoque, geração de requisições e notas fiscais de transferência para a empresa configurada.

Excecao / Importante: O campo CD_TPLOCALDESTINO (CD_TPLOCALDESTINO) deve obrigatoriamente estar preenchido antes de informar ou pesquisar o local destino. Essa validação ocorre tanto no momento da pesquisa (<F9>) quanto na validação do campo. Configure o tipo de local destino primeiro.


Procedures impactadas​

Rotinas Delphi com referência direta ao campo​

RotinaArquivoEvidência
TfrmMEQ001.edtIdLocalDestKeyDownUMEQ001.pas:1686Pesquisa F9 em LOCALESTOQUE filtrando por CD_TPLOCALDESTINO; atribui CD_LOCALDESTINO
TdmMEQ001.tabPARMESTOQUECD_LOCALDESTINOValidateUdmMEQ001.pas:1283Valida existência em LOCALESTOQUE; preenche DS_LOCALDESTINO; exige CD_TPLOCALDESTINO

Referências SQL diretas ao campo​

Procedure/ViewArquivoEvidência
GERA_NOTAFISCALESTOQUEScripts/GERA_NOTAFISCALESTOQUE.sql:232SELECT P.CD_TIPOLOCALDESTINO, P.CD_LOCALDESTINO
VIEW_REQ012TRANSFERENCIAScripts/VIEW_REQ012TRANSFERENCIA.sql:17Declara O_CD_LOCALDESTINO DOM_INTEGER como parâmetro de saída

Candidatas por uso da tabela (sem referência direta ao campo)​

Diversas procedures/views leem a tabela PARMESTOQUE via CD_EMPRESA sem citar CD_LOCALDESTINO literalmente. Entre as principais: GERA_ESTOQUE, GERA_ESTOQUE_NOTAFISCAL, CANCELA_ESTOQUE, CONFIRMA_ORDEMSERVICO, GERA_ORDEMPRODUCAO, GERA_PRODLOTEPRODUCAO, GERA_SPEDBLOCOL, entre outras listadas em Scripts/. Essas rotinas não foram confirmadas com impacto funcional direto sobre o campo.


Referência cruzada com outras telas​

  • O parâmetro equivalente em faturamento é PARMFATUR.CD_LOCALDESTINO, configurado em MFA001 (Parâmetros de Faturamento).
  • Em MFA011 (Parâmetros de Entrega), o par CD_LOCALDESTINO/CD_TIPOLOCALDESTINO é pré-carregado para NFs de transferência e consumido pelas telas de emissão (MNF002, MNF008, MNF019).