Pular para o conteúdo
MCPEmita nota conversando com a IA

Nota fiscal sem rejeição surpresa.

O SendNF valida cada NFS-e e NFC-e no layout oficial antes de transmitir. Cadastre a empresa pelo CNPJ, veja o que falta com o passo a passo e emita pela API, pelo painel ou pedindo para a IA.

  • Sistema Nacional e prefeituras com sistema próprio
  • Homologação ilimitada grátis
  • Sem cartão de crédito
api.sendnf.compré-emissão

POST/v1/nfse/preview

taker: "Acme Tecnologia Ltda"

service_code: "010101"

unit_amount: 150000 // R$ 1.500,00

  • Empresa ativa na Receita
  • Certificado A1 do mesmo CNPJ
  • Sistema da cidade
  • Código de serviço na lista
  • NBS do serviço
  • Layout oficial (XSD)
ok: trueEmitir nota

NFS-e nº 1042

Acme Tecnologia Ltda

R$ 1.500,00

AutorizadaPDF e XML enviados

Dados oficiais que o SendNF usa para emitir

Pré-emissão

Veja o erro antes da prefeitura

A pré-emissão monta a nota, assina e valida no layout oficial (ou no provedor da prefeitura) sem transmitir. O que estiver errado volta explicado, com o guia para resolver. Não conta no seu plano.

Como funciona a pré-emissão

Escolha um caso e veja a resposta

POST /v1/nfse/preview Pronta para emitir
  • Empresa e regime: passou
  • Certificado A1: passou
  • Sistema da cidade: passou
  • Código de serviço: passou
  • NBS: passou
  • Layout oficial: passou
{
  "ok": true,
  "route": {
    "system": "nacional",
    "provider": null,
    "reason": "A prefeitura emite pelo Sistema Nacional da NFS-e."
  },
  "validated": "schema",
  "problems": [],
  "warnings": [],
  "totals": { "gross": 150000, "discount": 0, "total": 150000 }
}
Nada transmitido, nada cobrado.próximo: POST /v1/nfse
POST /v1/nfse/preview Barrada antes da prefeitura
  • Empresa e regime: passou
  • Certificado A1: falhou
  • Sistema da cidade: passou
  • Código de serviço: passou
  • NBS: passou
  • Layout oficial: não conferido
{
  "ok": false,
  "validated": null,
  "problems": [{
    "code": "certificate_cnpj",
    "message": "O certificado enviado é de outro CNPJ.",
    "field": "certificate",
    "blocking": true,
    "guide": {
      "key": "certificate_a1",
      "title": "Certificado digital A1 (e-CNPJ)",
      "steps": ["…"]
    }
  }]
}
Cada problema vem com o guia para resolver.Como conseguir o certificado A1
POST /v1/nfse/preview Barrada antes da prefeitura
  • Empresa e regime: passou
  • Certificado A1: passou
  • Sistema da cidade: passou
  • Código de serviço: falhou
  • NBS: não conferido
  • Layout oficial: não conferido
{
  "ok": false,
  "validated": null,
  "problems": [{
    "code": "unknown_service_code",
    "message": "O código 019999 não existe na lista nacional de serviços. Busque o código certo pela descrição do serviço.",
    "field": "service_code",
    "blocking": true,
    "guide": {
      "key": "service_trib_code",
      "title": "Código de tributação nacional do serviço (cTribNac)",
      "steps": ["…"]
    }
  }]
}
Cada problema vem com o guia para resolver.Como achar o código de tributação nacional
POST /v1/nfse/preview Barrada antes da prefeitura
  • Empresa e regime: passou
  • Certificado A1: passou
  • Sistema da cidade: falhou
  • Código de serviço: passou
  • NBS: passou
  • Layout oficial: não conferido
{
  "ok": false,
  "route": {
    "system": "municipal",
    "provider": "ISSSaoPaulo",
    "reason": "A prefeitura emite pelo sistema próprio (ISSSaoPaulo)."
  },
  "problems": [{
    "code": "no_municipal_service_code",
    "message": "A prefeitura da empresa usa sistema próprio: cadastre o código de serviço municipal.",
    "field": "municipal_service_code",
    "blocking": true,
    "guide": {
      "key": "municipal_service_code",
      "title": "Código de serviço municipal",
      "steps": ["…"]
    }
  }]
}
Cada problema vem com o guia para resolver.Onde achar o código de serviço municipal
POST /v1/nfse/preview Barrada antes da prefeitura
  • Empresa e regime: passou
  • Certificado A1: passou
  • Sistema da cidade: passou
  • Código de serviço: passou
  • NBS: falhou
  • Layout oficial: não conferido
{
  "ok": false,
  "validated": null,
  "problems": [{
    "code": "no_nbs",
    "message": "Falta o código de tributação nacional (6 números) ou o código NBS (9 números) do serviço. Sem ele a prefeitura recusa a nota.",
    "field": "nbs_code",
    "blocking": true,
    "guide": {
      "key": "nbs_code",
      "title": "Código NBS do serviço",
      "steps": ["…"]
    }
  }]
}
Cada problema vem com o guia para resolver.Como descobrir o código NBS

