API раздела «Ваши машины»

API позволяет управлять вашими машинами — добавлять, изменять и удалять их.

Терминология

Машина — объявление о свободном транспорте. Содержит в себе информацию о машине, датах, в которые машина свободна, направлениях перевозки и комфортной ставке.

Ваши машины — раздел на сайте ATI.SU, в котором пользователь может добавлять, удалять и редактировать машины.

Архив ваших машин — информация об удаленной машине помещается в архив. Объявление из архива можно восстановить.

Приоритетный показ — услуга, закрепляющая объявление вверху поиска машин. Cтатья про приоритетный показ.

Атисы — валюта виртуального счета в ATI.SU. 1 атис равен 1 российскому рублю. Используется для приоритетного показа и других услуг. Статья про атисы.

Комментарий к машине — дополнительная информация, которая может быть добавлена к машине сотрудниками вашей фирмы. Видна только сотрудникам вашей фирмы.

Пользовательские ошибки в API машин

В API машин может произойти достаточно много пользовательских ошибок, и для идентификации конкретной ошибки не всегда достаточно http кода ошибки. Поэтому при возникновении ошибки в теле ответа всегда будет присутствовать объект ошибки, содержащий 2 поля: error с кодом ошибки в виде строки и reason с пояснением. В групповых операциях поля error и reason будут указаны для каждой машины, с которой произошла ошибка во время выполнения операции.

Примеры ошибок

Ошибка при одиночной операции (на примере добавления машины)

Ошибка при одиночной операции (не обновилась машина, так как уже была обновлена менее 60 минут назад).

{
    "error": "truck_duplicate",
    "reason": "Машина имеет дубликат в системе. Операция невозможна.",
    "duplicate_truck_id": "2fb37893-3587-eb11-bb9f-0cc47af30c1b"
}

Ошибка при групповой операции (на примере группового обновления)

{
    "2fb37893-3587-eb11-bb9f-0cc47af30c1b": {
        "error": "truck_renew_delay_not_elapsed_error",
        "reason": "Машина была обновлена менее 60 минут назад. Следующее обновление возможно через 57 минут.",
        "remaining_minutes": 57
    },
    "89d8e0db-3587-eb11-bb9f-0cc47af30c1b": {
        "error": "truck_renew_delay_not_elapsed_error",
        "reason": "Машина была обновлена менее 60 минут назад. Следующее обновление возможно через 59 минут.",
        "remaining_minutes": 59
    }
}

Ошибка валидации (на примере добавления машины)

В случае ошибки валидации json в теле запроса возникает ошибка json_validation_error. В теле ответа будут поля error и reason, и, кроме того, поле error_list, содержащее массив объектов вида {property;reason}, где: property – название поля, в котором произошла ошибка; reason – причина ошибки.

{
    "error": "json_validation_error",
    "reason": "Одна или несколько машин не прошли проверку. Отредактируйте машину, чтобы исправить ошибки.",
    "details": [
        {
            "property": "priority.view_rate",
            "reason": "Параметр  \"Ставка за просмотр\" должен должен принимать значения от  0.60 атисов до значения вашего баланса включительно"
        },
        {
            "property": "first_date",
            "reason": "Если значение параметра date_type равно 1, допустимое значение параметра first_date - от текущей даты до 60 дней вперед"
        }
    ]
}

Ошибка доступа (на примере добавления машины)

{
    "error": "contact_access_denied_error",
    "reason": "У данного контакта имеются ограничения на данную операцию"
}

Список возможных 4хх ошибок

Код ошибки	Пояснение
deserialization_error	Ошибка десериализации json
json_validation_error	Ошибка валидации json из тела запроса
validation_error	Ошибка валидации. Возникает в случае любой ошибки валидации, кроме ошибки валидации тела запроса (json_validation_error)
contact_access_denied_error	Отказано в доступе
truck_renew_delay_not_elapsed_error	Машина была обновлена менее 60 минут назад
dictionary_element_not_found_error	Элемент словаря не найден
truck_not_found_error	Машина не найдена

Список методов

Работа с машинами

• Получение одной машины
• Получение всех машин
• Получение машин контакта
• Получение количества машин
• Получение доступа на добавление машины
• Добавление машины
• Обновление машины
• Редактирование машины
• Удаление машины

Работа с архивом ваших машин

• Получение одной архивной машины
• Получение всех архивных машин
• Получение архивных машин для определенного контакта
• Восстановление архивной машины
• Удаление машины из архива

Групповые методы

• Групповое обновление машин (POST)
• Групповое обновление машин (PUT)
• Групповое удаление машин
• Групповое удаление машин из архива

Работа с комментариями к машинам

• Получение комментариев ко всем машинам
• Получение комментариев к машине
• Добавление/редактирование комментария к машине (POST)
• Добавление/редактирование комментария к машине (PUT)
• Удаление комментария к машине (DELETE)
• Удаление комментария к машине (POST)
• Получение комментариев к архивной машине
• Получение комментариев ко всем архивным машинам
• Добавление/редактирование комментария к архивной машине (POST)
• Добавление/редактирование комментария к архивной машине (PUT)
• Удаление комментария к архивной машине (DELETE)
• Удаление комментария к архивной машине (POST)

