Versão 4.0 da NFe: Principais Alterações na API

Egon Hilgenstieler

Conteúdo

A cada 2 anos aproximadamente é feita uma revisão do layout da NFe devido a mudanças na legislação. Esta nova versão apresenta varias alterações técnicas. Abaixo descrevemos as principais mudanças na nossa API.

Nós procuramos, dentro do possível, manter uma retro-compatibilidade com a versão 3.10 de forma que uma nota escrita na nossa API na documentação anterior possa ser emitida na nova versão. Abaixo descrevemos as retro-compatibilidades implementadas.

Acesse a nova página para documentação de todos os campos.

Prazos para a implantação na SEFAZ

  • Ambiente de Homologação (ambiente de teste das empresas): Já disponível
  • Ambiente de Produção: Já disponível
  • Desativação da versão anterior: 02/07/18

Prazos para a implantação na API Focus NFe

  • Ambiente de Homologação: Já disponível, obrigatoriedade em 01/03/18
  • Ambiente de Produção: Já disponível. Uso obrigatório em 01/06/18

Caso queira testar a NFe 4 em ambiente de homologação antes de 01/03 entre em contato com nosso suporte. Recomendamos que todos os usuários façam testes com suas aplicações para garantir que a emissão continua correta.

Descontinuidade do formato texto do SEFAZ/SP

O formato de dados em TXT baseado no emissor gratuito do SEFAZ-SP não será mais suportado em virtude da descontinuação do emissor gratuito do SEFAZ/SP que mantinha este padrão atualizado. Com a NFe 4.0, este padrão se torna obsoleto. Caso você ainda utilize este formato, ainda poderá emitir notas fiscais em modo de compatibilidade mas não poderá utilizar os novos campos da versão 4.0.

Recomendamos que todos os usuários atualizem seu sistema para utilizar nosso formato em JSON.

Alteração na forma de pagamento

A forma de pagamento será obrigatória agora também para NFe. Será removido o campo que informava apenas se a forma de pagamento era à vista ou não e será utilizado um grupo onde poderá ser informado várias formas de pagamento, como dinheiro, cartão, duplicata mercantil, etc. Apenas notas de ajuste e de devolução deverão informar um valor específico para indicar “sem pagamento”. Para NFC-e que já utilizava este campo, foi adicionada a possibilidade de informar troco.

Mudanças:

  • Removido campo forma_pagamento (no singular)
  • Adicionado campo formas_pagamento também para a NFe.
  • Adicionado novo campo “troco” em formas_pagamento  . Esta mudança afeta também NFC-e. O troco deverá ser informado se a soma dos pagamentos for maior que o valor total da nota fiscal.

Compatibilidade com a versão 3.10:

  • Notas que não forem informadas com o campo formas_pagamento serão automaticamente preenchidas com um pagamento no valor total da nota fiscal com a seguinte forma:
    • “14 – Duplicata Mercantil” se for informado alguma duplicata
    • “99 – Sem pagamento” se nota de devolução ou de ajuste
    • “90 – Outros” nos demais casos

Criação de novo grupo “rastreabilidade de produto”

Criação de novo grupo para permitir a rastreabilidade de qualquer produto sujeito a regulações sanitárias. É possível informar vários registros para cada item da NFe:

  • Número do Lote do produto
  • Quantidade de produto no Lote
  • Data de fabricação/ Produção
  • Data de validade

Estes campos já estavam disponíveis anteriormente para medicamentos.A diferença é que agora o grupo estará disponível para outros produtos e será possível informar mais de um registro por item da NFe. Por esta questão os nomes dos campos serão alterados em nossa API.

Para medicamentos e matérias-primas farmacêuticas, foi incluído o novo campo obrigatório “Código de Produto da ANVISA”.

Mudanças:

  • Removido campos medicamento_numero_lote, medicamento_quantidade_lote, medicamento_data_fabricacao, medicamento_data_validade
  • Adicionado grupo “rastros” dentro de “itens“.
  • Adicionado campo medicamento_codigo_anvisa na seção “itens“.

Compatibilidade com a versão 3.10:

  • Não implementada, campos terão que ser migrados para os novos nomes

Novos campos para o FCP (Fundo de Combate a Pobreza)

Os valores referente ao Fundo de Combate a Pobreza eram informados na versão anterior da NFe apenas para vendas interestaduais para consumidor final. Ele agora deverá ser preenchido para as seguintes situações tributárias do ICMS: 00, 10, 20, 30, 51, 60, 70, 90. Para empresas optantes pelo Simples Nacional, as situações tributárias onde se aplicará será: 201,202, 500, 900.

Para cada uma destas situações deverá ser informado a alíquota, base de cálculo e valor da contribuição, inclusive detalhando se o valor foi pago anteriormente por substituição tributária. Veja com o seu contador se esta situação irá se aplicar a sua empresa.

