ST_GERABOLETO - Gera Boleto ao Emitir NF

Tela de configuração: MFA002 — Parâmetros de Nota Fiscal por Série Tabela: PARMNOTA.ST_GERABOLETO Componente: cmbGERABOLETO (combobox) Valor padrão: N (Não)

Resumo

Controla se, ao emitir uma Nota Fiscal de Saída (TP_NOTA = 'S') por uma determinada série, o sistema deve gerar automaticamente o boleto bancário correspondente às duplicatas criadas pela nota.

Telas impactadas

Tela	Contexto
MFA002	Configuração do parâmetro por série
LNF028, LNF040, LNF140, LNF141, LNF148, LNF165, LNF168, LNF169, LNF175, LNF200, LNF204, LNF206, LNF211, LNF230, LNF233, LNF300, LNF400, LNF500, LNF501, LNF600	Geração automática de boleto durante emissão/impressão da NF

Campos envolvidos

Campo	Tabela	Descrição
ST_GERABOLETO	PARMNOTA	Parâmetro principal — 'S' gera boleto, 'N' não gera
TP_NOTA	PARMNOTA	Tipo da nota (chave primária). A geração de boleto só ocorre quando TP_NOTA = 'S' (saída)
NR_NOSSONUMEROAPI	CONTAS	Verificado antes de gerar o boleto; se já existir nosso número API, o boleto é gerado em modo "R" (reemissão)
ST_GERABOLNFSEPEND	CONFIGNFSE	(somente LNF230) Controla se gera boleto mesmo com NFS-e pendente de autorização

Opções disponíveis

S - Sim (Gera Boleto Automaticamente)

O que faz	Detalhe
Gera boleto ao emitir NF	Após a impressão da NF de saída, o sistema chama automaticamente o layout LBL000 para gerar o boleto das duplicatas
Restrição de tipo	Funciona apenas para notas de saída (TP_NOTA = 'S')
Verifica duplicata existente	Se já existir NR_NOSSONUMEROAPI na tabela CONTAS, gera em modo reemissão ('R')

Simulação passo a passo

1. Acesse MFA002 — Parâmetros de Nota Fiscal por Série.
2. Selecione a empresa, o tipo de nota Saída e a série desejada.
3. No campo Gera Boleto, escolha Sim (S).
4. Salve o parâmetro.
5. Emita uma nota fiscal de saída (R$ 1.000,00, por exemplo) pela série configurada.
6. Após a confirmação da impressão, o sistema cria automaticamente as duplicatas na tabela CONTAS e chama o layout de boleto (LBL000) para gerar o boleto bancário.

Resultado esperado: O boleto bancário é gerado automaticamente no momento da emissão da NF, sem necessidade de ação manual do usuário.

Exceção / Importante:

• Se a nota fiscal não for de saída (TP_NOTA <> 'S'), o boleto não será gerado, mesmo com ST_GERABOLETO = 'S'.
• No layout LNF230 (NFS-e), existe uma verificação adicional com ST_GERABOLNFSEPEND (configurado em MFA013 — Configuração NFS-e, tabela CONFIGNFSE). Se ST_GERABOLNFSEPEND = 'N' e a NFS-e ainda não estiver autorizada (CD_AUTENTICACAO vazio), o boleto não será gerado.
• No layout LNF400 (NFC-e), há uma condição extra: além de TP_NOTA = 'S', exige-se que retorno[0] <> '' (nota transmitida com sucesso) para gerar o boleto.
• Se já existir nosso número API (NR_NOSSONUMEROAPI) registrado na tabela CONTAS para a duplicata, o boleto será gerado em modo reemissão (iParam[16] = 'R').

N - Não (Não Gera Boleto)

O que faz	Detalhe
Não gera boleto automaticamente	Após emitir a NF, apenas as duplicatas são criadas; o boleto deve ser gerado manualmente

Simulação passo a passo

1. Acesse MFA002 — Parâmetros de Nota Fiscal por Série.
2. Selecione a empresa, o tipo de nota e a série desejada.
3. No campo Gera Boleto, mantenha Não (N) — valor padrão.
4. Salve o parâmetro.
5. Emita uma nota fiscal de saída pela série configurada.
6. O sistema cria as duplicatas na tabela CONTAS, porém não chama o layout de boleto automaticamente.

Resultado esperado: A nota é emitida normalmente e as duplicatas são criadas, mas o boleto bancário não é gerado. O usuário deverá gerá-lo manualmente após a emissão.

Regra Geral de Comportamento

• O parâmetro é definido por série dentro de cada empresa, na combinação CD_EMPRESA + TP_NOTA + CD_SERIE (chave primária de PARMNOTA).
• A geração automática de boleto ocorre apenas durante o fluxo de impressão/emissão da nota, dentro da rotina ExecLayout de cada layout de NF.
• O layout de boleto chamado é sempre o LBL000, recebendo os dados da nota (empresa, lançamento, tipo, série).
• O parâmetro não impede a geração manual posterior de boletos; ele apenas automatiza o processo.

Tabela Comparativa Resumida

Opção	Valor	Gera boleto ao emitir NF?	Requer TP_NOTA = 'S'?
Não	N	Não	—
Sim	S	Sim	Sim

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Todas as rotinas abaixo leem ST_GERABOLETO em PARMNOTA durante ExecLayout e, se 'S', chamam o layout de boleto LBL000:

Rotina	Arquivo	Tipo NF
LNF028	source/LNF028/ULNF028.pas	NF-e
LNF040	source/LNF040/ULNF040.pas	NF-e
LNF140	source/LNF140/ULNF140.pas	NF-e
LNF141	source/LNF141/ULNF141.pas	NF-e
LNF148	source/LNF148/ULNF148.pas	NF-e
LNF165	source/LNF165/ULNF165.pas	NF-e
LNF168	source/LNF168/ULNF168.pas	NF-e
LNF169	source/LNF169/ULNF169.pas	NF-e
LNF175	source/LNF175/ULNF175.pas	NF-e
LNF200	source/LNF200/ULNF200.pas	NF-e
LNF204	source/LNF204/ULNF204.pas	NF-e
LNF206	source/LNF206/ULNF206.pas	NF-e
LNF211	source/LNF211/ULNF211.pas	NF-e
LNF230	source/LNF230/ULNF230.pas	NFS-e (com verificação adicional de ST_GERABOLNFSEPEND)
LNF233	source/LNF233/ULNF233.pas	NFS-e
LNF300	source/LNF300/ULNF300.pas	CT-e
LNF400	source/LNF400/ULNF400.pas	NFC-e
LNF500	source/LNF500/ULNF500.pas	NF-e
LNF501	source/LNF501/ULNF501.pas	NF-e
LNF600	source/LNF600/ULNF600.pas	MDF-e

Atribuição de valor padrão

Rotina	Arquivo	Evidência
TdmMFA002.tabPARMNOTAAfterInsert	source/MFA002/UdmMFA002.pas:93	tabPARMNOTAST_GERABOLETO.AsString := 'N';

Referências SQL (Scripts)

Não foi encontrada referência direta ao campo ST_GERABOLETO em procedures/views SQL da pasta Scripts/. O uso do parâmetro é exclusivamente no código Delphi dos layouts de impressão.