docs(readme): banner apontando para a branch v3#19
Merged
Conversation
A branch master segue congelada na v2.5 (sem novas atualizacoes), mas qualquer integrador que cair aqui hoje vai instalar 'nfe/nfe' sem saber que existe a reescrita v3 moderna em PHP 8.2+. Adiciona um banner curto no topo do README apontando para a branch v3 e os recursos principais (README pt-BR, MIGRATION, samples). Sem mudancas de codigo. Conteudo da v2 mantido integralmente abaixo do banner para nao quebrar links existentes.
andrenfe
added a commit
that referenced
this pull request
Jul 14, 2026
A skill versionada no repo estava na baseline v3.1.0 — duas releases atrás. (As atualizações de v3.2.0 haviam sido aplicadas na cópia local ~/.claude, removida quando a skill passou a ser versionada aqui.) v3.2.0 (add-safe-retry-idempotency): - Retry method-aware (tabela de decisão; POST não retenta em 5xx/ambíguo; Idempotency-Key restaura retry pleno mas a API ainda não honra o header). - FailurePhase + failurePhase/curlErrno na ApiConnectionException. - Override de retry por chamada (RequestOptions->retry). - findByExternalId (rota /external, contrato de coleção, miss=200 lista vazia, lag de indexação) + isDuplicateExternalId + ciclo de emissão idempotente. - Pitfalls #17/#18; decision tree; descrições dos reference files. v3.3.0 (expand-service-invoice-dto): - ServiceInvoice: campos tipados number/checkCode/description/cityServiceCode/ baseTaxAmount/issRate/issTaxAmount/amountNet + borrower (Borrower DTO, federalTaxNumber int|string|null). - raw agora populado (SDK-wide, por item em list); provider via raw['provider']. - totalAmount documentado como phantom @deprecated (sempre null) — pitfall #19. - Nota sobre o teste de alinhamento YAML<->DTO (ancorado por path). Fatos verificados contra o src/ (ordem dos args de RequestOptions, cases do FailurePhase, allowlist de errnos 5/6/7/35, assinatura static de isDuplicateExternalId, campos do Borrower).
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
1 participant
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.
Resumo
Adiciona um banner curto no topo do
README.mdda branchmaster(v2.5, congelada) apontando para a branchv3— a reescrita moderna em PHP 8.2+ com paridade Node SDK.Motivação
Qualquer integrador que aterrissa hoje em
masterinstalanfe/nfe(v2.5, sem novas atualizações) sem saber que a v3 existe. Banner é o caminho zero-fricção para redirecionar.Mudanças
README.md.Test plan
tree/v3,blob/v3/README.md,blob/v3/MIGRATION.md,tree/v3/samples.