Работа с приоритетным показом

• Изменение приоритетного показа в актуальной машине
• Удаление приоритетного показа в актуальной машине

API отзывов на машины

API позволяет оставить встречное предложение на машину, а также запросить все встречные предложения на ваши машины.

Терминология

Машина — объявление о свободном транспорте. Содержит в себе информацию о машине, датах, в которые машина свободна, направлениях перевозки и комфортной ставке.

Ваши машины — раздел на сайте ATI.SU, в котором пользователь может добавлять, удалять и редактировать машины.

Встречное предложение — отзыв с предложением перевезти груз.

Список методов

• Изменение встречного предложения на машину
• Получение встречных предложений на машины для адресата
• Получение встречных предложений на машины по списку машин
• Получение своих встречных предложений на машины
• Удаление встречных предложений на машину
• Удаление встречного предложения на машину по ID
• Получение количества непросмотренных встречных предложений по машинам
• Получение счетчиков встречных предложений на опубликованные машины
• Получение счетчиков встречных предложений на архивные машины

Изменение встречного предложения на машину

Метод работает по семантике create-or-update: если предложение уже существует — обновляет его, иначе создает. Отдельно проверять существование перед вызовом не нужно. В обоих случаях метод возвращает HTTP 201.

put /v1.1/trucks/{truckId}/counter_offers

Модель и примеры

Запрос

Модель

{...}

Тело запроса для создания или изменения встречного предложения

offerer_contact_id: int32 (nullable)

ID контакта автора предложения (если не передан, подставляется текущий контакт)

cash_sum*: double

Сумма наличными

currency_id: int32 (nullable)

Валюта для наличной суммы. Значение из словаря валют АТИ

sum_with_nds*: double

Сумма с НДС

nds_currency_id: int32 (nullable)

Валюта суммы с НДС. Значение из словаря валют АТИ

sum_without_nds*: double

Сумма без НДС

not_nds_currency_id: int32 (nullable)

Валюта суммы без НДС. Значение из словаря валют АТИ

note: string (nullable)

Комментарий к предложению. Максимальное количество символов 512

prepay_percent: int32 (nullable)

Процент предоплаты

delay_payment_days: int32 (nullable)

Отсрочка оплаты в банковских днях

loading_city_id: int64 (nullable)

ID города погрузки. Значение из словаря городов АТИ

unloading_city_id: int64 (nullable)

ID города выгрузки. Значение из словаря городов АТИ

weight*: double

Максимальная грузоподъемность, т

volume*: double

Максимальный объем, м3

car_delivery_date*: date-time

Дата подачи машины. При передаче времени учитывается только дата.

unload_payment: boolean (nullable)

Оплата на выгрузке

coloading: boolean (nullable)

Разрешена догрузка

}

Пример запроса

CURL

curl 'https://api.ati.su/v1.1/trucks/{truckId}/counter_offers' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"offerer_contact_id":0,"cash_sum":65000,"currency_id":1,"sum_with_nds":0,"nds_currency_id":0,"sum_without_nds":0,"not_nds_currency_id":0,"note":"Готовы забрать сегодня","prepay_percent":30,"delay_payment_days":5,"loading_city_id":146,"unloading_city_id":2,"weight":20,"volume":82,"car_delivery_date":"2026-04-24T00:00:00Z","unload_payment":false,"coloading":false}'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("PUT", "https://api.ati.su", "/v1.1/trucks/{truckId}/counter_offers", "{""offerer_contact_id"":0,""cash_sum"":65000,""currency_id"":1,""sum_with_nds"":0,""nds_currency_id"":0,""sum_without_nds"":0,""not_nds_currency_id"":0,""note"":""Готовы забрать сегодня"",""prepay_percent"":30,""delay_payment_days"":5,""loading_city_id"":146,""unloading_city_id"":2,""weight"":20,""volume"":82,""car_delivery_date"":""2026-04-24T00:00:00Z"",""unload_payment"":false,""coloading"":false}");

Ответ

201 Встречное предложение создано или изменено

Модель

{...}

id: uuid

Id встречного предложения

truck_id: uuid

Id машины

addition_date: date-time

Дата добавления встречного предложения

change_date: date-time

Дата изменения встречного предложения

viewed_at: date-time (nullable)

Дата и время просмотра встречного предложения

cash_sum: double (nullable)

Ставка наличными

currency_id: int32 (nullable)

Валюта ставки наличными. Значение из словаря валют АТИ

sum_with_nds: double (nullable)

Ставка с НДС

nds_currency_id: int32 (nullable)

Валюта ставки с НДС. Значение из словаря валют АТИ

sum_without_nds: double (nullable)

Ставка без НДС

not_nds_currency_id: int32 (nullable)

Валюта ставки без НДС. Значение из словаря валют АТИ

note: string (nullable)

Комментарий к предложению. Максимальное количество символов 512

prepay_percent: int32 (nullable)

Предоплата в процентах

delay_payment_days: int32 (nullable)

Оплата через банковских дней

loading_city_id: int64 (nullable)

