Sugestões

Gostaríamos de sugerir a implementação de endpoints na API do Asaas que permitam cadastrar, editar e atualizar os serviços municipais e seus respectivos Códigos de Tributação Nacional (federalServiceTaxCode).

Atualmente, conforme orientação do suporte, a API disponibiliza endpoints para consultar os serviços cadastrados (GET /v3/fiscalInfo/services) e listar os códigos de tributação nacional disponíveis (GET /v3/fiscalInfo/federalServiceCodes), porém não permite realizar o cadastro ou a atualização dessas informações.

Isso gera uma dependência de operações manuais diretamente no dashboard do Asaas, especialmente após as alterações relacionadas à adequação da emissão de NFS-e ao Portal Nacional.

Em nosso cenário, integramos o Asaas a um ERP, no qual realizamos o gerenciamento dos serviços e a emissão de notas fiscais de forma automatizada. Como cada serviço municipal precisa ter seu respectivo Código de Tributação Nacional configurado individualmente, a ausência de um endpoint para essa operação impede que todo o processo seja realizado exclusivamente pela integração.

Nossa sugestão é disponibilizar operações via API que permitam:

• Cadastrar novos serviços municipais.
• Consultar os serviços cadastrados.
• Atualizar os dados de um serviço existente.
• Vincular ou atualizar o Código de Tributação Nacional (federalServiceTaxCode) ao serviço municipal.
• Consultar os serviços e suas respectivas configurações fiscais.

Com esse recurso, seria possível automatizar a configuração inicial e a manutenção dos serviços, reduzindo intervenções manuais, minimizando erros de configuração e permitindo uma integração mais completa entre o ERP e o Asaas.

Entendemos que essa funcionalidade seria bastante útil não apenas para nossa integração, mas também para outros desenvolvedores e empresas que utilizam a API do Asaas para automatizar seus processos de emissão de NFS-e.

Agradecemos a consideração da sugestão e esperamos que ela possa ser avaliada para inclusão no roadmap de melhorias da API.