Alterações da API NFSes Recebidas – v.2023-03-01

Luiz Bettoni

Conteúdo

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-17Versão Estável · 2023-03-01
situacao:
  autorizada, cancelada, substituida
status:
  autorizado, cancelado, substituido
valor_servicosvalor_total
Diferenças de campos na consulta Normal (padrão)

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-17Versã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
Diferenças de campos na consulta Estendida (completa=1)

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 .

Inscreva-se em nossa newsletter​

Receba nossos conteúdos exclusivos em primeira mão.

Explore outros conteúdos:

Nota Técnica 2023.004
Nota Fiscal
Hélio Marques

Nota Técnica 2023.004: novo evento para NF-e e NFC-e (ECONF)

documentos fiscais e recursos financeiros recebidos.

Assim, todos os que estão envolvidos no processo da emissão da Nota Fiscal eletrônica (NFe) e a Nota Fiscal de Consumidor eletrônica (NFCe), têm a possibilidade de anotar no documento fiscal as transações financeiras relacionadas através do Evento de Conciliação Financeira (ECONF).

No entanto, em 02 de fevereiro de 2024, foi lançada a versão 1.10 da NT 2023.004 com algumas alterações importantes. Acompanhe o artigo de hoje e entenda mais sobre essas mudanças.

Leia mais »
Nota Técnica 2019.001: Atualizações das Regras de Validação
Nota Fiscal
Douglas Pinheiro

Nota Técnica 2019.001: Atualizações das Regras de Validação

A Nota Técnica 2019.001 trata-se de um documento com alto impacto para desenvolvedores e demanda regras de validação mais rígidas. Por isso, passa por atualizações constantes, a fim de melhorar os serviços oferecidos aos consumidores.

Algumas de suas regras têm a ver com tópicos importantes, como benefícios fiscais, melhora do controle de documentos referenciados e a identificação do destinatário, descrição de informações do ICMS com mais precisão, entre outros tópicos.

A seguir, trazemos as mudanças da Nota Técnica 2019.001 nas diferentes versões do documento, lançadas nos últimos anos.

Leia mais »
Nota Fiscal Falsa: Como evitar golpes
Nota Fiscal
Gabriel Hissatomi Davanzo

Nota Fria: o que é, como identificar e como evitar golpes?

A Nota Fria é todo documento que contém qualquer tipo de informação adulterada. Esse é um problema que nem sempre fica claro e até mesmo as partes não envolvidas na ação criminosa podem ser afetadas judicialmente.

Portanto, é essencial saber como identificar as notas falsas e como lidar com esses percalços para evitar fraudes e se prevenir contra este tipo de documento. Acompanhe o artigo de hoje e saiba como reconhecer a Nota Fria.

Leia mais »