API v3 para emissão de Nota Fiscal de Serviço Eletrônica (NFSe) - NFe, NFSe e NFCe. REST API para Emissão de Notas Fiscais.
Infelizmente as prefeituras não adotam um padrão único para emissão de Nota Fiscal de Serviço Eletrônica (NFSe).
Apesar de existir uma recomendação da ABRASF, cada cidade é livre para decidir o padrão que achar melhor, tornando difícil o trabalho de quem precisa fazer a integração de seu cidade com múltiplas cidades.
Para contornar este problema, estamos desenvolvendo a versão 3 de nossa API para emissão de NFSe, que tentará ser o mais homogênea possível, atendendo ao maior número de cidades com um mínimo de mudanças. Abaixo descrevemos o formato de comunicação desta API. A API irá utilizar o padrão REST de comunicação via HTTP, as 3 chamadas possíveis da API são exemplificadas abaixo:
natureza_operacao (*): Natureza da operação. Informar um dos códigos abaixo. Campo ignorado para o município de São Paulo. 1 – Tributação no município 2 – Tributação fora do município 3 – Isenção 4 – Imune 5 – Exigibilidade suspensa por decisão judicial 6 – Exigibilidade suspensa por procedimento administrativo (Valor padrão: 1)
Uma nota pode ser cancelada após autorizada. O processo de cancelamento também é assíncrono e requer a justificativa do cancelamento como parâmetro. O cancelamento pode ser rejeitado dependendo das regras de prazo de cancelamento de cada prefeitura.
justificativa: Justificativa do cancelamento (valor padrão: "Dados incorretos")
DELETE /nfse/<REFERECIA>?token=<seu_token>&justificativa=Erro+nos+dados+do+tomador
Após solicitado o cancelamento, você deverá consultar o status da nota novamente usando a operação de consulta, que poderá retornar o status "autorizado", se o cancelamento ainda não foi autorizado, "erro_cancelamento" se houve um erro no cancelamento (a nota continuará autorizada) ou "cancelado" se o cancelamento foi efetivado com sucesso. Exemplo: