{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/toku/json-schema/toku-intent-create-request-schema.json",
  "title": "IntentCreateRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/toku-intents-de-consentimiento-api-openapi.yml#/components/schemas/IntentCreateRequest",
  "properties": {
    "agreement": {
      "description": "uuid del agreement que el titular va a aceptar, el que la organización ve en el backoffice.",
      "title": "Agreement",
      "type": "string"
    },
    "subject": {
      "allOf": [
        {
          "$ref": "#/$defs/ConsentSubjectRequest"
        }
      ],
      "description": "Quién va a aceptar, tal como la organización lo conoce. Es lo que queda en el registro: el browser no lo declara y no lo puede cambiar."
    }
  },
  "required": [
    "agreement",
    "subject"
  ],
  "type": "object",
  "$defs": {
    "ConsentSubjectRequest": {
      "properties": {
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Correo del titular. Se guarda sin espacios alrededor y en minúsculas, y tiene que tener forma de correo: una `@` y ningún espacio. **Hace falta este o el documento de identidad.**",
          "title": "Email"
        },
        "external_id": {
          "description": "Identificador con el que el comercio ya reconoce al titular en sus propios sistemas.",
          "minLength": 1,
          "title": "External Id",
          "type": "string"
        },
        "government_id": {
          "anyOf": [
            {
              "$ref": "#/$defs/GovernmentIdRequest"
            },
            {
              "type": "null"
            }
          ],
          "description": "Documento de identidad del titular. Sin él, la organización queda sin la recuperación de evidencia por RUT y sus titulares no pueden elegir qué revocan. **Hace falta este o el correo**: un titular sin ninguno de los dos no se podría encontrar después."
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Nombre del titular, si el comercio lo capturó.",
          "title": "Name"
        },
        "phone": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Teléfono del titular, si el comercio lo capturó.",
          "title": "Phone"
        }
      },
      "required": [
        "external_id"
      ],
      "title": "ConsentSubjectRequest",
      "type": "object"
    },
    "GovernmentIdRequest": {
      "properties": {
        "type": {
          "allOf": [
            {
              "$ref": "#/$defs/GovernmentIdType"
            }
          ],
          "description": "Tipo del documento de identidad. El titular no siempre tiene RUT, así que el tipo viaja en el registro en vez de adivinarse después mirando el valor."
        },
        "value": {
          "description": "Valor del documento. Un RUT se normaliza —sin puntos, con guion, dígito verificador en mayúscula— y uno con dígito inválido se rechaza; un pasaporte se normaliza en mayúsculas y tiene que ser hasta nueve letras y dígitos, sin puntuación ni espacios.",
          "minLength": 1,
          "title": "Value",
          "type": "string"
        }
      },
      "required": [
        "type",
        "value"
      ],
      "title": "GovernmentIdRequest",
      "type": "object"
    },
    "GovernmentIdType": {
      "enum": [
        "rut",
        "passport"
      ],
      "title": "GovernmentIdType",
      "type": "string"
    }
  }
}