PROC001 Controle de Pagamentos Eletrônicos - NFCe

	Projeto/Sistema: GerencieVendas	Versão do Template: 1.2
	Processo: PROC001 Controle de Pagamentos Eletrônicos	Versão do Documento: 1.0
	Responsável(eis):  Luís Leite	Data:  23/03/2026

1. Introdução

Esta documentação tem por objetivo descrever as mudanças para satisfazer a necessidade de vincular as informações de pagamento eletrônico vindas do GerencieVendas, para uso na autorização de documento fiscal.

2. Processo(s)

Processo	Envolvidos	Dados de Entrada	Dados de Saída
PROC001 Controle de Pagamentos Eletrônicos	GA-GV	-	-

Especificação Funcional

---

PROC001 Controle de Pagamentos Eletrônicos:

Regras de Negócio:

1. Deverá ser utilizado uma tabela intermediaria para todos pagamentos eletrônicos. Essa tabela vai servir pra armazenar os dados de código de autorização e demais informações de pagamento eletrônico. isso visa dois fluxos, (1) as vendas feitas no APP que não tem vínculo com NFC-e e as (2) vendas que são solicitadas NFC-e.

1  Emissão sem NFCe: 

• • • • As informações vão ficar salvas na tabela intermediaria pagamentosdigitais (antiga nfcecartao), tendo vínculo com a venda.
      • A emissão de NFCe posterior no GerencieAqui deve consultar essa tabela para ter acesso aos dados de autorização. Víncular as informações do registro dessa tabela na nfcefaturas.

1.2 Emissão com NFCe: Com a emissão da NFCe, deve ser enviado a venda + informações dos pagamentos para o GerencieAqui, para possibilitar que o serviço faça a autorização com os dados de autorização já vinculados ao documento fiscal. As informações ainda deverão preencher a tabela pagamentosdifigitais (antiga nfcecartao).

2. Pagamentos originados no app como venda podem posteriormente ser vinculados a uma NFC-e. Nesse caso, o sistema deve atualizar o registro existente, preenchendo o nfceId. Não deve ser criado um novo pagamento para a mesma transação TEF.

3. A tabela nfcefaturas deve continuar referenciando pagamentosdigitais. Para cada fatura com pagamento eletrônico, deve existir um vínculo válido.

Questões Técnicas:

1. No GerencieAqui Deve ser alterado o nome da tabela 'nfcecartao' para 'pagamentosdigitais'.

1.1 Devem ser adicionados campos referentes a informações de pagamento eletrônico.

1.2 Deve ser adicionado "Enum" pra controle de origem do pagamento eletrônico.

ALTER TABLE nfcecartao RENAME TO pagamentosdigitais;

ALTER TABLE pagamentosdigitais
ADD COLUMN meioPagamento VARCHAR(50) DEFAULT NULL,
ADD COLUMN nsu VARCHAR(50) NOT NULL,
ADD COLUMN nsuSitef VARCHAR(50),
ADD COLUMN nsuHost VARCHAR(50),
ADD COLUMN vendaId BIGINT(20),
ADD COLUMN nfceId BIGINT(20),
ADD COLUMN origemPgto INT(2), -- "01 - Cielo; 02 - Rede; 03 - MercadoPago;  04 - ELGIN"
ADD COLUMN statusTef BIT(1) -- 0 ativo, 1 cancelado
;

3. Deve ser alterada a rotina de inserção das informações na tabela 'pagamentosdigitais' pra que seja inserido apenas 1 Registro por transação eletrônica. Esse registro é vinculado com a 'nfcefaturas' por chave estrangeira, ou seja, caso tenham mais de um registro na 'nfcefaturas' eles terão referência do único registro de transação no 'pagamentosdigitais'.

©SOFTEN SISTEMAS 2026