API REST · NF-e · NFC-e · NFS-e Nacional · CT-e · CT-e OS · MDF-e · Produtor Rural

Envie o mínimo. A API faz o resto.

Plataforma Fiscal unificada. Simples de integrar, completa para emitir.

Emita NF-e, NFC-e, NFS-e Nacional, CT-e, CT-e OS e MDF-e com JSON simplificado, Motor Tributário Centralizado, suporte à Reforma Tributária (IBS/CBS) e cobrança transparente por créditos.

Sem mensalidade. Adicione créditos e pague somente pelas emissões realizadas.

curl -X POST "https://fiscal.versianecode.com.br/api/v1/nfe" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pedido":"PED-12345","cliente":"CLI001","itens":[{"codigo":"PROD001","quantidade":2}],"pagamento":"pix"}'
AUTORIZADA
SEFAZ / Município · protocolo
Motor Tributário
regras por vigência temporal
Recursos da Plataforma

Todos os documentos fiscais em uma única arquitetura moderna

Elimine a complexidade de regras tributárias, schemas XML, certificados e webhooks. Seu sistema envia dados comerciais e a API cuida de todo o ecossistema fiscal.

JSON simplificado

Envie apenas dados comerciais essenciais. Emitente, certificado A1, série, numeração e regras fiscais são resolvidos pela plataforma.

Motor Tributário Central

Motor unificado com vigência pela data da operação. Resolve ICMS, ISS, PIS, COFINS, IBS/CBS, retenções e benefícios fiscais automaticamente.

NF-e e NFC-e

Emissão, consulta, XML autorizado, DANFE e DANFCE em PDF, QR Code, cancelamento, Carta de Correção (CC-e) e inutilização.

NFS-e Nacional

Emissão no Sistema Nacional da NFS-e (DPS 1.00, REST/JSON), DANFSe em PDF via sped-da, cancelamento e catálogo de serviços.

CT-e, CT-e OS e MDF-e

Transporte rodoviário completo: CT-e (mod 57), CT-e OS (mod 67: pessoas, valores e excesso de bagagem) e MDF-e (mod 58), vinculação por cte_id, DACTE, DACTE OS e DAMDFE em PDF, e controle de condutores/veículos.

Produtor Rural

Emissão de NF-e para produtor rural pessoa física (CPF + IE) e jurídica, gestão de propriedades e regras versionadas de diferimento, isenção e benefícios (cadastradas com fundamento legal).

Importação de XML (DF-e)

Busque na SEFAZ as NF-e, CT-e e MDF-e emitidos contra o CNPJ da sua empresa (Distribuição DF-e), com sincronização incremental, XML guardado e Manifestação do Destinatário.

Status da SEFAZ

Status em tempo real de NF-e, NFC-e, CT-e, CT-e OS e MDF-e (consulta oficial de serviço) e conectividade da NFS-e Nacional, no painel e em GET /sefaz/status.

Multiempresa

Várias empresas (CNPJ ou CPF) por conta, cada uma com certificado, séries, ambiente e módulos próprios, totalmente isoladas entre si.

Snapshots e Auditoria

Snapshot fiscal imutável assinado com hash SHA-256 por emissão e auditoria rigorosa de substituições manuais (overrides) com justificativa.

Processamento Assíncrono

Receba solicitações mesmo com a SEFAZ indisponível: fila persistente, retentativas automáticas, consulta antes de reenviar (sem duplicidade) e aviso quando o resultado oficial for confirmado.

Notificações Fiscais

Painel, webhook (fiscal.document.*) e e-mail (PHPMailer) por mudança relevante: autorizada, rejeitada com o motivo ou ação necessária, sem aviso a cada tentativa.

Webhooks Confiáveis

Notificações em tempo real com assinatura HMAC-SHA256, retry exponencial automático, proteção anti-replay e anti-SSRF.

Créditos pré-pagos

Sem mensalidades ou contratos fixos: adicione créditos via Mercado Pago e pague por emissão, com reserva prévia e estorno automático em falhas.

Documentos Suportados

Emissão ponta a ponta com PDFs auxiliares

Suporte nativo aos principais modelos de documentos fiscais eletrônicos brasileiros, com geração local de PDFs, eventos e cancelamento.

NF-e (modelo 55)

  • Emissão, consulta e status
  • XML autorizado e chave de acesso
  • DANFE em PDF via sped-da
  • Cancelamento, CC-e e Inutilização
  • Prévia com /nfe/preview

NFC-e (modelo 65)

  • Emissão ágil para varejo
  • DANFCE em PDF com QR Code
  • Cliente opcional / consumidor final
  • Cancelamento homologado
  • Prévia com /nfce/preview

NFS-e Nacional (DPS)

  • Padrão Nacional unificado (DPS 1.00)
  • Catálogo próprio de serviços (/servicos)
  • DANFSe em PDF via sped-da
  • Cancelamento integrado
  • Prévia com /nfse/preview

