Changelog
Tudo público. Breaking changes nunca chegam à produção sem deprecation period de 90 dias.
2026-05-11 — Marcos 4.1+, 5.1, 5.1b, 5.2, 6.1, 6.2, 6.3, 6.4, 7.4, 7.5
Adicionado
- DevPortal Stripe-like (este site) — Nextra v4 hospedado em dev.zfiscoo.zek.app.br com Quickstart, 8 guias, 5 recipes (Next/Bun/Deno/Python/PHP)
- 2FA TOTP no dashboard (
/v1/auth/2fa/setup) com recovery codes one-shot SHA-256 - WebAuthn passkeys — Touch ID, Yubikey, Windows Hello (
/v1/auth/webauthn/*); login flow aceita TOTP OU passkey - SSO Google + Microsoft OAuth (
/v1/auth/oauth/{google,microsoft}/{start,callback}) com PKCE S256 + state HMAC-signed - Team RBAC — 5 roles (owner/admin/billing/developer/viewer) +
/v1/team/invites - HSM dual-mode —
envelope(default) ouaws-kms(opcional). Migração viaPOST /v1/issuers/:id/migrate-cert-to-kms - ICMS Normal completo — CST 00/10/20/40/60/70/90 + DIFAL EC 87/2015 + FCP por UF + matriz interestadual 27×27
- Reforma 2026 — campos
vIBS/vCBS/vISem InvoiceItem, flagAccount.taxRegime - DANFE template variables —
Issuer.danfeLogo,danfePrimaryColor,danfeFooterText - Notificações in-app — sino + SSE em
GET /v1/notifications/stream - Worker
cert-expiry— webhook + email + notif quando cert expira em 30/14/7/1 dia - k6 load test —
tools/loadtest/nfce-burst.js, 1000 req/s sustentado no sandbox - Metabase self-hosted em metabase.zek.app.br — MRR/ARR/churn/conversion dashboards
Documentação
- ISO 27001 readiness completo em
docs/security/iso27001-readiness.md - Risk register público em
docs/security/risk-register.md - Asset inventory em
docs/security/asset-inventory.md
2026-04-XX — Marco 4 (Paridade B2B)
Adicionado
- NF-e modelo 55 — destinatário PJ + ICMS interestadual + ST + DIFAL + transporte + cobrança
- Eventos NF-e — CCe (
POST /v1/nfe/:id/cce), manifestação (POST /v1/nfe/:id/manifestation) - NFS-e SP capital — ABRASF padrão via
POST /v1/nfse Application.scopes— granularidade de acesso por API key
2026-03-XX — Marco 3 (DX First)
Adicionado
- OpenTelemetry → Grafana Cloud — métricas custom (
nfce_emit_durationpor UF,bullmq_queue_depth) - Statuspage público — status.zek.app.br (cstate.io)
- Sandbox público sem cadastro —
sandbox.zfiscoo.zek.app.br, key fixa rate-limited 60req/min - Página
/pricingcom calculadora — sliders volume × UF × tipo doc - SDK types auto —
tools/gen-sdk-types/extrai do/docs/json, CI bloqueia merge se desatualizado - Webhook Playground —
/webhooks/[id]/playgroundno dashboard com tabs Deliveries / Send Test / Signature - DevPortal — esta documentação, em Nextra v4
2026-02-XX — Marco 2 (Competitivo)
Adicionado
- 27 UFs NFC-e configurados (SP
supported, 26configured) - Idempotency-Key Stripe-style em 17 endpoints
X-RateLimit-*em todas responses- Audit log LGPD + force-cancel account
- SDK npm
zfiscoo-sdk@0.1.0publicado
2026-01-XX — Marco 1 (Lançável)
Adicionado
- API Fastify + Zod + OpenAPI 3.0 válido
- Dashboard Next.js com signup / login / billing / multi-tenant
- Billing Asaas end-to-end (cartão / PIX / boleto)
- Docker Swarm + Traefik + Let’s Encrypt + GHCR self-hosted runner
Notas de release detalhadas + diffs em github.com/zek-tecno/fiscal-gateway/releases .