Atualizações

NFSe recebidas com dados completos

Foi realizada uma alteração no formato do JSON devolvido pelas NFSes recebidas. Agora é possível optar por receber os dados resumidos ou completos adicionando o parâmetro “completa=1“. Neste último caso, os dados completos do XML serão devolvidos, não sendo mais necessário fazer uma leitura manual do XML devolvido pela prefeitura.

A documenta de NFSes recebidas você encontra aqui.


Nova operação para substituição de NFSe

Agora é possível substituir uma NFSe quando o município permitir esta operação. Uma substituição algumas vezes é obrigatória quando o serviço foi prestado mas a nota emitida originalmente continha erros. Neste caso você poderá substituí-la ao invés de cancelar e emitir outra.

Para isto foram adicionados os seguintes campos que descrevem o RPS a ser substituído quem podem ser informados no envio de NFSe:

  • numero_rps_substituido
  • serie_rps_substituido
  • tipo_rps_substituido

Estes campos poderão ser obtidos na consulta da nota original, que agora também permite obter o número da NFSe substituída no campo numero_nfse_substituida. Além disso, caso a nota original tenha sido emitida pela nossa API, seu status será alterado para “substituido” indicando no campo numero_nfse_substituta a NFSe que a substituíu.


Novos campos para a API de consulta de municípios

Adicionamos novos campos para facilitar a consulta de funcionalidade de emissão de NFSe nos municípios. Agora a consulta irá devolver os seguintes campos adicionais:

  • requer_certificado_nfse
  • possui_ambiente_homologacao_nfse
  • possui_cancelamento_nfse

Consulte um exemplo na documentação da API.


API para consulta de emails bloqueados

Agora, caso algum cliente seu não receba o nosso email com a nota fiscal, você pode consultar se o endereço se encontra em uma lista de enderecos bloqueados. Esta lista é mantida para evitar que emails com problemas sejam reutilizados, o que aumenta a chance de outros emails enviados pela nossa API sejam considerados como “spam”.

Nesta API você poderá também solicitar a exclusão do bloqueio se aplicável.

Consulte a documentação da nova API aqui.


Novo campo para visualizar NFSe em PDF

Implementamos um novo campo na resposta da consulta de NFSe, chamado “url_danfse” que irá apontar para uma URL para baixar uma DANFSe (Documento Auxiliar da NFSe) em formato PDF. Estamos utilizando um formato padrão para todas as prefeituras apenas para que seja possível visualizar os principais dados da nota em formato PDF.

Está implementação está sendo feita aos poucos, no momento está disponível apenas para Curitiba, mas em breve outros municípios deverão ser contemplados. Caso esta funcionalidade ainda não tenha sido implementada para o município, este campo será omitido.

 


Gatilhos agora podem ser criados por token

Publicamos uma alteração onde gatilhos (webhooks) podem ser criados sem informar a empresa. Desta forma, o token será acionado para todas as emissões do token utilizado na requisição. Isto poderá ser útil para empresas de software que possuem várias empresas em seu domínio, onde não será mais necessário criar um gatilho para cada empresa, desde que seja usado o mesmo token para todas elas.

Também será possível agora cadastrar mais de um gatilho por evento, isto pode ser usado por exemplo para debugar novos eventos de emissão sem afetar os gatilhos já existentes.

Veja como criar um gatilho na documentação.


Aumento da segurança na recepção dos gatilhos

Agora é possível adicionar uma camada de segurança para garantir que o envio do gatilho (webhook) seja proveniente de nossos servidores. Isto foi feito através da adição de um novo campo “authorization” no cadastro de gatilhos. O valor informado será devolvido no cabeçalho “Authorization” a cada acionamento do gatilho e poderá ser usado para autenticar a requisição recebida, inclusive utilizando um mecanismo como o Basic Auth. Saiba mais na nossa documentação.


Nova API para busca de NFSes recebidas

Disponibilizamos uma primeira versão da API para busca de notas fiscais de serviço recebidas. Por enquanto o serviço esta disponível para notas recebidas no município de São Paulo.

Você pode encontrar a documentação aqui.


Webhooks alterados para permitir reenvio de notificações

Agora é possível testar o uso de gatilhos (webhooks) ou mesmo reenviar uma notificação perdida através de um novo endpoint na API. Consulte a documentação aqui.