STFATURAAUTO - Faturamento Automático de Pedidos (Recapadora)

Tela de configuração: REC001 - Parâmetros da Recapadora Tabela: PARAMRECAP.STFATURAAUTO Tipo: CHAR(1) Valor padrão: N

Descrição

Controla se os pedidos de recapadora (pneu) gerados pela empresa devem ser marcados automaticamente para faturamento automático. Quando ativado, pedidos originados de coletas móveis (IDPEDIDOMOVEL <> vazio) são inseridos com PEDIDOPNEU.STFATURAAUTO = 'S', permitindo que o serviço de faturamento (JunsoftServiceFatApp) gere notas fiscais de saída sem intervenção manual.

O campo STFATURAAUTO existe em duas camadas:

Tabela	Campo	Função
PARAMRECAP	STFATURAAUTO	Parâmetro por empresa — habilita/desabilita o recurso
PEDIDOPNEU	STFATURAAUTO	Status individual do pedido — indica se aquele pedido deve ser faturado automaticamente

Telas impactadas

• REC001 — Parâmetros da Recapadora: tela onde o parâmetro é configurado.
• CNF018 — Consulta/Faturamento de Pedidos: exibe e filtra pedidos pelo campo STFATURAAUTO / STFATURAAUTOSAIDA nos grids de pedidos e saídas.
• MRC001 — Manutenção de Pedidos de Recapadora: ao inserir ou validar um pedido, consulta PARAMRECAP.STFATURAAUTO para definir o status do pedido.

Campos envolvidos

Campo	Tabela	Tipo	Descrição
STFATURAAUTO	PARAMRECAP	CHAR(1)	Parâmetro global da empresa
STFATURAAUTO	PEDIDOPNEU	CHAR(1)	Status do pedido individual
IDPEDIDOMOVEL	PEDIDOPNEU	INTEGER	Identificador de coleta móvel (condição para aplicação automática)

Campo relacionado: STFATURAAUTOSAIDA (PARAMRECAP.STFATURAAUTOSAIDA) controla a faturamento automático de carcaças de saída. É um parâmetro distinto, documentado separadamente.

Opções disponíveis

S - Faturamento Automático Ativado

O que faz	Detalhe
Marca pedido como faturável	Pedidos com IDPEDIDOMOVEL <> vazio são inseridos com STFATURAAUTO = 'S'
Filtrável no faturamento	O serviço de faturamento seleciona pedidos com STFATURAAUTO = 'S' para gerar notas
Edição manual permitida	Usuário pode alterar o status individual do pedido na tela de manutenção

Simulação passo a passo

1. Acesse REC001 (Parâmetros da Recapadora).
2. Localize o campo Faturamento Automático (coluna STFATURAAUTO).
3. Selecione o valor S.
4. Salve o cadastro.
5. Realize uma coleta móvel (pelo aplicativo VulcanoColeta ou similar) para a empresa configurada.
6. O pedido gerado (PEDIDOPNEU) será inserido com STFATURAAUTO = 'S' automaticamente.
7. No serviço de faturamento (JunsoftServiceFatApp), o pedido aparecerá na fila para geração de nota fiscal de saída.

Resultado esperado: Pedidos originados de coletas móveis são automaticamente marcados para faturamento, e o serviço gera as notas fiscais sem necessidade de marcação manual.

Exceção / Importante: A marcação automática só ocorre quando NEW.IDPEDIDOMOVEL IS NOT NULL (trigger PEDIDOPNEU_BI). Pedidos inseridos manualmente no ERP (sem coleta móvel) recebem STFATURAAUTO = 'N' mesmo com o parâmetro ativado. Para que esses pedidos sejam faturados automaticamente, o usuário deve marcar manualmente o campo no pedido.

N - Faturamento Automático Desativado (Padrão)

O que faz	Detalhe
Pedido fica para faturamento manual	Todos os pedidos são inseridos com STFATURAAUTO = 'N'
Não aparece na fila automática	O serviço de faturamento ignora esses pedidos
Valor padrão ao inserir	Definido automaticamente no evento AfterInsert do UdmREC001

Simulação passo a passo

1. Acesse REC001 (Parâmetros da Recapadora).
2. Localize o campo Faturamento Automático (coluna STFATURAAUTO).
3. Selecione o valor N.
4. Salve o cadastro.
5. Realize uma coleta móvel para a empresa.
6. O pedido gerado (PEDIDOPNEU) será inserido com STFATURAAUTO = 'N'.
7. O faturamento deverá ser feito manualmente pela tela de faturamento.

Resultado esperado: Nenhum pedido é marcado para faturamento automático. O operador deve selecionar e faturar pedidos manualmente.

Regras de negócio

Herança na inserção do pedido (Trigger PEDIDOPNEU_BI)

Ao inserir um novo pedido de pneu, a trigger PEDIDOPNEU_BI executa:

1. Se PEDIDOPNEU.STFATURAAUTO já vier preenchido, respeita o valor informado.
2. Se estiver NULL:
   • Consulta PARAMRECAP.STFATURAAUTO para a empresa do pedido.
   • Se PARAMRECAP.STFATURAAUTO = 'S' E IDPEDIDOMOVEL <> vazio → marca STFATURAAUTO = 'S'.
   • Caso contrário → marca STFATURAAUTO = 'N'.

