CD_EMPRESA - Parâmetro de Empresa para Certidões (Comportamento)

Tela de configuração: TFI015 - Parâmetros de Certidão Tabela: PARMCERTIDAO.CD_EMPRESA Tipo do campo: INTEGER NOT NULL Componente: edtCD_EMPRESA (edit) Data Source: dmTFI015.dsPARMCERTIDAO Valor padrão: retorno.getParam(0) (empresa da sessão)

Telas impactadas

• TFI015 - Parâmetros de Certidão (configuração)

Campos envolvidos

• PARMCERTIDAO.CD_EMPRESA (INTEGER NOT NULL) — Chave primária composta com CD_TIPOCERTIDAO
• PARMCERTIDAO.CD_TIPOCERTIDAO (INTEGER NOT NULL)
• PARMCERTIDAO.DT_REGISTRO (TIMESTAMP)

Schema e regras da tabela

Coluna	Tipo	Nulo	Observação
CD_EMPRESA	INTEGER	NOT NULL	Parte da PK; filtra por empresa
CD_TIPOCERTIDAO	INTEGER	NOT NULL	Parte da PK; tipo de certidão
DT_REGISTRO	TIMESTAMP	NULL, DEFAULT NOW	Data/hora do registro

Chave primária: (CD_EMPRESA, CD_TIPOCERTIDAO)

Opções disponíveis

Este parâmetro não é uma opção (S/N/T/etc.); é um campo de ligação obrigatório (NOT NULL) que vincula cada registro de parâmetro de certidão a uma empresa específica.

O que faz	Detalhe
Editável/Bloqueado	Editável durante inclusão; o valor padrão vem da empresa da sessão (retorno.getParam(0))
Exige	Valor inteiro válido correspondente a um registro em EMPRESA.CD_EMPRESA
Restrição	Campo NOT NULL; parte da chave primária composta — não pode ser duplicado com o mesmo CD_TIPOCERTIDAO

Simulação passo a passo

1. Acesse a tela TFI015 — Parâmetros de Certidão.
2. Clique em Novo para incluir um registro de parâmetro.
3. O campo Empresa é preenchido automaticamente com o código da empresa da sessão atual (ex: 1).
4. Se necessário, altere o valor da empresa digitando o código desejado.
5. Informe o Tipo de Certidão (CD_TIPOCERTIDAO).
6. Salve o registro.

Resultado esperado: O parâmetro de certidão é gravado vinculado à empresa informada, com DT_REGISTRO preenchido automaticamente com a data/hora corrente.

Exceção / Importante: Como CD_EMPRESA faz parte da chave primária composta (CD_EMPRESA, CD_TIPOCERTIDAO), não é possível registrar dois parâmetros com a mesma empresa e o mesmo tipo de certidão. Para configurar outro tipo, altere CD_TIPOCERTIDAO.

Procedures impactadas

Rotinas Delphi com referência direta ao parâmetro

As rotinas abaixo referenciam CD_EMPRESA diretamente no contexto da tela TFI015:

Rotina	Arquivo	Linha	Contexto
(dfm) DataField = 'CD_EMPRESA'	source/TFI015/UTFI015.dfm	248	Vincula o campo ao componente edtCD_EMPRESA
dmTFI015.tabPARMCERTIDAOCD_EMPRESA.AsString := retorno.getParam(0)	source/TFI015/UTFI015.pas	242	Atribuição do valor padrão (empresa da sessão)

Candidatas por uso da tabela PARMCERTIDAO

Não foram encontradas referências diretas ao campo CD_EMPRESA da tabela PARMCERTIDAO nos scripts SQL do repositório. O schema indica apenas a constraint PK_PARMCERTIDAO sobre (CD_EMPRESA, CD_TIPOCERTIDAO).

Campo CD_EMPRESA em outras telas (referência cruzada)

O campo CD_EMPRESA é ubíquo no ERP — aparece como chave primária ou estrangeira em dezenas de tabelas (ex: ACESSO, PEDIDO, NOTA, MOVIMENTACAO, etc.). As procedures listadas no pacote de evidências referem-se a outras telas (ADM001, ADM002, etc.) e não impactam diretamente o comportamento do parâmetro na tela TFI015, mas reforçam que CD_EMPRESA é um filtro mandatório no sistema.

Regra geral

• O campo CD_EMPRESA em PARMCERTIDAO sempre exige valor (NOT NULL).
• O valor padrão é a empresa da sessão (retorno.getParam(0)), garantindo que o operador esteja sempre na empresa correta ao configurar certidões.
• Cada empresa pode ter múltiplos registros de PARMCERTIDAO, desde que o CD_TIPOCERTIDAO seja diferente.