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

# Alojamiento

> Factura para hoteles, hostales y servicios de alojamiento. Sector 16.

Para hoteles, hostales, apart-hoteles, residenciales y todo servicio de hospedaje.

## Datos del sector

| Campo                   | Valor                            |
| ----------------------- | -------------------------------- |
| `codigoDocumentoSector` | `16`                             |
| WSDL SIAT               | `ServicioFacturacionElectronica` |

## Campos adicionales

### Cabecera

| Campo              | Tipo    | Req | Descripcion                              |
| ------------------ | ------- | --- | ---------------------------------------- |
| `qtyGuests`        | integer | Si  | Cantidad total de huespedes              |
| `qtyRooms`         | integer | Si  | Cantidad de habitaciones ocupadas        |
| `qtyGreater`       | integer | No  | Cantidad de huespedes mayores de edad    |
| `qtyMinors`        | integer | No  | Cantidad de huespedes menores de edad    |
| `dateEntryLodging` | string  | Si  | Fecha de ingreso al hospedaje (ISO 8601) |

### Detalle

| Campo                    | Tipo    | Req | Descripcion                               |
| ------------------------ | ------- | --- | ----------------------------------------- |
| `details[].codeTypeRoom` | integer | No  | Codigo tipo de habitacion (catalogo SIAT) |
| `details[].detailGuests` | string  | No  | Detalle de huespedes por habitacion       |

## Ejemplo

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -X POST https://sandbox.cucu.bo/api/v1/invoices \
    -H "Content-Type: application/json" \
    -H "X-API-Key: YOUR_API_KEY" \
    -d '{
      "documentSectorType": 16,
      "pointOfSaleId": "660e8400-e29b-41d4-a716-446655440004",
      "clientDocumentType": 3,
      "clientDocumentNumber": "AB123456",
      "clientBusinessName": "JOHN SMITH",
      "paymentMethodCode": 2,
      "cardNumber": "4532",
      "qtyGuests": 2,
      "qtyRooms": 1,
      "qtyGreater": 2,
      "qtyMinors": 0,
      "dateEntryLodging": "2026-03-01T14:00:00",
      "details": [
        {
          "activityEconomic": "551000",
          "codeProductSin": "63111",
          "description": "Habitacion doble - 3 noches (01-04 Mar 2026)",
          "quantity": 3,
          "unitMeasure": 58,
          "priceUnit": 280.00,
          "codeTypeRoom": 1,
          "detailGuests": "John Smith, Jane Smith"
        }
      ]
    }'
  ```

  ```javascript JavaScript theme={"system"}
  const response = await fetch('https://sandbox.cucu.bo/api/v1/invoices', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      documentSectorType: 16,
      pointOfSaleId: '660e8400-e29b-41d4-a716-446655440004',
      clientDocumentType: 3,
      clientDocumentNumber: 'AB123456',
      clientBusinessName: 'JOHN SMITH',
      paymentMethodCode: 2,
      cardNumber: '4532',
      qtyGuests: 2,
      qtyRooms: 1,
      qtyGreater: 2,
      qtyMinors: 0,
      dateEntryLodging: '2026-03-01T14:00:00',
      details: [{
        activityEconomic: '551000',
        codeProductSin: '63111',
        description: 'Habitacion doble - 3 noches (01-04 Mar 2026)',
        quantity: 3,
        unitMeasure: 58,
        priceUnit: 280.00,
        codeTypeRoom: 1,
        detailGuests: 'John Smith, Jane Smith'
      }]
    })
  });
  ```

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

  response = requests.post(
      'https://sandbox.cucu.bo/api/v1/invoices',
      headers={
          'Content-Type': 'application/json',
          'X-API-Key': 'YOUR_API_KEY'
      },
      json={
          'documentSectorType': 16,
          'pointOfSaleId': '660e8400-e29b-41d4-a716-446655440004',
          'clientDocumentType': 3,
          'clientDocumentNumber': 'AB123456',
          'clientBusinessName': 'JOHN SMITH',
          'paymentMethodCode': 2,
          'cardNumber': '4532',
          'qtyGuests': 2,
          'qtyRooms': 1,
          'qtyGreater': 2,
          'qtyMinors': 0,
          'dateEntryLodging': '2026-03-01T14:00:00',
          'details': [{
              'activityEconomic': '551000',
              'codeProductSin': '63111',
              'description': 'Habitacion doble - 3 noches (01-04 Mar 2026)',
              'quantity': 3,
              'unitMeasure': 58,
              'priceUnit': 280.00,
              'codeTypeRoom': 1,
              'detailGuests': 'John Smith, Jane Smith'
          }]
      }
  )
  ```
</CodeGroup>

<Info>
  Ver [Crear Factura](/api/create-invoice) para la referencia completa de campos estandar, response y codigos de error.
</Info>