---
title: "Início rápido"
description: "Da chave de API à primeira NFS-e autorizada no sandbox em cinco passos: gere a chave, faça a primeira chamada, emita, receba o webhook e vá para produção."
url: https://docs.emissordenota.com/inicio-rapido
language: pt-BR
---
# Início rápido

Cinco passos, da chave de API à primeira NFS-e autorizada no sandbox. Nada do que você fizer aqui é transmitido à prefeitura nem ao ambiente nacional.

## Antes de começar

- Uma conta com acesso à API e ao Sandbox, com permissão para gerenciar chaves.
- cURL ou qualquer cliente HTTP.
- Um endereço HTTPS público para receber webhooks (só no passo 4).

## Gere uma chave de sandbox

*PASSO 1 DE 5*

No painel, abra Configurações › API e integrações e clique em Gerar nova chave. Escolha o ambiente Sandbox e marque a permissão de escrita em NFS-e. A chave aparece uma única vez: copie e guarde num cofre de segredos.

**Terminal**

```bash
export EDN_KEY="edn_test_SUA_CHAVE"
```

## Faça a primeira chamada

*PASSO 2 DE 5*

O sandbox já vem com uma empresa de teste. Liste as empresas para confirmar que a chave funciona e anote o id dela.

**cURL**

```bash
curl https://sandbox.api.emissordenota.com/v1/empresas \
  -H "Authorization: Bearer $EDN_KEY"
```

**200 OK**

```json
{
  "dados": [
    {
      "id": "emp_teste_01",
      "razao_social": "Empresa de Teste Ltda",
      "cnpj": "11222333000181"
    }
  ],
  "proximo_cursor": null
}
```

## Emita uma NFS-e

*PASSO 3 DE 5*

Envie a empresa emissora, o tomador e o serviço. O cabeçalho Idempotency-Key garante que uma nova tentativa não gere nota duplicada.

**cURL**

```bash
curl -X POST https://sandbox.api.emissordenota.com/v1/nfse \
  -H "Authorization: Bearer $EDN_KEY" \
  -H "Idempotency-Key: pedido-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "empresa_id": "emp_teste_01",
    "tomador": {
      "documento": "98765432000198",
      "nome": "Clínica Bem Viver Ltda",
      "email": "financeiro@bemviver.com.br"
    },
    "servico": {
      "codigo_tributacao_nacional": "010701",
      "descricao": "Suporte técnico em informática - novembro/2026",
      "valor": 1500.00
    }
  }'
```

A API responde na hora com a nota em processamento. A autorização chega em seguida.

**201 Created**

```json
{
  "id": "nfse_3Jt9wPz7Qa",
  "status": "processando",
  "empresa_id": "emp_teste_01",
  "valor": 1500.00,
  "criada_em": "2026-11-09T10:42:07-03:00"
}
```

> **Simulando uma rejeição**
>
> No sandbox, envie o valor 0.01 para receber a nota com status rejeitada e testar o tratamento de erro do seu sistema.

## Receba o resultado por webhook

*PASSO 4 DE 5*

Cadastre um endereço para ser avisado quando a nota for autorizada ou rejeitada. Sem webhook, consulte GET /nfse/{id} até o status mudar.

**cURL**

```bash
curl -X POST https://sandbox.api.emissordenota.com/v1/webhooks \
  -H "Authorization: Bearer $EDN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seusistema.com.br/webhooks/emissor",
    "eventos": ["nfse.autorizada", "nfse.rejeitada"]
  }'
```

Quando a nota for autorizada, seu endereço recebe:

**POST /webhooks/emissor**

```json
{
  "evento": "nfse.autorizada",
  "criado_em": "2026-11-09T10:42:11-03:00",
  "dados": {
    "id": "nfse_3Jt9wPz7Qa",
    "numero": "000000127",
    "status": "autorizada",
    "xml_url": "https://sandbox.api.emissordenota.com/v1/nfse/nfse_3Jt9wPz7Qa/xml",
    "pdf_url": "https://sandbox.api.emissordenota.com/v1/nfse/nfse_3Jt9wPz7Qa/pdf"
  }
}
```

## Vá para produção

*PASSO 5 DE 5*

O formato das chamadas não muda. Antes de virar a chave:

- Gere uma chave de produção (prefixo edn_live_) com as permissões que a integração usa, e nada além.
- Troque o endereço base para https://api.emissordenota.com/v1.
- Confira se cada empresa emissora tem certificado A1 válido em GET /certificados.
- Cadastre os webhooks de novo: os endpoints do sandbox não valem em produção.

> **Produção emite nota de verdade**
>
> Toda NFS-e criada com uma chave edn_live_ é transmitida e tem valor fiscal. Para desfazer, só cancelando a nota.
