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
| Campo | Tabela | Função |
|---|---|---|
CD_LOCALDESTINO | PARMESTOQUE | Código do local de estoque destino |
CD_TPLOCALDESTINO | PARMESTOQUE | Código do tipo de local destino (obrigatório antes de informar o local) |
DS_LOCALDESTINO | PARMESTOQUE | Descrição do local destino (preenchida automaticamente pelo sistema) |
CD_LOCAL / CD_TIPOLOCAL | LOCALESTOQUE | Tabela referenciada pela FK RPARMESTOQUE_LOCAL |
Telas impactadas
| Tela | Uso do campo |
|---|---|
| MEQ001 | Tela de configuração — edição direta do parâmetro |
| MEQ035 | Movimentação de estoque — usa CD_LOCALDESTINO como destino na transferência |
| MEQ052 | Consulta de itens — valida destino com CD_LOCALORIGEM/CD_LOCALDESTINO |
| MEQ057 | Lista de transporte — preenche destino a partir do cadastro do item |
| MEQ070 | Transferência de etapas de produção — grava destino na separação |
| MFA001 | Parâmetros de faturamento — campo equivalente CD_LOCALDESTINO |
| MFA011 | Parâmetros de entrega — pré-carrega local destino para NF de transferência |
| MNF002 / MNF008 / MNF019 | Emissã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 faz | Detalhe |
|---|---|
| Editável | Sim — campo digitável ou pesquisável via <F9> |
| Exige | CD_TPLOCALDESTINO preenchido antes de informar o local |
| Restrição | O código deve existir em LOCALESTOQUE para o tipo de local selecionado |
| Auto-preenchimento | DS_LOCALDESTINO é preenchido automaticamente após validação |
Simulação passo a passo
- Acesse a tela MEQ001 (Parâmetros de Estoque).
- Selecione a empresa desejada no campo
CD_EMPRESA. - Localize o campo Tipo Local Destino (
CD_TPLOCALDESTINO) e informe o código do tipo de local (ex.: código1para "Almoxarifado"). - Clique no campo Local Destino (
edtIdLocalDest). - 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. - Selecione o local desejado na lista de pesquisa (ex.: "Depósito Central").
- 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
| Rotina | Arquivo | Evidência |
|---|---|---|
TfrmMEQ001.edtIdLocalDestKeyDown | UMEQ001.pas:1686 | Pesquisa F9 em LOCALESTOQUE filtrando por CD_TPLOCALDESTINO; atribui CD_LOCALDESTINO |
TdmMEQ001.tabPARMESTOQUECD_LOCALDESTINOValidate | UdmMEQ001.pas:1283 | Valida existência em LOCALESTOQUE; preenche DS_LOCALDESTINO; exige CD_TPLOCALDESTINO |
Referências SQL diretas ao campo
| Procedure/View | Arquivo | Evidência |
|---|---|---|
GERA_NOTAFISCALESTOQUE | Scripts/GERA_NOTAFISCALESTOQUE.sql:232 | SELECT P.CD_TIPOLOCALDESTINO, P.CD_LOCALDESTINO |
VIEW_REQ012TRANSFERENCIA | Scripts/VIEW_REQ012TRANSFERENCIA.sql:17 | Declara 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).