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-tecnica-2024-002
Notas Técnicas
Douglas Pinheiro

Nota Técnica 2024.002: mudanças no leiaute de CT-e Simplificado

A Nota Técnica 2024.002 introduz uma novidade quando se trata do < a href="https://focusnfe.com.br/blog/cte/" target="_blan">Conhecimento de Transporte Eletrônico (CT-e). Tal mudança visa otimizar e desburocratizar a emissão e a gestão do documento, com ênfase na agilidade e na praticidade para as empresas.

Mas a mudança mais importante trazida com a nota técnica é a criação do CT-e simplificado. Trata-se de uma versão enxuta do documento original, direcionada a operações de transporte menos complexas. Seu layout é mais conciso, exclui campos não essenciais e facilita o preenchimento das informações.

Para emissores, as principais vantagens são: menos tempo para emissão do documento e menor índice de erros. Para as empresas, por sua vez, há maior agilidade na conferência de dados e melhorar a comunicação entre documentos fiscais eletrônicos.

Leia mais »
NT 2023.002 - v1.00: Emissão de NFC-e para produtor rural pessoa física com IE
NFe
Ludmila Ferreira

Nota Técnica 2020.004: NF-e e DANFE Simplificado

A Nota Técnica 2020.004 trouxe atualizações essenciais para a emissão da Nota Fiscal eletrônica (NFe) e do Documento Auxiliar da Nota Fiscal eletrônica (DANFE). Com a padronização de campos obrigatórios e a proposta de destacar informações relevantes, essas mudanças visam tornar os processos mais eficientes e objetivos.

Essa evolução foi impulsionada pelo crescimento exponencial do comércio eletrônico. Com vendas realizadas cada vez mais fora de lojas físicas, como em marketplaces e pelo telemarketing, a simplificação dos processos fiscais tornou-se indispensável.

Nesse contexto, o DANFE Simplificado – Etiqueta foi introduzido como uma solução prática para otimizar a entrega de mercadorias e facilitar a rotina de empresas e transportadores.

Continue lendo e entenda melhor esta NT e o que propõe suas versões.

Leia mais »
Entenda o que é SaaS, como utilizar e como calcular as métricas SaaS para avaliar sua empresa e analisar os resultados de forma efetiva.
SaaS
Ricardo Acras

Métricas SaaS: como calcular e avaliar seu negócio?

As métricas SaaS são fundamentais para a análise de dados que contribuem tanto com a otimização de serviços, como para uma boa gestão de negócios.

Afinal, esse mercado exige constante evolução e validação. Seja para manter seu produto vivo e superar concorrentes, como para manter clientes engajados e as assinaturas ativas.

Manter os indicadores de desempenho (KPIs) aprimorados e conectados com a real situação do SaaS, possibilita correções e atualizações constantes do produto, norteando as atividades de melhoria contínua do software.

Pensando nisso, no artigo de hoje separamos as principais métricas a serem analisadas para que gestores e times permaneçam atentos tanto às demandas do público quanto da organização. Confira!

Leia mais »