Skip to content

chore(openapi): resync nf-servico-v1 + regenerate (ErrorsResource)#25

Merged
andrenfe merged 1 commit into
masterfrom
chore/resync-nf-servico-v1
Jul 8, 2026
Merged

chore(openapi): resync nf-servico-v1 + regenerate (ErrorsResource)#25
andrenfe merged 1 commit into
masterfrom
chore/resync-nf-servico-v1

Conversation

@andrenfe

@andrenfe andrenfe commented Jul 8, 2026

Copy link
Copy Markdown
Member

O que

Re-sincroniza openapi/nf-servico-v1.yaml com a fonte nfe/docs/static/api (a cópia estava no snapshot de 5/jun; a fonte tem correções de 17 e 30/jun) e regenera src/Generated/.

Delta

  • openapi/nf-servico-v1.yaml — agora idêntico à fonte atual: fix de borrower opcional (nfe/docs #228), descrições enriquecidas, e respostas de erro componentizadas em ErrorsResource (nfe/docs #247). Passou de 0 $ref → 98 $ref + components.schemas={ErrorsResource}.
  • src/Generated/NfServicoV1/ErrorsResource.php (novo) — o spec passou a ter um schema gerável; antes o gerador produzia 0 tipos para este spec.

O que este PR NÃO faz

A resposta de sucesso da NFS-e continua inline no spec (sem schema nomeado), então o modelo da nota ainda não é gerado. Isso depende de componentizar a resposta de sucesso no nfe/docs (issue rascunhada internamente) + nova re-sync. Este PR é freshness + ErrorsResource + pré-requisito.

Verificação

…Resource)

Re-sincroniza openapi/nf-servico-v1.yaml com a fonte nfe/docs/static/api (que
estava ~3 semanas à frente): traz o fix de `borrower` opcional (nfe/docs #228),
descrições enriquecidas e as respostas de erro componentizadas em `ErrorsResource`
(nfe/docs #247). A cópia anterior era o snapshot de 5/jun.

Regenerar adiciona src/Generated/NfServicoV1/ErrorsResource.php (o spec passou a
ter components.schemas={ErrorsResource}); antes gerava 0 tipos.

Nota: a resposta de SUCESSO da NFS-e continua inline no spec (sem schema nomeado),
então o modelo da nota ainda NÃO é gerado — isso depende de componentizar a
resposta de sucesso no nfe/docs (issue rascunhada) + nova re-sync.
@andrenfe andrenfe self-assigned this Jul 8, 2026
@andrenfe andrenfe merged commit 0f1b720 into master Jul 8, 2026
9 checks passed
@andrenfe andrenfe deleted the chore/resync-nf-servico-v1 branch July 8, 2026 01:47
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.

1 participant