Emitir sua primeira NF-e

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

1. Criar usuário

curl -X POST https://api.nferapido.com.br/api/v1/auth/registrar \
  -H "Content-Type: application/json" \
  -d '{
    "email": "voce@empresa.com",
    "senha": "Senha@Forte123",
    "nome": "Seu Nome"
  }'

Retorna um token JWT. Guarde-o em $TOKEN.

2. Cadastrar empresa

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",
    "uf": "SP",
    "municipio": "São Paulo",
    "cod_municipio": "3550308",
    "logradouro": "Av. Paulista",
    "numero": "1000",
    "bairro": "Bela Vista",
    "cep": "01310100",
    "ambiente": "homologacao"
  }'

3. Upload do certificado A1

curl -X POST https://api.nferapido.com.br/api/v1/empresas/{id}/certificado \
  -H "Authorization: Bearer $TOKEN" \
  -F "certificado=@empresa.pfx" \
  -F "senha=senha-do-pfx"

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