CT-e (modelo 57)

  • Modal rodoviário de cargas
  • ICMS de transporte por origem/destino
  • DACTE em PDF via sped-da
  • Cancelamento, CC-e e Desacordo
  • Prévia com /cte/preview

CT-e OS (modelo 67)

  • Transporte de pessoas, de valores e excesso de bagagem
  • Fretamento: TAF ou Registro Estadual, veículo e viagem
  • ICMS do transporte pelo Motor (CFOP só por regra ou declarado)
  • DACTE OS em PDF via sped-da
  • Prévia com /cteos/preview

MDF-e (modelo 58)

  • Manifesto de carga rodoviário
  • Vinculação de CT-e por ID sem redigitação
  • DAMDFE em PDF via sped-da
  • Condutores e veículos cadastrados
  • Encerramento e cancelamento

Produtor Rural

  • PF (CPF + Inscrição Estadual) e PJ
  • Cadastro de propriedades rurais
  • Diferimento, redução e isenção somente por regra cadastrada com fundamento legal
  • CFOP e ICMS resolvidos pelo Motor, com revisão quando faltar regra
  • NFF: arquitetura preparada para expansão (ainda não integrada)
Processamento Assíncrono

Nenhuma solicitação se perde quando a SEFAZ cai

A API registra a solicitação numa fila persistente, transmite quando possível, repete com intervalo progressivo, confirma o resultado oficial e avisa você. Receber não é autorizar: o status só vira Autorizada com a confirmação do serviço fiscal.

Fila persistente

POST /fiscal/solicitacoes ou Prefer: respond-async devolvem um identificador de acompanhamento; a tarefa fica no MySQL, sobrevive a reinícios e é processada por workers.

Retentativas inteligentes

Falhas temporárias são repetidas com intervalo progressivo e variação aleatória; rejeições e erros de dados não geram tentativas ilimitadas e pedem sua correção.

Sem duplicidade

Timeout após o envio? A fila consulta a situação antes de qualquer reenvio e só retransmite se a SEFAZ confirmar que nunca recebeu. Créditos debitados uma única vez.

Notificação confiável

Aviso no painel, webhook assinado (fiscal.document.authorized/rejected/action_required) e e-mail, criados junto com a confirmação fiscal, sem repetir a cada tentativa.

NF-e, NFC-e, NFS-e Nacional, CT-e, CT-e OS e MDF-e · painéis do cliente e do administrador · workers por cron ou Agendador de Tarefas · e-mail depende da configuração SMTP da plataforma.

Produtor Rural

Emissão Fiscal para Produtor Rural

Pessoa física (CPF + IE) ou jurídica emitem pela mesma NF-e modelo 55 da plataforma, com o contexto PRODUTOR_RURAL e regras rurais no Motor Tributário.

Produtor PF e PJ

Cadastro com CPF e inscrição estadual (certificado e-CPF) ou CNPJ, com múltiplas propriedades rurais.

Produtos agropecuários

Qualquer produto com NCM e classificação rural; o NCM nunca é deduzido pela descrição.

Regras com fundamento

Diferimento, redução, isenção, suspensão e cBenef só entram por regra versionada com fonte e fundamento legal; sem regra, a emissão pede revisão.

Arquitetura preparada para NFF

O roteador de documentos já separa o fluxo da Nota Fiscal Fácil, que ainda não está integrada.

Como funciona

Comece a emitir em 6 passos

01

Crie sua conta

Cadastro rápido e seguro, sem exigir dados fiscais na entrada.

02

Configure sua empresa

Informe o CNPJ, importe dados oficiais, envie o certificado A1 e configure regras fiscais.

03

Gere sua API Key

Crie chaves com escopos dedicados (leitura/escrita por módulo) e comece no ambiente de homologação.

04

Adicione créditos

Pague por PIX ou cartão no Mercado Pago e o saldo é liberado automaticamente na sua carteira.

05

Integre via API REST

Envie o JSON mínimo para NF-e, NFC-e, NFS-e, CT-e, CT-e OS, MDF-e ou simule cálculos tributários sem emitir.

06

Receba XML, PDFs e Webhooks

Receba retorno imediato com chave de acesso e PDF auxiliar, além de notificações assíncronas via Webhook.

Fluxo unificado: Cadastro → Empresa & Certificado A1 → Regras no Motor Tributário → API REST → Documento Autorizado + PDF + Webhook.

Motor Tributário Central

Cálculo fiscal inteligente com vigência e auditoria