Id города загрузки. Значение из словаря городов АТИ

unloading_city_id: int64 (nullable)

Id города разгрузки. Значение из словаря городов АТИ

weight: double (nullable)

Максимальная грузоподъемность, т

volume: double (nullable)

Максимальный объем, м3

car_delivery_date: date-time

Дата подачи транспорта

is_actual: boolean

Актуальность встречного предложения

unload_payment: boolean

Оплата на выгрузке

coloading: boolean

Догруз

sender_firm_info:{...}

Информация о фирме, оставившей встречное предложение

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

firm_id: int32

Id фирмы

contact:{...}

Краткая информация о контакте

firm_id: int32

Id фирмы

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

name: string (nullable)

Имя контакта

phone: string (nullable)

Телефон

mobile_phone: string (nullable)

Мобильный телефон

claims_count: int32

Количество претензий

recommendations_count: int32

Количество рекомендаций

bad_partner_mentions_count: int32

Количество упоминаний в НП

city: string (nullable)

Город

firm_type: string (nullable)

Тип фирмы

firm_name: string (nullable)

Название фирмы

ownership: string (nullable)

Форма собственности

score: double

Рейтинг контакта

status: int32

Статус контакта

skype_name: string (nullable)

Skype

fax: string (nullable)

Факс

email: string (nullable)

E-mail

}

name: string

Название фирмы

score: double

Рейтинг фирмы

status: int32

Статус фирмы

}

}

Пример

{...}

"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"addition_date":"1970-01-01T00:00:00.000Z",

"change_date":"1970-01-01T00:00:00.000Z",

"viewed_at":"1970-01-01T00:00:00.000Z",

"cash_sum":0.5,

"currency_id":0,

"sum_with_nds":0.5,

"nds_currency_id":0,

"sum_without_nds":0.5,

"not_nds_currency_id":0,

"note":"string",

"prepay_percent":0,

"delay_payment_days":0,

"loading_city_id":0,

"unloading_city_id":0,

"weight":0.5,

"volume":0.5,

"car_delivery_date":"1970-01-01T00:00:00.000Z",

"is_actual":false,

"unload_payment":false,

"coloading":false,

"sender_firm_info":{...}

"ati_id":"string",

"contact_id":0,

"firm_id":0,

"contact":{...},

"firm_id":0,

"ati_id":"string",

"contact_id":0,

"name":"string",

"phone":"string",

"mobile_phone":"string",

"claims_count":0,

"recommendations_count":0,

"bad_partner_mentions_count":0,

"city":"string",

"firm_type":"string",

"firm_name":"string",

"ownership":"string",

"score":0.5,

"status":0,

"skype_name":"string",

"fax":"string",

"email":"string"

},

"name":"string",

"score":0.5,

"status":0

}

}

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

truckId ID машины

{ "offerer_contact_id": 0, "cash_sum": 65000, "currency_id": 1, "sum_with_nds": 0, "nds_currency_id": 0, "sum_without_nds": 0, "not_nds_currency_id": 0, "note": "Готовы забрать сегодня", "prepay_percent": 30, "delay_payment_days": 5, "loading_city_id": 146, "unloading_city_id": 2, "weight": 20, "volume": 82, "car_delivery_date": "2026-04-24T00:00:00Z", "unload_payment": false, "coloading": false }

Получение встречных предложений на машины для адресата

Возвращает встречные предложения, полученные на ваши машины.
Для регулярной синхронизации передавайте newerThan, а для учета архивных машин используйте includeArchived=true.

get /v1.1/trucks/counter_offers/received

Модель и примеры

Запрос

Пример запроса

CURL

curl 'https://api.ati.su/v1.1/trucks/counter_offers/received' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/v1.1/trucks/counter_offers/received");

Ответ

200 Список отзывов на ваши машины

Модель

[{...}]

id: uuid

Id встречного предложения

truck_id: uuid

Id машины

addition_date: date-time

Дата добавления встречного предложения

change_date: date-time

Дата изменения встречного предложения

viewed_at: date-time (nullable)

Дата и время просмотра встречного предложения

cash_sum: double (nullable)

Ставка наличными

currency_id: int32 (nullable)

Валюта ставки наличными. Значение из словаря валют АТИ

sum_with_nds: double (nullable)

Ставка с НДС

nds_currency_id: int32 (nullable)

Валюта ставки с НДС. Значение из словаря валют АТИ

sum_without_nds: double (nullable)

Ставка без НДС

not_nds_currency_id: int32 (nullable)

Валюта ставки без НДС. Значение из словаря валют АТИ

note: string (nullable)

Комментарий к предложению. Максимальное количество символов 512

prepay_percent: int32 (nullable)

Предоплата в процентах

delay_payment_days: int32 (nullable)

Оплата через банковских дней

loading_city_id: int64 (nullable)

Id города загрузки. Значение из словаря городов АТИ

unloading_city_id: int64 (nullable)

Id города разгрузки. Значение из словаря городов АТИ

weight: double (nullable)

Максимальная грузоподъемность, т

volume: double (nullable)

Максимальный объем, м3

car_delivery_date: date-time

Дата подачи транспорта

