{
  "$id": "urn:person",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "version": "0.4",
  "type": "object",
  "title": "Detalles del registro de personas",
  "description": "Información sobre una persona física.",
  "properties": {
    "isComponent": {
      "title": "Es componente",
      "description": "Si esta persona es un componente de una relación indirecta. Cuando `isComponent` es 'true': (1) el `recordId` de esta persona DEBE ser un elemento en el arreglo de datos `componentRecords` de dicho enunciado sobre relación primaria, (2) este enunciado sobre persona DEBE venir antes de dicho enunciado sobre relación primaria en un paquete o transmisión del BODS, (3) el reemplazo de este enunciado sobre persona DEBERÍA considerarse al reemplazar el enunciado sobre relación primaria. El enunciado sobre relación primaria DEBE tener un valor `isComponent` 'false'.",
      "type": "boolean"
    },
    "personType": {
      "title": "Tipo de persona",
      "description": "El estado de esta persona, usando la lista de códigos personType. Cuando una persona tiene el tipo 'anonymousPerson' o 'unknownPerson', DEBERÍA indicarse un motivo para la ausencia de información en 'unspecifiedPersonDetails'.",
      "type": "string",
      "enum": [
        "anonymousPerson",
        "unknownPerson",
        "knownPerson"
      ],
      "propertyOrder": 4,
      "codelist": "personType.csv",
      "openCodelist": false
    },
    "unspecifiedPersonDetails": {
      "$ref": "urn:components#/$defs/UnspecifiedRecord",
      "description": "Una explicación del motivo por el que una persona es anónima o desconocida."
    },
    "names": {
      "title": "Nombres",
      "description": "Uno o más nombres conocidos para esta persona.",
      "type": "array",
      "items": {
        "$ref": "#/$defs/Name"
      },
      "propertyOrder": 10
    },
    "identifiers": {
      "title": "Identificadores",
      "description": "Uno o más identificadores oficiales para esta persona. Si corresponde, deben proporcionarse números de inscripción oficial.",
      "type": "array",
      "items": {
        "$ref": "urn:components#/$defs/Identifier"
      },
      "propertyOrder": 20
    },
    "nationalities": {
      "title": "Nacionalidad",
      "description": "Las nacionalidades que esta persona posee.",
      "type": "array",
      "items": {
        "$ref": "urn:components#/$defs/Country"
      },
      "propertyOrder": 30
    },
    "placeOfBirth": {
      "title": "Lugar de nacimiento",
      "description": "En lugar donde nació esta persona.",
      "propertyOrder": 40,
      "$ref": "urn:components#/$defs/Address",
      "properties": {
        "type": {
          "enum": [
            "placeOfBirth"
          ]
        }
      }
    },
    "birthDate": {
      "title": "Fecha de nacimiento",
      "description": "La fecha de nacimiento de esta persona, en formato AAAA, AAAA-MM o AAAA-MM-DD.",
      "type": "string",
      "anyOf": [
        {
          "pattern": "^(\\d{4})(-(1[0-2]|0[1-9]))?$"
        },
        {
          "format": "date"
        }
      ],
      "propertyOrder": 35
    },
    "deathDate": {
      "title": "Fecha de defunción",
      "description": "La fecha de defunción de esta persona, en formato AAAA, AAAA-MM o AAAA-MM-DD.",
      "type": "string",
      "anyOf": [
        {
          "pattern": "^(\\d{4})(-(1[0-2]|0[1-9]))?$"
        },
        {
          "format": "date"
        }
      ],
      "propertyOrder": 36
    },
    "taxResidencies": {
      "title": "Residencia fiscal",
      "description": "Las residencias fiscales que esta persona posee, como un arreglo de datos de objetos en el País.",
      "type": "array",
      "items": {
        "$ref": "urn:components#/$defs/Country"
      },
      "propertyOrder": 55
    },
    "addresses": {
      "title": "Domicilios",
      "description": "Una o más direcciones de esta persona.",
      "type": "array",
      "items": {
        "$ref": "urn:components#/$defs/Address",
        "properties": {
          "type": {
            "enum": [
              "residence",
              "service",
              "alternative"
            ]
          }
        }
      },
      "propertyOrder": 60
    },
    "politicalExposure": {
      "type": "object",
      "title": "Exposición política",
      "description": "Información sobre si la persona descrita en este enunciado está expuesta políticamente y de qué manera. Use esta propiedad solo si se esperan declaraciones de personas políticamente expuestas (PEP) como parte de las declaraciones de beneficiarios finales.",
      "required": [
        "status"
      ],
      "properties": {
        "status": {
          "type": "string",
          "title": "Estado de persona expuesta políticamente (PEP)",
          "description": "Este valor es 'isPep' o 'isNotPep' dependiendo de si la persona descrita en este enunciado tiene el estado de persona expuesta políticamente (PEP). Un valor 'unknown' significa que se espera una declaración de estado PEP, pero está ausente; el motivo de la ausencia de datos DEBERÍA incluirse en el arreglo de datos `details`.",
          "enum": [
            "isPep",
            "isNotPep",
            "unknown"
          ]
        },
        "details": {
          "type": "array",
          "title": "Detalles de persona expuesta políticamente (PEP)",
          "description": "Una o más descripciones del estado de Persona Políticamente Expuesta (PEP) de esta persona.",
          "items": {
            "$ref": "#/$defs/PepStatusDetails"
          }
        }
      }
    }
  },
  "required": [
    "personType",
    "isComponent"
  ],
  "$defs": {
    "Name": {
      "title": "Nombre",
      "description": "Un nombre por el que se conoce a esta persona. DEBE proporcionarse un nombre en `fullName`, y PUEDE dividirse en los campos `familyName`, `givenName` y `patronymicName`, según las definiciones del Vocabulario principal de personas de ISA de la CE (https://joinup.ec.europa.eu/solution/e-government-core-vocabularies).",
      "type": "object",
      "required": [
        "fullName"
      ],
      "properties": {
        "type": {
          "title": "Tipo",
          "description": "El estado de este nombre para la persona, usando la lista de códigos nameType.",
          "type": "string",
          "enum": [
            "legal",
            "translation",
            "transliteration",
            "former",
            "alternative",
            "birth"
          ],
          "codelist": "nameType.csv",
          "openCodelist": false
        },
        "fullName": {
          "title": "Nombre completo",
          "description": "El nombre completo de la persona.",
          "type": "string"
        },
        "familyName": {
          "title": "Apellido",
          "description": "Parte del `fullName` de la persona que los miembros de la familia comparten. El valor puede incluir prefijos o sufijos, p. ej., 'de Boer', 'van de Putte', 'von und zu Orlow'. El valor puede ser un apellido de varias partes, como se encuentran comúnmente en países hispanos. Por ejemplo, el apellido de Miguel de Cervantes Saavedra se registraría como 'de Cervantes Saavedra'.",
          "type": "string"
        },
        "givenName": {
          "title": "Nombres de pila",
          "description": "La parte del `fullName` de la persona que identifica a la persona dentro de su familia. Los padres le dan este nombre a la persona al momento de nacer o puede ser legalmente reconocido como 'given names' mediante un proceso formal. Por ejemplo, el nombre de pila de Johann Sebastian Bach es 'Johann Sebastian'.",
          "type": "string"
        },
        "patronymicName": {
          "title": "Nombre patronímico",
          "description": "Parte del `fullName` que la persona hereda de su padre, que es común en países como Islandia, Etiopía y Rusia. Por ejemplo, el 'Sergeyevich' en 'Mikhail Sergeyevich Gorbachev'.",
          "type": "string"
        }
      }
    },
    "PepStatusDetails": {
      "title": "Detalles del estado de PEP",
      "description": "Información sobre la participación política de una persona.",
      "type": "object",
      "properties": {
        "reason": {
          "title": "Motivo",
          "description": "Motivo por el cual se declaró a esta persona como políticamente expuesta.",
          "type": "string"
        },
        "missingInfoReason": {
          "title": "Motivos de información faltante",
          "description": "Una explicación del motivo por el que no se proporciona el estado de PEP de la persona (es decir, `politicalExposure.status` es 'unknown'). Esto puede ser una frase descriptiva estándar del sistema fuente o una justificación de texto libre. Cuando este campo está presente, debería ser el único campo a excepción de `source`.",
          "type": "string"
        },
        "jurisdiction": {
          "title": "Jurisdicción",
          "description": "La jurisdicción en la cual la persona reviste la condición de PEP.",
          "$ref": "urn:components#/$defs/Jurisdiction"
        },
        "startDate": {
          "title": "Fecha del estado",
          "description": "La fecha desde la cual esta persona tuvo el estado de persona expuesta políticamente (PEP). La fecha DEBE indicarse en formato AAAA-MM-DD. Si no se pueden indicar un mes o una fecha precisos, puede redondearse el valor al primer día del (primer) mes. Este redondeo DEBERÍA mencionarse en la guía complementaria (como una política de publicaciones o una guía de uso de datos).",
          "type": "string",
          "format": "date"
        },
        "endDate": {
          "title": "Fecha de finalización",
          "description": "La fecha desde la cual esta persona ya no tenía el estado de persona expuesta políticamente (PEP). La fecha DEBE indicarse en formato AAAA-MM-DD. Si no se pueden indicar un mes o una fecha precisos, puede redondearse el valor al primer día del (primer) mes. Este redondeo DEBERÍA mencionarse en la guía complementaria (como una política de publicaciones o una guía de uso de datos).",
          "type": "string",
          "format": "date"
        },
        "source": {
          "title": "Fuente",
          "description": "Fuente de la información sobre la PEP",
          "$ref": "urn:components#/$defs/Source"
        }
      }
    }
  }
}