fix(invoice): inutilização e EPEC de NF-e usam as rotas reais (POST /disablement, /xml-epec)

[andrenfe]

Resumo

Três métodos de ProductInvoicesResource estavam quebrados contra a API real — retornavam 405/404 incondicionalmente porque usavam rotas que não existem no servidor (sondas ao vivo de 2026-07-29, empresa dev, nada inutilizado):

Método	Antes (morto)	Depois (contrato da spec, sondado vivo)
disable()	PUT …/{id}/disable → 404	POST …/{id}/disablement (+ reason em query)
disableRange()	PUT …/disable → 405	POST …/productinvoices/disablement
downloadEpecXml()	GET …/xml/epec → 404	GET …/xml-epec

downloadRejectionXml() não foi tocado: /xml/rejection e /xml-rejection são aliases vivos.

Detalhes

• Assinaturas públicas inalteradas — só rota/verbo interno. SemVer patch: não há uso funcional possível do comportamento anterior.
• Em disable(), $data['reason'] é promovido a query param (o endpoint individual não declara request body na spec); o fio exige 15–255 caracteres (erro 40001).
• Em disableRange(), o body segue DisablementResource (serie, beginNumber, lastNumber, state, environment, reason); reason é obrigatório no fio (400 "The Reason field is required").
• Docs (product-invoices.md) e skill nfeio-php-sdk atualizados; CHANGELOG em Unreleased.

Testes

• Unit: verbo+path dos 3 métodos pinados via MockTransport (+ alias de rejection + reason→query).
• Novo ProductInvoiceSpecAlignmentTest: amarra as rotas a openapi/nf-produto-v2.yaml e pina a ausência das rotas mortas (um sync de spec que as mova quebra o build).
• make test: 233 passed / 1 failed — a falha é CurlTransportFailurePhaseTest (classificação de erro DNS), ambiental e pré-existente (falha idêntica na master limpa desta máquina). make stan e make cs limpos.

Validação ao vivo (2026-07-30, com o SDK deste PR)

• disableRange sem reason → 400 "The Reason field is required." (rota viva; nada inutilizado)
• disable com invoice falso + reason válido → 404 {"code":40401,"message":"invoice not found"}
• downloadEpecXml com invoice falso → 40401 invoice not found

Decisão (task 4.3 da change): aceitamos o 400/40401 como prova suficiente de rota+verbo+parsing de reason. Não fizemos inutilização real nem em Development — inutilização de numeração é irreversível na SEFAZ.

OpenSpec: fix-product-invoice-disablement-epec (13/13 tasks; artefatos locais, openspec/ é gitignored). Contexto completo no vault review-07-14-2026 (arquivos 03, 08 e 09).