Como funciona

Do CNPJ à nota autorizada em quatro passos

Você não precisa saber de cabeça o que a prefeitura exige. O SendNF descobre o que é público e ensina a conseguir o resto.

  1. 1

    Informe o CNPJ

    O SendNF busca razão social, endereço, regime tributário e CNAE na base pública da Receita, descobre se a sua prefeitura usa o Sistema Nacional da NFS-e ou um sistema próprio e sugere o código de serviço.

    POST /v1/companies

  2. 2

    Envie o certificado A1

    O arquivo .pfx da empresa é conferido (CNPJ e validade) e guardado cifrado. Não tem certificado? Compre o e-CNPJ A1 pelo SendNF, com validação por videoconferência.

    PUT /v1/companies/{id}/certificate

  3. 3

    Pré-emita

    A pré-emissão monta a nota, assina e valida no XSD oficial ou no provedor da prefeitura sem transmitir. Cada problema vem com a explicação e o guia para resolver.

    POST /v1/nfse/preview

  4. 4

    Emita

    A nota vai para a fila, é transmitida e volta autorizada com PDF e XML. O tomador recebe por e-mail e o seu sistema recebe um webhook assinado.

    POST /v1/nfse

API, SDK e MCP

Uma chamada HTTP, uma nota autorizada

JSON simples, valores em centavos e espera opcional pelo resultado. Use curl, o SDK TypeScript ou deixe a IA chamar por você.

emitir.sh
curl -X POST "https://api.sendnf.com/v1/nfse?wait=true" \
  -H "Authorization: Bearer $SENDNF_KEY" \
  -H "Idempotency-Key: pedido-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": "0192f1c4-7d2e-7b3a-9c41-5e8a2f6b1d07",
    "reference": "pedido-1042",
    "taker": {
      "document": "11.222.333/0001-81",
      "name": "Acme Tecnologia Ltda",
      "email": "financeiro@acme.com.br"
    },
    "items": [{ "description": "Desenvolvimento de software", "unit_amount": 150000 }],
    "service_code": "010101",
    "iss_rate": 200
  }'
emitir.ts · @sendnf/sdk
import { SendNF } from '@sendnf/sdk';

const sendnf = new SendNF({ apiKey: process.env.SENDNF_KEY! });

const nota = await sendnf.nfse.create(
  {
    company_id: empresaId,
    reference: pedido.id,
    taker: { document: cliente.cnpj, name: cliente.nome, email: cliente.email },
    items: [{ description: 'Mensalidade do plano Pro', unit_amount: 7900 }],
  },
  { idempotencyKey: pedido.id, waitSeconds: 20 },
);

console.log(nota.status, nota.nfse_number, nota.urls.pdf);
terminal
# Claude Code: conecte o servidor MCP com a sua chave
claude mcp add --transport http sendnf https://api.sendnf.com/mcp \
  --header "Authorization: Bearer $SENDNF_KEY"