is_actual: boolean

Актуальность встречного предложения

unload_payment: boolean

Оплата на выгрузке

coloading: boolean

Догруз

sender_firm_info:{...}

Информация о фирме, оставившей встречное предложение

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

firm_id: int32

Id фирмы

contact:{...}

Краткая информация о контакте

firm_id: int32

Id фирмы

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

name: string (nullable)

Имя контакта

phone: string (nullable)

Телефон

mobile_phone: string (nullable)

Мобильный телефон

claims_count: int32

Количество претензий

recommendations_count: int32

Количество рекомендаций

bad_partner_mentions_count: int32

Количество упоминаний в НП

city: string (nullable)

Город

firm_type: string (nullable)

Тип фирмы

firm_name: string (nullable)

Название фирмы

ownership: string (nullable)

Форма собственности

score: double

Рейтинг контакта

status: int32

Статус контакта

skype_name: string (nullable)

Skype

fax: string (nullable)

Факс

email: string (nullable)

E-mail

}

name: string

Название фирмы

score: double

Рейтинг фирмы

status: int32

Статус фирмы

}

}]

Пример

[...]

{...}

"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"addition_date":"1970-01-01T00:00:00.000Z",

"change_date":"1970-01-01T00:00:00.000Z",

"viewed_at":"1970-01-01T00:00:00.000Z",

"cash_sum":0.5,

"currency_id":0,

"sum_with_nds":0.5,

"nds_currency_id":0,

"sum_without_nds":0.5,

"not_nds_currency_id":0,

"note":"string",

"prepay_percent":0,

"delay_payment_days":0,

"loading_city_id":0,

"unloading_city_id":0,

"weight":0.5,

"volume":0.5,

"car_delivery_date":"1970-01-01T00:00:00.000Z",

"is_actual":false,

"unload_payment":false,

"coloading":false,

"sender_firm_info":{...}

"ati_id":"string",

"contact_id":0,

"firm_id":0,

"contact":{...},

"firm_id":0,

"ati_id":"string",

"contact_id":0,

"name":"string",

"phone":"string",

"mobile_phone":"string",

"claims_count":0,

"recommendations_count":0,

"bad_partner_mentions_count":0,

"city":"string",

"firm_type":"string",

"firm_name":"string",

"ownership":"string",

"score":0.5,

"status":0,

"skype_name":"string",

"fax":"string",

"email":"string"

},

"name":"string",

"score":0.5,

"status":0

}

}

]

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

newerThan Вернуть отзывы, измененные после указанной даты. Если модификатора часового пояса нет, дата отправляется в формате UTC+3 (Москва)

includeArchived true false Включать архивные машины

Получение встречных предложений на машины по списку машин

Возвращает встречные предложения по списку ID машин: передайте массив ID, в ответе получите словарь truck_id -> список встречных предложений.

post /v1.1/trucks/counter_offers/by_truck_ids

Модель и примеры

Запрос

Модель

[uuid]

Массив UUID.

Пример запроса

CURL

curl 'https://api.ati.su/v1.1/trucks/counter_offers/by_truck_ids' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '["ce303e3c-210b-ec11-bb9f-0cc47af30c1b","80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1"]'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/v1.1/trucks/counter_offers/by_truck_ids", "[""ce303e3c-210b-ec11-bb9f-0cc47af30c1b"",""80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1""]");

Ответ

200 Встречные предложения по списку машин

Модель

{...}

Словарь отзывов по ID машин

any-key:[{...}]

id: uuid

Id встречного предложения

truck_id: uuid

Id машины

addition_date: date-time

Дата добавления встречного предложения

change_date: date-time

Дата изменения встречного предложения

viewed_at: date-time (nullable)

Дата и время просмотра встречного предложения

cash_sum: double (nullable)

Ставка наличными

currency_id: int32 (nullable)

Валюта ставки наличными. Значение из словаря валют АТИ

sum_with_nds: double (nullable)

Ставка с НДС

nds_currency_id: int32 (nullable)

Валюта ставки с НДС. Значение из словаря валют АТИ

sum_without_nds: double (nullable)

Ставка без НДС

not_nds_currency_id: int32 (nullable)

Валюта ставки без НДС. Значение из словаря валют АТИ

note: string (nullable)

Комментарий к предложению. Максимальное количество символов 512

prepay_percent: int32 (nullable)

Предоплата в процентах

delay_payment_days: int32 (nullable)

Оплата через банковских дней

loading_city_id: int64 (nullable)

Id города загрузки. Значение из словаря городов АТИ

unloading_city_id: int64 (nullable)

Id города разгрузки. Значение из словаря городов АТИ

weight: double (nullable)

Максимальная грузоподъемность, т

volume: double (nullable)

Максимальный объем, м3

car_delivery_date: date-time

Дата подачи транспорта

is_actual: boolean

Актуальность встречного предложения

unload_payment: boolean

Оплата на выгрузке

coloading: boolean

Догруз

sender_firm_info:{...}

Информация о фирме, оставившей встречное предложение

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

firm_id: int32

Id фирмы

contact:{...}

Краткая информация о контакте

firm_id: int32

