[16.0][IMP] l10n_br_focus: add nfse nacional support

[marcelsavegnago]

depende: #4340

Adiciona suporte para NFSe Nacional na integração FocusNFE

Resumo

Esta PR adiciona suporte completo para emissão de Notas Fiscais de Serviços (NFSe) através da API Nacional da FocusNFE, além do suporte já existente para NFSe Municipal. A implementação abrange múltiplos módulos do sistema de localização brasileira do Odoo.

Mudanças Principais

1. Módulo l10n_br_fiscal

• Adicionado suporte para Código Tributário Nacional em documentos fiscais
• Novos campos e views para gerenciamento de códigos tributários nacionais
• Integração com produtos e definições de impostos para NFSe Nacional

2. Módulo l10n_br_account

• Atualização das views de documentos fiscais para suportar NFSe Nacional
• Melhorias na interface para seleção e configuração de códigos tributários

3. Módulo l10n_br_nfse

• Adicionadas constantes e lógica para processamento de NFSe Nacional
• Suporte para códigos tributários nacionais em documentos e linhas de documento

4. Módulo l10n_br_nfse_focus (Principal)

• Novo modelo nfse_nacional.py: Implementação completa da API Nacional da FocusNFE
• Refatoração do modelo document.py: Separação de lógica entre NFSe Municipal e Nacional
• Novo modelo nfse_municipal.py: Extração da lógica municipal para melhor organização
• Novos helpers e constantes: Utilitários para processamento de NFSe Nacional
• Configuração de empresa: Novo campo para seleção do tipo de API (Municipal ou Nacional)
• Testes abrangentes: Adição de mais de 900 linhas de testes para garantir qualidade
• Documentação atualizada: README e arquivos de configuração/uso atualizados

5. Documentação

• Atualização do README principal com informações sobre NFSe Nacional
• Melhorias nos arquivos de configuração e uso
• Descrição atualizada do módulo incluindo ambos os tipos de emissão

Funcionalidades

NFSe Municipal (existente)

• Emissão através da API municipal da FocusNFE
• Suporte para códigos tributários municipais

NFSe Nacional (novo)

• Emissão através da API nacional da FocusNFE
• Suporte para Código Tributário Nacional (NBS)
• Compatibilidade com códigos tributários municipais quando aplicável
• Processamento completo de documentos fiscais nacionais

Configuração

A configuração permite escolher entre:

• NFSe Municipal: API municipal da FocusNFE (padrão)
• NFSe Nacional: API nacional da FocusNFE

A seleção é feita através do campo "Tipo FocusNFe NFSe" na configuração fiscal da empresa.

Impacto

• ✅ Compatibilidade retroativa mantida (NFSe Municipal continua funcionando)
• ✅ Novos campos e funcionalidades adicionados sem quebrar funcionalidades existentes
• ✅ Testes abrangentes garantem qualidade e estabilidade
• ✅ Documentação completa e atualizada

Testes

• Testes unitários adicionados para NFSe Nacional
• Cobertura de testes expandida significativamente
• Validação de integração com API da FocusNFE

Referências

• Documentação FocusNFE: https://focusnfe.com.br/
• API Nacional: Suporte para emissão de NFSe através da plataforma nacional

[OCA-git-bot]

Hi @AndreMarcos, @ygcarvalh, @luismalta, @mileo,
some modules you are maintaining are being modified, check this out!

[antoniospneto]

@marcelsavegnago será que não é melhor separar pelo menos as alterações dos outros módulos que são mais simples, para ser mais facil revisar? que ai o que é simples já vai entrando antes

[marcelsavegnago]

@marcelsavegnago será que não é melhor separar pelo menos as alterações dos outros módulos que são mais simples, para ser mais facil revisar? que ai o que é simples já vai entrando antes

Separei pelos commits.. fora o l10n_br_nfse_focus, são poucas alterações até.... mas se for o caso posso dividir em duas PRs.

[marcelsavegnago]

@antoniospneto criei uma outra PR apenas para os commits no fiscal e account.

#4340