Crear Credencial
Crea una nueva credencial validándola en el SII
Que hace
- Crea una nueva credencial para autenticacion en el SII
- Valida automaticamente las credenciales proporcionadas antes de almacenarlas
- Asocia la credencial con una entidad maestra especifica
- 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 invalidas
- Configurar multiples credenciales para diferentes entidades
Obtener el master_entity_id
Elmaster_entity_id es el ID unico de la empresa en Tupana que se esta asociando con estas credenciales. Para obtener este ID, debes usar el endpoint /master-entities:
- Buscar la entidad por RUT usando
GET /master-entities?rut=76543210-1 - Obtener el ID de la respuesta (campo
id) - Usar ese ID como
master_entity_iden la creacion de credenciales
Tipos de Credenciales
Puedes usarcredential_type (string) o credential_type_id (numerico) para indicar el tipo de credencial. Consulta la referencia completa de tipos de credenciales para mas detalles.
Certificado digital (.pfx) por archivo
Si necesitas subir un certificado digital, el archivo.pfx se envia en el payload JSON como string base64.
- Convierte primero el archivo
.pfxa base64 - Envia ese valor en el campo
digital_certificate_base64 - Envia
digital_certificate_passwordsi corresponde - Envia
credential_type: "certificate"para guardarlo como credencial de certificado digital
Ejemplo de payload
Importante
- El
.pfxse envia como string base64 endigital_certificate_base64 - En este flujo no se envian
user_rutnipassword - El backend guarda la credencial como tipo certificado digital
Authorizations
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
RUT del usuario (sin puntos y con guión)
^[0-9]+-[0-9kK]$"12345678-9"
Contraseña del usuario en el SII
"mi_password_segura"
Contraseña del certificado digital
"mi_password_certificado"
ID de la entidad maestra a la que pertenece la credencial
123
ID del tipo de credencial (opcional, por defecto SII)
70
Response
Credencial creada exitosamente
ID único de la credencial creada
1
RUT del usuario de la credencial
"12345678-9"
Información de la entidad maestra asociada
Tipo de credencial
Estado de la credencial
VALID, INVALID, EXPIRED "VALID"
Fecha de creación de la credencial
"2024-01-01T10:00:00Z"