Id фирмы

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

name: string (nullable)

Имя контакта

phone: string (nullable)

Телефон

mobile_phone: string (nullable)

Мобильный телефон

claims_count: int32

Количество претензий

recommendations_count: int32

Количество рекомендаций

bad_partner_mentions_count: int32

Количество упоминаний в НП

city: string (nullable)

Город

firm_type: string (nullable)

Тип фирмы

firm_name: string (nullable)

Название фирмы

ownership: string (nullable)

Форма собственности

score: double

Рейтинг контакта

status: int32

Статус контакта

skype_name: string (nullable)

Skype

fax: string (nullable)

Факс

email: string (nullable)

E-mail

}

name: string

Название фирмы

score: double

Рейтинг фирмы

status: int32

Статус фирмы

}

}]

}

Пример

{...}

"any-key":[...]

{...}

"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"addition_date":"1970-01-01T00:00:00.000Z",

"change_date":"1970-01-01T00:00:00.000Z",

"viewed_at":"1970-01-01T00:00:00.000Z",

"cash_sum":0.5,

"currency_id":0,

"sum_with_nds":0.5,

"nds_currency_id":0,

"sum_without_nds":0.5,

"not_nds_currency_id":0,

"note":"string",

"prepay_percent":0,

"delay_payment_days":0,

"loading_city_id":0,

"unloading_city_id":0,

"weight":0.5,

"volume":0.5,

"car_delivery_date":"1970-01-01T00:00:00.000Z",

"is_actual":false,

"unload_payment":false,

"coloading":false,

"sender_firm_info":{...}

"ati_id":"string",

"contact_id":0,

"firm_id":0,

"contact":{...},

"firm_id":0,

"ati_id":"string",

"contact_id":0,

"name":"string",

"phone":"string",

"mobile_phone":"string",

"claims_count":0,

"recommendations_count":0,

"bad_partner_mentions_count":0,

"city":"string",

"firm_type":"string",

"firm_name":"string",

"ownership":"string",

"score":0.5,

"status":0,

"skype_name":"string",

"fax":"string",

"email":"string"

},

"name":"string",

"score":0.5,

"status":0

}

}

]

}

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

includeArchived true false Включать архивные машины

[ "ce303e3c-210b-ec11-bb9f-0cc47af30c1b", "80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1" ]

Получение своих встречных предложений на машины

Возвращает встречные предложения, которые ваша фирма оставила на чужие машины.

get /v1.1/trucks/counter_offers/my

Модель и примеры

Запрос

Пример запроса

CURL

curl 'https://api.ati.su/v1.1/trucks/counter_offers/my' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/v1.1/trucks/counter_offers/my");

Ответ

200 Список ваших отзывов на чужие машины

Модель

[{...}]

id: uuid

Id встречного предложения

truck_id: uuid

Id машины

addition_date: date-time

Дата добавления встречного предложения

change_date: date-time

Дата изменения встречного предложения

viewed_at: date-time (nullable)

Дата и время просмотра встречного предложения

cash_sum: double (nullable)

Ставка наличными

currency_id: int32 (nullable)

Валюта ставки наличными. Значение из словаря валют АТИ

sum_with_nds: double (nullable)

Ставка с НДС

nds_currency_id: int32 (nullable)

Валюта ставки с НДС. Значение из словаря валют АТИ

sum_without_nds: double (nullable)

Ставка без НДС

not_nds_currency_id: int32 (nullable)

Валюта ставки без НДС. Значение из словаря валют АТИ

note: string (nullable)

Комментарий к предложению. Максимальное количество символов 512

prepay_percent: int32 (nullable)

Предоплата в процентах

delay_payment_days: int32 (nullable)

Оплата через банковских дней

loading_city_id: int64 (nullable)

Id города загрузки. Значение из словаря городов АТИ

unloading_city_id: int64 (nullable)

Id города разгрузки. Значение из словаря городов АТИ

weight: double (nullable)

Максимальная грузоподъемность, т

volume: double (nullable)

Максимальный объем, м3

car_delivery_date: date-time

Дата подачи транспорта

is_actual: boolean

Актуальность встречного предложения

unload_payment: boolean

Оплата на выгрузке

coloading: boolean

Догруз

sender_firm_info:{...}

Информация о фирме, оставившей встречное предложение

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

firm_id: int32

Id фирмы

contact:{...}

Краткая информация о контакте

firm_id: int32

Id фирмы

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

name: string (nullable)

Имя контакта

phone: string (nullable)

Телефон

mobile_phone: string (nullable)

Мобильный телефон

claims_count: int32

Количество претензий

recommendations_count: int32

Количество рекомендаций

bad_partner_mentions_count: int32

Количество упоминаний в НП

city: string (nullable)

Город

firm_type: string (nullable)

Тип фирмы

firm_name: string (nullable)

Название фирмы

ownership: string (nullable)

Форма собственности

score: double

Рейтинг контакта

status: int32

Статус контакта

skype_name: string (nullable)

Skype

fax: string (nullable)

Факс

email: string (nullable)

E-mail

}

name: string

Название фирмы

score: double

Рейтинг фирмы

status: int32