O Motor Tributário centraliza a lógica fiscal de todos os documentos. Ele resolve regras pelo período de vigência baseado na data da operação, aplica regras municipais, estaduais e federais, e gera um snapshot imutável para compliance fiscal.

  • Vigência Temporal: alíquotas e regras consultadas pela data da operação, garantindo precisão histórica.
  • Simulação sem emissão: endpoints POST /fiscal/calcular e POST /fiscal/validate para verificar impostos antes de autorizar.
  • Snapshot Fiscal Imutável: gravação do cálculo detalhado com assinatura SHA-256 contra adulterações.
  • Overrides Auditados: substituições manuais de cálculo registram usuário, data e justificativa obrigatória.
  • Bases Fiscais Importáveis: atualizadores versionados (com fonte e versão obrigatórias) para CFOP, NCM, NBS, cClassTrib, IBS/CBS, LC 116 e municípios.

Fluxo do Motor Tributário

Seu sistema (ERP / E-commerce / SaaS)
↓
JSON Comercial Simplificado
↓
Validação de Escopos & Idempotência
↓
Motor Tributário Central (Vigência + Regras)
↓
Snapshot Fiscal (Hash SHA-256)
↓
NF-e · NFC-e · NFS-e · CT-e · CT-e OS · MDF-e

Se faltar qualquer regra necessária, a API responde 422 informando exatamente os campos e parâmetros que precisam ser cadastrados.

JSON Simplificado

Envie menos. Deixe a API fazer o resto.

Seu sistema envia o pedido, cliente/tomador, itens comerciais e valores. A API obtém emitente, certificado, série, numeração e resolve CFOP, CST, tributos, IBS/CBS e documentos auxiliares.

  • Autenticação Segura: Bearer Token ou cabeçalho X-API-Key com escopos granulares.
  • Idempotência Completa: envie o cabeçalho Idempotency-Key para proteção total contra duplicidade.
  • Respostas Padronizadas: retornos consistentes com request_id em todas as requisições.
  • Webhooks Assinados: notificações com chave secreta HMAC-SHA256 e proteção contra replay.
POST https://fiscal.versianecode.com.br/api/v1/nfe
{
    "pedido": "PED-12345",
    "cliente": "CLI001",
    "itens": [
        {
            "codigo": "PROD001",
            "quantidade": 2
        }
    ],
    "pagamento": "pix"
}
{
    "success": true,
    "status": "AUTORIZADA",
    "id": "43",
    "numero": 1,
    "serie": 1,
    "chave": "3524...",
    "protocolo": "135240000000001",
    "xml": "/api/v1/nfe/43/xml",
    "danfe": "/api/v1/nfe/43/danfe",
    "request_id": "req_a1b2c3d4e5f6a7b8c9d0"
}

Exemplo real do contrato da API. Resposta instantânea com chave de acesso, protocolo e links de XML e PDF.

Reforma Tributária

Pronta para o novo IVA brasileiro (IBS e CBS)

Sua empresa preparada para a transição tributária com motor inteligente de regras por vigência temporal.

IBS Estadual e Municipal

Alíquotas segregadas por estado e município de destino, com suporte a redução de base e diferimento.

cClassTrib e novos CSTs

Classificação tributária nacional com código cClassTrib de 6 dígitos e CSTs novos integrados às regras.

Vigência Temporal Dinâmica

Cada regra possui período de início e fim. O motor aplica a tributação correta de acordo com a data da operação.

Créditos e Preços

Pague somente pelo que utilizar

Sem assinaturas ou custos fixos mensais. Adicione créditos pré-pagos e consuma conforme emitir seus documentos fiscais.

NF-e (modelo 55)

R$ 1,00

por emissão autorizada

NFC-e (modelo 65)

R$ 1,00

por emissão autorizada

NFS-e Nacional (DPS)

R$ 1,00

por emissão autorizada

CT-e (modelo 57)

R$ 1,00

por emissão autorizada

MDF-e (modelo 58)

R$ 1,00

por emissão autorizada

CT-e OS (modelo 67)

R$ 1,00

por emissão autorizada

Rejeições ou falhas na emissão possuem estorno imediato ao seu saldo. Pagamentos seguros processados via Mercado Pago (PIX e Cartão).

Transparência Financeira

Como funcionam os créditos

01

Adicione saldo

Escolha qualquer valor a partir de R$ 10,00 e pague via PIX ou cartão na plataforma.

02

Liberação imediata

Após a confirmação, o saldo fica instantaneamente disponível na sua carteira fiscal.

03

Emita com segurança

A cada chamada da API, o valor é reservado previamente para garantir o processo.

04

Confirmação ou Estorno

Se a nota for autorizada, o valor é confirmado. Se for rejeitada, é estornado ao saldo.

Benefícios

Tudo o que sua empresa precisa em um único lugar

