import { Aside } from "@astrojs/starlight/components";

## El endpoint

```
GET /api/v1/ecf/{id}/representation
GET /api/v1/ecf/{id}/representation?layout=pos
GET /api/v1/ecf/{id}/representation?download=true
```

| Parámetro  | Nota                                                                           |
| ---------- | ------------------------------------------------------------------------------ |
| `layout`   | `letter` (por defecto) o `pos`.                                                |
| `download` | `true` para forzar la descarga; sin él, el PDF se abre inline en el navegador. |

El archivo se llama `{e-NCF}.pdf` (`{e-NCF}-pos.pdf` para el formato POS).
Disponible para los tres roles de API key, no solo `admin_tenant`: si tu
integración solo consulta comprobantes, también puede descargar su
representación impresa.

## Los dos formatos

- **Carta** (por defecto): pensado para imprimir en una impresora normal.
  Si el comprobante tiene muchas líneas, se pagina automáticamente.
- **POS de 80 mm**: pensado para una impresora térmica de punto de venta.
  Es una sola página continua, sin paginación, con los montos alineados
  para ese ancho.

Ambos muestran los mismos datos: identidad fiscal, comprador, líneas,
totales, y el timbre de la DGII (código de seguridad y QR).

## De dónde sale

La representación impresa se arma siempre a partir del mismo `<ECF>`
firmado que NovaFE ya guardó al emitir, nunca de un modelo aparte. Esto
importa para un caso puntual: si tu comprobante tipo 32 se envió a la DGII
como RFCE (por estar debajo de RD$250,000), la representación impresa
muestra de todas formas el comprobante completo, no el resumen que se
transmitió.

## El QR

El QR no es el código de seguridad: es una URL de verificación de la DGII
(`consultatimbre`, o `consultatimbrefc` si el comprobante se envió como
RFCE). Cualquiera que lo escanee ve, directamente en un servidor de la
DGII, si ese comprobante es válido, y no depende de NovaFE para
confirmarlo.

## Elige tu formato por defecto

Si no mandas `?layout` en el request, NovaFE usa el formato por defecto de
tu tenant. Puedes cambiarlo tú mismo desde la configuración del tenant en el
panel, con el ajuste `representation.default_layout`.

Acepta `"letter"` o `"pos"`. Por defecto es `"letter"`.

## Leyenda de contingencia

Si un comprobante se firmó mientras NovaFE estaba en modo de contingencia,
ambos formatos imprimen la leyenda que exige la DGII:

> e-CF emitido en modalidad de Contingencia, el cual podrá ser consultado
> para su validez fiscal, a partir de las setenta y dos (72) horas.

<Aside type="note" title="Qué falta todavía">
  El envío de la representación impresa por correo al comprador todavía no
  existe (necesita infraestructura de correo propia). Los catálogos de
  provincia/municipio y de unidad de medida tampoco se traducen a texto todavía:
  se muestran como código.
</Aside>