Restrição de pedidos antigos (Trigger PEDIDOPNEU_AU0)

Ao tentar alterar um pedido de STFATURAAUTO = 'N' para 'S', a trigger PEDIDOPNEU_AU0 verifica:

• Se a data de emissão do pedido é anterior a 01/01/2018, a alteração é bloqueada com a mensagem:

  "PEDIDOS DE RECAPADORA ANTIGOS NÃO DEVEM SER ALTERADOS PARA FATURAMENTO AUTOMATICO. CONTATE O SUPORTE JUNSOFT."

Geração de notas fiscais (JunsoftServiceFatApp)

O método PedidoPneuDAO.GerarPedidosNotas filtra pedidos com PP.STFATURAAUTO = 'S' para gerar notas fiscais de saída. Pedidos com STFATURAAUTO = 'N' não são considerados pelo serviço.

Faturamento de carcaças de saída

A procedure ATUALIZA_STFATURAAUTO é chamada durante a geração de nota fiscal (GERA_NOTAFISCAL). Ela consulta o parâmetro PARAMRECAP.STFATURAAUTOSAIDA (campo distinto de STFATURAAUTO) e, se ativado, atualiza os itens do pedido (ITEMPEDIDOPNEU.STFATURAAUTOSAIDA = 'S').

Tabela Comparativa Resumida

Valor	Descrição	Faturamento automático	Exige coleta móvel	Restrição
S	Ativado	Sim	Sim (IDPEDIDOMOVEL <> vazio)	Pedidos anteriores a 01/01/2018 não podem ser alterados para S
N	Desativado (padrão)	Não	N/A	Nenhuma

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Contexto
TdmREC001.qryCadastroAfterInsert	UdmREC001.pas	Define STFATURAAUTO = 'N' como padrão ao inserir registro nos parâmetros
TdmMRC001.qryPedidoPneuIDPESSOAValidate	UdmMRC001.pas	Marca STFATURAAUTO = 'S' ao validar pessoa no pedido
TdmMRC001.qryPedidoPneuAfterInsert	UdmMRC001.pas	Inicializa STFATURAAUTO se vazio na inserção do pedido
PedidoPneuDAO.Atualizar	PersistenciaDao.pas	Atualiza o campo STFATURAAUTO ao persistir o pedido
PedidoPneuDAO.GerarPedidosNotas	PersistenciaDao.pas	Filtra PP.STFATURAAUTO = 'S' para faturamento automático
TfrmCNF018.gridPedidosCellClick	UCNF018.pas	Verifica STFATURAAUTO = 'E' (erro) ao clicar no grid
TfrmCNF018.gridPedidosDrawColumnCell	UCNF018.pas	Pinta linha com erro quando STFATURAAUTO = 'E'
TfrmCNF018.btnPedidosReenvioClick	UCNF018.pas	Localiza pedidos com STFATURAAUTO = 'E' para reenvio
TfrmMRC043.btnReimprimeEtiquetaClick	UMRC043.pas	Inclui PP.STFATURAAUTO no SELECT de reimpressão de etiqueta

Scripts SQL com referência direta ao campo

Procedure/Trigger	Arquivo	Contexto
PEDIDOPNEU_BI	PEDIDOPNEU_BI.sql	Trigger BEFORE INSERT: herda PARAMRECAP.STFATURAAUTO para pedidos de coleta móvel
PEDIDOPNEU_AU0	PEDIDOPNEU_AU0.sql	Trigger AFTER UPDATE: bloqueia alteração de N→S em pedidos anteriores a 01/01/2018
FECHA_ORDEMPRODUCAORECAP	FECHA_ORDEMPRODUCAORECAP.sql	Inclui STFATURAAUTO no INSERT de PEDIDOPNEU ao fechar ordem de produção
ATUALIZA_STFATURAAUTO	ATUALIZA_STFATURAAUTO.sql	Procedure que atualiza STFATURAAUTOSAIDA nos itens (relacionado ao parâmetro de saída)
GERA_NOTAFISCAL	GERA_NOTAFISCAL.sql	Chama ATUALIZA_STFATURAAUTO durante a geração de nota fiscal

Scripts que usam PARAMRECAP mas sem referência direta a STFATURAAUTO

Estes scripts acessam a tabela PARAMRECAP mas não citam o campo STFATURAAUTO diretamente. Incluem: ATUALIZA_PEDIDONOTA, ATUALIZA_PREVISAOORDEMPROD, ATUALIZA_TIPOPESSOARECAP, CANCELA_ESTOQUERECAP, CANCELA_NOTAFISCAL, CONFIRMA_PNEURECUSADO, EXCLUSAO_BANDA, FECHA_ORDEMPRODUCAORECAPNOTA, GERA_NOTAPEDIDO, GERA_ORDEMPRODUCAORECAP, GERA_PEDIDOENTRADACARCACA, GERA_PEDIDOSAIDACARCACA, entre outros. Nenhum impacto funcional direto identificado sobre STFATURAAUTO nessas rotinas.