Ir para o conteúdo principal
NFS-e Nacional obrigatória em Set/2026 — Migre antes da multidãoSaiba mais
NotaFácil API

Changelog

Histórico de versões e mudanças na API.

2026-05-01

v1.1.0

Novo
  • •Sandbox público sem cadastro (sk_test_sandbox_demo) — testa em 30 segundos
  • •Developer portal com referência interativa Scalar, guias e playground
  • •Spec OpenAPI 3.1 completa em docs/openapi.yaml — fonte de verdade para SDKs
  • •Tipos TypeScript gerados automaticamente via openapi-typescript no CI
  • •Rate limiter in-memory por IP para o sandbox (20 req/hora)

2026-04-30

v1.0.0

Novo
  • •POST /v1/nfse — emissão assíncrona de NFS-e via Receita Federal Nacional
  • •GET /v1/nfse — listagem paginada com filtros de status e competência
  • •GET /v1/nfse/:id — consulta de status com todos os detalhes da nota
  • •DELETE /v1/nfse/:id — cancelamento de nota autorizada
  • •GET /v1/nfse/:id/pdf e /xml — download de documentos
  • •GET /v1/billing/usage — consumo do mês com limite do plano
  • •GET /v1/billing/portal — URL do Stripe Customer Portal
  • •POST /v1/billing/checkout — criação de sessão de checkout Stripe
  • •Webhook engine: publicação no RabbitMQ, consumer, HMAC-SHA256, requeuer
  • •Dashboard Next.js: listagem de notas, detalhe, billing com progress bar
  • •Poller de NFS-e: consulta automática de notas PROCESSANDO a cada 30s
  • •Suporte a certificado A1 via AWS Secrets Manager (NoopSigner em dev)
  • •CI com golangci-lint (errcheck, staticcheck, revive, bodyclose, gofmt)
  • •Testes unitários: auth, nfse/adapter, webhook/consumer, document/builder
  • •Testes de integração: handler Fiber (health, auth, NFS-e validation)
  • •k6 load test: smoke/load/spike — p95 < 500ms, error rate < 1%
  • •Deploy checklist em docs/deploy-checklist.md