feat: transmitir eventos já assinados fora da biblioteca - #182
Merged
robertorp merged 1 commit intoJul 30, 2026
Conversation
danilobreda
self-requested a review
July 29, 2026 20:02
danilobreda
approved these changes
Jul 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
O problema
Em arquiteturas onde a emissão roda num servidor mas o certificado A3 é do
cliente e vive na máquina dele, o servidor não tem — e não pode ter — a chave
privada usada para assinar. Ele fala com a SEFAZ com outro certificado, só para
o TLS. A assinatura precisa acontecer fora do servidor.
Para a emissão isso já funciona:
NFeAutorizacao4recebeList<NFe>jáassinadas e apenas transmite. Para eventos e inutilização faltavam duas
peças:
1. 7 dos 11 serviços de evento não tinham como receber o objeto já assinado.
Só cancelamento, carta de correção, EPEC e perecimento tinham a sobrecarga que
recebe
List<evento>. Os demais — incluindo a Manifestação do Destinatário —existiam apenas na forma acoplada, que monta e assina com o certificado do
próprio processo. Quem assina fora do servidor simplesmente não conseguia usar
esses eventos.
2. Não havia como obter o
@Idsem assinar.O Id do elemento assinável (
infEvento/@Id,infInut/@Id) só era calculadodentro dos métodos que assinam. Como
Assina()lança exceção se o Id viernulo, quem montasse o objeto por fora precisava reimplementar a regra de
formação na mão. Errar um dígito não dá erro em lugar nenhum: o digest deixa de
bater e a SEFAZ rejeita a assinatura.
O que foi feito
RecepcaoEventoX(int idlote, List<evento> eventos, bool assinar = false)para os 7 serviços que faltavam. Com
assinar: false(padrão) o evento étransmitido exatamente como veio; com
truea biblioteca calcula o Id eassina com o certificado da instância.
Extevento.ObterId(tpEvento, chNFe, nSeqEvento)eExtinutNFe.ObterId(cUF, ano, cnpj, modelo, serie, nNFIni, nNFFin)—públicos, estáticos e de uso opcional.
Cancelamento por substituição não precisou de método novo: usa o mesmo
ServicoNFe.RecepcaoEventoCancelmento, então a sobrecarga de cancelamento quejá existia atende.
Fluxo completo que passa a ser possível: