---
title: "Onboarding do zero — NFS-e Inbound"
description: "Do zero à primeira NFS-e recebida: conta, empresa, certificado e ativação. Sem empresa + certificado, o serviço não é ativado."
source_url: https://nfe.io/docs/distribuicao-nfse-inbound-onboarding/
last_updated: 2026-07-30
---

# Onboarding do zero — NFS-e Inbound

Este guia leva você do zero até a primeira NFS-e capturada.

:::warning Pré-condição
**Sem empresa cadastrada + certificado digital válido, o serviço não é ativado.** A captura usa o certificado da empresa (mTLS) no ambiente nacional.
:::

## Cadência base

```
1. Criar a conta  →  2. Criar a empresa (CNPJ)  →  3. Subir o certificado  →  4. Habilitar a recepção
```

Veja **[Conta → Empresa → Ativação](../../comum/modelo-conta-empresa.md)**. A recepção é habilitada **por empresa**.

## Etapas

### 1. Criar a conta principal
Acesse [app.nfe.io](https://app.nfe.io) → **Criar conta** e **confirme o e-mail**. Detalhe em **[Criar conta](../../../nossa-plataforma/criar-conta.md)**.

### 2. Criar a empresa (CNPJ)
No Painel → **Empresas → + Nova Empresa**, informe CNPJ, razão social, endereço, **Inscrição Municipal** e regime tributário. Detalhe em **[Criar empresa](../../../nossa-plataforma/criar-empresa.md)**.

### 3. Subir o certificado digital
Envie o certificado da empresa no painel. Ele é **obrigatório** — a captura no ambiente nacional o usa via mTLS. Veja **[Certificado digital](../explanation/certificado-digital.md)**.

### 4. Habilitar a recepção de NFS-e
Cadastre a empresa no serviço de inbound — via **[painel](../how-to/ativar-via-painel.md)** ou **[API](../how-to/ativar-via-api.md)**. Ao habilitar, a captura entra **ativa** (`isActive: true`).

### 5. Configurar o webhook (recomendado)
Cada documento dispara um POST assinado (HMAC-SHA1, `x-hub-signature`) — veja **[Webhook — eventos](../reference/webhook-events.md)**.

### 6. Validar
Aguarde (ou provoque) uma NFS-e contra o CNPJ e confira via `GET .../inbound/nfse`.

## Autenticação

As chamadas usam uma **API Key** com papel `Nota Fiscal` ou `NFSeDist` no header `Authorization` (sem prefixo) — veja **[Autenticação](../../comum/autenticacao.md)**.

## Checklist de prontidão

- [ ] Conta criada e e-mail confirmado
- [ ] Empresa (CNPJ) cadastrada com Inscrição Municipal
- [ ] **Certificado digital** válido enviado na empresa
- [ ] Recepção **habilitada** (`isActive: true`)
- [ ] Webhook configurado e validação HMAC implementada
- [ ] Primeiro documento recebido e baixado

## Veja também

- [Conta → Empresa → Ativação](../../comum/modelo-conta-empresa.md) · [Certificado digital](../explanation/certificado-digital.md)
- [Primeira integração](./primeira-integracao.md) · [Console vs API](../../comum/console-vs-api.md)