Depois de um longo tempo em beta, a versão estável da nossa API de NFSes Recebidas (ou NFSeR) está em fase final de implantação. A partir do dia 2/10/2023 a versão estável passa a ser o novo padrão das respostas da API. Entenda aqui as melhorias e alterações desta versão.
Novos Recursos
A fim de manter compatibilidade com versões específicas, agora é possível especificar a versão da API na consulta. Assim, você já pode testar e adotar a nova versão informando o parâmetro adicional “api_version=2023-03-01”, tanto em homologação quanto produção. Se você precisar de respostas no formato de outra versão (como a deprecada beta), basta especificar a versão desejada conforme a Documentação de Versões da API.
Agora também é possível obter informações completas referentes a uma NFSe específica, consultando a chave da nota no endpoint de Consulta de NFSe Individual. Assim, é possível obter dados resumidos de todas as notas recebidas usando a consulta normal (padrão), e consultar detalhes completos apenas das notas de seu interesse.
Melhorias nos Campos
As consultas (normal e completa) de notas receberam diversos ajustes nos campos retornados. As principais diferenças da consulta normal (padrão):
Versão Beta · 2020-11-17 | Versão Estável · 2023-03-01 |
|---|---|
| situacao: autorizada, cancelada, substituida | status: autorizado, cancelado, substituido |
| valor_servicos | valor_total |
Os campos da nota completa foram padronizados e normalizados, conforme descrito na Documentação Completa de Campos NFSes Recebidas. Destacam-se as seguintes alterações estruturais:
Versão Beta · 2020-11-17 | Versão Estável · 2023-03-01 |
|---|---|
| situacao: autorizada, cancelada, substituida | status: autorizado, cancelado, substituido |
| servico: dados de um serviço prestado | servicos: array de (um ou mais) serviços prestados |
| – | url, url_xml: campos adicionais (antes exclusivos da consulta normal) |
| – | erros: mensagens de eventuais erros de processamento |
Para mais informações sobre compatibilidade de versões e detalhes de utilização, consulte nossa Documentação para a API de NFSes Recebidas. Em caso de dúvidas, entre em contato conosco no email suporte@focusnfe.com.br .
