Skip to main content
POST
/
credentials
Crear credencial
curl --request POST \
  --url https://api.tupana.ai/v1/credentials \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_rut": "12345678-9",
  "password": "mi_password_segura",
  "digital_certificate_password": "mi_password_certificado",
  "master_entity_id": 123,
  "credential_type_id": 70
}
'
{
  "id": 1,
  "user": "12345678-9",
  "master_entity": {
    "id": 123,
    "name": "Empresa Ejemplo SpA",
    "tax_id": "76543210-1"
  },
  "credential_type": {
    "id": 70,
    "name": "SII"
  },
  "status": "VALID",
  "created_at": "2024-01-01T10:00:00Z"
}
Crea una nueva credencial para autenticación en el SII. El sistema valida automáticamente las credenciales proporcionadas antes de almacenarlas.

​
Parámetros Requeridos

  • user_rut (string): RUT del usuario (formato: 12345678-9)
  • password (string): Contraseña del usuario en el SII
  • master_entity_id (integer): ID de la entidad maestra en Tu Pana

​
Parámetros Opcionales

  • credential_type_id (integer): ID del tipo de credencial (por defecto 70 para SII)

​
Obtener el master_entity_id

El master_entity_id es el ID único de la empresa en Tu Pana que se está asociando con estas credenciales. Para obtener este ID, debes usar el endpoint /master-entities:
  1. Buscar la entidad por RUT usando GET /master-entities?rut=76543210-1
  2. Obtener el ID de la respuesta (campo id)
  3. Usar ese ID como master_entity_id en la creación de credenciales

Authorizations

​
Authorization
string
header
required

API Key para autenticación. Debe proporcionarse en el formato: 'Api-Key YOUR-API-KEY'

Body

application/json
​
user_rut
string
required

RUT del usuario (sin puntos y con guión)

Example:

"12345678-9"

​
password
string
required

Contraseña del usuario en el SII

Example:

"mi_password_segura"

​
digital_certificate_password
string
required

Contraseña del certificado digital

Example:

"mi_password_certificado"

​
master_entity_id
integer
required

ID de la entidad maestra a la que pertenece la credencial

Example:

123

​
credential_type_id
integer

ID del tipo de credencial (opcional, por defecto SII)

Example:

70

Response

Credencial creada exitosamente

​
id
integer

ID único de la credencial creada

Example:

1

​
user
string

RUT del usuario de la credencial

Example:

"12345678-9"

​
master_entity
object

Información de la entidad maestra asociada

​
credential_type
object

Tipo de credencial

​
status
enum<string>

Estado de la credencial

Available options:
VALID,
INVALID,
EXPIRED
Example:

"VALID"

​
created_at
string<date-time>

Fecha de creación de la credencial

Example:

"2024-01-01T10:00:00Z"