Skip to content
ATI.SU MCP NEW Мои токены Поддержка
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
For LLMs and AI agents: canonical Markdown source of this documentation page (plain-text .md — fetch this URL to use the page content in tools and RAG). For LLMs and AI agents: developers documentation index in llms.txt format — ordered list of key documentation URLs for the developers section.

Словари для работы с претензиями

Словари, которыми описываются претензии ATI.SU: типы и уровни претензий, их статусы, роли участников, документы. Значения из этих словарей приходят в ответах методов претензий и передаются в их запросах.

Каждый метод отдаёт плоский список: у каждого элемента есть идентификатор и набор атрибутов. Состав полей и их описания смотрите в схеме ответа ниже.

Типы претензий

Типы претензий ATI.SU: за что участник выставляет претензию контрагенту, например неоплата, простой транспорта или утрата груза.

Получение типов претензий
get /gw/marshak/v1/dictionaries/claim_types
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_types' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_types
Модель
[{...}]

Типы претензий ATI.SU: за что участник выставляет претензию контрагенту — неоплата, простой транспорта, утрата груза и прочие основания.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"claim_levels":"0,1",
"claim_name":"Опоздание на загрузку/выгрузку (просрочка в доставке груза)",
"for_type":"2"
}
}
]

Сторона, к которой выставлена претензия

Сторона, к которой выставлена претензия: заказчик или исполнитель перевозки.

Получение сторон претензии
get /gw/marshak/v1/dictionaries/claim_for_types
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_for_types' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_for_types
Модель
[{...}]

Сторона, к которой выставлена претензия: заказчик или исполнитель перевозки.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"К заказчику"
}
}
]

Уровни претензии

Уровни претензии: для претензии-Лайт достаточно прикрепить Заявку, для претензии-Про необходимо прикрепить полный комплект документов.

Получение уровней претензии
get /gw/marshak/v1/dictionaries/claim_levels
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_levels' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_levels
Модель
[{...}]

Уровни претензии: лайт — поданная по минимальному комплекту документов, про — по полному комплекту.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"Претензия-про"
}
}
]

Статусы претензии

Статусы претензии: опубликована, отклонена, урегулирована и прочие состояния её жизненного цикла.

Получение статусов претензии
get /gw/marshak/v1/dictionaries/claim_statuses
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_statuses' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_statuses
Модель
[{...}]

Статусы претензии: опубликована, отклонена, урегулирована и прочие состояния её жизненного цикла.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"Опубликована"
}
}
]

Статусы модерации

Статусы модерации претензии: проверил ли претензию модератор ATI.SU и с каким результатом.

Получение статусов модерации
get /gw/marshak/v1/dictionaries/claim_moderator_statuses
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_moderator_statuses' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_moderator_statuses
Модель
[{...}]

Статусы модерации претензии: проверил ли претензию модератор ATI.SU и с каким результатом.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"Проверена модератором"
}
}
]

Статусы связи ответчика

Статусы связи ответчика по претензии с юридическим лицом, указанным в её документах: подтверждена ли связь и на каком основании.

Получение статусов связи ответчика
get /gw/marshak/v1/dictionaries/claim_connection_statuses
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_connection_statuses' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_connection_statuses
Модель
[{...}]

Статусы связи ответчика по претензии с юр. лицом, указанным в её документах: подтверждена ли связь и на каком основании.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"Не подтверждена"
}
}
]

Статусы оспоренности

Статусы оспоренности претензии: заявил ли ответчик несогласие с претензией по существу.

Получение статусов оспоренности
get /gw/marshak/v1/dictionaries/claim_challenge_statuses
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_challenge_statuses' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_challenge_statuses
Модель
[{...}]

Статусы оспоренности претензии: заявил ли ответчик несогласие с претензией по существу.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"Не оспорена"
}
}
]

Роли участника претензии

Роли участника претензии: истец — участник, который добавил претензию; ответчик — участник, в адрес которого добавили претензию.

Получение ролей участника претензии
get /gw/marshak/v1/dictionaries/claim_roles
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_roles' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_roles
Модель
[{...}]

Роли участника претензии: истец — тот, кто выставил претензию, ответчик — тот, кому она выставлена.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"Истец"
}
}
]

Поля сортировки списка претензий

Поля, по которым упорядочивается список претензий: дата, сумма, имя стороны.

Получение полей сортировки
get /gw/marshak/v1/dictionaries/claim_sort_types
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_sort_types' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_sort_types
Модель
[{...}]

Поля, по которым упорядочивается список претензий: дата, сумма, имя стороны.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"По дате"
}
}
]

Типы документов претензии

Типы документов, которые прикладываются к претензии: договор, заявка, транспортная накладная, акт и прочие. Список обязательных документов для каждого типа претензии определяется «Положением о Претензиях».

Получение типов документов претензии
get /gw/marshak/v1/dictionaries/claim_doc_types
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_doc_types' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_doc_types
Модель
[{...}]

Типы документов, которые прикладываются к претензии: договор, заявка, транспортная накладная, акт и прочие.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"ТН (Транспортная накладная)"
}
}
]

Статусы документа претензии

Статусы отдельного документа претензии: проверен ли документ модератором ATI.SU.

Получение статусов документа претензии
get /gw/marshak/v1/dictionaries/claim_doc_statuses
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_doc_statuses' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_doc_statuses
Модель
[{...}]

Статусы отдельного документа претензии: проверен ли документ модератором ATI.SU.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"Документ проверен"
}
}
]

Состояния проверки электронного документа

Состояния проверки электронного документа претензии: отправлен на проверку, проверка пройдена и прочие.

Получение состояний проверки электронного документа
get /gw/marshak/v1/dictionaries/claim_digital_document_statuses
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_digital_document_statuses' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_digital_document_statuses
Модель
[{...}]

Состояния проверки электронного документа претензии.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"Проверка пройдена"
}
}
]

Состояния черновика претензии

Состояния черновика претензии, добавленной с электронными документами: идёт ли по нему проверка и чем она закончилась.

Получение состояний черновика претензии
get /gw/marshak/v1/dictionaries/claim_draft_statuses
Параметры
Параметр Тип Расположение Описание
locale string query
Локаль значений полей. Доступные варианты: ru, en, kk, ky, uz, hy Пример: ru
Запрос
Пример запроса
curl 'https://api.ati.su/gw/marshak/v1/dictionaries/claim_draft_statuses' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Элементы словаря claim_draft_statuses
Модель
[{...}]

Состояния черновика претензии, поданной с электронными документами: идёт ли по нему проверка и чем она закончилась.

dictionary_item_id: integer

Идентификатор элемента словаря

}]
Пример
[...]
{...}
"dictionary_item_id":1,
"attributes":{...}
"name":"Проверка пройдена, черновик материализован в претензию"
}
}
]