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

# Tenants

> Crear y gestionar las empresas que emiten documentos

Un **tenant** es una empresa (RUT) que emite documentos tributarios electrónicos. Cada tenant tiene sus propias credenciales, folios y DTEs.

## Crear tenant

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.example.com/api/v1/tenants \
    -H "Authorization: Bearer sk_live_..." \
    -H "Content-Type: application/json" \
    -d '{
      "rutEmpresa": "76.123.456-7",
      "razonSocial": "Comercial Andes SpA",
      "giro": "Venta al por mayor de productos electrónicos",
      "direccion": "Av. Providencia 1234, Of. 567",
      "comuna": "Providencia",
      "ciudad": "Santiago",
      "numeroResolucion": 80,
      "fechaResolucion": "2024-01-15"
    }'
  ```

  ```javascript Node.js theme={null}
  const tenant = await fetch('https://api.example.com/api/v1/tenants', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      rutEmpresa: '76.123.456-7',
      razonSocial: 'Comercial Andes SpA',
      giro: 'Venta al por mayor de productos electrónicos',
      direccion: 'Av. Providencia 1234, Of. 567',
      comuna: 'Providencia',
      ciudad: 'Santiago',
      numeroResolucion: 80,
      fechaResolucion: '2024-01-15',
    }),
  }).then(r => r.json())
  ```
</CodeGroup>

## Campos requeridos

| Campo              | Descripción                              | Ejemplo                |
| ------------------ | ---------------------------------------- | ---------------------- |
| `rutEmpresa`       | RUT de la empresa con dígito verificador | `76.123.456-7`         |
| `razonSocial`      | Nombre legal de la empresa               | `Comercial Andes SpA`  |
| `giro`             | Actividad económica                      | `Venta al por mayor`   |
| `direccion`        | Dirección de la casa matriz              | `Av. Providencia 1234` |
| `comuna`           | Comuna                                   | `Providencia`          |
| `ciudad`           | Ciudad                                   | `Santiago`             |
| `numeroResolucion` | Número de resolución SII                 | `80`                   |
| `fechaResolucion`  | Fecha de resolución SII                  | `2024-01-15`           |

## Listar tenants

```bash theme={null}
curl https://api.example.com/api/v1/tenants \
  -H "Authorization: Bearer sk_live_..."
```

## Siguiente paso

Una vez creado el tenant, necesitas que el titular configure sus credenciales (certificado digital + API key de Simple API).

<Card title="Credenciales" icon="shield" href="/guides/credentials">
  Configurar credenciales del tenant
</Card>