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

​
Qué hace

  • Crea una nueva credencial para autenticación en el SII
  • Valida automáticamente las credenciales proporcionadas antes de almacenarlas
  • Asocia la credencial con una entidad maestra específica
  • Verifica que los datos sean correctos en el SII

​
Ejemplos de uso

  • Configurar credenciales del SII para una nueva empresa
  • Agregar credenciales adicionales para una entidad existente
  • Reemplazar credenciales expiradas o inválidas
  • Configurar múltiples credenciales para diferentes entidades

​
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 header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu 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"