Implementar consulta e artefatos fiscais para jacobina-saatri

[Yorizel]

Contexto

O PR de NF-e/NFS-e no Montte precisa sair da fundação visual/configuração e plugar o fluxo real do portal jacobina-saatri. Hoje o package expõe emissão via GerarNfse, mas o Montte precisa consultar documentos do portal, persistir metadados em fiscal.nfe_documents e guardar XML/PDF no Vault.

Necessário para o Montte

• Expor uma API de consulta para notas emitidas/prestadas no jacobina-saatri.
• Retornar metadados normalizados para o Montte persistir:
  • número
  • série/RPS quando aplicável
  • status
  • emitente
  • destinatário/tomador
  • valor total
  • data de emissão
  • chave/código de verificação ou identificador equivalente do provedor
• Retornar artefatos quando disponíveis:
  • XML autorizado
  • XML de resposta/protocolo
  • PDF, se o portal disponibilizar
• Manter a URL/endpoints dentro do package. O Montte só deve fornecer portal + credenciais.
• Documentar claramente se o portal é NFS-e, NF-e ou ambos. No código atual do adapter SAATRI, issue_nfe está marcado como unsupported e o fluxo implementado é ABRASF/NFS-e.

Contrato desejado

Idealmente algo no nível do provider/package, sem o Montte montar SOAP manualmente:

const provider = createJacobinaSaatriProvider(credentials, {
  environment: "production",
});

const result = await provider.queryIssued({
  startDate,
  endDate,
});

Ou nome equivalente alinhado ao contrato do @dfe-kit/fiscal.

Critério de aceite

• @dfe-kit/jacobina-saatri expõe consulta real do portal para documentos emitidos/prestados.
• A resposta inclui metadados + artefatos suficientes para o Montte preencher fiscal.nfe_documents e criar documentos no Vault.
• Testes cobrem parse de resposta de consulta com fixture realista.
• README mostra exemplo de uso com login/senha/inscrição municipal.