Repository navigation
Release v6.0.2 — CNPJ alfanumérico (primeira parte), manifestação 210200 e gate de tipos - #59
Merged
Merged
Conversation
…ceita Uma regra unica de CNPJ, CPF e chave de acesso (src/core/utils/tax-id.ts, interno) passa a valer em todos os recursos: - companies.create, update e findByTaxNumber aceitam CNPJ ou CPF que perdeu o zero a esquerda como number. A API completa os zeros (medido em 2026-11-18 com escrita autorizada). CNPJ alfanumerico recebe um erro que aponta a API v3 de empresas. - inboundProductInvoices, productInvoiceQuery, consumerInvoiceQuery e transportationInvoices aceitam letras nas posicoes 7 a 18 da chave (CNPJ alfanumerico do emitente) e enviam a chave em maiusculas. Cada rota da API decide se atende. - legalEntityLookup mantem as letras, confere o DV no cliente (modulo 11 com ASCII - 48) e recusa texto fora da mascara. - legalPeople.findByTaxNumber e naturalPeople.findByTaxNumber comparam pelo valor. Docs, exemplos e skill trocam o CNPJ de exemplo invalido 12345678000190 por 11222333000181 e explicam o formato com letras. A skill tambem corrige as opcoes e os campos da consulta de CNPJ e o padrao de CEP. Evidencia em tests/fixtures/live-contracts/alphanumeric-tax-ids.json. Refs #36
A documentacao chamava o 210220 de Confirmacao da Operacao. O 210220 e Desconhecimento da Operacao: envia-lo registra na SEFAZ, em nome do destinatario, que a operacao nao e reconhecida. A Confirmacao e o 210200, que faltava no tipo. - ManifestEventType passa a ser 210200 | 210210 | 210220 | 210240, o enum que a plataforma declara para a rota de manifestacao. A mudanca e aditiva, e o padrao continua 210210. - JSDoc, README, docs/API.md, skill e exemplo trazem os quatro codigos, o aviso e um exemplo de Confirmacao com 210200. Saem os exemplos com 210220 e 210240 (a rota responde 400 para 210240). - Teste unitario de manifest com tpEvent=210200 e teste de tipo em tests/types/manifest-event-type.test-d.ts.
O vitest --typecheck so confere os arquivos do programa do TypeScript, e o tsconfig.json inclui so src/. Os tests/types/*.test-d.ts ficavam de fora e nenhum erro de tipo aparecia: expectTypeOf<1>().toEqualTypeOf<2>() passava. O CI e o publish.yml rodam esse comando. O vitest.config.ts aponta typecheck.tsconfig para o tsconfig.test-types.json (novo), que inclui os testes de tipo. A assercao falsa agora falha, e os cinco arquivos de tipo passam sem mudanca.
Onze pontos de versoes anteriores citavam fontes internas: o CHANGELOG, a skill, JSDoc, comentarios em src/ e docs/recursos/municipal-taxes.md. Passam a citar a documentacao da plataforma, sem mudar o sentido. O pacote publicado deixa de levar essas referencias (conferido com npm pack).
Versao 6.0.2 no package.json e no package-lock.json; src/version.ts regenerado. Entrada 6.0.2 no CHANGELOG: CNPJ alfanumerico, primeira parte (zero a esquerda, chave de acesso com letras e consulta de CNPJ, com as mensagens de erro novas); manifestacao (210220 e Desconhecimento, e ManifestEventType ganha o 210200); o gate test:types; e o que ja estava em [Nao lancado] (paginas conferidas e frontmatter de maquina). Links de comparacao para v6.0.2. Sai o arquivo VERSION da raiz: parado em 4.0.0 e sem leitor. A versao vem do package.json, e tests/unit/version.test.ts guarda a concordancia.
O CNPJ de exemplo 11222333000181 existe na Receita e esta ativo. Os exemplos de consulta devolviam dados reais, e o companies.create do README cadastraria esse CNPJ. README, MIGRATION, docs/, skill, exemplos, JSDoc, a mensagem de erro do CNPJ fora do formato e os testes passam a usar 11222333999952 (11.222.333/9999-52): o DV e valido, e a consulta de CNPJ responde 404 (conferido em 2026-11-18). Os dados das escritas de teste (TEST_COMPANY_DATA da integracao e test-company.json) tambem saem do CNPJ real.
📋 OpenAPI Spec Validation✅ All specs validated and types generated successfully Specs processed:
Generated types available as artifact in |
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 que é
Patch. O SDK para de recusar no cliente o que a API aceita em CNPJ, CPF e chave de acesso. É a
primeira parte da #36 (CNPJ alfanumérico, IN RFB 2.229/2024). A segunda parte, o acesso à
família v3 da API, a única que aceita CNPJ alfanumérico, vem numa minor.
Entram também uma correção de documentação perigosa na manifestação do destinatário, com uma
mudança de tipo aditiva, e o conserto do gate
test:types.Nada novo é exportado. A única mudança de tipo é aditiva:
ManifestEventTypeganha o210200. Evidência versionada emtests/fixtures/live-contracts/alphanumeric-tax-ids.json, comdados sintéticos.
O
publish.ymldispara só emrelease: createde emworkflow_dispatch. Push, PR e merge namasterrodam só o CI. A 6.0.2 vai para o npm quando alguém criar a releasev6.0.2noGitHub (ver "Depois do merge").
O
npm run releasepublica direto da máquina local, sem passar pelo portão do workflow. Nãousar.
CNPJ, CPF e chave de acesso
Uma regra única (
src/core/utils/tax-id.ts, interno) passa a valer em todos os recursos:.,/,-e espaços e passa para maiúsculas, sem perder letras;^[0-9A-Z]{12}[0-9]{2}$, com DV por módulo 11 sobre o valor ASCII − 48 de cadacaractere. Para dígitos, o cálculo é o de sempre;
^\d{6}[0-9A-Z]{12}\d{26}$. Só o CNPJ do emitente, nas posições 7 a 18, temletra.
companiesaceita CNPJ ou CPF que começa com zero. Comonumber,01234567999885vira1234567999885, e o SDK recusava esse número pelo tamanho. Medido em 18/11, com escritaautorizada e CNPJ sintético:
POST /v1/companiescom o número curto respondeu201, e a API gravou as 14 posições;PUTcom o objeto lido respondeu200.Agora o SDK completa com zeros e confere o DV, e
findByTaxNumbercompara pelo valor. Um testede integração novo repete o ciclo pelo SDK, com opt-in de escrita.
A chave de acesso com letras deixa de ser recusada no cliente.
inboundProductInvoices,productInvoiceQuery,consumerInvoiceQueryetransportationInvoicesaceitam a chave e aenviam em maiúsculas. Cada rota da API decide se atende (medido em 18/11):
/inbound/productinvoices/…aceitam a chave;/inbound/{chave}…e a consulta de NF-e ainda respondem400, e o SDK repassa amensagem como
ValidationError.A consulta de CNPJ deixa de arrancar as letras. O
replace(/\D/g, '')transformava um CNPJalfanumérico em 9 dígitos. Agora o CNPJ chega à API, que responde
400com "Utilize a v3", e oSDK repassa a mensagem.
legalPeopleenaturalPeople:findByTaxNumbercompara pelo valor. Um registro que a APIdevolve como número sem o zero à esquerda passa a ser achado.
CNPJ de exemplo. O
12345678000190dos exemplos tinha DV inválido. README,docs/, skill,exemplos, JSDoc e testes passam a usar
11222333999952, um CNPJ sintético: o DV é válido, e aconsulta de CNPJ responde
404.Mudanças de comportamento
ValidationErrorsemrequisição. Antes, o
400da API já viravaValidationError.'CNPJ 11.222.333/9999-52'passava.Manifestação:
210220é Desconhecimento, não ConfirmaçãoO README,
docs/API.md, o JSDoc, a skill e o exemplo chamavam o210220de "Confirmação daOperação". Ele é Desconhecimento da Operação: enviá-lo registra na SEFAZ, em nome do
destinatário, que a operação não é reconhecida, de forma visível para o emissor e para o fisco.
Um cliente quase o enviou seguindo a documentação.
ManifestEventTypeganha o210200, a Confirmação, que faltava. Em TypeScript, confirmar umaoperação não compilava sem forçar o tipo. O tipo passa a ser o enum que a plataforma declara
para a rota, e o padrão continua
210210.400para210240, porque o eventoexige justificativa. Os exemplos com
210220e210240saíram.confere o
tpEvent=210200na URL, e um teste de tipo fixa os quatro códigos.Manutenção
npm run test:typesnão conferia nada. Ovitest --typecheckusava otsconfig.json,que só inclui
src/, e ostests/types/*.test-d.tsficavam de fora:expectTypeOf<1>().toEqualTypeOf<2>()passava. O CI e opublish.ymlrodam esse comando.Agora o
vitest.config.tsaponta o typecheck para otsconfig.test-types.json. A asserçãofalsa falha, e os quatro testes de tipo antigos passam sem mudança.
VERSIONda raiz. Ele estava parado em4.0.0e nada o lia. A versão vem dopackage.json, e oversion.test.tsguarda a concordância comsrc/version.ts.JSDoc, comentários e uma página de
docs/) citavam fontes internas. Agora citam adocumentação da plataforma, sem mudar o sentido. O tarball da 6.0.2 sai limpo.
Commits
Cada commit é revisável sozinho, e todos passam em typecheck e na suíte unitária isoladamente.
a4968ebfix(tax-id)b10517cfix(inbound)ManifestEventTypecom210200;210220é Desconhecimentoee88945test(types)test:typespassa a conferir os testes de tipoc5358aadocs620b133chore(release)21c41c2docsVerificação
Depois do merge
v6.0.2no GitHub sobre o commit de merge, que é o que dispara opublish.yml. A entrada do CHANGELOG está datada de 2026-11-18. Se o release sair em outrodia, ajustar antes.
aberta até a minor da família v3.
Fora deste PR:
nfe.v3.*), que vem numa minor;manifest; arota
manifestation-eventsfica para a 6.1.0.