CD_ESPECIE — Espécie do Modelo NF

Tela de configuração: MFA002 — Parâmetros de Nota Fiscal por Série Tabela: PARMNOTA.CD_ESPECIE — VARCHAR(4) NOT NULL Controle: edtCD_ESPECIE (edit com lookup <F9>) Valor padrão: preenchido automaticamente a partir de MODELONF ao informar a série

Descrição

Define a espécie/modelo de documento fiscal associada à combinação empresa + tipo de nota + série. O valor informado deve existir previamente cadastrado na tabela MODELONF (tela TFI007) para a série selecionada.

Telas impactadas

Tela	Contexto
MFA002 / PARMNOTA	Cadastro do parâmetro (origem)
MNF001 / NOTA (entrada)	Campo CD_ESPECIEFOR utiliza espécie para validação de duplicidade e busca de nota
CNF001 / NOTA (saída)	Botão XML, cancelamento e cálculo de impostos variam conforme CD_ESPECIE
CNF012 / NOTA (CTRC)	Geração XML e cálculo de impostos diferenciados para CT-e
MFI016 / ITEMPROCESSOREFSPED	Vincula nota ao item SPED usando CD_ESPECIE

Campos envolvidos

Campo	Tabela	Tipo	Observação
CD_ESPECIE	PARMNOTA	VARCHAR(4) NOT NULL	Parâmetro documentado
CD_SERIE	PARMNOTA	VARCHAR(4) NOT NULL	Deve ser informado antes da espécie
CD_MODELO	PARMNOTA	VARCHAR(4)	Preenchido automaticamente a partir de MODELONF
CD_ESPECIE	MODELONF	VARCHAR(4) NOT NULL	Cadastro de referência (PK: CD_SERIE + CD_ESPECIE)
CD_ESPECIE	NOTA	VARCHAR(4)	Espécie gravada na nota fiscal emitida/recebida

Valores conhecidos

Valor	Significado	Modelo
NFE	NF-e modelo 55	Nota Fiscal Eletrônica
NFCE	NFC-e modelo 65	Nota Fiscal de Consumidor Eletrônica
CTE	CT-e	Conhecimento de Transporte Eletrônico
SAT	SAT-CFe	Cupom Fiscal Eletrônico do SAT

Outros valores podem existir conforme cadastro em MODELONF.

Comportamento

Preenchimento automático pela série

Quando o campo CD_SERIE é preenchido e validado, o sistema consulta MODELONF:

• Existe apenas 1 espécie para a série → CD_ESPECIE é preenchido automaticamente.
• Existem múltiplas espécies → é aberta a tela de pesquisa para o usuário selecionar.
• Série não cadastrada → CD_ESPECIE é limpo e é exibido aviso "Série não Cadastrada! Verifique [TFI007]".

Preenchimento manual (lookup <F9>)

O usuário pode pressionar <F9> sobre o campo CD_ESPECIE para abrir a pesquisa, que lista Série + Espécie da tabela MODELONF. Ao selecionar, tanto CD_SERIE quanto CD_ESPECIE são preenchidos.

Exceção: Se CD_SERIE estiver em branco ao pressionar <F9>, o sistema exibe o aviso "A Série deve ser Informada Primeiro!".

Validação ao digitar

Ao informar CD_ESPECIE manualmente:

1. Verifica se a série está preenchida; caso contrário, exibe erro.
2. Verifica se a combinação CD_SERIE + CD_ESPECIE existe em MODELONF; se não existir, exibe "Espécie não Cadastrada para a Série".
3. Se válida, preenche automaticamente CD_MODELO a partir de MODELONF.

Simulação passo a passo

1. Acesse MFA002 — Parâmetros de Nota Fiscal por Série.
2. Clique em Novo para criar um novo parâmetro.
3. Selecione o Tipo de Nota (entrada/saída).
4. No campo Série, pressione <F9> e escolha a série desejada (ex.: 001).
5. Se houver mais de uma espécie cadastrada para essa série, a tela de pesquisa será aberta automaticamente — selecione a espécie (ex.: NFE).
6. Se houver apenas uma espécie, o campo Espécie será preenchido automaticamente.
7. O campo Modelo (CD_MODELO) será preenchido automaticamente com base na tabela MODELONF.
8. Confira os demais parâmetros e clique em Salvar.

Resultado esperado: O parâmetro de nota fiscal fica vinculado à combinação Empresa + Tipo de Nota + Série + Espécie, e todas as notas geradas com essa configuração utilizarão a espécie informada.

Exceção / Importante: A espécie informada aqui é utilizada por diversas rotinas fiscais (emissão de NF-e, NFC-e, CT-e, SAT, SPED, Geração de Impostos, Cancelamento etc.). Alterar a espécie de um parâmetro já em uso pode impactar a emissão de novas notas. O cadastro de espécies e séries é feito na tabela MODELONF (tela TFI007).

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Observação
edtCD_SERIEKeyDown	source/MFA002/UMFA002.pas	Lookup <F9> — pesquisa em MODELONF e preenche CD_ESPECIE junto com CD_SERIE
edtCD_ESPECIEKeyDown	source/MFA002/UMFA002.pas	Lookup <F9> no campo espécie; exige série preenchida
ListaEspecie	source/MFA002/UdmMFA002.pas	Abre pesquisa quando a série possui múltiplas espécies
tabPARMNOTACD_SERIEValidate	source/MFA002/UdmMFA002.pas	Preenche CD_ESPECIE automaticamente ou chama ListaEspecie
tabPARMNOTACD_ESPECIEValidate	source/MFA002/UdmMFA002.pas	Valida existência em MODELONF e preenche CD_MODELO

Scripts SQL com referência direta ao campo

Procedure/View	Arquivo	Observação
GERA_NFE	Scripts/GERA_NFE.sql	Utiliza espécie para gerar NF-e
GERA_NOTAPEDIDO	Scripts/GERA_NOTAPEDIDO.sql	Consulta espécie ao gerar nota de pedido
GERA_IMPOSTONOTA	Scripts/GERA_IMPOSTONOTA.sql	Considera espécie no cálculo de impostos
CALCULA_IMPOSTOS	Scripts/CALCULA_IMPOSTOS.sql	Recebe espécie como parâmetro de entrada
CANCELA_NOTAFISCAL	Scripts/CANCELA_NOTAFISCAL.sql	Usa espécie no cancelamento de nota
GERA_CHAVEACESSONFE	Scripts/GERA_CHAVEACESSONFE.sql	Gera chave de acesso conforme espécie
GERA_NOTAFISCAL	Scripts/GERA_NOTAFISCAL.sql	Geração de nota fiscal com espécie do fornecedor
GRAVA_NOTACTB	Scripts/GRAVA_NOTACTB.sql	Grava nota contábil usando espécie
GRAVA_NOTACTE	Scripts/GRAVA_NOTACTE.sql	Grava CT-e usando espécie
GERA_INTEGRACAO	Scripts/GERA_INTEGRACAO.sql	Integração com espécie como parâmetro
GERA_INTEGRACAOFISCAL	Scripts/GERA_INTEGRACAOFISCAL.sql	Integração fiscal com espécie
GERA_ARQUIVOMAGNETICO	Scripts/GERA_ARQUIVOMAGNETICO.sql	Geração de arquivo magnético (SPED)
GERA_SPEDPISCOFINS	Scripts/GERA_SPEDPISCOFINS.sql	SPED PIS/COFINS usando espécie
GERA_GIA	Scripts/GERA_GIA.sql	GIA com filtro por espécie
GERA_ESTOQUE_NOTAFISCAL	Scripts/GERA_ESTOQUE_NOTAFISCAL.sql	Movimento de estoque por nota fiscal
GRAVA_SALDOFISCAL	Scripts/GRAVA_SALDOFISCAL.sql	Saldo fiscal filtrado por espécie
GRAVA_MOVTOFISCALNOTA	Scripts/GRAVA_MOVTOFISCALNOTA.sql	Movimento fiscal de nota
GRAVA_MOVTOFISCALCTE	Scripts/GRAVA_MOVTOFISCALCTE.sql	Movimento fiscal de CT-e
RECALCULA_SALDOFISCAL	Scripts/RECALCULA_SALDOFISCAL.sql	Recálculo de saldo fiscal
GRAVA_NOTAENVIOSCANNTECH	Scripts/GRAVA_NOTAENVIOSCANNTECH.sql	Integração ScannTech
GRAVA_NOTAFISCALPEDIDO	Scripts/GRAVA_NOTAFISCALPEDIDO.sql	Grava nota fiscal de pedido
IMPORTA_NOTACTB	Scripts/IMPORTA_NOTACTB.sql	Importação de nota contábil
IMPORTA_ARQUIVOMAGNETICO	Scripts/IMPORTA_ARQUIVOMAGNETICO.sql	Importação de arquivo magnético
PROCESSA_NOTASOVIS	Scripts/PROCESSA_NOTASOVIS.sql	Processamento de notas Sovis
PROCESSA_PEDIDOSOVIS	Scripts/PROCESSA_PEDIDOSOVIS.sql	Processamento de pedidos Sovis
EXPORTACAO_DOMINIONOTAS	Scripts/EXPORTACAO_DOMINIONOTAS.sql	Exportação Domínio — notas
EXPORTACAO_DOMINIOLIQUIDACAO	Scripts/EXPORTACAO_DOMINIOLIQUIDACAO.sql	Exportação Domínio — liquidação
EXPORTACAO_DOMINIOMODSEPARADOR	Scripts/EXPORTACAO_DOMINIOMODSEPARADOR.sql	Exportação Domínio — módulo separador
EXPORTACAO_RADAR	Scripts/EXPORTACAO_RADAR.sql	Exportação Radar
EXPORTACAO_SOVIS_COMPLEMENTO	Scripts/EXPORTACAO_SOVIS_COMPLEMENTO.sql	Exportação Sovis complemento
GERA_NFORDEMCARREGMRC049	Scripts/GERA_NFORDEMCARREGMRC049.sql	Geração NF ordem de carregamento
GERA_NOTAFISCALORDEMCARREG	Scripts/GERA_NOTAFISCALORDEMCARREG.sql	Geração nota fiscal ordem de carregamento
FECHA_CONTRATOLEITE	Scripts/FECHA_CONTRATOLEITE.sql	Fechamento contrato de leite
FECHA_CONTRATOLEITE_V2	Scripts/FECHA_CONTRATOLEITE_V2.sql	Fechamento contrato de leite v2

Candidatas por uso da tabela PARMNOTA (sem referência direta ao campo)

Procedure/View	Arquivo	Observação
RETORNA_NFSEQUENCIA	Scripts/RETORNA_NFSEQUENCIA.sql	Retorna sequência da NF, consulta PARMNOTA
RETORNA_IMPMOV	Scripts/RETORNA_IMPMOV.sql	Retorna impressora de movimento
RETORNA_IMPRESSORAUSUARIO	Scripts/RETORNA_IMPRESSORAUSUARIO.sql	Retorna impressora do usuário
CALCULA_IMPOSTONOTA	Scripts/CALCULA_IMPOSTONOTA.sql	Cálculo de imposto da nota
GERA_IMPOSTONOTA_INDIVIDUAL	Scripts/GERA_IMPOSTONOTA_INDIVIDUAL.sql	Geração de imposto individual
VIEW_LIVROFISCAL	Scripts/VIEW_LIVROFISCAL.sql	View do livro fiscal
ATUALIZA_NOTACTB	Scripts/ATUALIZA_NOTACTB.sql	Atualiza nota contábil via PARMNOTACTB
GRAVA_AVISOS	Scripts/GRAVA_AVISOS.sql	Grava avisos via PARMNOTACTB