Mail DTO

Описание сущностей и типов из src/dto/mail/.

Обогащено snapshot-данными бэкенд-DTO (4 из 5 типов сопоставлено, snapshot от 2026-05-05T13:21:51.699Z).

Содержание

• CreateMailRequestDto · backend ✓
• GetMailsRequestDto · backend ✓
• MailFileDto
• MailStatusDto · backend ✓
• UpdateMailStatusRequestDto · backend ✓

---

CreateMailRequestDto

Backend-источник: core.businesslogicservice/Core.BusinessLogicService/Nuget.BusinessApiClient/Dto/Mail/Requests/CreateMailRequestDto.cs (core.businesslogicservice).

Поля

Поле	Тип (TS)	Обязательное	Описание	Тип (C#)
file	File | Blob	да	—	IFormFile
externalType	ExternalTypeDto | null	нет	—	ExternalTypeDto?
externalTypeId	number | null	нет	—	int?

Пример

{
  "file": "<File | Blob>",
  "externalType": "<externaltypedto>",
  "externalTypeId": 0
}

---

GetMailsRequestDto

Filters for GET Api/Mails — the outgoing physical post, not Emails.

Every field except pagination is optional; an absent field means the condition is not applied.

statusFilter.available is the universe the counts are computed over, statusFilter.selected is the choice; an absent or empty selected means every status. The counts describe the slice left by the other filters, not the whole table.

Backend-источник: core.businesslogicservice/Core.BusinessLogicService/Nuget.BusinessApiClient/Dto/Mail/Requests/GetMailsRequestDto.cs (core.businesslogicservice).

Поля

Поле	Тип (TS)	Обязательное	Описание	Тип (C#)
pagination	Pagination	да	—	Pagination
statusFilter	PaginationFilter<MailStatusDto>	нет	Status facet. available is the universe the counts are computed over, selected is the choice; an absent or empty selected means every status, so no condition is applied.	—
createdAt	PaginationRangeFilter<string>	нет	ISO 8601 range over the creation timestamp.	—
updatedAt	PaginationRangeFilter<string>	нет	ISO 8601 range over the last-update timestamp. Mails never updated are excluded.	—
externalTypes	ExternalTypeDto[]	нет	Entity kind the mail is addressed to.	—
externalId	number	нет	Identifier within externalTypes.	—
externalFullName	string	нет	Prefix match on the name of the addressee, as stored on the mail.	—
senderFullName	string	нет	Prefix match on the full name of the user the mail originated from.	—

Пример

{
  "pagination": "<Pagination>",
  "statusFilter": "<PaginationFilter<MailStatusDto>>",
  "createdAt": "<PaginationRangeFilter<string>>",
  "updatedAt": "<PaginationRangeFilter<string>>",
  "externalTypes": [],
  "externalId": 0,
  "externalFullName": "string",
  "senderFullName": "string"
}

---

MailFileDto

Поля

Поле	Тип	Обязательное	Описание
id	number	да	—
mailId	number	да	—
fileName	string	да	—
fileUrl	string	да	—
createDateTime	string	да	—
updateDateTime	string | null	нет	—
deleteDateTime	string | null	нет	—

Пример

{
  "id": 0,
  "mailId": 0,
  "fileName": "string",
  "fileUrl": "https://...",
  "createDateTime": "2026-05-05T08:00:00Z",
  "updateDateTime": "2026-05-05T08:00:00Z",
  "deleteDateTime": "2026-05-05T08:00:00Z"
}

---

MailStatusDto

Backend-источник: core.businesslogicservice/Core.BusinessLogicService/Nuget.BusinessApiClient/Dto/Mail/Enum/MailStatusDto.cs (core.businesslogicservice).

Также определён в: infrastructure.notificationservice.

Значения

Имя	Значение (TS)	Описание	Код (C#)
NotFound	0	—	0
New	1	—	1
Printing	2	—	2
Sent	3	—	3
Archived	4	—	4

Пример

0

---

UpdateMailStatusRequestDto

Backend-источник: core.businesslogicservice/Core.BusinessLogicService/Nuget.BusinessApiClient/Dto/Mail/Requests/UpdateMailStatusRequestDto.cs (core.businesslogicservice).

Поля

Поле	Тип (TS)	Обязательное	Описание	Тип (C#)
mailId	number	да	—	int
status	MailStatusDto	да	—	MailStatusDto

Пример

{
  "mailId": 0,
  "status": "<MailStatusDto>"
}

---