Skip to content

feat(cliente): implementa endpoints do ADN (DFe por NSU e convenio) - #10

Merged
matheuscardosos merged 4 commits into
mainfrom
feat/cliente-adn
Aug 14, 2026
Merged

feat(cliente): implementa endpoints do ADN (DFe por NSU e convenio)#10
matheuscardosos merged 4 commits into
mainfrom
feat/cliente-adn

Conversation

@matheuscardosos

Copy link
Copy Markdown
Contributor

Completa o modulo cliente com o segundo host da API oficial (ADN, separado do SEFIN Nacional, mesmo certificado mTLS):

  • baixarDfe(nsu, opcoes?) - GET /contribuintes/DFe/{nsu}, com cnpjConsulta e lote opcionais. Descompacta o XML de cada documento do lote.
  • consultarConvenio(codigoMunicipio) - GET /parametrizacao/{codigoMunicipio}/convenio.

Especificacoes OpenAPI oficiais baixadas direto do gov.br e versionadas em schemas/adn/v1 (mesma pratica ja usada com os XSDs da DPS).

Adiciona baixarDfe (GET /contribuintes/DFe/{nsu}) e consultarConvenio
(GET /parametrizacao/{codigoMunicipio}/convenio), completando o modulo
cliente com o segundo host da API oficial (o ADN e separado do SEFIN
Nacional, mas usa o mesmo certificado mTLS).

Especificacoes OpenAPI oficiais do ADN e do SEFIN Nacional baixadas
direto do gov.br e versionadas em schemas/adn/v1 - mesma pratica ja
usada com os XSDs da DPS, pra nao depender de nenhuma fonte externa
pra confirmar o contrato dos endpoints.

baixarDfe descompacta o XML de cada documento do lote (GZip+Base64,
mesmo padrao ja usado em emitirDps/registrarEvento). consultarConvenio
normaliza os nomes de campo da resposta oficial (que tem uma peculiaridade
de nomenclatura do backend do governo, ex. tipoConvenioDeserializationSetter)
pra nomes limpos no tipo exposto pelo SDK.
Comment thread src/cliente/indice.teste.ts Fixed
Comment thread src/cliente/indice.teste.ts Fixed
@matheuscardosos
matheuscardosos merged commit 00924f7 into main Aug 14, 2026
5 checks passed
@matheuscardosos
matheuscardosos deleted the feat/cliente-adn branch August 14, 2026 00:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants