CD_CATEGORIABANDA - Parâmetro de Categoria de Banda
Tela de configuração: REC001 - Parâmetros de Recapagem Localização: Aba Opção 3 Tabela:
PARAMRECAP.CD_CATEGORIABANDATipo: INTEGER Componente:edtCdCategoriaBanda(edit) Valor padrão: vazio (null)
Define qual categoria de confecção é considerada como "banda" na operação de recapagem. O sistema utiliza esse código para identificar itens do tipo banda em processos de produção, exclusão, faturamento e integração.
Telas impactadas
| Tela | Efeito |
|---|---|
| REC001 | Configuração do parâmetro |
| MRC020 | Valida se o parâmetro está preenchido antes de atualizar (btnAtualizarClick) |
| MRC037 | Consulta e filtro por categoria de banda em alterações e exclusões |
| RRC011 | Relatório de custos utiliza o parâmetro em join com RETORNA_ITEMVIPCUSTOS |
| Integração Bridgestone | Relatórios diários de banda e emborrachamento filtram por esta categoria |
Campos envolvidos
| Campo | Tabela | Descrição |
|---|---|---|
CD_CATEGORIABANDA | PARAMRECAP | Código da categoria de confecção que representa a banda |
DS_CATEGORIA | CATEGORIACONFECCAO | Descrição da categoria (preenchida automaticamente pelo sistema) |
CD_CATEGORIA | ITEM | Campo usado nas consultas SQL para comparar com o parâmetro |
Opções disponíveis
O campo aceita qualquer código inteiro válido da tabela CATEGORIACONFECCAO. Não existem valores fixos (S/N) — é um campo de lookup numérico.
Código preenchido (ex: 5)
| O que faz | Detalhe |
|---|---|
| Identifica a categoria de banda | Itens com CD_CATEGORIA igual a este valor são tratados como "banda" nos processos de recapagem |
| Preenche descrição automática | O campo DS_CATEGORIA é atualizado automaticamente com a descrição da categoria cadastrada |
<F9> abre busca | Permite pesquisar categorias cadastradas em CATEGORIACONFECCAO |
Simulação passo a passo
- Acesse REC001 (Parâmetros de Recapagem).
- Navegue até a aba Opção 3.
- Localize o campo Categoria de Banda.
- Digite um código válido (ex:
5) ou pressione<F9>para buscar. - Se usar
<F9>, selecione a categoria desejada na lista deCATEGORIACONFECCAO. - O sistema exibirá automaticamente a descrição da categoria ao lado.
- Salve o registro.
Resultado esperado: O campo CD_CATEGORIABANDA fica gravado na tabela PARAMRECAP para a empresa corrente. A partir desse momento, todos os processos de recapagem que necessitam identificar o item "banda" utilizarão este código como referência.
Exceção / Importante: Se o código digitado não existir na tabela
CATEGORIACONFECCAO, o sistema exibe a mensagem "Categoria não Cadastrada, Verifique! [TPO040]" e impede a gravação.
Campo vazio (null)
| O que faz | Detalhe |
|---|---|
| Desabilita o filtro de banda | Processos que dependem da categoria de banda não encontram correspondência e tratam como "sem banda" |
| Descrição limpa | O campo DS_CATEGORIA é esvaziado automaticamente |
Simulação passo a passo
- Acesse REC001 → aba Opção 3.
- Limpe o campo Categoria de Banda (deixe vazio).
- Salve o registro.
Resultado esperado: O campo fica nulo em PARAMRECAP. Scripts como EXCLUSAO_BANDA e RETORNA_BANDAPNEU não encontram itens correspondentes, e os processos de exclusão/consulta de banda não são executados para nenhum item.
Exceção / Importante: Em
RETORNA_DETALHESPRODUCAORECAP, quandoCD_CATEGORIABANDAé nulo, o sistema utilizaCOALESCEpara tratar o caso sem gerar erro, retornando descrição vazia.
Regra de validação
Ao informar ou alterar o código, o sistema executa:
SELECT C.DS_CATEGORIA FROM CATEGORIACONFECCAO C WHERE C.CD_CATEGORIA = :codigo
- Se encontrar: preenche
DS_CATEGORIAautomaticamente. - Se não encontrar: lança exceção
"Categoria não Cadastrada, Verifique! [TPO040]".
Procedures impactadas
Rotinas Delphi com referência direta ao campo
| Rotina | Arquivo | Efeito |
|---|---|---|
qryCadastroCD_CATEGORIABANDAValidate | UdmREC001.pas | Validação do código ao informar o valor; busca descrição em CATEGORIACONFECCAO |
edtCdCategoriaBandaKeyDown | UframeREC001.pas | Abre busca genérica em CATEGORIACONFECCAO ao pressionar <F9> |
btnAtualizarClick (MRC020) | UMRC020.pas | Verifica se o parâmetro está preenchido antes de atualizar |
tabALTERACAOBANDA (MRC037) | UdmMRC037.pas | Consulta a categoria de banda em filtros de alteração de banda |
btnExcluirClick (MRC037) | UMRC037.pas | Filtra itens por CD_CATEGORIABANDA na exclusão de bandas |
DiarioBandaRolagem (Bridgestone) | UdmBridgestone.pas | Filtro de categoria de banda em relatório diário de rolagem |
DiarioEmborrachamento (Bridgestone) | UdmBridgestone.pas | Filtro de categoria de banda em relatório diário de emborrachamento |
btnProcurarClick (RRC011) | URRC011.pas | Passa CD_CATEGORIABANDA como parâmetro para RETORNA_ITEMVIPCUSTOS |
retornaDataSetItens (jNFe) | jNFe.pas | Condiciona lógica de faturamento de produção recap à categoria de banda |
Scripts SQL com referência direta ao campo
| Procedure/View | Arquivo | Efeito |
|---|---|---|
EXCLUSAO_BANDA | EXCLUSAO_BANDA.sql | Filtra itens da categoria de banda para exclusão |
INSERE_ITEMPEDIDO_BANDARECAP | INSERE_ITEMPEDIDO_BANDARECAP.sql | Insere itens de pedido filtrando pela categoria de banda |
RETORNA_BANDAPNEU | RETORNA_BANDAPNEU.sql | Retorna a descrição da banda do pneu via CD_CATEGORIA = CD_CATEGORIABANDA |
RETORNA_DADOSORDEMCARREGRECAP | RETORNA_DADOSORDEMCARREGRECAP.sql | Dados da ordem de carregamento filtrando por categoria de banda |
RETORNA_DETALHESPRODUCAORECAP | RETORNA_DETALHESPRODUCAORECAP.sql | Detalhes da produção de recapagem; usa variável local V_CD_CATEGORIABANDA |
RETORNA_ITENSADICIONAISNOTA | RETORNA_ITENSADICIONAISNOTA.sql | Itens adicionais da nota filtrados pela categoria de banda |
RETORNA_PNEUSNF_RECAP | RETORNA_PNEUSNF_RECAP.sql | Lógica de faturamento de pneus de recapagem por categoria de banda |
RETORNA_PNEUSNF_RECAPLNF168 | RETORNA_PNEUSNF_RECAPLNF168.sql | Variante do retorno de pneus NF para LNF168 |
RETORNA_VALORSERVBANDAORC | RETORNA_VALORSERVBANDAORC.sql | Valor do serviço de banda no orçamento |
VALIDA_ESTOQUEPRODUCAORECAPRASP | VALIDA_ESTOQUEPRODUCAORECAPRASP.sql | Valida estoque para produção de raspagem filtrando por categoria de banda |
VIEW_RRC020 | VIEW_RRC020.sql | View do relatório RRC020 filtra por CD_CATEGORIABANDA |
Tabela Comparativa Resumida
| Cenário | CD_CATEGORIABANDA preenchido | CD_CATEGORIABANDA vazio |
|---|---|---|
| Identificação de banda na produção | Itens da categoria definida são tratados como "banda" | Nenhum item é identificado como banda |
| Exclusão de banda (MRC037) | Exclui itens da categoria correspondente | Nenhuma exclusão executada |
| Relatório diário Bridgestone | Filtra itens da categoria | Relatório sem dados de banda |
| Faturamento NF de recapagem | Lógica de faturamento por produção aplica-se | Faturamento ignora lógica de banda |
Busca com <F9> | Abre lista de CATEGORIACONFECCAO | Abre lista de CATEGORIACONFECCAO |
| Validação | Código deve existir em CATEGORIACONFECCAO | Sem validação (aceita vazio) |