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

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).

Author: andrenfe

openapi/consulta-cnpj-v3.yaml

@@ -4,7 +4,7 @@ info:
   description: "# Introducão\nSeja bem-vindo a documentação da API de Nota Fiscal de Consumidor!\nNossa API foi criada utilizando o padrão REST que possibilita a integração de seu sistema ao nosso, sendo assim você também pode extender ou recriar as funcionalidades existentes na nossa plataforma, tudo isso consumindo a API que está documentada abaixo.\n\n\n# Como usar a API?\nLogo a seguir você encontrará todos os recursos e metódos suportados pela API, sendo que essa página possibilita que você teste os recursos e métodos diretamente através dela.\n\n\n# Autenticação\nVocê precisa de uma chave de API (API Key) para identificar a conta que está realizando solicitações para a API. \nPara isso você deve colocar sua chave de API no campo que se encontra topo desta página para que os métodos funcionem corretamente.\nNo seu código e integração temos suporte para autenticação de diversas formas sendo eles: \nHTTP Header (Authorization) ou HTTP Query String (api_key) nos dois modos passando o valor da sua chave de api (API Key).\n<!-- ReDoc-Inject: <security-definitions> -->\n"
   version: v2
 servers:
-  - url: https://api.nfse.io/
+  - url: https://api.nfse.io
 tags:
   - name: Companies
     description: |
@@ -5531,12 +5531,6 @@ components:
           $ref: '#/components/schemas/ConsumptionCityCode'
         ibsConsumptionCityCode:
           $ref: '#/components/schemas/IbsConsumptionCityCode'
-        debitType:
-          description: "⚠️ Não se aplica à NFC-e (modelo 65) — campo/grupo exclusivo da NF-e (modelo 55)."
-          $ref: '#/components/schemas/DebitType'
-        creditType:
-          description: "⚠️ Não se aplica à NFC-e (modelo 65) — campo/grupo exclusivo da NF-e (modelo 55)."
-          $ref: '#/components/schemas/CreditType'
         governmentPurchase:
           $ref: '#/components/schemas/GovernmentPurchaseResource'
         buyer:
@@ -7836,46 +7830,6 @@ components:
           description: "Valor de CBS a transferir (vCBS)."
           format: "double"
       additionalProperties: false
-    CreditType:
-      type: "string"
-      nullable: true
-      description: |
-        Tipo de Nota de Crédito (tpNFCredito).
-        Valores possíveis:
-        - `FinesAndInterest`: Multa e juros
-        - `IbsPresumedCreditAppropriationZfm`: Apropriação de crédito presumido de IBS sobre o saldo devedor na ZFM
-        - `ReturnDeliveryRefusedOrNotFound`: Retorno por recusa na entrega ou não localização do destinatário
-        - `ValueReduction`: Redução de valores
-        - `TransferCreditSuccession`: Transferência de crédito na sucessão
-      enum:
-        - "FinesAndInterest"
-        - "IbsPresumedCreditAppropriationZfm"
-        - "ReturnDeliveryRefusedOrNotFound"
-        - "ValueReduction"
-        - "TransferCreditSuccession"
-    DebitType:
-      type: "string"
-      nullable: true
-      description: |
-        Tipo de Nota de Débito (tpNFDebito).
-        Valores possíveis:
-        - `TransferCreditsToCooperatives`: Transferência de créditos para cooperativas
-        - `CancelCreditsExemptImmuneSales`: Cancelamento de créditos por vendas isentas/imunes
-        - `UnprocessedInvoicesDebits`: Débitos de faturas não processadas no cálculo
-        - `FinesAndInterest`: Multas e juros
-        - `TransferInheritanceCredit`: Transferência de crédito de herança
-        - `AdvancePayment`: Pagamento antecipado
-        - `InventoryLoss`: Perda de estoque
-        - `SnDisqualification`: Desenquadramento do Simples Nacional
-      enum:
-        - "TransferCreditsToCooperatives"
-        - "CancelCreditsExemptImmuneSales"
-        - "UnprocessedInvoicesDebits"
-        - "FinesAndInterest"
-        - "TransferInheritanceCredit"
-        - "AdvancePayment"
-        - "InventoryLoss"
-        - "SnDisqualification"
     DefermentTaxResource:
       type: "object"
       description: "Grupo de Informações do Diferimento"