# Depois é só pedir, em português:
# "Emite a nota da Acme: R$ 1.500 de desenvolvimento
#  de software, referente a outubro."
#
# A IA chama search_service_codes, preview_nfse e,
# depois da sua confirmação, issue_nfse.
201 CreatedPOST /v1/nfse?wait=true
pendingprocessingauthorized
{
  "id": "0192f1c5-0a11-7e42-8b6d-1c9e4f2a7b30",
  "object": "nfse",
  "mode": "live",
  "status": "authorized",
  "reference": "pedido-1042",
  "nfse_number": "1042",
  "route": "nacional",
  "total": 150000,
  "rejections": [],
  "urls": {
    "pdf": "https://api.sendnf.com/v1/documents/0192f1c5-…/pdf",
    "xml": "https://api.sendnf.com/v1/documents/0192f1c5-…/xml"
  },
  "authorized_at": "2026-10-20T14:32:07Z"
}
Idempotency-Key
Repetiu a chamada? A mesma chave devolve a mesma nota, nunca duas.
Centavos e centésimos
unit_amount 150000 é R$ 1.500,00; iss_rate 200 é 2%. Sem vírgula, sem arredondamento.
Teste e produção
Chaves nt_test_ emitem em homologação, sem limite. nt_live_ emite com valor fiscal.
Webhooks assinados
Nota autorizada, rejeitada, bloqueada ou cancelada, no padrão Standard Webhooks.
Claude + servidor MCP do SendNFexemplo
  1. Emite a nota da Acme: R$ 1.500 de desenvolvimento de software, referente a outubro.

  2. search_service_codes("desenvolvimento de software") → 01.01.01 Análise e desenvolvimento de sistemas

  3. preview_nfse → pronta para emitir (validada no XSD oficial)

  4. A nota está pronta: Acme Tecnologia, R$ 1.500,00, código 01.01.01, ISS de 2%. Você está em produção. Posso emitir?

  5. Pode.

  6. issue_nfse → authorized, NFS-e nº 1042

  7. Emitida: NFS-e nº 1042. O PDF e o XML foram para financeiro@acme.com.br.

Servidor MCP

Peça a nota em português. A IA faz o resto.

Conecte o Claude (ou qualquer cliente MCP) com a sua chave de API. A IA consulta o CNPJ, acha o código de serviço, pré-emite e só emite quando você confirma. Quando falta um dado que não é público, ela explica como conseguir em vez de inventar.

21 ferramentas · escrevem na sua conta

  • account_overview
  • lookup_cnpj
  • search_service_codes
  • get_service_code
  • how_to_get
  • list_companies
  • get_company
  • create_company
  • import_invoice
  • update_company
  • upload_certificate
  • check_readiness
  • preview_nfse
  • issue_nfse
  • preview_nfce
  • issue_nfce
  • list_documents
  • get_document
  • cancel_document
  • retry_document
  • order_certificate

Guias

O que não é público, a gente ensina a conseguir

Certificado, inscrição municipal, alíquota do ISS, CSC da NFC-e: o checklist de cada empresa mostra o que falta, e cada item tem um passo a passo com as fontes oficiais.

Todos os 12 guias

Acme Tecnologia Ltda

CNPJ 11.222.333/0001-81

4 de 6 prontos
  • Dados da Receita
  • Regime tributário
  • Sistema da cidade
  • Código de serviço
  • Certificado A1Ver o passo a passo
  • Alíquota do ISSVer o passo a passo
Sem certificado? Compre pelo SendNF.e-CNPJ A1 por R$ 149, válido por 12 meses, com validação por videoconferência.

Recursos

E tudo o que vem depois da nota

Cadastro pelo CNPJ

Dados públicos da Receita preenchidos sozinhos, sistema da prefeitura identificado e código de serviço sugerido pelo CNAE da empresa.

Webhooks assinados

Eventos de nota criada, autorizada, rejeitada, bloqueada e cancelada, e de certificado vencendo, assinados no padrão Standard Webhooks e com reenvio automático.

PDF e XML para o cliente

Com a nota autorizada, o tomador recebe o PDF (DANFSe ou DANFC-e) e o XML por e-mail, em nome da sua empresa.

Nada se perde

Se a Receita ou a prefeitura cair, a nota fica na fila e é reenviada. Na NFC-e, a contingência é automática. Notas paradas por falta de dado voltam sozinhas quando o dado chega.

