Tenants

Un tenant es una empresa (RUT) que emite documentos tributarios electrónicos. Cada tenant tiene sus propias credenciales, folios y DTEs. Un tenant puede existir sin estar certificado ante el SII. Los campos de resolución son opcionales: se registra la empresa primero y se completan cuando el SII la autoriza.

Crear tenant sin resolución

Es el caso normal de una empresa que todavía no postuló al SII. Nace en estadoCertificacion: "borrador" y ambiente: "certificacion".

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"
  }'

Crear tenant con resolución

Para una empresa que ya postuló al SII, el número que corresponde es el del ambiente de certificación — el par _cert.

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",
    "numeroResolucionCert": 99,
    "fechaResolucionCert": "2023-05-20"
  }'

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',
    numeroResolucionCert: 99,
    fechaResolucionCert: '2023-05-20',
  }),
}).then(r => r.json())

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`

Campos opcionales: las dos resoluciones

El SII publica dos números de resolución distintos: uno al aceptar la postulación al ambiente de certificación y otro al autorizar la emisión en producción. La carátula de cada envío declara el del ambiente en que el tenant está parado, así que declarar el equivocado hace que el SII rechace el envío completo.

Campo	Ambiente	Ejemplo
`numeroResolucionCert`	Certificación	`99`
`fechaResolucionCert`	Certificación	`2023-05-20`
`numeroResolucion`	Producción	`80`
`fechaResolucion`	Producción	`2024-01-15`

Reglas que la API valida:

Cada par va completo o vacío. Mandar numeroResolucion sin fechaResolucion devuelve 400.
Las fechas van en YYYY-MM-DD. Otro formato devuelve 400.
Si mandas numeroResolucion estando en certificación, la API lo copia al par _cert por compatibilidad — es la única resolución que ese tenant puede tener. No sobrescribe un numeroResolucionCert que ya tenga valor.

Estado de certificación

estadoCertificacion es de solo lectura: no se acepta en el payload de creación ni de edición.

Estado	Significa
`borrador`	Registrado, sin postular al SII
`certificando`	Postuló y está en el set de pruebas. Requiere el par `_cert` completo
`certificado`	El SII lo aprobó

Pasar a producción

PUT con ambiente: "produccion" devuelve 409 TENANT_NO_CERTIFICADO mientras el tenant no esté certificado. El camino es un endpoint aparte, que exige la resolución de producción y requiere rol administrativo:

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/go-live \
  -H "Authorization: Bearer <token de admin>" \
  -H "Content-Type: application/json" \
  -d '{
    "numeroResolucion": 4321,
    "fechaResolucion": "2026-08-10"
  }'

Mueve el tenant a certificado + produccion y guarda su resolución en una sola operación. El número es obligatorio porque la API no lo puede inferir: es una afirmación de que el SII autorizó la emisión, y usar el de certificación en producción hace que el SII rechace todos los envíos.

Las API keys no tienen rol administrativo, así que no pueden llamar a go-live. Es una operación de consola: ocurre una vez en la vida de un tenant.

Listar tenants

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

Credenciales

Configurar credenciales del tenant

Empezar

Flujos principales

Referencia

Crear tenant sin resolución

Crear tenant con resolución

Campos requeridos

Campos opcionales: las dos resoluciones

Estado de certificación

Pasar a producción

Listar tenants

Siguiente paso

Credenciales

​Crear tenant sin resolución

​Crear tenant con resolución

​Campos requeridos

​Campos opcionales: las dos resoluciones

​Estado de certificación

​Pasar a producción

​Listar tenants

​Siguiente paso

Credenciales

Crear tenant sin resolución

Crear tenant con resolución

Campos requeridos

Campos opcionales: las dos resoluciones

Estado de certificación

Pasar a producción

Listar tenants

Siguiente paso