Changelog da API

Atualizado em 11/11/2026

Nesta página

Mudanças na API pública (/api/v1/integracao) e nos webhooks, da mais recente para a mais antiga.

Como ler este changelog#

Mudanças compatíveis (campo novo na resposta, rota nova, evento novo, parâmetro opcional novo) entram na v1 sem aviso prévio. Seu código deve ignorar campos desconhecidos.
Mudanças incompatíveis (remover ou renomear campo, mudar tipo, mudar comportamento) só acontecem numa nova versão de prefixo, como /v2. A versão anterior continua funcionando por pelo menos 6 meses depois do anúncio, e as respostas passam a trazer o header Sunset com a data de desligamento.

Versão inicial da API pública.

Chaves de API por empresa, com escopos, expiração obrigatória (até 1 ano) e revogação.
Chaves de produção (emt_live_) e de teste (emt_test_), com sandbox de respostas simuladas.
Header Authorization: Bearer (ou X-Api-Key).

Tomadores: criar, listar, consultar, alterar, remover e buscar por documento.
Itens de serviço: criar, listar, consultar, alterar e remover.
NFS-e: emitir (com Idempotency-Key obrigatória), consultar, listar com filtros, baixar XML e PDF, cancelar e substituir.
Eventos: histórico de eventos fiscais de cada nota.
Webhooks: criar, alterar, remover, testar e consultar entregas.
Conta e referência: dados da empresa, plano, limites e uso; busca de códigos de serviço e municípios.

Envelope de resposta {status, message, data} e de erro {status, message, code, details}.
Paginação por cursor (limit, cursor, next_cursor, has_more).
Valores monetários em string decimal e datas em ISO 8601 com fuso.
Rate limit por plano, com headers X-RateLimit-* e Retry-After.

Eventos do ciclo fiscal, automação, exportação, certificado e assinatura. Veja o catálogo.
Assinatura HMAC-SHA256, até 7 tentativas e desativação automática após 20 falhas seguidas.

Esta página foi útil?