> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cucu.bo/llms.txt
> Use this file to discover all available pages before exploring further.

# Acceso Publico

> Descarga publica de facturas (PDF A4, ticket, ticket SIAT, chititicket, XML, ZIP) sin autenticacion.

Estos endpoints son **publicos** y no requieren API Key. El CUF (Codigo Unico de Factura) actua como token de acceso.

<Note>
  Los URLs de descarga se incluyen en la respuesta al crear una factura. Puedes compartirlos directamente con tus clientes.
</Note>

## Informacion de la factura

```
GET /api/v1/public/invoice/{cuf}
```

### Path Parameters

| Parametro | Tipo   | Req | Descripcion             |
| --------- | ------ | --- | ----------------------- |
| `cuf`     | string | Si  | Codigo Unico de Factura |

```json theme={"system"}
{
  "success": true,
  "data": {
    "invoiceNumber": 5,
    "state": "VALIDATED",
    "amountTotal": 500.00,
    "clientBusinessName": "EMPRESA DEMO S.R.L.",
    "emissionDate": "2026-02-11T12:00:00",
    "downloads": {
      "pdf": "/api/v1/public/invoice/{cuf}/pdf",
      "ticket": "/api/v1/public/invoice/{cuf}/ticket",
      "xml": "/api/v1/public/invoice/{cuf}/xml",
      "zip": "/api/v1/public/invoice/{cuf}/zip"
    }
  }
}
```

***

## Descargar PDF (A4)

```
GET /api/v1/public/invoice/{cuf}/pdf
```

Descarga la factura en formato PDF tamano A4.

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -O https://sandbox.cucu.bo/api/v1/public/invoice/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74/pdf
  ```

  ```javascript JavaScript theme={"system"}
  window.open('https://sandbox.cucu.bo/api/v1/public/invoice/{cuf}/pdf');
  ```

  ```python Python theme={"system"}
  import requests

  response = requests.get(
      'https://sandbox.cucu.bo/api/v1/public/invoice/{cuf}/pdf'
  )
  with open('factura.pdf', 'wb') as f:
      f.write(response.content)
  ```
</CodeGroup>

***

## Descargar Ticket (80mm)

```
GET /api/v1/public/invoice/{cuf}/ticket
```

Descarga la factura en formato ticket para impresoras de 80mm (diseno CUCU).

***

## Descargar Ticket SIAT (formato oficial)

```
GET /api/v1/public/invoice/{cuf}/ticketsiat
```

Descarga el ticket replicando la **Representacion Grafica oficial** de impuestos.gob.bo: mismo diseno que el documento que emite el SIN (tipografia con serifa, separadores punteados, detalle de items linea por linea, totales, leyendas fiscales y QR). Util cuando el cliente necesita un ticket identico al formato del impuesto.

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -O https://sandbox.cucu.bo/api/v1/public/invoice/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74/ticketsiat
  ```

  ```javascript JavaScript theme={"system"}
  window.open('https://sandbox.cucu.bo/api/v1/public/invoice/{cuf}/ticketsiat');
  ```
</CodeGroup>

***

## Descargar Chititicket (ticket reducido)

```
GET /api/v1/public/invoice/{cuf}/chititicket
```

Descarga un ticket **reducido** (formato POS): incluye emisor y sucursal, NIT / N° de factura / codigo de autorizacion, datos del cliente (razon social y NIT/CI/CEX), totales, importe literal y QR. **No incluye el detalle de items ni las leyendas largas** — pensado para impresion rapida en punto de venta.

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -O https://sandbox.cucu.bo/api/v1/public/invoice/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74/chititicket
  ```

  ```javascript JavaScript theme={"system"}
  window.open('https://sandbox.cucu.bo/api/v1/public/invoice/{cuf}/chititicket');
  ```
</CodeGroup>

***

## Descargar XML

```
GET /api/v1/public/invoice/{cuf}/xml
```

Descarga el XML firmado digitalmente de la factura.

***

## Descargar ZIP

```
GET /api/v1/public/invoice/{cuf}/zip
```

Descarga un ZIP que contiene: PDF A4 + Ticket 80mm + XML firmado.

***

## Pagina de verificacion

```
GET /f/{cuf}
```

Pagina web publica de verificacion de la factura o nota credito/debito. Muestra los datos completos del documento en formato visual con QR, ideal para compartir con clientes o verificar la autenticidad del documento.

```
https://sandbox.cucu.bo/f/2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74
```

<Tip>
  El endpoint `/f/{cuf}` funciona tanto para facturas como para notas de credito/debito. Cada documento tiene su propio CUF unico.
</Tip>

***

<Tip>
  Todos los archivos incluyen el header `Cache-Control: public, max-age=31536000`. Las facturas son inmutables una vez emitidas.
</Tip>