---
title: "Arquitetura — NFe/CTe Inbound"
description: "Como o NFe/CTe Inbound funciona por dentro: fluxo SEFAZ -> Ambiente Nacional -> nfe.io -> seu sistema, com tempos e papel do NSU."
source_url: https://nfe.io/docs/distribuicao-nfe-cte-arquitetura/
last_updated: 2026-07-30
---

# Arquitetura do NFe/CTe Inbound

O **DFe Inbound da nfe.io** monitora automaticamente a SEFAZ e captura todos os Documentos Fiscais Eletrônicos (NF-e e CT-e) emitidos por terceiros que têm como destinatário o CNPJ da sua empresa.

## Sumário

- [O que você ganha](#o-que-você-ganha)
- [Para quem é este serviço](#para-quem-é-este-serviço)
- [O Fluxo Completo em 7 Passos](#o-fluxo-completo-em-7-passos)
- [Quanto tempo leva](#quanto-tempo-leva)
- [Diagrama de integração](#diagrama-de-integração)

## O que você ganha

- **Captura automática:** Sem precisar acessar o portal da SEFAZ manualmente.
- **XML armazenado:** Os XMLs ficam disponíveis para download via API a qualquer momento.
- **Notificações em tempo real:** Receba webhooks assim que um documento chegar.
- **Dados estruturados:** Consulte metadados (emitente, valor, data) sem precisar parsear XML.
- **Histórico completo:** Acesso a documentos recebidos nos últimos 90 dias (ou desde o NSU configurado).

## Para quem é este serviço

- Empresas que recebem NF-e de fornecedores e precisam ter controle sobre esses documentos
- Empresas que recebem CT-e de transportadoras
- Empresas que precisam fazer a **manifestação fiscal** das NF-es recebidas
- Equipes de TI ou contabilidade que precisam integrar documentos fiscais com sistemas de gestão (ERP, TMS, etc.)

## O Fluxo Completo em 7 Passos

```mermaid
flowchart TD
    P1[1. Fornecedor emite NF-e destinada à sua empresa] --> P2[2. SEFAZ autoriza a NF-e]
    P2 --> P3[3. SEFAZ sincroniza com Ambiente Nacional]
    P3 --> P4[4. Ambiente Nacional registra com um NSU]
    P4 --> P5[5. nfe.io detecta o documento consultando o AN]
    P5 --> P6[6. nfe.io baixa o XML e extrai dados com segurança]
    P6 --> P7a[7a. Webhook é disparado ao seu sistema]
    P6 --> P7b[7b. Você consulta via API quando precisar]
```

## Quanto tempo leva

Em condições normais, **entre 15 minutos e 4 horas** após a SEFAZ autorizar o documento, ele já está disponível no nosso sistema. Em períodos de alta carga da SEFAZ (geralmente final de mês), pode levar um pouco mais.

## Diagrama de integração

```
SEFAZ (Ambiente Nacional)
  │
  │ (Polling automático via NSU)
  ▼
nfe.io DFe Inbound
  │
  ├──▶ Armazena XML no cloud storage
  ├──▶ Salva metadados (emitente, valor, data...)
  └──▶ Dispara Webhook ──▶ SEU SISTEMA
                              │
                              ├── Consulta metadados via API
                              └── Baixa XML via API
```

Nosso sistema usa o **NSU (Número Sequencial Único)** para saber quais documentos já foram buscados e quais ainda precisam ser baixados. Assim, nenhum documento é perdido ou duplicado. Veja [Conceitos fiscais](./conceitos.md) para detalhes do NSU e da chave de acesso.

## Veja também

- [Conceitos: NF-e, CT-e, NSU, eventos](./conceitos.md)
- [Conceitos: Certificado digital](./certificado-digital.md)
- [Conceitos: Segurança e LGPD](./seguranca-lgpd.md)
- [Webhook events + HMAC](../reference/webhook-events.md)
- [Quickstart](../00-quickstart.md)