> ## 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.

# Empresas y puntos de venta

> GET /api/v3/companies y GET /api/v3/points-of-sale: descubrí con tu API Key tus empresas, sucursales, puntos de venta y sectores autorizados.

Con tu API Key ves **sólo lo tuyo**: no reciben ids. De acá sale el `pointOfSaleId` de la emisión y los sectores que
podés emitir. Tools MCP gemelas: `listarEmpresas` y `listarPuntosVenta`. Una credencial de servicio (`ck_svc_`) recibe `403`.

Ambas son paginadas: `page` (desde `0`) y `size` (`1` a `100`, default `20`). Fuera de rango: `400 VALIDATION_ERROR`
([`OUT_OF_RANGE`](https://docs.cucu.bo/errors#out_of_range)).

## Puntos de venta

`GET /api/v3/points-of-sale`

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://sandbox.cucu.bo/api/v3/points-of-sale -H "X-API-Key: YOUR_API_KEY"
```

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "success": true,
  "data": {
    "content": [
      {
        "id": "8f14e45f-ceea-4e7a-9a3b-2b6f5c1d0e21",
        "name": "POS Principal",
        "siatCode": 0,
        "defaultDocumentSector": 1,
        "authorizedSectors": [1, 24],
        "branchOfficeId": "1c9a7e2b-…",
        "branchOfficeSiatCode": 0,
        "branchOfficeName": "Casa Matriz",
        "companyId": "5d2c1b7a-…",
        "companyNit": "1020304050",
        "companyBusinessName": "EMPRESA DEMO S.R.L.",
        "modality": "ELECTRONICA",
        "siatVersion": "v2"
      }
    ],
    "page": 0, "size": 20, "totalElements": 1, "totalPages": 1, "first": true, "last": true
  },
  "timestamp": "2026-11-18T12:00:00.000-04:00"
}
```

| Campo | Uso |
| - | - |
| `id` | `pointOfSaleId` al emitir |
| `siatCode` / `branchOfficeSiatCode` | Códigos del POS y la sucursal ante el SIN |
| `defaultDocumentSector` | Sector que se usa si no mandás `documentSectorType` |
| `authorizedSectors` | Sectores que este POS puede emitir; otro da [`SECTOR_NOT_AUTHORIZED`](https://docs.cucu.bo/errors#sector_not_authorized) |
| `modality` / `siatVersion` | Electrónica o computarizada; `v2` o `v3` del SIAT |

## Empresas

`GET /api/v3/companies`

Cada empresa con sus sucursales y, dentro, sus puntos de venta (mismos campos que arriba).

| Campo | Descripción |
| - | - |
| `id`, `nit`, `businessName`, `tradeName` | Identidad de la empresa |
| `modality`, `siatVersion`, `priceBasis` | Modalidad, versión SIAT y base de precio (`v3`) |
| `defaultDocumentSector`, `authorizedSectors` | Sectores de la empresa |
| `branchOffices[]` | `id`, `name`, `siatCode`, `address`, `city`, `pointsOfSale[]` |

La respuesta no trae secretos (token SIAT, certificado). Para dar de alta empresas, sucursales o POS: [Onboarding](https://docs.cucu.bo/api/onboarding.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.