Evidence

Representa una evidencia que respalda un consentimiento o acuerdo.

idstring

Identificador único de la evidencia.

Example: evd_wCntp5aXB5q7fKSthevwrw

integrity_hashstring

Hash criptográfico que garantiza la integridad de la evidencia.

Example: 28b0f934...

legal_basisenum

Base legal del acuerdo.

Possible values: [consent]

Example: consent

consent_actions object[]

Lista de acciones realizadas por el usuario para consentimiento.

Array [

kindenum

Tipo de acción ("grant" o "revoke")

Possible values: [grant, revoke]

Example: grant

metadataobjectnullable

Datos adicionales de la acción (máximo 4KB de tamaño serializado en JSON)

Example: {"checkbox_id":"cb_123"}

action_dataobjectnullabledeprecated

Deprecado: usar metadata en su lugar. Datos adicionales de la acción.

Example: {"checkbox_id":"cb_123"}

action_typestringnullabledeprecated

Deprecado: campo eliminado, se mantiene por retrocompatibilidad.

Example: opt_in_click

action_idstring

Identificador único de la acción de consentimiento

Example: consact_1B2M2Y8AsgTpgAmY7PhCfg

originstringnullable

Origen asociado a la acción de consentimiento.

Example: web_signup

template_idstring

Identificador del template de consentimiento asociado.

Example: ctmpl_1B2M2Y8AsgTpgAmY7PhCfg

template_versioninteger

Versión del template de consentimiento asociado.

Example: 1

scope_selection_behaviorstring

Semántica de selección de scopes (replace o additive).

Possible values: [replace, additive]

Example: replace

selected_scopes object[]

Scopes seleccionados para esta acción.

Array [

scope_typestringrequired

Tipo de ámbito.

Possible values: [product, branch]

Example: product

scope_idstringrequired

Identificador público tokenizado del recurso scope.

Example: prod_1B2M2Y8AsgTpgAmY7PhCfg

scope_versionintegerrequired

Versión del recurso scope persistida en esta versión del template. Este valor queda fijado al guardar y no se actualiza automáticamente cuando aparecen nuevas versiones del scope.

Example: 1

]

channelstringnullable

Canal a través del cual se realizó la acción de consentimiento.

Possible values: [in_person, digital, phone_call]

Example: digital

timestampstring<date-time>

Fecha y hora de la acción

Example: 2024-03-20T15:30:00Z

contextual_data object

Datos contextuales como IP, user agent, etc.

ipstring

Example: 192.168.1.1

user_agentstring

Example: Mozilla/5.0

urlstring

Example: https://example.com

phone_numberstring

Example: +56912345678

]

identification_method object

Información sobre el método de identificación utilizado.

data_subject_idstring

ID del sujeto de datos identificado.

Example: id_ftKAfJCmbmGe1t2X1Kt3gw

typestring

Tipo de método de identificación utilizado.

Example: soyio.validation

type_referencestring

Referencia al proceso de identificación específico.

Example: va_Pwj5xTQYQ4vciUZPqnVTdg

event_logs object[]

Registro cronológico de eventos relacionados con la evidencia.

Array [

descriptionstring

Descripción del evento.

Example: Disclosure request was created

timestampstring<date-time>

Fecha y hora del evento.

Example: 2024-11-21T14:54:29.802Z

typestring

Tipo de evento.

Example: disclosure_created

metadataobjectnullable

Metadatos adicionales al evento

Example: {"details":"se le mostró al usuario el texto de consentimiento en un chatbot de whatsapp","chat_id":13928}

]

data_permissions_diff objectnullable

Diferencia de permisos de datos entre la versión anterior y actual del acuerdo. Muestra los permisos creados, removidos y extendidos.

created object[]

Permisos de datos que fueron creados en esta versión del acuerdo

