CD_TIPOCERTIDAO - Parâmetro de Tipo de Certidão Negativa

Tela de configuração: TFI015 - Parâmetros de Certidão Negativa
Localização: Tela principal → Campo "Tipo de Certidão"
Tabela: PARMCERTIDAO.CD_TIPOCERTIDAO
Tipo de dado: INTEGER
Valor padrão: retorno.getParam(0) (carregado via parâmetro externo na abertura da tela)

Visão Geral

O parâmetro CD_TIPOCERTIDAO armazena o código do tipo de certidão negativa configurado para uma empresa. Este campo faz parte da chave primária da tabela PARMCERTIDAO (composta por CD_EMPRESA + CD_TIPOCERTIDAO) e referencia diretamente a tabela TIPOCERTIDAO, onde estão cadastrados os tipos de certidão disponíveis.

A combinação CD_EMPRESA + CD_TIPOCERTIDAO + DT_EMISSAO forma a chave primária da tabela NEGATIVAS, que registra as certidões emitidas.

Telas Impactadas

Tela	Descrição	Impacto
TFI015	Parâmetros de Certidão Negativa	Tela principal de configuração do parâmetro
TFI014	Cadastro de Tipo de Certidão	Tela de manutenção dos tipos válidos (códigos que podem ser usados neste parâmetro)

Campos Envolvidos

Campo	Tabela	Descrição	Obrigatório
CD_TIPOCERTIDAO	PARMCERTIDAO	Código do tipo de certidão	Sim
CD_EMPRESA	PARMCERTIDAO	Código da empresa ao qual o tipo se aplica	Sim
DS_TIPOCERTIDAO	TIPOCERTIDAO	Descrição do tipo (lida na validação)	-
QT_DIASVALIDADE	TIPOCERTIDAO	Dias de validade configurados para o tipo	-

Comportamento do Campo

O que faz	Detalhe
Campo editável	O usuário final digita ou busca o código do tipo de certidão no campo edtCD_TIPOCERTIDAO
Validação obrigatória	O campo não pode estar vazio ao salvar (erro W-0513 se vazio)
Validação de existência	O código informado deve existir na tabela TIPOCERTIDAO, senão gera erro W-1210
Descrição automática	Ao validar um código válido, a descrição (DS_TIPOCERTIDAO) é preenchida automaticamente
Teclas de atalho	Atalhos <F5> (Novo), <F6> (Salvar), <F7> (Excluir), <F3> (Procurar), <F8> (Imprimir)

Simulação passo a passo

1. Acesse a tela TFI015 — Parâmetros de Certidão Negativa.
2. Clique em Novo (ou pressione <F5>) para criar um novo registro.
3. Digite o código da empresa no campo CD_EMPRESA (ex: 1).
   • O sistema exibe automaticamente o nome da empresa no campo adjacente.
4. Digite o código do tipo de certidão no campo CD_TIPOCERTIDAO (ex: 10 = "Certidão Negativa de Débitos Federais").
   • O código deve corresponder a um registro válido na tabela TIPOCERTIDAO (mantido na tela TFI014).
5. Confirme que o campo DS_TIPOCERTIDAO (descrição) foi preenchido automaticamente pelo sistema.
6. Clique em Salvar (ou pressione <F6>).
7. Verifique que o registro aparece no grid de consulta.

Resultado esperado: O parâmetro do tipo de certidão negativa fica vinculado à empresa informada. O registro aparece no grid principal e pode ser usado no processo de emissão/registro de certidões (tabela NEGATIVAS).

Exceção / Importante:

• Campo vazio ao salvar: Se o código do tipo de certidão estiver em branco ao tentar salvar, o sistema exibe o erro W-0513 e posiciona o foco no campo CD_TIPOCERTIDAO.
• Código inexistente: Se o código digitado não existir na tabela TIPOCERTIDAO, o sistema exibe o erro W-1210. Consulte a tela TFI014 para verificar/cadastrar os tipos válidos.
• Chave duplicada: Como CD_EMPRESA + CD_TIPOCERTIDAO formam a chave primária de PARMCERTIDAO, não é possível vincular o mesmo tipo de certidão duas vezes à mesma empresa.

Limpar registro

1. Acesse a tela TFI015.
2. Selecione o registro a ser limpo no grid.
3. Clique em Limpar (ou pressione <F4>).
4. Confirme a operação.

Resultado esperado: O registro é removido da tabela PARMCERTIDAO.

Procurar registro

1. Acesse a tela TFI015.
2. Clique em Procurar (ou pressione <F3>).
3. Informe os critérios de busca desejados (empresa, tipo de certidão).

Resultado esperado: O grid exibe somente os registros que atendem aos critérios informados.

Procedures Impactadas

Rotinas Delphi (TFI015)

Rotina	Arquivo	Descrição
TfrmTFI015.edtCD_TIPOCERTIDAOKeyDown	source/TFI015/UTFI015.pas:248	Manipulador de teclas no campo
TfrmTFI015.btnSalvarClick	source/TFI015/UTFI015.pas:189	Valida CD_TIPOCERTIDAO antes de salvar (icdTIPOCERTIDAO := edtCD_TIPOCERTIDAO.Text)
TdmTFI015.tabPARMCERTIDAOBeforePost	source/TFI015/UdmTFI015.pas:54	Validação de campo obrigatório (erro W-0513 se vazio)
TdmTFI015.tabPARMCERTIDAOCD_TIPOCERTIDAOValidate	source/TFI015/UdmTFI015.pas:77	Valida existência do código na tabela TIPOCERTIDAO (erro W-1210 se inexistente); preenche DS_TIPOCERTIDAO

Rotinas Delphi (TFI014 — Cadastro de Tipo de Certidão)

Rotina	Arquivo	Descrição
TfrmTFI014.btnNovoClick	source/TFI014/UTFI014.pas:202	Prepara campo para novo tipo
TfrmTFI014.btnLimparClick	source/TFI014/UTFI014.pas:165	Limpa campo de código
TfrmTFI014.btnSalvarClick	`source/TFI014/UTFI014.pas:186	Captura valor do campo para validação
TdmTFI014.tabTIPOCERTIDAOBeforePost	source/TFI014/UdmTFI014.pas:47	Valida campo obrigatório na tela de cadastro de tipos

Scripts SQL Diretos

Nenhuma referência direta ao campo CD_TIPOCERTIDAO foi identificada em scripts da pasta Scripts/. As referências existentes são:

• docs/schema/tables/PARMCERTIDAO.sql — DDL da tabela com a coluna CD_TIPOCERTIDAO DOM_INTEGER NOT NULL, parte da PK_PARMCERTIDAO.
• docs/schema/tables/TIPOCERTIDAO.sql — DDL da tabela de tipos (PK_TIPOCERTIDAO).
• docs/schema/tables/NEGATIVAS.sql — DDL onde CD_TIPOCERTIDAO faz parte da chave composta PK_NEGATIVAS.

Relacionamentos

TIPOCERTIDAO (1)
   CD_TIPOCERTIDAO (PK)
   DS_TIPOCERTIDAO
   QT_DIASVALIDADE
      │
      │  ← referência
      ▼
PARMCERTIDAO (N)
   CD_EMPRESA       (PK)
   CD_TIPOCERTIDAO  (PK) ← este parâmetro
   DT_REGISTRO
      │
      │  ← referência usada na emissão de certidões
      ▼
NEGATIVAS (N)
   CD_EMPRESA       (PK)
   CD_TIPOCERTIDAO  (PK)
   DT_EMISSAO       (PK)
   ... demais campos da certidão