Pular para o conteúdo
API REST + servidor MCP

Nota fiscal no seu SaaS em um prompt.

NF-e e NFS-e para quem constrói com Cursor, Claude Code e Lovable.

  • 7 dias grátis
  • Homologação ilimitada
  • PIX, sem fidelidade

Exemplo ilustrativo: no terminal, o usuário pede ao agente para integrar nota fiscal no checkout usando a Simplifisca; o agente lê a documentação, chama as ferramentas MCP salvar_servico e emitir_nfse e recebe o webhook de NFS-e autorizada.

Funciona com

  • Cursor
  • Claude Code
  • Windsurf
  • Lovable
  • Bolt
  • v0
  • Node
  • Python
  • cURL

Como funciona

Você manda JSON. A gente fala com a SEFAZ.

  1. 01 Crie a conta e a chave sf_live_...
  2. 02 Cadastre CNPJ e certificado A1 · .pfx
  3. 03 Emita e receba o webhook 202 → autorizada

Recursos

A parte chata do fiscal, resolvida.

Catálogo fiscal

O contador configura uma vez. A nota só precisa do código.

Webhooks assinados

HMAC-SHA256 e reenvio com backoff.

Fila com retentativa

SEFAZ caiu? A gente tenta de novo, sem duplicar.

Multi-CNPJ

Vários emitentes, cada um com seu A1 criptografado.

DANFE e DANFSe em PDF

Junto com o XML autorizado, prontos para baixar.

Idempotência

Repetiu a chamada? Continua sendo uma nota só.

Homologação ilimitada

Teste à vontade. Produção é um campo de distância.

"ambiente": "homologacao"

Não conta no plano Nota com validade fiscal · conta no plano

Painel

Tudo visível. Nada de caixa-preta.

Documentos, catálogo, logs com requestId, webhooks e uso do mês.

Ilustração do painel da Simplifisca com dados de exemplo: cartões de resumo do mês e lista de documentos com status autorizada, processando, rejeitada e cancelada.

Feito para agentes de IA

Seu agente integra. Você revisa.

Servidor MCP, llms.txt e um prompt pronto para colar.

claude mcp add --transport http simplifisca https://app.simplifisca.com.br/mcp \
  --header "Authorization: Bearer sf_live_SUA_CHAVE"

.cursor/mcp.json

{
  "mcpServers": {
    "simplifisca": {
      "url": "https://app.simplifisca.com.br/mcp",
      "headers": { "Authorization": "Bearer sf_live_SUA_CHAVE" }
    }
  }
}
Integre emissão de nota fiscal no meu SaaS usando a API da Simplifisca. Leia https://app.simplifisca.com.br/llms-full.txt. Cadastre meus produtos/serviços no catálogo fiscal. Quando um pagamento for confirmado, emita NF-e ou NFS-e referenciando só o código do catálogo, com Idempotency-Key = id do pagamento, e trate o webhook nfe.autorizada/nfse.autorizada validando X-Simplifisca-Assinatura. Use SIMPLIFISCA_API_KEY.

Endpoint MCP: https://app.simplifisca.com.br/mcp · Streamable HTTP

  • MCP remoto

    sem instalar nada

  • Mesma chave

    da API REST

  • llms.txt

    docs no contexto

13 ferramentas MCP
  • conta
  • listar_emitentes
  • cadastrar_emitente
  • enviar_certificado
  • listar_catalogo
  • salvar_produto
  • salvar_servico
  • emitir_nfe
  • emitir_nfse
  • consultar_documento
  • listar_documentos
  • cancelar_documento
  • exemplo_payload
Windsurf e outros clientes

Prefere escrever na mão?

Uma NFS-e, quatro campos.

O resto vem do catálogo fiscal.

  1. 202
  2. processando
  3. autorizada
Referência da API
curl -X POST https://app.simplifisca.com.br/api/v1/nfse \
  -H "Authorization: Bearer $SIMPLIFISCA_API_KEY" \
  -H "Idempotency-Key: pagamento-981" \
  -H "Content-Type: application/json" \
  -d '{
    "emitente": "11222333000181",
    "referencia": "pagamento-981",
    "tomador": { "cpfCnpj": "11144477735", "nome": "Cliente Exemplo" },
    "servico": { "codigo": "PLANO-PRO" }
  }'
const resp = await fetch("https://app.simplifisca.com.br/api/v1/nfse", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLIFISCA_API_KEY}`,
    "Idempotency-Key": pagamento.id,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    emitente: "11222333000181",
    referencia: pagamento.id,
    tomador: { cpfCnpj: "11144477735", nome: "Cliente Exemplo" },
    servico: { codigo: "PLANO-PRO" },
  }),
});
resp = requests.post(
    "https://app.simplifisca.com.br/api/v1/nfse",
    headers={
        "Authorization": f"Bearer {os.environ['SIMPLIFISCA_API_KEY']}",
        "Idempotency-Key": pagamento.id,
    },
    json={
        "emitente": "11222333000181",
        "referencia": pagamento.id,
        "tomador": {"cpfCnpj": "11144477735", "nome": "Cliente Exemplo"},
        "servico": {"codigo": "PLANO-PRO"},
    },
)
202 Accepted { "status": "processando", "tipo": "nfse" }

Preços

Pague pelas notas em produção.

Homologação é por nossa conta.

Start

Para o MVP que acabou de ganhar os primeiros clientes.

R$ 39,90 /mês

100 notas/mês produção
  • 3 CNPJs
  • NF-e + NFS-e
  • Webhooks + MCP
  • Homologação ilimitada
Começar grátis no plano Start
Mais popular

Pro

Para SaaS em tração emitindo todo dia.

R$ 129,90 /mês

1000 notas/mês produção
  • 20 CNPJs
  • NF-e + NFS-e
  • Webhooks + MCP
  • Homologação ilimitada
Começar grátis no plano Pro

Scale

Para plataformas que emitem em nome de muitos CNPJs.

R$ 389,90 /mês

5000 notas/mês produção
  • CNPJs ilimitados
  • NF-e + NFS-e
  • Webhooks + MCP
  • Homologação ilimitada
Começar grátis no plano Scale
  • Teste grátis de 7 dias
  • Homologação não conta no plano
  • PIX

FAQ

Perguntas frequentes

Sim, um certificado A1 (.pfx) por emitente. Você envia uma vez pela API ou pelo painel e ele fica guardado criptografado.

Sim. A API aceita CSOSN (Simples Nacional) e CST de ICMS (regime normal), além de PIS e COFINS. O regime é definido por emitente.

Os aderentes ao Padrão Nacional da NFS-e. Confirme se o município do seu emitente já aderiu antes de integrar.

Não. Homologação é ilimitada; só notas emitidas em produção contam no limite mensal.

A nota fica em processando e é retentada automaticamente, com checagem de duplicidade. Você recebe o webhook quando ela for concluída.

Sim. Qualquer ferramenta que gera código integra via REST lendo o llms-full.txt. Clientes com MCP remoto, como Cursor, Claude Code e Windsurf, conectam direto.

Não. NCM, CFOP e tributação vêm do seu contador, que pode configurar tudo uma vez no catálogo fiscal. A API cuida do XML, da SEFAZ e do DANFE.

Sim, sem fidelidade e sem multa. O pagamento é mensal via PIX.

Emita a primeira nota hoje.

Conta, chave, prompt. Pronto.

7 dias grátis · homologação ilimitada · sem fidelidade