Array [

data_categorystring

Categoría del dato personal. Sigue la taxonomía de datos. Revisa taxonomía para más información.

Example: user.name.first

data_labelstring

Identificador del dato

Example: name

data_usestring

Propósito específico del uso del dato. Sigue la taxonomía de usos de datos. Revisa taxonomía para más información.

Example: essential.service.authentication

data_subjectstring

Sujeto de derecho para el cual se aplica este permiso de datos. El valor se hereda del template de consentimiento que originó el permiso.

Possible values: [anonymous_user, citizen_voter, commuter, consultant, customer, employee, job_applicant, next_of_kin, passenger, patient, prospect, shareholder, supplier_vendor, trainee, visitor]

Example: customer

scope_typestringnullable

Tipo de alcance del uso del dato. Un dato puede estar dentro del contexto de un producto o de una branch

Possible values: [product, branch]

scope_idstringnullable

Identificador del producto o filial para la cual está vigente el uso del dato.

scope_versionintegernullable

Versión del producto o filial para la cual está vigente el uso del dato.

expires_atstring<date>nullable

Fecha de expiración del permiso de uso

]

removed object[]

Permisos de datos que fueron removidos en esta versión del acuerdo

Array [

data_categorystring

Categoría del dato personal. Sigue la taxonomía de datos. Revisa taxonomía para más información.

Example: user.name.first

data_labelstring

Identificador del dato

Example: name

data_usestring

Propósito específico del uso del dato. Sigue la taxonomía de usos de datos. Revisa taxonomía para más información.

Example: essential.service.authentication

data_subjectstring

Sujeto de derecho para el cual se aplica este permiso de datos. El valor se hereda del template de consentimiento que originó el permiso.

Example: customer

scope_typestringnullable

Tipo de alcance del uso del dato. Un dato puede estar dentro del contexto de un producto o de una branch

Possible values: [product, branch]

scope_idstringnullable

Identificador del producto o filial para la cual está vigente el uso del dato.

scope_versionintegernullable

Versión del producto o filial para la cual está vigente el uso del dato.

expires_atstring<date>nullable

Fecha de expiración del permiso de uso

]

extended object[]

Permisos de datos cuya fecha de expiración fue extendida en esta versión del acuerdo

Array [

data_categorystring

Categoría del dato personal. Sigue la taxonomía de datos. Revisa taxonomía para más información.

Example: user.name.first

data_labelstring

Identificador del dato

Example: name

data_usestring

Propósito específico del uso del dato. Sigue la taxonomía de usos de datos. Revisa taxonomía para más información.

Example: essential.service.authentication

data_subjectstring

Sujeto de derecho para el cual se aplica este permiso de datos. El valor se hereda del template de consentimiento que originó el permiso.

Example: customer

scope_typestringnullable

Tipo de alcance del uso del dato. Un dato puede estar dentro del contexto de un producto o de una branch

Possible values: [product, branch]

scope_idstringnullable

Identificador del producto o filial para la cual está vigente el uso del dato.

scope_versionintegernullable

Versión del producto o filial para la cual está vigente el uso del dato.

expires_atstring<date>nullable

Fecha de expiración del permiso de uso

]

consent_method objectdeprecated

Deprecado: usar consent_actions en su lugar. Método de captura del consentimiento.

channelstringdeprecated

Deprecado. Si integras por SDK, este campo se maneja automáticamente. Si integras por API, usa el campo channel al crear un action token.

Possible values: [in_person, digital, phone_call]

Example: digital

capture_facilitatorstringnullabledeprecated

Deprecado: campo eliminado, se mantiene por retrocompatibilidad.

capture_sourcestringnullabledeprecated

Deprecado: usar origin en su lugar. El campo origin es aceptado tanto por SDK como al crear un action token en integraciones por API.

Example: web_signup

metadataobjectdeprecated

Deprecado: usar metadata de cada consent_action en su lugar. Metadatos adicionales de la forma de captura del consentimiento.

Example: {"details":"se le mostró al usuario el texto de consentimiento en un chatbot de whatsapp","chat_id":13928}

actions object[]deprecated

Deprecado: usar consent_actions en su lugar. Lista de acciones de consentimiento.

