---
title: "Endpoints de CT-e — NFe/CTe Inbound"
description: "Referência dos endpoints da API para CT-e: metadados, XML, reprocessamento de webhooks e consolidação de batch."
source_url: https://nfe.io/docs/distribuicao-nfe-cte-endpoints-cte/
last_updated: 2026-07-30
---

:::info Referência interativa disponível
Para spec OpenAPI completa, schemas e "Try it" inline, use a [API Reference — Consulta CT-e v2](/desenvolvedores/rest-api/consulta-de-ct-e-v2/). Esta página documenta o uso prático; a referência tem o contrato completo.
:::

# Endpoints de CT-e

Referência dos endpoints HTTP do serviço NFe/CTe Inbound para operações com CT-e (modelo 57).

## Sumário

- [Ativar e Configurar CT-e](#ativar-e-configurar-ct-e)
- [Buscar Metadados de um CT-e](#buscar-metadados-de-um-ct-e)
- [Baixar XML de um CT-e](#baixar-xml-de-um-ct-e)
- [Reprocessar Webhooks de CT-e](#reprocessar-webhooks-de-ct-e)
- [Reprocessar NSUs Específicos](#reprocessar-nsus-específicos)
- [Consolidação de Batch](#consolidação-de-batch)

## Ativar e Configurar CT-e

Veja [Ativar via API](../how-to/ativar-via-api.md) — o processo é idêntico ao NF-e mas no endpoint `/transportationinvoices`.

## Buscar Metadados de um CT-e

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

**Resposta (200):**

```json
{
  "id": "abc123",
  "accessKey": "35240198765432000100570010000009871234567890",
  "createdOn": "2024-03-15T14:22:10Z",
  "nsu": 10042,
  "type": "transportationInvoice",
  "description": "Autorizado o uso do CT-e",
  "company": {
    "id": "comp_123",
    "federalTaxNumber": "98765432000100"
  },
  "issuer": {
    "federalTaxNumber": "11111111000100",
    "name": "Transportadora ABC LTDA"
  },
  "taker": {
    "federalTaxNumber": "98765432000100",
    "name": "Minha Empresa S.A."
  },
  "totalAmount": 350.00,
  "issuedOn": "2024-03-15T10:00:00Z",
  "xmlUrl": "https://storage.nfe.io/temp/cte/..."
}
```

**Campos específicos do CT-e:**

| Campo | Tipo | Descrição |
|---|---|---|
| `issuer` | `object` | A transportadora que emitiu o CT-e |
| `taker` | `object` | Tomador do serviço de transporte |
| `totalAmount` | `decimal` | Valor do serviço de transporte |
| `issuedOn` | `DateTime` | Data de emissão do CT-e |
| `xmlUrl` | `string` | URL temporária para download do XML (expira em 1 hora) |

## Baixar XML de um CT-e

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

# Retorna o arquivo XML (Content-Type: application/xml)
```

## Reprocessar Webhooks de CT-e

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

{
  "Key": "35240198765432000100570010000009871234567890",
  "Date": "2024-03-15"
}
```

**Resposta de sucesso (204):** sem corpo; operação agendada/processada em background.

## Reprocessar NSUs Específicos

Útil quando um NSU falhou no processamento:

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

[10042, 10043, 10044]
```

**Resposta de sucesso (204):** sem corpo; operação agendada/processada em background.

## Consolidação de Batch

Consolida batches em um intervalo de NSU:

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

{
  "StartNSU": 10000,
  "EndNSU": 10500
}
```

**Resposta de sucesso (204):** sem corpo; operação agendada/processada em background.

## Veja também

- [Endpoints de NF-e](./endpoints-nfe.md)
- [Consultar com OData](../how-to/consultar-com-odata.md)
- [Webhook events + HMAC](./webhook-events.md)
- [Tipos e enums](./tipos-e-enums.md)
- [Ativar via API](../how-to/ativar-via-api.md)