Saltar al contenido principal

DataSubjectRequest

DataSubjectRequest

Representan las solicitudes de ejercicio de derechos de los usuarios.

Guías relacionadas​

idstring

Identificador único del data subject request. Debe empezar con dsreq_

Example: dsreq_1B2M2Y8AsgTpgAmY7PhCfg
humanized_identifierstring

Identificador de la solicitud.

Example: FME4607
subject_idstring

Identificador único del sujeto de datos que se está modificando. Puede corresponder al identificador de un Identity o Entity.

Example: ent_1B2M2Y8AsgTpgAmY7PhCfg
user_referencestring

Referencia del usuario en el sistema del cliente.

Example: user_123
request_referencestring

Referencia opcional de la solicitud proporcionada por el cliente para correlacionar webhooks y eventos.

Example: ticket-12345
company_branch_idstring

Identificador de la sucursal a la que está asociada esta solicitud.

Example: branch_1B2M2Y8AsgTpgAmY7PhCfg
government_only_modeboolean

Indica si la solicitud fue creada con el modo government-only activo. Cuando es true, el solicitante debe ingresar manualmente su RUT y número de documento para iniciar la validación contra el Registro Civil. Este valor se deriva de company.config.data_subject_request.government_only_mode y no es editable al crear la solicitud.

Example: true
kindstringrequired

Tipo de solicitud.

Possible values: [access, rectification, opposition, suppression, portability, redec_update, redec_rectification, redec_complementation, redec_cancellation]

Example: access
statusstring

Estado actual de la solicitud.

Possible values: [awaiting_verification, validating, processing, resolved, data_missmatch, timed_out]

Example: awaiting_verification
terminal_statestring

Estado terminal de la solicitud cuando status es resolved.

Possible values: [approved, partially_approved, rejected]

Example: approved
approvedbooleandeprecated

Indica si la resolución fue aprobada (true) o rechazada (false). Campo legacy derivado de terminal_state y puede ser null si la resolución es parcial.

Example: true
data_usage_during_requeststring

Indica si el uso de datos durante la solicitud está permitido o no. Solo es requerido para las solicitudes de tipo rectification, opposition y suppression.

Possible values: [block, allow]

Example: block
rejection_reasonstring

Razón de rechazo si la solicitud fue rechazada.

Example: Documentación insuficiente
contact_information objectrequired

Información de contacto del titular. La visibilidad / obligatoriedad de alguno de estos campos es configurable.

ninstringrequired

Número de identificación del usuario. No configurable.

Example: 123456789
emailstring<email>required

Email del usuario. Este email se usa para enviar confirmaciones. No configurable.

Example: user@example.com
namesstring

Nombres del usuario. Configurable

Example: Juan Carlos
last_namesstring

Apellidos del usuario. Configurable

Example: Pérez Gómez
phonestring

Número de teléfono del usuario. Configurable

Example: +56 9 1234 5678
request_detail objectnullable

Detalle de la solicitud. Puede ser null cuando la solicitud es creada directamente por la compañía (a través de la API). Cuando se crea a través del widget del centro de privacidad, este campo siempre estará presente.

oneOf
kindstringrequired

Tipo de solicitud de consulta.

Possible values: [all, specific]

Example: all
data_categoriesstring[]

Categorías de datos a solicitar. Requerido cuando kind es 'specific'. Debe ser una categoría válida de la taxonomía o 'other'.

Example: ["user.name","user.contact.email"]
detailstring

Detalle adicional de la solicitud.

Example: Solicitud de acceso a datos personales
workflow_run_idstring

ID del workflow run asociado a la solicitud.

Example: wfr_1B2M2Y8AsgTpgAmY7PhCfg
expires_atstring<date-time>

Fecha y hora de expiración de la solicitud.

Example: 2024-03-20T15:30:00Z
created_atstring<date-time>

Fecha y hora de creación de la solicitud.

Example: 2024-03-20T15:30:00Z
updated_atstring<date-time>

Fecha y hora de la última actualización de la solicitud.

Example: 2024-03-20T15:30:00Z
DataSubjectRequest
{
  "id": "dsreq_1B2M2Y8AsgTpgAmY7PhCfg",
  "humanized_identifier": "FME4607",
  "subject_id": "ent_1B2M2Y8AsgTpgAmY7PhCfg",
  "user_reference": "user_123",
  "request_reference": "ticket-12345",
  "company_branch_id": "branch_1B2M2Y8AsgTpgAmY7PhCfg",
  "government_only_mode": true,
  "kind": "access",
  "status": "awaiting_verification",
  "terminal_state": "approved",
  "data_usage_during_request": "block",
  "rejection_reason": "Documentación insuficiente",
  "contact_information": {
    "nin": "123456789",
    "email": "user@example.com",
    "names": "Juan Carlos",
    "last_names": "Pérez Gómez",
    "phone": "+56 9 1234 5678"
  },
  "request_detail": {
    "kind": "all",
    "data_categories": [
      "user.name",
      "user.contact.email"
    ],
    "detail": "Solicitud de acceso a datos personales"
  },
  "workflow_run_id": "wfr_1B2M2Y8AsgTpgAmY7PhCfg",
  "expires_at": "2024-03-20T15:30:00Z",
  "created_at": "2024-03-20T15:30:00Z",
  "updated_at": "2024-03-20T15:30:00Z"
}