CD_ITEMCTE - Produto Padrão para Frete/CT-e

Tela de configuração: MFA001 — Parâmetros de Faturamento Localização: aba Parâmetros de Notas Tabela: PARMFATUR.CD_ITEMCTE (INTEGER, FK para ITEM.CD_ITEM) Campo na tela: edtCD_ITEMCTE (TDBEdit) com descrição readonly ao lado (edtDS_ITEMCTE) Valor padrão: definido pelo usuário ao configurar

Resumo

Define o código do produto que será utilizado automaticamente como item de frete em operações envolvendo CT-e (Conhecimento de Transporte Eletrônico). O produto cadastrado aqui é usado como item padrão nas telas de importação de CT-e, manifesto de transporte e contratos de frete.

Campos envolvidos

Campo	Tabela	Tipo	Descrição
CD_ITEMCTE	PARMFATUR	INTEGER	Código do produto padrão para frete/CT-e
DS_ITEMCTE	consulta (JOIN)	VARCHAR	Descrição do produto (somente leitura, via LEFT JOIN ITEM IC ON IC.CD_ITEM = PARMFATUR.CD_ITEMCTE)

Telas impactadas

Tela	Arquivo	Uso
MFA001 / Parâmetros de Faturamento	UMFA001.pas	Cadastro do parâmetro
MNF001 / Entrada de Notas	UMNF001.pas	Importação de CT-e — usa o produto como item de frete na entrada
MNF034 / Manifesto	UMNF034.pas	Preenche automaticamente o filtro de produto ao abrir a tela e ao trocar tipo de documento para CT-e
MTR010 / Contratos de Frete	UMTR010.pas	Geração de pedido de frete — usa o produto como item do pedido
MPD097 / Pedido de Compra Automático	UdmMPD097.pas	Consulta parâmetros para gerar pedido de compra

Comportamento detalhado

Validação ao preencher

Ao informar um código de produto, o sistema valida:

1. Produto deve existir na tabela ITEM — caso contrário, exibe: "Produto Não Cadastrado! [TPO001]"
2. Produto deve estar ativo (ST_ATIVO = 'S') — caso contrário, exibe: "O Produto Não Está Ativo! [TPO001]"
3. Após validação, preenche automaticamente a descrição (DS_ITEMCTE)

Busca de produto (<F9>)

No campo edtCD_ITEMCTE, pressionar <F9> abre a tela de busca de produtos (tela genérica ITEM).

Opções disponíveis

Este parâmetro não possui opções fixas (não é combobox). Trata-se de um campo de código de produto (inteiro) com busca <F9>.

O que faz	Detalhe
Campo editável	Sim — código de produto livre, com validação de existência e ativo
Busca	Pressione <F9> para abrir a lista de produtos
Obrigatório	Não na configuração, porém bloqueia operações de CT-e se não preenchido

Simulação passo a passo — Configuração

1. Acesse MFA001 — Parâmetros de Faturamento.
2. Abra a aba Parâmetros de Notas.
3. Posicione o cursor no campo ao lado da descrição de produto (ou pressione <F9>).
4. Selecione o produto desejado na lista de produtos.
5. Salve os parâmetros.

Resultado esperado: O código e a descrição do produto ficam gravados como produto padrão de frete/CT-e para a empresa.

Simulação passo a passo — Uso na importação de CT-e (MNF001)

1. Abra MNF001 — Entrada de Notas Fiscais.
2. Inicie a importação de um XML de CT-e.
3. O sistema verifica se CD_ITEMCTE está preenchido; se não estiver, exibe erro: "Não Há um Produto Padrão para Frete Cadastrado. Verifique! [MFA001]".
4. Se preenchido, o produto é adicionado automaticamente como item na entrada.

Resultado esperado: O produto de frete é incluído nos itens da nota de entrada com o CST do CT-e.

Simulação passo a passo — Uso no Manifesto (MNF034)

