---
title: "Quickstart — primeira NFS-e em ≤5 minutos"
description: "Ative a captura automática de NFS-e do padrão nacional e receba o primeiro documento em menos de 5 minutos."
source_url: https://nfe.io/docs/distribuicao-nfse-inbound-quickstart/
last_updated: 2026-07-30
---

# Quickstart — primeira NFS-e em ≤5 minutos

> Objetivo: ativar o NFS-e Inbound e **receber a primeira NFS-e em ≤5 minutos**. Para tutorial completo, vá direto a [Primeira integração](./tutorials/primeira-integracao.md).

## Sumário

- [Pré-requisitos](#pré-requisitos)
- [Fluxo em 5 passos](#fluxo-em-5-passos)
- [Passo 1 — Ativar inbound](#passo-1--ativar-inbound)
- [Passo 2 — Aguardar primeiro polling](#passo-2--aguardar-primeiro-polling)
- [Passo 3 — Receber webhook ou consultar via API](#passo-3--receber-webhook-ou-consultar-via-api)
- [Passo 4 — Baixar XML/PDF](#passo-4--baixar-xmlpdf)
- [Passo 5 — Próximos passos](#passo-5--próximos-passos)

## Pré-requisitos

- **API Key** ativa com papel `Nota Fiscal (api.nfe.io)` ou `NFSeDist (dfe.nfe.io)`
- **CompanyId** da empresa (CNPJ) cadastrada no painel
- **webhookUrl** HTTPS público para receber notificações

## Fluxo em 5 passos

```mermaid
flowchart LR
    A[1. Ativar inbound] --> B[2. Aguardar polling ~30s]
    B --> C[3. Receber webhook ou consultar API]
    C --> D[4. Baixar XML/PDF via signed URL]
    D --> E[5. Próximos passos]
```

## Passo 1 — Ativar inbound

```bash
export NFEIO_API_KEY="<sua-chave>"
export COMPANY_ID="<id-da-empresa>"

curl -X POST "https://api.nfse.io/v2/companies/inbound/nfse" \
  -H "Authorization: $NFEIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "'$COMPANY_ID'",
    "initialNsu": 0,
    "webhookUrl": "https://meu-sistema.com/webhook/nfse"
  }'
```

Resposta `201 Created` com `isActive: true` confirma a ativação.

## Passo 2 — Aguardar primeiro polling

A NFE.io passa a consultar o ADN a cada **~30 segundos** em nome do seu CNPJ. Se há histórico no ADN, a primeira NFS-e chega em segundos.

## Passo 3 — Receber webhook ou consultar via API

Via webhook (preferido): o endpoint recebe POST com `eventName: inbound.serviceInvoice.received`.

Via API:

```bash
curl "https://api.nfse.io/v2/companies/$COMPANY_ID/inbound/nfse?pageCount=10" \
  -H "Authorization: $NFEIO_API_KEY"
```

## Passo 4 — Baixar XML/PDF

```bash
# XML — segue 302 redirect para signed URL (TTL 30min)
curl -L "https://api.nfse.io/v2/companies/$COMPANY_ID/inbound/nfse/{id}/xml" \
  -H "Authorization: $NFEIO_API_KEY" -o nfse.xml
```

## Passo 5 — Próximos passos

- [Tutorial completo: Primeira integração](./tutorials/primeira-integracao.md)
- [Como fazer: Integração REST](./how-to/integracao-rest.md)
- [Referência: Webhook events](./reference/webhook-events.md)

## Veja também

- [Arquitetura](./explanation/arquitetura.md)
- [Troubleshooting](./reference/troubleshooting.md)
- [Mapa de cross-repos](./99-mapa-cross-repos.md)