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 (avulsos ou assinatura mensal).

Compre créditos avulsos ou assine um plano mensal com créditos incluídos.

curl -X POST "https://www.fiscal.jhonataversiane.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 avulsos e assinaturas

Compre créditos quando precisar ou contrate um plano mensal com franquia de créditos incluída (Pagar.me), com débito prévio 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 Pagar.me 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://www.fiscal.jhonataversiane.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 Planos

Compre créditos quando precisar ou assine um plano mensal

Dois modelos independentes e compatíveis: a compra avulsa de créditos não exige assinatura, e quem assina pode comprar créditos adicionais a qualquer momento. Cada emissão consome créditos conforme o tipo de documento.

Compra avulsa de créditos

  • Sem contratação obrigatória: compre créditos conforme a sua necessidade.
  • Pagamento por PIX ou cartão (Pagar.me); os créditos são liberados após a confirmação do pagamento.
  • Créditos avulsos não expiram e não são afetados por cancelamento de assinatura.
  • Compre novamente a qualquer momento.

Compra de valor livre: cada R$ 1,00 equivale a 1 crédito.

Criar conta e comprar créditos

Assinatura mensal com créditos incluídos

  • Mensalidade cobrada de forma recorrente pelo Pagar.me, com uma franquia de créditos a cada ciclo.
  • A franquia é liberada somente após a confirmação da cobrança, uma vez por ciclo.
  • Se os créditos incluídos acabarem, você compra créditos adicionais sem trocar de plano.
  • Você pode cancelar a renovação e continuar usando os benefícios já pagos até o fim do período vigente.
  • Troca de plano vale a partir da próxima renovação, sem cobrança extra.
Criar conta e escolher um plano
A contratação online de assinaturas ainda não está habilitada. A compra avulsa de créditos já está disponível.

Planos de assinatura

Valores, franquias e limites abaixo são os configurados no sistema e podem ser alterados; o contratado vale para o ciclo em andamento.

Desenvolvedor

R$ 49,90

por mês

100,00 creditos incluídos por mês

Para quem esta integrando e testando a API fiscal.

  • Empresas: limite padrão da plataforma
  • Todos os documentos fiscais disponíveis
  • Franquia não acumula para o ciclo seguinte
  • Créditos adicionais a qualquer momento

Profissional

R$ 99,90

por mês

300,00 creditos incluídos por mês

Para operacoes em crescimento com maior volume de emissoes.

  • Empresas: limite padrão da plataforma
  • Todos os documentos fiscais disponíveis
  • Franquia não acumula para o ciclo seguinte
  • Créditos adicionais a qualquer momento

Software House

R$ 199,90

por mês

1.000,00 creditos incluídos por mês

Para software houses que emitem em nome de varios clientes.

  • Empresas: limite padrão da plataforma
  • Todos os documentos fiscais disponíveis
  • Franquia não acumula para o ciclo seguinte
  • Créditos adicionais a qualquer momento

Enterprise

Sob consulta

preço, franquia e limites negociados

Preco, franquia e limites negociados sob medida.

  • Empresas: limite padrão da plataforma
  • Todos os documentos fiscais disponíveis
  • Franquia não acumula para o ciclo seguinte
  • Créditos adicionais a qualquer momento

Créditos consumidos por emissão

O mesmo consumo vale para créditos avulsos e de assinatura.

NF-e (modelo 55)

1,00

crédito por emissão autorizada

NFC-e (modelo 65)

1,00

crédito por emissão autorizada

NFS-e Nacional (DPS)

1,00

crédito por emissão autorizada

CT-e (modelo 57)

1,00

crédito por emissão autorizada

MDF-e (modelo 58)

1,00

crédito por emissão autorizada

CT-e OS (modelo 67)

1,00

crédito por emissão autorizada

Rejeições ou falhas na emissão devolvem os créditos ao lote de origem. Créditos de assinatura têm a validade do ciclo (salvo plano com acúmulo); créditos avulsos não expiram. Pagamentos seguros via Pagar.me.

Transparência Financeira

Como funcionam os créditos

01

Adicione créditos

Compre créditos avulsos por PIX ou cartão, ou contrate um plano mensal com franquia incluída.

02

Liberação após confirmação

Os créditos só são liberados depois que o Pagar.me confirma o pagamento. O retorno do navegador nunca libera saldo.

03

Emita com segurança

A cada emissão os créditos são debitados antes, consumindo primeiro os de assinatura (os que vencem antes) e depois os avulsos.

04

Confirmação ou estorno

Autorizada: o consumo é confirmado. Rejeitada ou com falha: os créditos voltam ao lote de origem.

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 avulsos ou assinatura mensal
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 cobrança é feita em créditos. Você pode comprar créditos avulsos quando precisar ou contratar um plano mensal que inclui uma franquia de créditos por ciclo. Cada emissão consome créditos conforme o tipo de documento (valores no site e no painel). Se a SEFAZ ou Prefeitura rejeitar a emissão ou ocorrer falha, os créditos são devolvidos ao lote de origem.

São modelos independentes. A compra avulsa não exige assinatura: você compra créditos por PIX ou cartão, eles não expiram e você pode comprar de novo a qualquer momento. A assinatura é uma mensalidade recorrente com uma franquia de créditos liberada a cada ciclo pago. Quem assina também pode comprar créditos adicionais sem trocar de plano, e uma compra avulsa nunca vira assinatura automaticamente.

Não há multa de fidelidade. A assinatura renova mensalmente pelo Pagar.me. Ao cancelar a renovação, nenhuma nova cobrança é feita e você continua usando os benefícios já pagos até o fim do período vigente. Créditos avulsos não são afetados. Se uma renovação for recusada, há um período de tolerância para regularizar o pagamento e você é avisado no painel.

Você pode comprar créditos adicionais a qualquer momento, sem trocar de plano. Por padrão, o consumo usa primeiro os créditos de assinatura que vencem antes e depois os avulsos. Os créditos de assinatura têm a validade do ciclo e, salvo plano com acúmulo, não passam para o ciclo seguinte; essa condição é informada antes da contratação.

Somente após a confirmação do pagamento pelo Pagar.me. O retorno do navegador após o checkout não libera créditos; um pagamento pendente fica aguardando e os créditos entram assim que for aprovado. A franquia de cada ciclo é liberada uma única vez.

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 Assinatura e créditos > Comprar créditos adicionais (ou Financeiro > Adicionar créditos), escolha um pacote ou um valor livre e pague via PIX ou cartão pelo Pagar.me. A confirmação é processada via webhook e os créditos são liberados após a aprovação.

Créditos avulsos comprados não expiram. Créditos de assinatura têm a validade do ciclo de cobrança (e acumulam somente se o plano permitir). Cancelar ou encerrar a assinatura não remove os créditos avulsos.

Os créditos já disponíveis continuam utilizáveis durante a tolerância de atraso. Pagamentos pendentes não liberam créditos até a confirmação. A emissão de documentos depende apenas do saldo disponível e dos recursos do seu plano.

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