Configuration
Configuration
Representa a los aspectos configurables de tu empresa, tales como canales de comunicación u otros datos relevantes.
Dirección de correo electrónico que recibirá alertas de eventos críticos en el sistema, por ejemplo, notificaciones sobre fallas de webhooks.
alerts@example.comVariante de íconos preferida.
Possible values: [duotone, outline, solid]
duotoneColor primario de la personalización de marca general, reutilizado en correos REDEC.
#111827Color utilizado para enlaces en correos REDEC.
#2563EBLista de dominios permitidos para el contenido de tu embed.
Indica si los usuarios pueden autorizar conexiones MCP con permisos derivados de sus roles del dashboard.
falsevalidation object
Configuración exclusiva para las validaciones de identidad.
Indica si se requiere validación de liveness (prueba de vida). No puede ser true si id_scan_check es false.
trueIndica si se requiere escaneo del documento de identidad. Cuando se combina con liveness_check, se verifica que la persona que hizo el liveness corresponda la persona del documento de identidad.
trueIndica si se debe hacer un cruce con la base de datos del gobierno al validar una identidad.
falseProveedor de la verificación gubernamental. Con null se usa el proveedor por defecto de Soyio.
Possible values: [ecert, certificadora_del_sur, null]
certificadora_del_surProveedor por defecto de Soyio, usado cuando government_check_provider es null.
Possible values: [ecert, certificadora_del_sur]
certificadora_del_surIndica si los datos de la transacción deben ser eliminados después de la validación.
truedisclosure object
Configuración exclusiva para el módulo de Disclosure Request.
Indica si se requiere validación de liveness (prueba de vida). No puede ser true si id_scan_check es false.
trueIndica si se requiere escaneo del documento de identidad. Cuando se combina con liveness_check, se verifica que la persona que hizo el liveness corresponda la persona del documento de identidad.
trueIndica si se debe hacer un cruce con la base de datos del gobierno durante el disclosure request.
falseProveedor de la verificación gubernamental. Con null se usa el proveedor por defecto de Soyio.
Possible values: [ecert, certificadora_del_sur, null]
certificadora_del_surIndica si se debe saltar el registro de llave de acceso para usuarios que no creen cuenta con Soyio. Si el usuario desea crear una cuenta, de todas maneras se le pedirá que registre su llave de acceso.
falseconsent object
Configuración exclusiva para el módulo de consentimiento.
Lista de dominios permitidos para el contenido de tu embed. Los dominios especificados acá se agregarán a la lista de dominios permitidos para el contenido de tu embed.
Los consentimientos pueden ser opcionales o obligatorios. Si el consentimiento es obligatorio y el label_display es mandatory_only, entonces sólo se mostrará el label de Requerido en los consentimietos. Por el contrario, si el consentimiento es opcional y el label_display es optional_only, entonces sólo se mostrará el label de Opcional en los consentimietos. Puedes ver un ejemplo acá.
Possible values: [optional_only, mandatory_only]
optional_onlyTexto del label de consentimiento cuando el label_display es mandatory_only. Si es required, entonces el label será Requerido. Si es mandatory, entonces el label será Obligatorio.
Possible values: [required, mandatory]
requiredIndica si la funcionalidad REDEC (Registro de Deudores de Créditos) está habilitada para la cuenta.
Es de solo lectura y refleja el estado del módulo redec; su activación se gestiona a nivel de
módulos, no a través de este campo.
trueDeprecado: usa GET /config/redec y PATCH /config/redec.
Habilita la generación automática semanal de reportes RDC30 para cumplimiento REDEC.
Cuando está habilitado, el sistema generará automáticamente reportes RDC30 de forma periódica
sin necesidad de solicitud manual. Requiere que redec_enabled esté activado.
falsefalseDeprecado: usa GET /config/redec y PATCH /config/redec.
Habilita la generación automática semanal de reportes RDC31 para cumplimiento REDEC.
Cuando está habilitado, el sistema generará automáticamente reportes RDC31 con la semana
cerrada de sábado a viernes. Requiere que redec_enabled esté activado.
falsefalseHabilita el envío automático de correos al usuario cuando otorga o revoca un consentimiento REDEC.
El correo solo se envía cuando redec_enabled está activado. Al otorgar, el endpoint de
creación debe recibir el parámetro email; al revocar, se usa ese parámetro o, si no viene,
el correo registrado al otorgar el consentimiento revocado.
falsefalseGenera el RDC30 con el formato del MSI vigente según la NCG 576: registros de 72 caracteres,
sin hash, con la fecha de referencia del período en el encabezado y con las revocaciones del
período aunque el consentimiento se haya otorgado antes. Requiere redec_responsible_nin.
Activado, cada otorgamiento de un consentimiento REDEC debe incluir channel en el action_token;
sin canal, el registro responde 422. Desactivado, el RDC30 mantiene el formato anterior.
falsefalseRUT de la contraparte responsable del REDEC registrada ante la CMF. El RDC30 con el formato de la
NCG 576 lo informa como RUT del ejecutivo cuando el consentimiento no tiene uno. Se guarda sin
puntos. No se puede borrar mientras redec_rdc30_ncg576_enabled esté activado.
22222222-2Exige un consent_form_template_lock personalizado válido para crear entries y validar documentos antes del envío, en todos los formularios y versiones de la empresa. Sin lock personalizado válido, esos endpoints responden 400. Emite el personalization_token desde tu backend para el usuario autenticado antes de activar esta opción.
falseMeses de vigencia por defecto del consentimiento de cookies. Cada banner de cookies puede
sobrescribirlo con consent_duration_months.
Possible values: [3, 6, 12, 13, 24]
1212privacy_center object
Configuración exclusiva para el módulo de Centro de Privacidad.
Email de contacto para el Centro de Privacidad.
privacy@example.comURL pública del Centro de Privacidad. Puedes encontrar más información sobre los modos de integración acá.
https://public-privacy.example.comURL privada del Centro de Privacidad. Revisa funcionalidades y modos del Centro de Privacidad para más información.
https://private-privacy.example.comDefine si los consentimientos requeridos pueden revocarse desde el Centro de Privacidad.
truetrueDefine qué plantillas de consentimiento se muestran en el Centro de Privacidad. enabled muestra las plantillas disponibles (enabled: true). enabled_and_accepted muestra solo las plantillas disponibles en las que el titular otorgó su consentimiento en al menos un alcance.
Possible values: [enabled, enabled_and_accepted]
enabledCómo se cuentan los días de consent_retention_period.
calendar_days: días corridos.chile_business_days: días hábiles, sin los feriados legales de Chile.chile_banking_business_days: días hábiles bancarios; agrega el 31 de diciembre como feriado.
Los días hábiles solo aplican a periodos expresados en días, como P5D.
Possible values: [calendar_days, chile_business_days, chile_banking_business_days]
calendar_dayschile_banking_business_daysLista de dominios permitidos para incrustar el Centro de Privacidad.
data_subject_request object
Configuración exclusiva para el Data Subject Request, módulo que se encuentra en el Centro de Privacidad.
Indica si se requiere validación de liveness (prueba de vida). No puede ser true si id_scan_check es false.
trueIndica si se requiere escaneo del documento de identidad. Cuando se combina con liveness_check, se verifica que la persona que hizo el liveness corresponda la persona del documento de identidad.
trueIndica si se debe hacer un cruce con la base de datos del gobierno durante la validación de identidad en DSR.
falseProveedor de la verificación gubernamental. Con null se usa el proveedor por defecto de Soyio.
Possible values: [ecert, certificadora_del_sur, null]
certificadora_del_surDetermina si la validación de identidad es obligatoria durante el proceso de solicitud de derechos del titular de datos (DSR).
false(por defecto): El usuario recibe confirmación de que su solicitud fue creada exitosamente y puede elegir validar su identidad inmediatamente o en un momento posterior.true: El usuario debe completar el proceso de validación de identidad antes de poder proceder con su solicitud.
falseDetermina si se deben enviar correos electrónicos funcionales (recuperación de código de solicitud por ejemplo) al titular de datos.
false(por defecto): Se envían correos electrónicos funcionales.true: No se envían correos electrónicos funcionales. Si eliges esta opción, debes manejar el envío de estos correos electrónicos por tu cuenta, o el usuario no recibirá ningún correo electrónico funcional.
falseDetermina si se deben enviar correos electrónicos informativos (confirmación de solicitud, etc.) al titular de datos.
false(por defecto): Se envían correos electrónicos informativos.true: No se envían correos electrónicos informativos.
falsePeríodo de tiempo durante el cual el titular de datos puede validar su identidad después de crear una solicitud en formato ISO 8601.
- Si no se especifica (
null): La solicitud no expira y el usuario puede validar su identidad en cualquier momento. - Si se especifica: La solicitud expirará después del período indicado, y el usuario deberá crear una nueva solicitud.
El período total debe ser mayor que 0.
P1DDetermina si las solicitudes de mutación (rectificación, oposición, supresión) pueden especificar más de una categoría de datos.
true(por defecto): Las solicitudes de mutación pueden incluir múltiples categorías de datos.false: Las solicitudes de mutación están limitadas a una sola categoría de datos por solicitud.
truetrueTipos de solicitud para los que se oculta la selección de categorías de datos.
Possible values: [access, portability, rectification, opposition, suppression]
[]Tipos de solicitud de consulta para los que el paso de detalle deja "Todos mis datos" como única opción y preseleccionada.
El titular no elige categorías ni escribe una justificación: solo continúa, y la solicitud queda registrada con request_detail.kind = "all".
Solo acepta access y portability, y un mismo tipo de solicitud no puede estar además en data_category_selection_hidden_kinds.
Possible values: [access, portability]
[]Derechos que el centro de privacidad ofrece por defecto al titular, es decir cuando la integración no envía su propia lista.
Cuando la integración sí envía una lista, esa lista reemplaza a esta configuración en vez de recortarla: puede pedir un derecho que no esté acá y el centro de privacidad lo va a mostrar igual.
Las empresas creadas antes de que el bloqueo pasara a ser un derecho solicitable por sí solo quedaron con los cinco derechos previos, para que su centro de privacidad no cambiara sin que lo pidieran. Las empresas nuevas nacen con los seis.
Debe contener al menos un derecho. Se guarda sin repetidos y en un orden fijo, sin importar el orden en que se envíe. No incluye los tipos REDEC, que siguen su propio flujo.
Possible values: [access, rectification, opposition, suppression, portability, blocking], >= 1
["access","rectification","opposition","suppression","portability"]contact_field_configs object[]
Configuración de los campos adicionales de contacto que puede completar el titular al crear su solicitud.
Cada elemento permite controlar la visibilidad y obligatoriedad de los campos soportados (names, last_names, phone).
Campo de contacto al que se aplica la configuración.
Possible values: [names, last_names, phone]
phoneDetermina si el campo se muestra en los formularios del Centro de Privacidad. Si es false, el titular no verá este campo.
trueIndica si el campo debe ser completado cuando es visible. No puede establecerse en true cuando visible es false.
falseDefine si las solicitudes deben asociarse obligatoriamente a una sucursal de la empresa.
- Si está vacío (por defecto): Las solicitudes son de alcance general (sin asociación a sucursal).
- Si contiene
"branch": El solicitante debe seleccionar una sucursal al crear la solicitud.
Possible values: [branch]
[]["branch"]branch_validation_overrides object[]
Sobrescribe la configuración de validación de identidad para sucursales específicas.
Cada elemento define un modo de validación propio para una sucursal (company_branch_id); las sucursales sin sobrescritura usan la configuración general del flujo DSR. Solo tiene efecto cuando appliable_scopes incluye "branch".
Identificador de la sucursal (branch_*) a la que aplica esta configuración.
branch_1a2b3c4d5e6fIndica si esta sucursal requiere validación de liveness (prueba de vida). No puede ser true si id_scan_check es false.
trueIndica si esta sucursal requiere escaneo del documento de identidad.
trueIndica si esta sucursal requiere un cruce con la base de datos del gobierno.
falseProveedor de la verificación gubernamental. Con null se usa el proveedor por defecto de Soyio.
Possible values: [ecert, certificadora_del_sur, null]
certificadora_del_surDeprecado: usa GET /config/redec y PATCH /config/redec.
Habilita la generación automática diaria de reportes RDC40 para solicitudes REDEC.
Cuando está habilitado, el sistema generará automáticamente reportes RDC40 de forma periódica (diaria)
sin necesidad de solicitud manual. Requiere que redec_enabled esté activado.
falsefalseDetermina si la justificación es obligatoria cuando el titular elige bloquear el uso de sus datos durante la solicitud (data_usage_during_request: "block").
false(por defecto): La justificación del bloqueo es opcional.true: El titular debe proveer una justificación para poder bloquear el uso de sus datos.
falsefalseDetermina si el dashboard ofrece resolver una solicitud cuya identidad todavía no fue validada, es decir en estado awaiting_verification o validating.
false(por defecto): El botón de resolver aparece deshabilitado en esos estados.true: El operador puede resolver la solicitud, y el dashboard le advierte que la identidad no fue verificada. La resolución queda registrada con su responsable y su razón interna, igual que cualquier otra.
Este ajuste gobierna la acción del dashboard. La API de resolución acepta esos estados con independencia de su valor.
falsefalseDefine desde cuándo corre el plazo para resolver una solicitud.
submission: el plazo empieza cuando el titular envía la solicitud.validation: el plazo empieza cuando el titular acredita su identidad. Hasta que eso ocurra la solicitud no tiene fecha de vencimiento.
Las compañías creadas desde que existe esta opción usan validation; las anteriores conservan submission, que es el comportamiento que ya tenían.
Possible values: [submission, validation]
validationdashboard object
Configuración exclusiva para el dashboard de la empresa.
Lista de métodos de autenticación habilitados para el dashboard de la empresa. Los métodos disponibles son:
password: Autenticación con contraseñagoogle: Autenticación con Google OAuthazure: Autenticación con Azure ADpasskeys: Autenticación con llaves de acceso (WebAuthn)
Possible values: [password, google, azure, passkeys]
["password"]["password","google","passkeys"]workflows object
Configuración global para automatizaciones reutilizables entre todos los workflows de la empresa.
variablesexpone valores reutilizables no sensibles bajo la rutaworkflow.variables.<key>.secretsexpone referencias write-only reutilizables bajo la rutaworkflow.secrets.<key>.- En respuestas, los secrets se devuelven enmascarados con
configured. - En requests, debes enviar
valuepara crear o reemplazar un secret.
variables object[]
Lista de variables globales reutilizables en condiciones y templates de workflows.
Clave reutilizable expuesta como workflow.variables.<key>.
Possible values: Value must match regular expression ^[a-z][a-z0-9_]*$
support_emailValor asociado a la variable.
support@example.comTimestamp ISO 8601 de la última actualización persistida de la variable.
2026-03-07T12:00:00Zsecrets object[]
Lista de secrets globales reutilizables solo durante interpolación de templates.
- En requests, usa
valuepara guardar o reemplazar el secret. - En responses, el valor no se expone; se devuelve
configuredpara indicar si existe un valor almacenado.
Clave reutilizable expuesta como workflow.secrets.<key>.
Possible values: Value must match regular expression ^[a-z][a-z0-9_]*$
crm_api_keyIndica si existe un valor almacenado para ese secret. Solo se devuelve en responses.
trueTimestamp ISO 8601 de la última actualización persistida del secret.
2026-03-07T12:00:00Z{
"alert_notification_email": "alerts@example.com",
"icon_variant": "duotone",
"default_color": "#111827",
"link_color": "#2563EB",
"whitelisted_domains": [
"string"
],
"mcp_enabled": false,
"validation": {
"liveness_check": true,
"id_scan_check": true,
"government_check": false,
"government_check_provider": "certificadora_del_sur",
"default_government_check_provider": "certificadora_del_sur",
"ephemeral_transaction_data": true
},
"disclosure": {
"liveness_check": true,
"id_scan_check": true,
"government_check": false,
"government_check_provider": "certificadora_del_sur",
"skip_passkey_registration": false
},
"consent": {
"whitelisted_domains": [
"string"
],
"label_display": "optional_only",
"mandatory_label_text": "required",
"redec_enabled": true,
"redec_consent_notification_email_enabled": false,
"redec_rdc30_ncg576_enabled": false,
"redec_responsible_nin": "22222222-2",
"require_consent_form_personalization": false,
"cookie_consent_duration_months": 12
},
"privacy_center": {
"contact_email": "privacy@example.com",
"public_url": "https://public-privacy.example.com",
"private_url": "https://private-privacy.example.com",
"allow_required_consent_revocation": true,
"consent_templates_display": "enabled",
"consent_retention_period": "P1D",
"consent_retention_counted_in": "chile_banking_business_days",
"whitelisted_domains": [
"string"
]
},
"data_subject_request": {
"liveness_check": true,
"id_scan_check": true,
"government_check": false,
"government_check_provider": "certificadora_del_sur",
"mandatory_validation": false,
"disable_functional_emails": false,
"disable_informative_emails": false,
"validation_timeout_period": "P1D",
"allow_many_data_categories_mutations": true,
"data_category_selection_hidden_kinds": [
"access"
],
"all_data_categories_preselected_kinds": [
"access"
],
"offered_request_kinds": [
"access",
"rectification",
"opposition",
"suppression",
"portability"
],
"contact_field_configs": [
{
"field_name": "phone",
"visible": true,
"required": false
}
],
"appliable_scopes": [
"branch"
],
"branch_validation_overrides": [
{
"company_branch_id": "branch_1a2b3c4d5e6f",
"liveness_check": true,
"id_scan_check": true,
"government_check": false,
"government_check_provider": "certificadora_del_sur"
}
],
"data_usage_block_justification_required": false,
"allow_resolution_without_validation": false,
"deadline_counted_from": "validation"
},
"dashboard": {
"auth_methods": [
"password",
"google",
"passkeys"
]
},
"workflows": {
"variables": [
{
"key": "support_email",
"value": "support@example.com",
"updated_at": "2026-03-07T12:00:00Z"
}
],
"secrets": [
{
"key": "crm_api_key",
"configured": true,
"updated_at": "2026-03-07T12:00:00Z"
}
]
}
}