Logo Novidade

API Fiscal SysVelox.

Emita NF-e, NFC-e e NFS-e direto do seu sistema, sem reescrever o motor fiscal do zero. Uma API REST pensada para múltiplos CNPJs por conta, idempotência de verdade e ambientes de teste e produção separados desde a credencial.

Acessar a API Falar com a equipe
Exemplo

Emissão em uma chamada

A API responde na hora com o status processando e cuida da assinatura, transmissão e retorno da SEFAZ ou do sistema municipal de forma assíncrona — seu sistema nunca fica esperando.

# emitir uma NFC-e curl -X POST https://api.sysvelox.com/v1/nfce \ -H "Authorization: Bearer sk_test_..." \ -H "Idempotency-Key: venda-123" \ -d '{"company_id":"emp_xxx","items":[...]}' { "id": "nf_xxx", "status": "processando" } # consultar depois curl https://api.sysvelox.com/v1/notas/nf_xxx \ -H "Authorization: Bearer sk_test_..." { "status": "autorizado", "chave_acesso": "..." }
O que a API faz

Três documentos, uma única integração

NF-e — modelo 55Operações entre empresas. XML e DANFE prontos após a autorização da SEFAZ.
NFC-e — modelo 65Venda direta ao consumidor, pensada para o fluxo de um PDV.
NFS-e — padrão nacionalPrestação de serviços, por município já aderente ao Sistema Nacional NFS-e.
Como funciona

Do pedido à nota autorizada

Pensada para nunca travar a venda do seu cliente esperando a SEFAZ responder.

1
Seu sistema chama a API

Um POST com os dados do documento e um Idempotency-Key único por venda ou operação. A resposta chega em milissegundos, com status processando.

2
A fila assina e transmite

Um worker assíncrono assina o XML, transmite para a SEFAZ (ou webservice municipal, no caso de NFS-e) e trata rejeições e reprocessamento — sem bloquear a requisição original.

3
Você é avisado, ou consulta quando quiser

Um webhook assinado com HMAC chega assim que o resultado sai (autorizado, rejeitado, cancelado). Se preferir, o mesmo status pode ser consultado a qualquer momento pelo endpoint de status.

4
Reenviar não duplica

Se a conexão cair e seu sistema reenviar a mesma requisição com o mesmo Idempotency-Key, a API devolve o mesmo documento — a garantia é feita no banco de dados, não só na aplicação.

Idempotência de verdade

Reenviar a mesma requisição nunca duplica um documento — a garantia é no banco, não só na aplicação. Testado sob concorrência real, não só em teoria.

Multi-CNPJ por conta

Uma conta, vários CNPJs, franquia de documentos compartilhada. Sem limite artificial de quantos CNPJs uma conta pode ter.

Webhooks assinados

Receba autorização, rejeição e cancelamento em tempo real, com assinatura HMAC e reenvio automático em caso de falha.

Teste e produção separados

Chaves sk_test_ e sk_live_ distintas — o ambiente vem da credencial, nunca de um campo que o seu sistema poderia errar.

XML e DANFE prontos

Baixe o XML autorizado e o PDF (DANFE/DANFCE/DANFSE) direto pela API, sem montar nada manualmente.

Rate limit e franquia claros

Limite de requisições por minuto e franquia mensal de documentos sempre visíveis nos headers da resposta — sem surpresa.

A API está em fase de disponibilização gradual. Emissão de NF-e/NFC-e e NFS-e (padrão nacional) já validadas em ambiente real; cobertura de municípios para NFS-e está sendo expandida progressivamente.
Referência

Endpoints principais

Um pequeno conjunto de rotas cobre todo o ciclo de vida do documento fiscal.

MétodoRotaO que faz
POST /v1/nfce Emite uma NFC-e (modelo 65) — venda direta ao consumidor.
POST /v1/nfe Emite uma NF-e (modelo 55) — operação entre empresas.
POST /v1/nfse Emite uma NFS-e (padrão nacional) — prestação de serviços, por município aderente.
GET /v1/notas/{id} Consulta o status de um documento (processando, autorizado, rejeitado, cancelado).
GET /v1/notas/{id}/xml Baixa o XML autorizado pela SEFAZ ou pelo sistema municipal.
GET /v1/notas/{id}/danfe Baixa o PDF (DANFE, DANFCE ou DANFSE) pronto para impressão ou envio ao cliente.
POST /v1/notas/{id}/cancelamento Cancela um documento já autorizado, dentro do prazo fiscal permitido.
Segurança

Isolamento levado a sério

Chaves nunca em texto puroAPI keys são armazenadas com hash, nunca em texto plano no banco.
Certificado protegidoSenha do certificado digital criptografada com chave mestra fora do banco de dados.
Isolamento por contaCada conta só enxerga seus próprios CNPJs, documentos e chaves — sem exceção.
Auditoria de açõesAções sensíveis ficam registradas para consulta e investigação posterior.
Dúvidas comuns

Perguntas frequentes

Preciso instalar alguma biblioteca fiscal no meu sistema?

Não. Sua aplicação só faz chamadas HTTP/JSON — assinatura digital, comunicação com a SEFAZ, geração de XML e montagem de DANFE ficam por conta da API.

O que acontece se eu enviar a mesma requisição duas vezes por engano?

Nada duplicado. Cada chamada leva um cabeçalho Idempotency-Key, e a garantia de não duplicar é feita no banco de dados — não depende de lógica da aplicação, que pode falhar sob concorrência.

Minha empresa tem mais de um CNPJ, preciso de mais de uma conta?

Não. Uma conta pode ter múltiplos CNPJs cadastrados, todos compartilhando a mesma franquia de documentos do plano.

Como funciona o ambiente de testes?

Toda chave de API já nasce marcada como sk_test_ (testes) ou sk_live_ (produção). O ambiente é decidido pela credencial usada na chamada, nunca por um campo que seu sistema poderia errar.

Como eu sei quando uma nota foi autorizada?

A resposta imediata da API só confirma que a emissão entrou na fila. A confirmação real (autorizada, rejeitada) chega por webhook assinado, ou pode ser consultada a qualquer momento pelo endpoint de status.

Quer integrar seu sistema à API Fiscal?

Fale com a equipe para conhecer os planos, a documentação técnica e solicitar acesso antecipado.

Falar no WhatsApp Formulário de contato