Mudanças:

  • Removido campos icms_percentual_fcp e icms_valor_fcp e o totalizador icms_valor_total_fcp
  • Adicionado novos campos de uso exclusivo para vendas interestaduais para consumidor final:
    • fcp_percentual_uf_destino
    • fcp_valor_uf_destino
    • fcp_base_calculo_uf_destino
  • Adicionado novos campos para uso nas demais situações na seção “itens“:
    • fcp_percentual
    • fcp_base_calculo
    • fcp_valor
    • fcp_percentual_st
    • fcp_base_calculo_st
    • fcp_valor_st
    • fcp_percentual_retido_st
    • fcp_base_calculo_retido_st
    • fcp_valor_retido_st
  • Adicionado totalizadores na nota fiscal:
    • fcp_valor_total – somatório de fcp_valor
    • fcp_valor_total_uf_destino – somatório de fcp_valor_uf_destino
    • fcp_valor_total_st – somatório de fcp_valor_st
    • fcp_valor_total_retido_st – somatório de fcp_valor_retido_st

Compatibilidade com a versão 3.10:

  • Se informados os campos icms_percentual_fcp e icms_valor_fcp eles serão traduzidos para fcp_percentual_uf_destino, fcp_valor_uf_destino
  • Se informado o totalizador icms_valor_total_fcp ele será traduzido para fcp_valor_total_uf_destino

Demais novos campos

Nos itens quando informado o campo “cest” pode ser informado o campo escala_relevante, este campo indica se a produção foi feita em escala relevante ou não. Caso positivo, deverá ser preenchido os campos:

  • cnpj_fabricante – CNPJ do Fabricante da Mercadoria
  • codigo_beneficio_fiscal – Código de Benefício Fiscal na UF aplicado ao item

Criado novos campos para combustíveis nos itens (e removido o campo combustivel_percentual_gas_natural) :

  • combustivel_descricao_anp
  • combustivel_percentual_glp
  • combustivel_percentual_gas_natural_nacional
  • combustivel_percentual_gas_natural_importado
  • combustivel_valor_partida

Novas opções em campos já existentes

Em vários campos foram adicionadas novas opções:

  • modalidade_frete:
    • 3 – Transporte Próprio por conta do Remetente
    • 4 – Transporte Próprio por conta do Destinatário
  • presenca_comprador:
    • 5 – operação presencial, fora do estabelecimento

 

Picture of Egon Hilgenstieler

Egon Hilgenstieler

CTO e cofundador do Focus NFe, desenvolvedor, professor de yoga e praticante de meditação. Enquanto não está programando, procura a resposta para a vida, para o universo e para tudo mais.

Inscreva-se em nossa newsletter​

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

Explore outros conteúdos:

Substituição Tributária: o que é, como funciona e como calcular!
Nota Fiscal
Ricardo Acras

Substituição Tributária: o que é, como funciona e como calcular!

calcular
A Substituição Tributária (ST) é um meio utilizado pelos governos federal e estaduais para arrecadar tributos como o ICMS (Imposto sobre Circulação de Mercadorias e Serviços) e o IPI (Imposto sobre Produtos Industrializados).

Dessa forma, o órgão responsável determina que um terceiro envolvido na transação fique responsável por calcular e pagar os tributos, tanto das suas operações como das etapas seguintes da cadeia de produção e distribuição. Geralmente, é o fabricante ou o importador que torna-se responsável por isso.

Por possuir alta complexidade, é preciso estar a par do seu funcionamento e saber em quais situações a Substituição Tributária se enquadra. Isso evita problemas fiscais e permite uma gestão mais clara das finanças da sua empresa.

Leia mais »
decreto-n-599-2023
Nota Fiscal
Ludmila Ferreira

Decreto n° 599/2023: novas regras de pagamento da NFe e NFCe

O Decreto n.º 599/2023, publicado em 28 de novembro de 2023 no Diário Oficial do Mato Grosso, introduz na legislação estadual a obrigatoriedade de vinculação dos pagamentos eletrônicos ao programa emissor da Nota Fiscal Eletrônica (NF-e) e Nota Fiscal do Consumidor Eletrônica (NFC-e).

Conforme o Portal da Transparência de Mato Grosso, com o avanço das tecnologias aplicadas ao comércio, principalmente aquelas que concernem aos pagamentos eletrônicos, permite-se que os sistemas emissores e APIs de documentos fiscais (NF-e) possam se integrar a diversos meios de pagamento eletrônico.

Por este motivo, trazemos explicações sobre o Decreto n.º 599/2023, suas alterações, quem deve aderir às suas regras e prazo de se adequar à obrigatoriedade disposta no Decreto.

Leia mais »
O que é GNRE? Saiba quem precisa emitir e como gerar!
Nota Fiscal
Douglas Pinheiro

GNR-e: o que é, quem precisa emitir e como gerar

Durante operações de transporte interestaduais, determinados documentos são necessários, e a GNRE é um deles.
Assim como outros documentos, a exemplo do Conhecimento de Transporte Eletrônico (CTe), a Guia Nacional de Recolhimento de Tributos Estaduais (GNRE) deve estar presente junto à mercadoria durante o processo de carga, pois a ausência dela pode gerar complicações para a empresa transportadora.
Quer saber mais? Confira o artigo de hoje! Nele, falamos o que é a GNRE, qual a sua importância, como gerá-la e outras informações relevantes.

Leia mais »