Plataforma multiempresa de emissão de NFS-e nacional, com painel e API comercial. Monólito modular NestJS + TypeScript com processo web/API e processo de tarefas separados.
POST /v1/organizations com o header x-bootstrap-token cria a organização.POST /v1/bootstrap/api-keys gera a primeira chave de API (o segredo é exibido uma única vez).Authorization: Bearer <chave> e escopos
(companies:read, companies:write, certificates:write, audit:read, admin).POST /v1/organizations · POST /v1/bootstrap/api-keys · POST /v1/api-keys
Criação da organização (bootstrap) e emissão, listagem e revogação de chaves com escopos.
POST /v1/companies · GET /v1/companies/{id}/readiness
Cadastro de emitentes, acesso isolado por organização e verificação de prontidão de emissão.
POST /v1/companies/{id}/fiscal-profiles · POST /v1/companies/{id}/eligibility-checks
Perfil tributário versionado (regime derivado) e verificações de elegibilidade.
POST /v1/companies/{id}/certificates
Metadados do certificado A1 e guarda cifrada (cofre). Chave privada nunca é exposta.
POST · GET /v1/services · GET /v1/services/links
Códigos de serviço da organização e vínculo por empresa.
POST · GET /v1/invoices · GET /v1/invoices/{id}/xml · /pdf · /cancel · /email
Emissão com fila, idempotência, numeração, eventos, DANFSe/XML, cancelamento e reconciliação.
POST · GET /v1/webhook-endpoints · GET /v1/webhook-endpoints/{id}/deliveries
Destinos HTTPS com assinatura HMAC, proteção anti-SSRF, retentativa e histórico de entregas.
GET /v1/audit-logs · GET /v1/invoices/usage/summary
Trilha de auditoria da organização e consumo medido de autorizações.
POST /v1/admin/process-jobs
Processamento da fila de emissão (escopo admin).
GET /v1/fiscal/environments · GET /v1/fiscal/capabilities
Dois ambientes de emissão: sandbox (Produção Restrita, tpAmb=2, sem validade fiscal) e production (tpAmb=1, com validade fiscal).