---
title: "Ativar o serviço de inbound via API (NF-e e CT-e)"
description: "Como ativar, consultar e desativar o serviço de inbound NFe/CTe via API REST, com todos os campos do payload e variações de ambiente."
source_url: https://nfe.io/docs/distribuicao-nfe-cte-ativar-via-api/
last_updated: 2026-07-30
---

# Ativando o Serviço de Inbound

Antes de receber documentos, você precisa ativar o serviço de inbound para cada CNPJ que deseja monitorar.

## Sumário

- [Ativar Inbound de NF-e](#ativar-inbound-de-nf-e)
- [Ativar Inbound de CT-e](#ativar-inbound-de-ct-e)
- [Verificar Configuração Atual](#verificar-configuração-atual)
- [Desativar Inbound](#desativar-inbound)

## Ativar Inbound de NF-e

```http
POST /v2/companies/{company_id}/inbound/productinvoices
Authorization: ApiKey {api_key}
Content-Type: application/json

{
  "StartFromNsu": 0,
  "StartFromDate": "2024-01-01T00:00:00Z",
  "EnvironmentSEFAZ": "Production",
  "AutomaticManifesting": {
    "MinutesToWaitAwarenessOperation": 60
  },
  "WebhookVersion": 2
}
```

**Campos do corpo:**

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `StartFromNsu` | `long` | Não | NSU inicial. `0` = busca desde o início. Use um NSU específico para sincronizar com histórico |
| `StartFromDate` | `DateTime` | Não | Data inicial para busca. Padrão: 90 dias atrás |
| `EnvironmentSEFAZ` | `string` | Sim | `"Production"` (produção SEFAZ) ou `"Test"` (homologação SEFAZ) |
| `EventType` | `string` | Não | Filtro de tipos de evento (códigos separados por vírgula). `null` = todos |
| `Schema` | `int` | Não | `0`=NF-e + Eventos, `1`=Somente NF-e, `2`=Somente Eventos |
| `AutomaticManifesting.MinutesToWaitAwarenessOperation` | `int` | Não | Minutos aguardados antes de auto-manifestar ciência. Mínimo: 5 |
| `WebhookVersion` | `int` | Não | Versão do formato de webhook. Use `2` (mais recente) |

**Resposta de sucesso (200):**

```json
{
  "companyId": "comp_123",
  "environmentSEFAZ": "Production",
  "startFromNsu": 0,
  "startFromDate": "2024-01-01T00:00:00Z",
  "status": "Active",
  "createdOn": "2024-03-15T10:30:00Z"
}
```

## Ativar Inbound de CT-e

```http
POST /v2/companies/{company_id}/inbound/transportationinvoices
Authorization: ApiKey {api_key}
Content-Type: application/json

{
  "StartFromNsu": 0,
  "StartFromDate": "2024-01-01T00:00:00Z",
  "EnvironmentSEFAZ": "Production"
}
```

## Verificar Configuração Atual

```http
GET /v2/companies/{company_id}/inbound/productinvoices
Authorization: ApiKey {api_key}
```

## Desativar Inbound

```http
DELETE /v2/companies/{company_id}/inbound/productinvoices
Authorization: ApiKey {api_key}
```

## Referência completa da API

- [📖 API Reference — Consulta NF-e Distribuição](/desenvolvedores/rest-api/consulta-nf-e-distribuicao)
- [📖 API Reference — Consulta CT-e v2](/desenvolvedores/rest-api/consulta-de-ct-e-v2/)

## Veja também

- [Ativar via painel](./ativar-via-painel.md) — alternativa sem código
- [Configurar webhook](./configurar-webhook.md)
- [Endpoints de NF-e](../reference/endpoints-nfe.md)
- [Endpoints de CT-e](../reference/endpoints-cte.md)
- [Tipos e enums](../reference/tipos-e-enums.md)