# Obtener DTE por ID

`GET /api/v1/billing/dte/{id}`

Retorna el DTE completo con estado actual, tracking del envío al SII y último detalle de consulta de estado. Con `include_xml=true` incluye el XML firmado en el campo `xml_documento`.

- Autenticación: header `X-Api-Key: sk_simplo_...` (o `Authorization: Bearer <jwt>` para sesiones de la plataforma).
- operationId: `obtenerDTE` — contrato completo en https://docs.simplo.cl/openapi.yaml
- Versión HTML: https://docs.simplo.cl/api/operations/obtenerdte/

## Parámetros

| Nombre | En | Tipo | Requerido | Descripción |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | sí | UUID del DTE |
| `include_xml` | query | boolean | no | Incluir XML firmado en la respuesta |

## Ejemplo (curl)

```sh
curl -X GET "https://api.simplo.cl/api/v1/billing/dte/<id>" \
  -H "X-Api-Key: $SIMPLO_API_KEY"
```

## Respuestas

### 200 — DTE encontrado

Schema: `DTEResponse`

| Campo | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `id` | string (uuid) | sí |  |
| `tipo_dte` | integer (33 \| 34 \| 39 \| 41 \| 43 \| 46 \| 52 \| 56 \| 61 \| 110 \| 111 \| 112) | sí | Código SII del tipo de Documento Tributario Electrónico (33 factura, 39 boleta, 52 guía de despacho, 56/61 notas, 110-112 exportación). |
| `folio` | integer | sí |  |
| `estado` | string (borrador \| generado \| firmado \| enviando \| procesando \| aceptado \| rechazado \| con_reparos) | sí | Estado del DTE en su ciclo de vida. |
| `rut_receptor` | string | sí |  |
| `razon_social_receptor` | string | sí |  |
| `fecha_emision` | string (date) | sí |  |
| `monto_neto` | integer | no |  |
| `monto_exento` | integer | no |  |
| `tasa_iva` | number | no |  |
| `iva` | integer | no |  |
| `monto_total` | integer | sí |  |
| `detalle` | LineaDetalle[] | sí |  |
| `referencias` | Referencia[] | no |  |
| `tracking` | TrackingInfo | no | Información de tracking del envío al SII |
| `sii_status` | SIIStatusInfo | no | Último detalle fino por documento consultado al SII. |
| `xml_documento` | string | no | XML firmado (solo si se solicita con include_xml=true) |
| `metadata` | object | no |  |
| `created_at` | string (date-time) | sí |  |
| `updated_at` | string (date-time) | sí |  |

### 401 — Token o API key inválido o ausente

Schema: `ErrorResponse`

### 404 — Recurso no encontrado

Schema: `ErrorResponse`
