GetExternalCorrespondenceV2Response

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/raiffeisen-ru/main/json-schema/raiffeisen-ru-get-external-correspondence-v2-response-schema.json",
  "title": "GetExternalCorrespondenceV2Response",
  "x-generated": "2026-10-09",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/raiffeisen-ru-letters-openapi.yml#/components/schemas/GetExternalCorrespondenceV2Response",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "Идентификатор переписки"
    },
    "direction": {
      "description": "Направление переписки",
      "$ref": "#/$defs/ExternalCorrespondenceDirection"
    },
    "status": {
      "description": "Статус переписки",
      "$ref": "#/$defs/ExternalCorrespondenceStatus"
    },
    "topic": {
      "$ref": "#/$defs/ExternalCorrespondenceTopic"
    },
    "createdAt": {
      "description": "Время создания переписки",
      "$ref": "#/$defs/DateTime"
    },
    "updatedAt": {
      "description": "Время обновления переписки",
      "$ref": "#/$defs/DateTime"
    },
    "account": {
      "type": [
        "string",
        "null"
      ],
      "description": "Номер счета"
    },
    "senderFirstName": {
      "type": "string",
      "description": "Имя инициатора"
    },
    "senderMiddleName": {
      "type": [
        "string",
        "null"
      ],
      "description": "Отчество инициатора"
    },
    "senderLastName": {
      "type": "string",
      "description": "Фамилия инициатора"
    },
    "correspondenceMails": {
      "type": "array",
      "description": "Письма переписки",
      "items": {
        "$ref": "#/$defs/ExternalCorrespondenceMail"
      }
    }
  },
  "required": [
    "id",
    "direction",
    "status",
    "topic",
    "createdAt",
    "updatedAt",
    "account",
    "senderFirstName",
    "senderMiddleName",
    "senderLastName",
    "correspondenceMails"
  ],
  "$defs": {
    "DateTime": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$",
      "description": "Дата и время в UTC в формате yyyy-MM-dd'T'HH:mm:ss'Z'"
    },
    "ExternalCorrespondenceDirection": {
      "type": "string",
      "description": "Направление переписки относительно клиента. TO_BANK — от клиента в банк, FROM_BANK — из банка клиенту",
      "enum": [
        "FROM_BANK",
        "TO_BANK"
      ]
    },
    "ExternalCorrespondenceMail": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "Идентификатор письма"
        },
        "type": {
          "description": "Тип письма",
          "$ref": "#/$defs/ExternalMailType"
        },
        "text": {
          "type": "string",
          "description": "Текст письма"
        },
        "number": {
          "type": "integer",
          "description": "Номер письма"
        },
        "createdAt": {
          "description": "Время создания письма",
          "$ref": "#/$defs/DateTime"
        },
        "updatedAt": {
          "description": "Время обновления письма",
          "$ref": "#/$defs/DateTime"
        },
        "senderFirstName": {
          "type": "string",
          "description": "Имя отправителя"
        },
        "senderMiddleName": {
          "type": "string",
          "description": "Отчетсво отправителя"
        },
        "senderLastName": {
          "type": "string",
          "description": "Фамилия отправителя"
        },
        "attachments": {
          "type": "array",
          "description": "Информация о вложениях",
          "items": {
            "$ref": "#/$defs/ExternalMailAttachment"
          }
        }
      },
      "required": [
        "id",
        "type",
        "text",
        "number",
        "createdAt",
        "updatedAt",
        "senderFirstName",
        "senderLastName",
        "attachments"
      ]
    },
    "ExternalCorrespondenceStatus": {
      "type": "string",
      "description": "Статус переписки; промежуточные статусы закрытия относятся к OPEN",
      "enum": [
        "OPEN",
        "CLOSED"
      ]
    },
    "ExternalCorrespondenceTopic": {
      "type": [
        "object",
        "null"
      ],
      "description": "Названия составляющих тематики переписки; null, если тематические данные не заполнены",
      "properties": {
        "product": {
          "type": [
            "string",
            "null"
          ],
          "description": "Продукт"
        },
        "theme": {
          "type": [
            "string",
            "null"
          ],
          "description": "Тема"
        },
        "clarification": {
          "type": [
            "string",
            "null"
          ],
          "description": "Уточнение"
        }
      }
    },
    "ExternalMailAttachment": {
      "type": "object",
      "properties": {
        "number": {
          "type": "integer",
          "description": "Номер вложения"
        },
        "name": {
          "type": "string",
          "description": "Название вложения"
        }
      },
      "required": [
        "number",
        "name"
      ]
    },
    "ExternalMailType": {
      "type": "string",
      "description": "Направление письма относительно клиента",
      "enum": [
        "TO_BANK",
        "FROM_BANK"
      ]
    }
  }
}