API REST moderna em JSON
NF-e e NFC-e completas
NFS-e Nacional (DPS 1.00)
CT-e, CT-e OS e MDF-e Rodoviário
Produtor Rural (PF e PJ)
Motor Tributário Centralizado
Reforma Tributária (IBS e CBS)
DANFE, DACTE, DACTE OS, DAMDFE e DANFSe
Importação de XML (Distribuição DF-e)
Status da SEFAZ de todos os documentos
Fila assíncrona com retentativas automáticas
Notificações no painel, webhook e e-mail
Webhooks com HMAC-SHA256
Snapshots Fiscais Imutáveis
Idempotência e Previews nativos
Créditos pré-pagos sem mensalidade
Ambiente de homologação gratuito
Consulta de CNPJ automatizada
Auditoria completa de logs fiscais
Segurança

Segurança e conformidade em primeiro lugar

API Keys Hashed

Chaves exibidas apenas no momento da criação; apenas hashes SHA-256 são mantidos.

Proteção de Credenciais

Senhas de certificado e dados sensíveis são criptografados e mascarados em todos os logs.

Rate Limiting & Anti-DDoS

Controle rigoroso de taxa por chave com cabeçalhos padrão Retry-After.

Isolamento Multi-tenant

Cada cliente e empresa possui segregação total de dados, carteiras e documentos fiscais.

FAQ

Perguntas frequentes

A plataforma utiliza créditos pré-pagos. Você adiciona saldo à sua carteira e cada emissão consome o valor correspondente ao documento fiscal. Se a SEFAZ ou Prefeitura rejeitar a emissão ou ocorrer falha, o valor reservado é estornado automaticamente ao seu saldo.

Não. A plataforma opera exclusivamente no modelo pré-pago por emissão, sem mensalidades, assinaturas, franquias mínimas ou taxas ocultas.

Suporte completo para NF-e (modelo 55), NFC-e (modelo 65), NFS-e Nacional (DPS 1.00), CT-e (modelo 57 - transporte rodoviário de cargas), CT-e OS (modelo 67 - transporte de pessoas, de valores e excesso de bagagem) e MDF-e (modelo 58 - manifesto de carga rodoviário), além de NF-e para Produtor Rural (PF com CPF + IE e PJ). Todos com geração local de documentos auxiliares em PDF (DANFE, DANFCE, DANFSe, DACTE, DACTE OS e DAMDFE).

O Motor Tributário resolve tributação (ICMS, ISS, PIS, COFINS, IBS/CBS, retenções e benefícios) utilizando a data da operação para consultar regras vigentes na sua empresa. Ele gera snapshots fiscais imutáveis com hash SHA-256 e permite simulações antecipadas via POST /fiscal/calcular e POST /fiscal/validate sem emitir documento.

No painel, em Financeiro > Adicionar créditos, escolha o valor desejado e pague via PIX ou cartão de crédito pelo Mercado Pago. A confirmação é processada via webhook e o saldo é liberado instantaneamente.

Não. Os créditos adicionados permanecem disponíveis na sua carteira até serem utilizados, sem expiração.

O sistema já possui arquitetura e regras para a Reforma Tributária, com cadastro e resolução de IBS (alíquota estadual e municipal), CBS, classificação cClassTrib de 6 dígitos e CSTs novos, calculados conforme a data da operação para transição suave.

O certificado A1 (.pfx) é validado quanto à titularidade (CNPJ) e validade, armazenado em diretório privado protegido e sua senha é criptografada no banco de dados, nunca sendo exposta em logs ou respostas.

Use o modo assíncrono (POST /fiscal/solicitacoes ou o header Prefer: respond-async): a solicitação fica numa fila persistente e o worker transmite quando o serviço voltar, com tentativas automáticas progressivas. Se a transmissão ficar sem resposta, a fila consulta a situação do documento antes de reenviar, evitando duplicidade. Receber a solicitação não significa que ela foi transmitida ou autorizada: acompanhe o status (Autorizada ou Rejeitada = resultado oficial) ou receba o webhook/e-mail de confirmação.

Ao cadastrar sua URL de webhook, enviamos notificações automáticas para eventos de emissão, autorização, rejeição e cancelamento. Todas as requisições incluem a assinatura criptográfica HMAC-SHA256 no cabeçalho X-Webhook-Signature e timestamp para proteção contra ataques de replay.

Sim. Chaves de teste (prefixo fiscal_test_) operam em ambiente de homologação da SEFAZ e prefeituras, permitindo homologar fluxos completos sem custo e sem valor fiscal.

Nossa API implementa idempotência nativa com suporte ao cabeçalho Idempotency-Key e identificação por empresa + módulo + pedido. Reenviar o mesmo pedido retorna a emissão original sem duplicar notas nem débitos.

Toda requisição gera um cabeçalho request_id único. Basta informar esse identificador ao suporte para localizarmos os logs e detalhes da operação instantaneamente.

Pronto para transformar sua emissão fiscal?

Configure sua empresa, gere sua API Key, adicione créditos e integre sua aplicação em minutos.

WhatsApp