1. Abra MNF034 — Manifesto.
2. O sistema preenche automaticamente o campo Produto com o valor de CD_ITEMCTE.
3. Ao trocar o tipo de documento para CT-e, o filtro de produto também é preenchido com CD_ITEMCTE.

Resultado esperado: O filtro de produto já vem preenchido com o produto de frete padrão, agilizando a operação.

Simulação passo a passo — Uso em Contratos de Frete (MTR010)

1. Abra MTR010 — Contratos de Frete.
2. Gere um contrato/pedido de frete.
3. O sistema verifica se CD_ITEMCTE está preenchido; se não estiver, exibe erro: "O Protudo de Frete Não está Cadastrado. Verifique! [MFA001]".
4. O produto é usado como item do pedido de frete, com valor igual ao frete calculado.

Resultado esperado: O pedido de frete é gerado com o produto padrão e o valor do frete.

Exceção / Importante:

• Se o parâmetro estiver vazio, as operações de CT-e e frete não prosseguem — é obrigatório cadastrar um produto antes de usar essas funcionalidades.
• O produto informado deve estar ativo no cadastro de itens (ITEM.ST_ATIVO = 'S').
• O produto deve ter um Tipo de Cálculo vinculado (CD_TIPOCALCULO), pois o MTR010 faz JOIN com TIPOCALCULO.

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
edtCD_ITEMCTEKeyDown	source/MFA001/UMFA001.pas	Busca de produto via <F9>
tabPARMFATURCD_ITEMCTEValidate	source/MFA001/UdmMFA001.pas	Valida existência e se produto está ativo
TfrmMNF001.ImportaCTe	source/MNF001/UMNF001.pas	Importação de CT-e — usa como item de frete
Busca_Parametros / geraSequencial	source/MNF001/UdmMNF001.pas	Carrega parâmetros de faturamento, incluindo CD_ITEMCTE
iniciar	source/MNF034/UMNF034.pas	Preenche filtro de produto na abertura do manifesto
cmbTP_DOCUMENTOChange	source/MNF034/UMNF034.pas	Preenche filtro ao trocar tipo de documento para CT-e
TdmMPD097.GeraPedidoCompra	source/MPD097/UdmMPD097.pas	Consulta CD_ITEMCTE entre os parâmetros para pedido de compra
TfrmMTR010.btnContratosClick	source/MTR010/UMTR010.pas	Geração de pedido de frete com produto e valor do frete

Referências SQL diretas ao campo

Nenhuma stored procedure ou view em Scripts/ referencia diretamente CD_ITEMCTE. O campo é consumido exclusivamente via código Delphi.

Candidatas por uso da tabela

As procedures abaixo utilizam a tabela PARMFATUR mas não referenciam CD_ITEMCTE diretamente:

ATUALIZA_PESSOA, ATUALIZA_PRECOVENDA, BUSCAPRECORECAP, CALCULA_CENTRORESULT, CALCULA_CENTRORESULTITEM, CALCULA_COMISSAO, CALCULA_COMISSAO_V2, CALCULA_JUROVENDA, CALCULA_MAQUINA, CALCULA_MAQUINAFICHA, CANCELA_MESTRA, CANCELA_NOTAFISCAL, CONFIRMA_ORDEMSERVICO, CONFIRMA_ORDEMSERVICOMETAL, CONSOME_LOTEMATERIAPRIMA, CREDITOPERIODICO_AI0, CREDITOPERIODICOGRUPO_AI0, EXPORTACAO_ALLABOR, EXPORTACAO_DOMINIOCADASTROS, EXPORTACAO_DOMINIOCUPOM.

Sem impacto direto identificado no código dessas procedures.

Regra Geral

Condição	Efeito
CD_ITEMCTE vazio	Bloqueia importação de CT-e (MNF001) e geração de pedido de frete (MTR010)
CD_ITEMCTE preenchido com produto ativo	Produto é usado automaticamente como item de frete em CT-e, manifestos e contratos
Produto inativo ou inexistente	Rejeitado na validação ao salvar o parâmetro