Статус фирмы

}

}]

Пример

[...]

{...}

"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"addition_date":"1970-01-01T00:00:00.000Z",

"change_date":"1970-01-01T00:00:00.000Z",

"viewed_at":"1970-01-01T00:00:00.000Z",

"cash_sum":0.5,

"currency_id":0,

"sum_with_nds":0.5,

"nds_currency_id":0,

"sum_without_nds":0.5,

"not_nds_currency_id":0,

"note":"string",

"prepay_percent":0,

"delay_payment_days":0,

"loading_city_id":0,

"unloading_city_id":0,

"weight":0.5,

"volume":0.5,

"car_delivery_date":"1970-01-01T00:00:00.000Z",

"is_actual":false,

"unload_payment":false,

"coloading":false,

"sender_firm_info":{...}

"ati_id":"string",

"contact_id":0,

"firm_id":0,

"contact":{...},

"firm_id":0,

"ati_id":"string",

"contact_id":0,

"name":"string",

"phone":"string",

"mobile_phone":"string",

"claims_count":0,

"recommendations_count":0,

"bad_partner_mentions_count":0,

"city":"string",

"firm_type":"string",

"firm_name":"string",

"ownership":"string",

"score":0.5,

"status":0,

"skype_name":"string",

"fax":"string",

"email":"string"

},

"name":"string",

"score":0.5,

"status":0

}

}

]

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

newerThan Вернуть отзывы, измененные после указанной даты. Если модификатора часового пояса нет, дата отправляется в формате UTC+3 (Москва)

includeArchived true false Включать архивные машины

Удаление встречных предложений на машину

Удаляет ваши встречные предложения по конкретной машине. Если встречных предложений уже нет, сервис вернет 204 No Content.

delete /v1.1/trucks/{truckId}/counter_offers

Модель и примеры

Запрос

Пример запроса

CURL

curl 'https://api.ati.su/v1.1/trucks/{truckId}/counter_offers' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("DELETE", "https://api.ati.su", "/v1.1/trucks/{truckId}/counter_offers");

Ответ

200 Удаленные встречные предложения

Модель

[{...}]

id: uuid

Id встречного предложения

truck_id: uuid

Id машины

addition_date: date-time

Дата добавления встречного предложения

change_date: date-time

Дата изменения встречного предложения

viewed_at: date-time (nullable)

Дата и время просмотра встречного предложения

cash_sum: double (nullable)

Ставка наличными

currency_id: int32 (nullable)

Валюта ставки наличными. Значение из словаря валют АТИ

sum_with_nds: double (nullable)

Ставка с НДС

nds_currency_id: int32 (nullable)

Валюта ставки с НДС. Значение из словаря валют АТИ

sum_without_nds: double (nullable)

Ставка без НДС

not_nds_currency_id: int32 (nullable)

Валюта ставки без НДС. Значение из словаря валют АТИ

note: string (nullable)

Комментарий к предложению. Максимальное количество символов 512

prepay_percent: int32 (nullable)

Предоплата в процентах

delay_payment_days: int32 (nullable)

Оплата через банковских дней

loading_city_id: int64 (nullable)

Id города загрузки. Значение из словаря городов АТИ

unloading_city_id: int64 (nullable)

Id города разгрузки. Значение из словаря городов АТИ

weight: double (nullable)

Максимальная грузоподъемность, т

volume: double (nullable)

Максимальный объем, м3

car_delivery_date: date-time

Дата подачи транспорта

is_actual: boolean

Актуальность встречного предложения

unload_payment: boolean

Оплата на выгрузке

coloading: boolean

Догруз

sender_firm_info:{...}

Информация о фирме, оставившей встречное предложение

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

firm_id: int32

Id фирмы

contact:{...}

Краткая информация о контакте

firm_id: int32

Id фирмы

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

name: string (nullable)

Имя контакта

phone: string (nullable)

Телефон

mobile_phone: string (nullable)

Мобильный телефон

claims_count: int32

Количество претензий

recommendations_count: int32

Количество рекомендаций

bad_partner_mentions_count: int32

Количество упоминаний в НП

city: string (nullable)

Город

firm_type: string (nullable)

Тип фирмы

firm_name: string (nullable)

Название фирмы

ownership: string (nullable)

Форма собственности

score: double

Рейтинг контакта

status: int32

Статус контакта

skype_name: string (nullable)

Skype

fax: string (nullable)

Факс

email: string (nullable)

E-mail

}

name: string

Название фирмы

score: double

Рейтинг фирмы

status: int32

Статус фирмы

}

}]

Пример

[...]

{...}

"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"addition_date":"1970-01-01T00:00:00.000Z",

"change_date":"1970-01-01T00:00:00.000Z",

"viewed_at":"1970-01-01T00:00:00.000Z",

"cash_sum":0.5,

"currency_id":0,

"sum_with_nds":0.5,

"nds_currency_id":0,

"sum_without_nds":0.5,

"not_nds_currency_id":0,

"note":"string",

"prepay_percent":0,

"delay_payment_days":0,

"loading_city_id":0,

"unloading_city_id":0,

"weight":0.5,

"volume":0.5,

