Skip to content

chore(openapi): resync specs 2026-08 + regenerate (famílias V3, inbound NFS-e, CNPJ em OpenAPI 3) - #35

Merged
andrenfe merged 1 commit into
masterfrom
chore/openapi-resync-2026-08
Aug 1, 2026
Merged

chore(openapi): resync specs 2026-08 + regenerate (famílias V3, inbound NFS-e, CNPJ em OpenAPI 3)#35
andrenfe merged 1 commit into
masterfrom
chore/openapi-resync-2026-08

Conversation

@andrenfe

@andrenfe andrenfe commented Aug 1, 2026

Copy link
Copy Markdown
Member

Resync mecânico das specs entregues pelo time da API (2026-08-01)

Nada de runtime muda — só openapi/ e src/Generated/. Sem release; as funcionalidades novas virão em changes próprias com sondas.

REFRESHED in place (4)

  • nf-servico-v1.yaml: docs do 400 de CNPJ alfanumérico (aponta migração à V3)
  • nf-consumidor-v2.yaml: remove CreditType/DebitType (exclusivos da NF-e modelo 55)
  • nf-produto-v2.yaml: adiciona CreditType/DebitType + purposeType 5/6 (Nota de Crédito/Débito, Ajuste SINIEF 49/25)
  • product-invoice-rtc-v1.yaml: enums de creditType remodelados (RefusedDeliveryTotalOrNotFound/Partial, Ajuste SINIEF 8/26)

ADDED (4 namespaces novos + 1 upgrade)

Spec Namespace Schemas
nf-servico-v3.yaml NfServicoV3 1 ⚠️ (respostas inline, mesma doença da V1 — vai para o report upstream)
nf-produto-v3.yaml NfProdutoV3 99
nf-consumidor-v3.yaml NfConsumidorV3 130
nfse-inbound-v2.yaml NfseInboundV2 26
consulta-cnpj-v3 ConsultaCnpjV3 24 — entregue como .json OpenAPI 3.0.4; convertida a YAML (o pipeline lê só *.yaml), substituindo a Swagger 2.0 que era invisível ao gerador

Validação

  • make generate: 856 arquivos, lint sintático verde (nenhuma spec nova tropeçou no gerador — primeira colheita real da trava da v3.4.1)
  • generate-check, suite completa (280 passed; única falha local é a ambiental CurlTransportFailurePhaseTest), PHPStan e cs verdes
  • Nenhum teste de alinhamento acusou: V1/V2 seguem congeladas; todo o resto é aditivo

…nd NFS-e, CNPJ em OpenAPI 3)

Specs entregues pelo time da API em 2026-08-01. Triage:

REFRESHED in place (4):
- nf-servico-v1.yaml: docs do 400 de CNPJ alfanumérico (aponta migração à V3)
- nf-consumidor-v2.yaml: remove CreditType/DebitType (exclusivos da NF-e mod. 55)
- nf-produto-v2.yaml: adiciona CreditType/DebitType + purposeType 5/6
  (Nota de Crédito/Débito, Ajuste SINIEF 49/25)
- product-invoice-rtc-v1.yaml: enums de creditType remodelados
  (RefusedDeliveryTotalOrNotFound/Partial, Ajuste SINIEF 8/26)

ADDED as new namespaces (4 + 1 upgrade):
- nf-servico-v3.yaml    -> NfServicoV3    (1 — respostas inline, como a V1)
- nf-produto-v3.yaml    -> NfProdutoV3    (99)
- nf-consumidor-v3.yaml -> NfConsumidorV3 (130)
- nfse-inbound-v2.yaml  -> NfseInboundV2  (26)
- consulta-cnpj-v3: entregue como .json OpenAPI 3.0.4; convertido a YAML
  (pipeline lê só *.yaml) substituindo a Swagger 2.0 -> ConsultaCnpjV3 (24)

856 arquivos gerados; lint sintático e generate-check verdes; suite completa,
PHPStan e cs verdes (nenhum teste de alinhamento acusou — V1/V2 congeladas,
todo o resto é aditivo). Nada de runtime muda — os resources V3/inbound-NFS-e
são funcionalidade futura (onda própria com sondas).
@andrenfe
andrenfe merged commit 128e4fd into master Aug 1, 2026
9 checks passed
@andrenfe
andrenfe deleted the chore/openapi-resync-2026-08 branch August 1, 2026 01:17
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