Array [

kindstringdeprecated

Deprecado: usar consent_actions[].kind en su lugar.

Possible values: [grant, revoke]

Example: grant

action_typestringnullabledeprecated

Deprecado: campo eliminado, se mantiene por retrocompatibilidad.

action_dataobjectnullabledeprecated

Deprecado: usar consent_actions[].metadata en su lugar.

action_idstringdeprecated

Deprecado: usar consent_actions[].action_id en su lugar.

Example: consact_1B2M2Y8AsgTpgAmY7PhCfg

template_idstringdeprecated

Deprecado: usar consent_actions[].template_id en su lugar.

Example: ctmpl_1B2M2Y8AsgTpgAmY7PhCfg

template_versionintegerdeprecated

Deprecado: usar consent_actions[].template_version en su lugar.

Example: 1

scope_selection_behaviorstringdeprecated

Deprecado: usar consent_actions[].scope_selection_behavior en su lugar.

Possible values: [replace, additive]

Example: replace

selected_scopes object[]deprecated

Deprecado: usar consent_actions[].selected_scopes en su lugar.

Array [

scope_typestringrequired

Tipo de ámbito.

Possible values: [product, branch]

Example: product

scope_idstringrequired

Identificador público tokenizado del recurso scope.

Example: prod_1B2M2Y8AsgTpgAmY7PhCfg

scope_versionintegerrequired

Versión del recurso scope persistida en esta versión del template. Este valor queda fijado al guardar y no se actualiza automáticamente cuando aparecen nuevas versiones del scope.

Example: 1

]

timestampstring<date-time>deprecated

Deprecado: usar consent_actions[].timestamp en su lugar.

Example: 2024-03-20T15:30:00Z

]

created_atstring<date-time>

Fecha y hora de creación de la evidencia.

Example: 2024-11-21T14:54:57.202Z

Evidence
{
  "id": "evd_wCntp5aXB5q7fKSthevwrw",
  "integrity_hash": "28b0f934...",
  "legal_basis": "consent",
  "consent_actions": [
    {
      "kind": "grant",
      "metadata": {
        "checkbox_id": "cb_123"
      },
      "action_id": "consact_1B2M2Y8AsgTpgAmY7PhCfg",
      "origin": "web_signup",
      "template_id": "ctmpl_1B2M2Y8AsgTpgAmY7PhCfg",
      "template_version": 1,
      "scope_selection_behavior": "replace",
      "selected_scopes": [
        {
          "scope_type": "product",
          "scope_id": "prod_1B2M2Y8AsgTpgAmY7PhCfg",
          "scope_version": 1
        }
      ],
      "channel": "digital",
      "timestamp": "2024-03-20T15:30:00Z",
      "contextual_data": {
        "ip": "192.168.1.1",
        "user_agent": "Mozilla/5.0",
        "url": "https://example.com",
        "phone_number": "+56912345678"
      }
    }
  ],
  "identification_method": {
    "data_subject_id": "id_ftKAfJCmbmGe1t2X1Kt3gw",
    "type": "soyio.validation",
    "type_reference": "va_Pwj5xTQYQ4vciUZPqnVTdg"
  },
  "event_logs": [
    {
      "description": "Disclosure request was created",
      "timestamp": "2024-11-21T14:54:29.802Z",
      "type": "disclosure_created",
      "metadata": {
        "details": "se le mostró al usuario el texto de consentimiento en un chatbot de whatsapp",
        "chat_id": 13928
      }
    }
  ],
  "data_permissions_diff": {
    "created": [
      {
        "data_category": "user.contact.email",
        "data_label": "email",
        "data_use": "marketing",
        "expires_at": "2025-11-21"
      }
    ],
    "removed": [
      {
        "data_category": "user.name.first",
        "data_label": "name",
        "data_use": "essential",
        "expires_at": "2024-11-21"
      }
    ],
    "extended": [
      {
        "data_category": "user.contact.phone",
        "data_label": "phone",
        "data_use": "essential",
        "expires_at": "2026-11-21"
      }
    ]
  },
  "created_at": "2024-11-21T14:54:57.202Z"
}