"car_delivery_date":"1970-01-01T00:00:00.000Z",

"is_actual":false,

"unload_payment":false,

"coloading":false,

"sender_firm_info":{...}

"ati_id":"string",

"contact_id":0,

"firm_id":0,

"contact":{...},

"firm_id":0,

"ati_id":"string",

"contact_id":0,

"name":"string",

"phone":"string",

"mobile_phone":"string",

"claims_count":0,

"recommendations_count":0,

"bad_partner_mentions_count":0,

"city":"string",

"firm_type":"string",

"firm_name":"string",

"ownership":"string",

"score":0.5,

"status":0,

"skype_name":"string",

"fax":"string",

"email":"string"

},

"name":"string",

"score":0.5,

"status":0

}

}

]

204 На машине не было отзывов

Успешный ответ

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

truckId ID машины

Удаление встречного предложения на машину по ID

Удаляет конкретное встречное предложение по offerId, когда нужно точечное удаление без очистки всех предложений по машине.

delete /gw/truck_responses/public/v1.1/trucks/counter_offers/{offerId}

Модель и примеры

Запрос

Пример запроса

CURL

curl 'https://api.ati.su/gw/truck_responses/public/v1.1/trucks/counter_offers/{offerId}' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("DELETE", "https://api.ati.su", "/gw/truck_responses/public/v1.1/trucks/counter_offers/{offerId}");

Ответ

200 Удаленный отзыв

Модель

{...}

id: uuid

Id встречного предложения

truck_id: uuid

Id машины

addition_date: date-time

Дата добавления встречного предложения

change_date: date-time

Дата изменения встречного предложения

viewed_at: date-time (nullable)

Дата и время просмотра встречного предложения

cash_sum: double (nullable)

Ставка наличными

currency_id: int32 (nullable)

Валюта ставки наличными. Значение из словаря валют АТИ

sum_with_nds: double (nullable)

Ставка с НДС

nds_currency_id: int32 (nullable)

Валюта ставки с НДС. Значение из словаря валют АТИ

sum_without_nds: double (nullable)

Ставка без НДС

not_nds_currency_id: int32 (nullable)

Валюта ставки без НДС. Значение из словаря валют АТИ

note: string (nullable)

Комментарий к предложению. Максимальное количество символов 512

prepay_percent: int32 (nullable)

Предоплата в процентах

delay_payment_days: int32 (nullable)

Оплата через банковских дней

loading_city_id: int64 (nullable)

Id города загрузки. Значение из словаря городов АТИ

unloading_city_id: int64 (nullable)

Id города разгрузки. Значение из словаря городов АТИ

weight: double (nullable)

Максимальная грузоподъемность, т

volume: double (nullable)

Максимальный объем, м3

car_delivery_date: date-time

Дата подачи транспорта

is_actual: boolean

Актуальность встречного предложения

unload_payment: boolean

Оплата на выгрузке

coloading: boolean

Догруз

sender_firm_info:{...}

Информация о фирме, оставившей встречное предложение

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

firm_id: int32

Id фирмы

contact:{...}

Краткая информация о контакте

firm_id: int32

Id фирмы

ati_id: string

ATI ID контакта

contact_id: int32

Id контакта

name: string (nullable)

Имя контакта

phone: string (nullable)

Телефон

mobile_phone: string (nullable)

Мобильный телефон

claims_count: int32

Количество претензий

recommendations_count: int32

Количество рекомендаций

bad_partner_mentions_count: int32

Количество упоминаний в НП

city: string (nullable)

Город

firm_type: string (nullable)

Тип фирмы

firm_name: string (nullable)

Название фирмы

ownership: string (nullable)

Форма собственности

score: double

Рейтинг контакта

status: int32

Статус контакта

skype_name: string (nullable)

Skype

fax: string (nullable)

Факс

email: string (nullable)

E-mail

}

name: string

Название фирмы

score: double

Рейтинг фирмы

status: int32

Статус фирмы

}

}

Пример

{...}

"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"addition_date":"1970-01-01T00:00:00.000Z",

"change_date":"1970-01-01T00:00:00.000Z",

"viewed_at":"1970-01-01T00:00:00.000Z",

"cash_sum":0.5,

"currency_id":0,

"sum_with_nds":0.5,

"nds_currency_id":0,

"sum_without_nds":0.5,

"not_nds_currency_id":0,

"note":"string",

"prepay_percent":0,

"delay_payment_days":0,

"loading_city_id":0,

"unloading_city_id":0,

"weight":0.5,

"volume":0.5,

"car_delivery_date":"1970-01-01T00:00:00.000Z",

"is_actual":false,

"unload_payment":false,

"coloading":false,

"sender_firm_info":{...}

"ati_id":"string",

"contact_id":0,

"firm_id":0,

"contact":{...},

"firm_id":0,

"ati_id":"string",

"contact_id":0,

"name":"string",

"phone":"string",

"mobile_phone":"string",

"claims_count":0,

"recommendations_count":0,

"bad_partner_mentions_count":0,

"city":"string",

"firm_type":"string",

"firm_name":"string",

"ownership":"string",

"score":0.5,