Reforma tributária

Grupo IBS/CBS preenchido com a classificação da tabela oficial de correlação do código de serviço, e NBS descoberto a partir do código nacional.

Homologação sem limite

Chaves de teste (nt_test_) emitem em homologação, sem valor fiscal, de graça e sem limite, em todos os planos.

Preços

Comece grátis. Pague por nota quando crescer.

O plano Grátis tem homologação ilimitada e 20 notas reais por mês. Nota rejeitada, nota em homologação e pré-emissão não contam.

300
1

Plano ideal: Start

R$ 44/mês

Sai a R$ 0,15 por nota, com 100 notas extras a R$ 0,15.

Começar com o Start
  • Grátis

    R$ 0/mês · 20 notas · 1 CNPJ

    até 20 notas

  • Startideal

    R$ 29/mês · 200 notas · 1 CNPJ

    R$ 44

  • Pro

    R$ 79/mês · 1.000 notas · até 5 CNPJs

    R$ 79

  • Scale

    R$ 249/mês · 5.000 notas · até 30 CNPJs

    R$ 249

Contador? O plano Escritório contábil custa R$ 9 por CNPJ ativo, com 100 notas por CNPJ. Ver o plano

  • NFS-e pelo Sistema Nacional e por prefeituras com sistema próprio
  • NFC-e para venda ao consumidor
  • Pré-emissão com validação no layout oficial
  • Ambiente de homologação ilimitado
  • API REST, SDK TypeScript e servidor MCP
  • Webhooks assinados (Standard Webhooks)
  • PDF e XML enviados por e-mail ao tomador
  • Cadastro pelo CNPJ e checklist com guias

Tabela completa e perguntas sobre cobrança

FAQ

Perguntas frequentes

Não achou a sua? Escreva para a gente.

Falar com a equipe

O que é o SendNF?

O SendNF é uma API, um painel e um servidor MCP para emitir nota fiscal de serviço (NFS-e) e de venda ao consumidor (NFC-e) no Brasil. Ele cadastra a empresa pelo CNPJ, mostra o que falta para emitir e valida cada nota no layout oficial antes de transmitir.

O SendNF emite NFS-e em qualquer cidade?

Emite pelo Sistema Nacional da NFS-e e por prefeituras com sistema próprio que estejam na tabela de provedores do ACBr, o que cobre a grande maioria dos municípios. Ao informar o CNPJ, o SendNF diz qual sistema a sua cidade usa e o que ela exige.

Quais regimes tributários o SendNF atende?

Na NFS-e, MEI, Simples Nacional, Lucro Presumido e Lucro Real, com retenções. A NFC-e sai para MEI e Simples Nacional.

O SendNF emite NF-e de produto (modelo 55)?

Ainda não. Hoje o SendNF emite NFS-e (serviço) e NFC-e (modelo 65, venda ao consumidor final dentro do estado).

Preciso de certificado digital?

Sim. Para emitir por API é preciso o certificado A1 (e-CNPJ) da empresa. Se você não tiver, dá para comprar pelo SendNF por R$ 149, com validação por videoconferência.

O que é a pré-emissão?

É uma simulação completa da nota sem transmitir: o SendNF confere empresa, certificado, sistema da cidade, código de serviço e NBS, assina e valida no XSD oficial (ou no provedor da prefeitura) e devolve os problemas com o guia de como resolver.

Dá para emitir nota pelo ChatGPT ou pelo Claude?

Pelo Claude e por qualquer cliente compatível com MCP (Model Context Protocol), sim. Você conecta o servidor MCP do SendNF com a sua chave de API e pede a nota em português. O servidor orienta a IA a pré-emitir antes e a confirmar com você antes de emitir ou cancelar em produção.

Quanto custa?

Há um plano grátis com homologação ilimitada e 20 notas reais por mês. Os planos pagos vão de R$ 29 por mês (200 notas) a R$ 249 por mês (5.000 notas), e o plano para contadores custa R$ 9 por CNPJ ativo.

Emita a primeira nota ainda hoje.

Conta grátis com homologação ilimitada e 20 notas reais por mês. Sem cartão de crédito.