Emitir sua primeira NF-e

Do zero à primeira NF-e autorizada pela SEFAZ em 5 passos.

1. Criar a conta e o token

1. Crie a conta no painel: https://app.nferapido.com.br/cadastro.
2. No painel, abra Empresas → detalhe da empresa → Tokens de API → Novo Token e escolha o ambiente (homologação para testar). O token aparece uma única vez: guarde-o em $TOKEN.

O cadastro de conta é feito só pelo painel. A rota POST /api/v1/auth/registrar foi desativada e responde 410.

2. Cadastrar empresa

A empresa informada no cadastro da conta já está criada e aparece em Empresas no painel: siga para o passo 3. Repetir o mesmo CNPJ aqui responde 409.

Para cadastrar outra empresa na mesma conta (o token de API vale para a empresa em que foi criado: para emitir pela empresa nova, gere um token dela, como no passo 1):

curl -X POST https://api.nferapido.com.br/api/v1/empresas \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "razao_social": "Sua Empresa LTDA",
    "cnpj": "11222333000181",
    "ie": "111222333",
    "crt": "1",
    "regime_tributario": "simples_nacional",
    "uf": "SP",
    "municipio": "São Paulo",
    "cod_municipio": "3550308",
    "logradouro": "Av. Paulista",
    "numero": "1000",
    "bairro": "Bela Vista",
    "cep": "01310100",
    "ambiente": "homologacao"
  }'

3. Enviar o certificado A1

No painel, abra Empresas → detalhe da empresa → Certificado digital e envie o arquivo .pfx com a senha.

O envio do certificado é feito por quem administra a empresa: o token de API não tem essa permissão e recebe 403.

4. Emitir a NF-e

curl -X POST https://api.nferapido.com.br/api/v1/nfe \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d @nfe-exemplo.json

Com nfe-exemplo.json:

{
  "ide": {
    "natOp": "Venda de mercadoria",
    "serie": 1,
    "nNF": 1
  },
  "dest": {
    "cnpj": "33000167000101",
    "xNome": "Cliente Exemplo",
    "email": "cliente@exemplo.com",
    "enderDest": {
      "xLgr": "Av. República do Chile", "nro": "65",
      "xBairro": "Centro", "cMun": "3304557",
      "xMun": "Rio de Janeiro", "UF": "RJ",
      "CEP": "20031170", "cPais": "1058", "xPais": "Brasil"
    }
  },
  "det": [{
    "prod": {
      "cProd": "PROD001", "cEAN": "SEM GTIN",
      "xProd": "Produto de Teste", "NCM": "84713012",
      "CFOP": "6102", "uCom": "UN", "qCom": "1",
      "vUnCom": "100.00", "vProd": "100.00",
      "cEANTrib": "SEM GTIN", "uTrib": "UN",
      "qTrib": "1", "vUnTrib": "100.00", "indTot": "1"
    },
    "imposto": {
      "ICMS": { "ICMSSN102": { "orig": "0", "CSOSN": "102" } },
      "PIS":  { "PISNT": { "CST": "07" } },
      "COFINS": { "COFINSNT": { "CST": "07" } }
    }
  }],
  "total": { "vProd": "100.00", "vNF": "100.00" },
  "transp": { "modFrete": "9" },
  "pag": [{ "tPag": "01", "vPag": "100.00" }]
}

5. Acompanhar o retorno

curl https://api.nferapido.com.br/api/v1/nfe/{id} \
  -H "Authorization: Bearer $TOKEN"

Em segundos, o status muda de pendente → autorizada com:

• chave (44 dígitos)
• protocolo da SEFAZ
• Link para baixar a DANFE em PDF
• XML autorizado armazenado em S3/R2

Pronto!

Sua primeira NF-e está autorizada. Acesse o dashboard para ver visualmente, ou configure webhooks para receber o retorno em tempo real no seu ERP.

→ Próximo: Webhooks