"status":0,

"skype_name":"string",

"fax":"string",

"email":"string"

},

"name":"string",

"score":0.5,

"status":0

}

}

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

offerId ID отзыва

Получение количества непросмотренных встречных предложений по машинам

Возвращает количество непросмотренных встречных предложений по каждой машине из списка.

Вариант пути v1.1 v2

post /gw/truck_responses/public/v1.1/trucks/counter_offers/unviewed_count/by_truck_ids

Модель и примеры

Запрос

Модель

[uuid]

Массив UUID.

Пример запроса

CURL

curl 'https://api.ati.su/gw/truck_responses/public/v1.1/trucks/counter_offers/unviewed_count/by_truck_ids' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '["ce303e3c-210b-ec11-bb9f-0cc47af30c1b","80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1"]'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/truck_responses/public/v1.1/trucks/counter_offers/unviewed_count/by_truck_ids", "[""ce303e3c-210b-ec11-bb9f-0cc47af30c1b"",""80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1""]");

Ответ

200 Количество непросмотренных встречных предложений по машинам

Модель

{...}

Ключи свойств — строки UUID машин, значения — целые числа.

any-key: int32

}

Пример

{...}

"any-key":0

}

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

Нет параметров

[ "ce303e3c-210b-ec11-bb9f-0cc47af30c1b", "80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1" ]

post /gw/truck_responses/v2/trucks/counter-offers/unviewed-count/by-truck-ids

Модель и примеры

Запрос

Модель

[uuid]

Массив UUID.

Пример запроса

CURL

curl 'https://api.ati.su/gw/truck_responses/v2/trucks/counter-offers/unviewed-count/by-truck-ids' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '["ce303e3c-210b-ec11-bb9f-0cc47af30c1b","80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1"]'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/truck_responses/v2/trucks/counter-offers/unviewed-count/by-truck-ids", "[""ce303e3c-210b-ec11-bb9f-0cc47af30c1b"",""80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1""]");

Ответ

200 Количество непросмотренных встречных предложений по машинам

Модель

{...}

Ключи свойств — строки UUID машин, значения — целые числа.

any-key: int32

}

Пример

{...}

"any-key":0

}

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

Нет параметров

[ "ce303e3c-210b-ec11-bb9f-0cc47af30c1b", "80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1" ]

Получение счетчиков встречных предложений на опубликованные машины

Возвращает словарь счетчиков встречных предложений по указанным ID опубликованных машин.

post /gw/truck_responses/v1/trucks/published/counter_offers/count

Модель и примеры

Запрос

Модель

[uuid]

Массив UUID.

Пример запроса

CURL

curl 'https://api.ati.su/gw/truck_responses/v1/trucks/published/counter_offers/count' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '["ce303e3c-210b-ec11-bb9f-0cc47af30c1b","80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1"]'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/truck_responses/v1/trucks/published/counter_offers/count", "[""ce303e3c-210b-ec11-bb9f-0cc47af30c1b"",""80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1""]");

Ответ

200 Счетчики встречных предложений по опубликованным машинам

Модель

{...}

any-key:{...}

active_count: int32

Количество активных встречных предложений

has_counter_offers: boolean

Есть ли встречные предложения по машине

unviewed_count: int32

Количество непросмотренных встречных предложений

}

}

Пример

{...}

"any-key":{...}

"active_count":0,

"has_counter_offers":false,

"unviewed_count":0

}

}

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

Нет параметров

[ "ce303e3c-210b-ec11-bb9f-0cc47af30c1b", "80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1" ]

Получение счетчиков встречных предложений на архивные машины

Возвращает наличие встречных предложений для машин из архива по их ID.

post /gw/truck_responses/v1/trucks/archive/counter_offers/count

Модель и примеры

Запрос

Модель

[uuid]

Массив UUID.

Пример запроса

CURL

curl 'https://api.ati.su/gw/truck_responses/v1/trucks/archive/counter_offers/count' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '["ce303e3c-210b-ec11-bb9f-0cc47af30c1b","80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1"]'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/truck_responses/v1/trucks/archive/counter_offers/count", "[""ce303e3c-210b-ec11-bb9f-0cc47af30c1b"",""80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1""]");

Ответ

200 Счетчики встречных предложений по архивным машинам

Модель

{...}

any-key:{...}

has_counter_offers: boolean

Есть ли встречные предложения по архивной машине

}

}

Пример

{...}

"any-key":{...}

"has_counter_offers":false

}

}

4XX Ошибка запроса

Модель

{...}

error: string

Ключ ошибки (идентификатор сценария отказа или типа сбоя).

reason: string

Пояснение: что не так с запросом и при валидации — какие ограничения нарушены.

details:[{...}]

Ошибки валидации по полям: каждый элемент соответствует одному полю JSON-тела.

property: string

Имя поля в теле запроса, к которому относится ошибка.

reason: string

Текстовое описание нарушения для этого поля (например, неверный формат или диапазон).

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

Нет параметров

[ "ce303e3c-210b-ec11-bb9f-0cc47af30c1b", "80f2f0f4-89a9-4ff5-95eb-6cf7b4a577c1" ]