Aproveitando a mudança iminente para NFe 4.0, alteramos a nossa API fazendo diversas melhorias para agilizar a emissão de notas fiscais, facilitar o desenvolvimento e aumentar a segurança do sistema.

A versão anterior da API irá continuar em operação por tempo indeterminado. Fica a critério do desenvolvedor fazer upgrade da sua versão.

Abaixo listamos as principais mudanças na API

1. Nova URL - Agora com versionamento de API e 100% REST

A API de NFe foi padronizada para seguir a mesma estrutura da emissão de NFCe (padrão REST) e agora a URL de emissão inclui a versão da API, exemplo: https://api.focusnfe.com.br/v2/nfe

É também obrigatório agora o uso de SSL em ambiente de produção.

2. Novo mecanismo de autenticação

Agora é possível usar o método HTTP Basic Auth ao invés de passar um token por parâmetro. O modelo antigo ainda funciona mas o novo modelo permite maior segurança, pois o token não será armazenado em histórico de navegadores ou em qualquer log de acesso.

3. Suporte a JSON, apenas JSON.

Abandonamos o suporte a linguagem YAML e agora é obrigatório o uso de JSON. Esta mudança foi feita pois agora JSON se tornou o padrão de facto para APIs REST, sendo que praticamente qualquer linguagem moderna possui uma biblioteca para serialização neste formato.

O padrão YAML apesar de parecer simples, não possui suporte nativo a todas as linguagens o que pode estimular o desenvolvedor a usar apenas concatenação de strings manual para serializar os dados. Isto poderia ocasionar problemas dependendo dos dados utilizados. Com o formato JSON e uso de bibliotecas adequadas, eliminamos este problema.

4. Cancelamento e Carta de Correção agora são síncronos

A operação de cancelamento de NFe  e a operação de emissão de Carta de Correção agora é síncrono, ou seja, não é necessário aguardar um processamento em segundo plano para isso. Isto simplifica a API de várias formas.

5. Cálculo automático de totais em NFe e NFCe

Alguns campos da API agora são calculados automaticamente com base nos itens recebidos. Você não irá mais precisar somar manualmente todos os impostos da nota. Esta melhoria é válida apenas para quem já migrou para NFe versão 4.00

6. Nota denegada agora não pode ser reenviada com a mesma referência

Um nota é denegada quando ocorre alguma irregularidade fiscal no cadastro do emitente e do destinatário. O SEFAZ considera este tipo de nota como se fosse uma “denúncia” e gera um número de nota e XML que devem ser armazenados como uma nota qualquer.

Um erro de nota denegada causava confusão pois um número era consumido e era permitido o reenvio da nota usando a mesma referência, fazendo com que esta mesma referência consumisse dois números de nota fiscal. Agora, uma nota denegada é um status final e a nota deverá ser reenviada (quando corrigido o problema do cadastro) apenas usando outra referência.

7. Reenvio de email por API

Agora é disponibilizada uma operação para enviar uma nota por email para qualquer endereço indicado.

8. Webhook (Gatilhos)

Agora é possível que nosso próprio sistema faça uma chamada na URL de sua escolha informando a mudança de status no processamento de uma nota fiscal. Desta forma você não precisará mais fazer “polling” para consultar o status do processamento. Ou seja, você envia a nota para autorização e nós avisamos quando ela for processada. Desta forma será possível eliminar o número de requisições à API e simplificar o processo de emissão.

A documentação da nova API você acessa aqui.