Услуга Перехват грузов — cпециальные предложения для заказчиков

Абонентский Договор - оферта (действует с 18 апреля 2024 г.)

Спецификация API по услуге Перехват груза

С услугой «Перехват грузов» вы мгновенно узнаете о появлении нового груза в ATI.SU и отправите заказчику перевозки ваше предложение. Услуга ориентирована на средние и крупные транспортные и транспортно-экспедиционные компании (далее - ТК) с большим собственным или привлеченным автопарком. У таких компаний должна быть возможность автоматизировать расчет стоимости перевозки груза и передачу предложений на перевозку в ATI.SU с помощью API.

Как работает «Перехват грузов»?

Заказчик перевозки добавляет информацию о грузе на сайт ATI.SU. Система «АТИ» запрашивает цены и условия перевозки для данного груза в нескольких ТК и показывает предложения заказчику. Заказчик выбирает подходящее предложение. Далее происходит оформление и исполнение заявки на перевозку в выбранной ТК.

Сколько стоит услуга «Перехват грузов»?

Плата за услугу (способ тарификации) зависит от выбранного тарифного плана:

• «Только показы» — ATI.SU переадресовывает заказчика на сайт ТК, где происходит оформление и исполнение заявки.
• «Показы и заявки» — заказчик оформляет заявку в ATI.SU. Заполненную заявку ATI.SU отправит в ТК, которая выполнит перевозку. (В разработке)
• «Показы и перевозки» — заказчик оформляет заявку в ATI.SU. Заполненную заявку ATI.SU отправит в ТК, которая выполнит перевозку. Информация об исполнении заявки транслируется заказчику в кабинет на сайте ATI.SU. (В разработке)

Как подключить?

• Ознакомьтесь с абонентским договором — офертой и выберите тарифный план.
• Реализуйте в своей системе API по «Перехвату грузов» согласно Спецификации API.
• Заполните и отправьте в ATI.SU заявку на подключение услуги.
• Внесите абонентскую плату за первый месяц обслуживания.

Методы API для встречных предложений по перехвату грузов

В обоих методах используется carrierViewId — идентификатор карточки груза в сценарии перехвата.

Создание встречного предложения по перехвату

Метод отправляет первичное встречное предложение по грузу из перехвата.

Версия API Актуальная Legacy (v1.0)

Создание встречного предложения из перехвата грузов

post /gw/cargo-counter-offers-api/integrator/v1/cargos/interception/{carrierViewId}/counter-offers

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

Запрос

Модель

{...}

contact_id*: int32

Контакт, от лица которого выставить встречное предложение

price: decimal

Предложенная ставка встречного предложения не б/нал.

currency_id: int32

Валюта встречного предложения. Значение из словаря валют АТИ

nds_price: decimal

Предложенная ставка встречного предложения б/нал с НДС

nds_currency_id: int32

Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ

not_nds_price: decimal

Предложенная ставка встречного предложения б/нал без НДС

not_nds_currency_id: int32

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

note: string (nullable)

Примечание к встречному предложению

prepay_percent: int32

Процент предоплаты
Допустимое значение от 0 до 100

pay_after_max_bank_days: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

loading_date: date (nullable)

Дата загрузки

pay_attributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

• 1 - возможна оплата наличными
• 2 - возможна оплата по безналичному рассчету
• 4 - блиц
• 8 - оплата с НДС
• 16 - возможна предоплата
• 32 - оплата на выгрузке
• 64 - включена ли оплата через некоторое количество банковских дней

}

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

CURL

curl 'https://api.ati.su/gw/cargo-counter-offers-api/integrator/v1/cargos/interception/{carrierViewId}/counter-offers' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"contact_id":1,"price":100.5,"currency_id":1,"nds_price":100.5,"nds_currency_id":1,"not_nds_price":100.5,"not_nds_currency_id":1,"note":"Примечание","prepay_percent":10,"pay_after_max_bank_days":0,"loading_date":"2024-01-15","pay_attributes":64}'

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/cargo-counter-offers-api/integrator/v1/cargos/interception/{carrierViewId}/counter-offers", "{""contact_id"":1,""price"":100.5,""currency_id"":1,""nds_price"":100.5,""nds_currency_id"":1,""not_nds_price"":100.5,""not_nds_currency_id"":1,""note"":""Примечание"",""prepay_percent"":10,""pay_after_max_bank_days"":0,""loading_date"":""2024-01-15"",""pay_attributes"":64}");

Ответ

200

Модель

{...}

Встречное предложение

id: guid

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

cargo_id: guid

Id груза, на который оставлено встречное предложение

cargo_number: string

Минимальное количество символов: 1

Номер груза

cargo_firm_id: int32

Id фирмы, которой принадлежит груз

firm_id: int32

Id фирмы, которая оставила встречное предложение

added_at: date-time

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

updated_at: date-time

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

price: decimal

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

currency_id: int32

Валюта встречного предложения
Значение из словаря валют АТИ

nds_price: decimal

Предложенная цена встречного предложения с НДС

nds_currency_id: int32

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

not_nds_price: decimal

Предложенная цена встречного предложения без НДС

not_nds_currency_id: int32

Валюта встречного предложения без НДС

counter_offer_source: int32

Обозначение откуда было добавлено встречное предложение

• 0 - Неизвестный источник
• 1 - Мобильное приложение
• 2 - Интегратор
• 3 - Перехват грузов интегратором
• 4 - Страница поиска грузов
• 5 - Перехват машин
• 6 - Сквозное встречное предложение, добавлено автоматически

note: string

Минимальное количество символов: 1

Примечание к встречному предложению
Максимальная длина - 512 символов

pay_attributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

• 1 - возможна оплата наличными
• 2 - возможна оплата по безналичному рассчету
• 4 - блиц
• 8 - оплата с НДС
• 16 - возможна предоплата
• 32 - оплата на выгрузке
• 64 - включена ли оплата через некоторое количество банковских дней

prepay_percent: int32

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

pay_after_max_bank_days: int32

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

loading_date: date

Дата загрузки

is_outdated: boolean

Определяет, просрочено ли встречное предложение. Когда груз редактируют, удаляют, обновляют, встречное предложение помечается просроченным.\

is_cargo_published: boolean

Относится ли встречное предложение к опубликованному грузу

firm_info:

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

ONE-OF

1:{...}

Информация о фирме

total_score: double

Сумма очков фирмы (количество звезд)

status: int32

Тип звезд фирмы

• 0: Серый
• 1: Красный
• 2: Желтый
• 3: Зеленый
• 4: Партнер АТИ
• 5: Сотрудник АТИ
• 6: Гос. органы
• 7: ОДКС

full_firm_name: string

Минимальное количество символов: 1

Полное название фирмы

contact:

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

ONE-OF

1:{...}

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

id: int32

Id контакта в фирме

name: string

Минимальное количество символов: 1

Имя контакта

telephone: string

Минимальное количество символов: 1

Телефон

email: string

Минимальное количество символов: 1

Электронная почта

mobile: string

Минимальное количество символов: 1

Телефон(мобильный)

mobile_operator: string

Минимальное количество символов: 1

Мобильный оператор

location:

Информация о местоположении фирмы

ONE-OF

1:{...}

Информация о городе

city_id: int32

ID города

region_id: int32

ID региона

country_id: int32

ID страны

full_name: string

Минимальное количество символов: 1

Полное название

short_name: string

Минимальное количество символов: 1

Краткое название

is_regional_center: boolean

Является ли региональным центром

fias_id: guid

Id в базе ФИАС

city_name: string

Минимальное количество символов: 1

Название города

region_name: string

Минимальное количество символов: 1

Название региона

country_name: string

Минимальное количество символов: 1

Название страны

country_code: string

Минимальное количество символов: 1

Код страны

}

}

inn: string

Минимальное количество символов: 1

ИНН

}

}

Пример

{...}

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

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

"cargo_number":"CES23786",

"cargo_firm_id":1234,

"firm_id":1234,

"added_at":"2024-01-15T10:30:00+03:00",

"updated_at":"2024-01-15T10:30:00+03:00",

"price":100.5,

"currency_id":1,

"nds_price":100.5,

"nds_currency_id":1,

"not_nds_price":100.5,

"not_nds_currency_id":1,

"counter_offer_source":2,

"note":"Тестовое примечание",

"pay_attributes":0,

"prepay_percent":0,

"pay_after_max_bank_days":0,

"loading_date":"2024-01-15",

"is_outdated":false,

"is_cargo_published":false,

"firm_info":{...}

"total_score":4.5,

"status":3,

"full_firm_name":"ООО Тест",

"contact":{...},

"id":1,

"name":"Иванов Иван",

"telephone":"+74951234567",

"email":"test@test.ru",

"mobile":"+79001234567",

"mobile_operator":"МТС",

"location":{...}

"city_id":1,

"region_id":1,

"country_id":1,

"full_name":"Москва, Россия",

"short_name":"Москва",

"is_regional_center":true,

"fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",

"city_name":"Москва",

"region_name":"Московская область",

"country_name":"Россия",

"country_code":"RU"

}

},

"inn":1234567890

}

}

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

Модель

{...}

error: string

Код ошибки

reason: string (nullable)

Причина ошибки

details:[{...}]

Детали ошибки

property: string

Свойство модели с ошибкой

error: string

Ошибка

reason: string

Причина ошибки

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"error":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

carrierViewId Идентификатор карточки груза в сценарии перехвата

{ "contact_id": 1, "price": 100.5, "currency_id": 1, "nds_price": 100.5, "nds_currency_id": 1, "not_nds_price": 100.5, "not_nds_currency_id": 1, "note": "Примечание", "prepay_percent": 10, "pay_after_max_bank_days": 0, "loading_date": "2024-01-15", "pay_attributes": 64 }

Данная версия метода устарела и её поддержка будет прекращена. Пожалуйста, пользуйтесь актуальной версией API.

post /v1.0/loads/new/interception/{carrierViewId}/responses

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

Запрос

Модель

{...}

response_id: guid

Id отзыва
Только для чтения

read only

load_id: guid

Id груза, на который оставлен отзыв
Только для чтения

read only

load_number: string

Номер груза
Только для чтения

read only

load_firm_id: int32

Id фирмы, которой принадлежит груз
Только для чтения

read only

firm_id: int32

Id фирмы, которая оставила отзыв
Только для чтения

read only

contact_id*: int32

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

added_at: date-time

Дата добавления отзыва
Только для чтения

read only

updated_at: date-time

Дата изменения отзыва
Только для чтения

read only

price*: decimal

Предложенная ставка встречного предложения не б/нал. Если у груза заданы фиксированная ставка (fixed_rate) и без торга (torg), значение должно совпадать с одной из ставок груза (не б/нал, б/нал с НДС или б/нал без НДС). Значение больше 0 и содержит не более 10 символов.

currency_id*: int32

Валюта встречного предложения. Если у груза заданы фиксированная ставка (fixed_rate) и без торга (torg), должна совпадать с валютой груза.
Значение из словаря валют АТИ

nds_price*: decimal

Предложенная ставка встречного предложения б/нал с НДС

nds_currency_id*: int32

Валюта ставки встречного предложения б/нал с НДС. Если у груза заданы фиксированная ставка (fixed_rate) и без торга (torg), должна совпадать с валютой груза.
Значение из словаря валют АТИ

not_nds_price*: decimal

Предложенная ставка встречного предложения б/нал без НДС

not_nds_currency_id*: int32

Валюта ставки встречного предложения б/нал без НДС. Если у груза заданы фиксированная ставка (fixed_rate) и без торга (torg), должна совпадать с валютой груза.
Значение из словаря валют АТИ

note: string

Примечание к встречному предложению
Максимальная длина - 512 символов

pay_attributes*: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

• 1 - возможна оплата наличными
• 2 - возможна оплата по безналичному рассчету
• 4 - блиц
• 8 - оплата с НДС
• 16 - возможна предоплата
• 32 - оплата на выгрузке
• 64 - включена ли оплата через некоторое количество банковских дней

prepay_percent*: int32

Процент предоплаты
Должен быть равен 0 или отсутствовать, если pay_attributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100

pay_after_max_bank_days*: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если pay_attributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

loading_date: date-time (nullable)

Дата, когда предложивший хочет перевезти ваш груз

is_outdated: boolean

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

read only

is_load_published: boolean

Относится ли отзыв к публикующемуся грузу
Только для чтения

read only

is_no_load: boolean

Параметр "Груза нет"

announced_currency_id: int32

Валюта "Озвученной ставки"
Значение из словаря валют АТИ

announced_rate: int32

Озвученная ставка

}

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

CURL

curl 'https://api.ati.su/v1.0/loads/new/interception/{carrierViewId}/responses' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"response_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa7","load_number":"string","load_firm_id":0,"firm_id":0,"contact_id":0,"added_at":"2026-04-28T08:56:55.313Z","updated_at":"2026-04-28T09:00:00.000Z","price":120,"currency_id":2,"nds_price":120,"nds_currency_id":2,"not_nds_price":120,"not_nds_currency_id":2,"note":"string","pay_attributes":0,"prepay_percent":0,"pay_after_max_bank_days":0,"loading_date":"2026-04-28T08:56:55.313Z","is_outdated":false,"is_load_published":true,"is_no_load":false,"announced_currency_id":2,"announced_rate":120}'

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.0/loads/new/interception/{carrierViewId}/responses", "{""response_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""load_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa7"",""load_number"":""string"",""load_firm_id"":0,""firm_id"":0,""contact_id"":0,""added_at"":""2026-04-28T08:56:55.313Z"",""updated_at"":""2026-04-28T09:00:00.000Z"",""price"":120,""currency_id"":2,""nds_price"":120,""nds_currency_id"":2,""not_nds_price"":120,""not_nds_currency_id"":2,""note"":""string"",""pay_attributes"":0,""prepay_percent"":0,""pay_after_max_bank_days"":0,""loading_date"":""2026-04-28T08:56:55.313Z"",""is_outdated"":false,""is_load_published"":true,""is_no_load"":false,""announced_currency_id"":2,""announced_rate"":120}");

Ответ

200

Модель

binary

Пример

"binary"

4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/api/loads/#loads-title-errors)

Модель

{...}

Тело ответа при ошибке запроса методов перехвата груза (HTTP 4xx): пояснение и ключ ошибки.

Reason: string

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

Error: string

Строковый идентификатор сценария ошибки или кода отказа; используйте вместе с общей документацией по ошибкам API грузов.

}

Пример

{...}

"Reason":"string",

"Error":"string"

}

Консоль

Отправить

Параметры

carrierViewId Идентификатор карточки груза в сценарии перехвата

{ "response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "load_id": "3fa85f64-5717-4562-b3fc-2c963f66afa7", "load_number": "string", "load_firm_id": 0, "firm_id": 0, "contact_id": 0, "added_at": "2026-04-28T08:56:55.313Z", "updated_at": "2026-04-28T09:00:00.000Z", "price": 120, "currency_id": 2, "nds_price": 120, "nds_currency_id": 2, "not_nds_price": 120, "not_nds_currency_id": 2, "note": "string", "pay_attributes": 0, "prepay_percent": 0, "pay_after_max_bank_days": 0, "loading_date": "2026-04-28T08:56:55.313Z", "is_outdated": false, "is_load_published": true, "is_no_load": false, "announced_currency_id": 2, "announced_rate": 120 }

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

Метод изменяет ранее отправленное встречное предложение. Требуется cargoCounterOfferId.

Версия API Актуальная Legacy (v1.0)

Обновление встречного предложения из перехвата грузов

put /gw/cargo-counter-offers-api/integrator/v1/cargos/interception/{carrierViewId}/counter-offers/{cargoCounterOfferId}

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

Запрос

Модель

{...}

contact_id*: int32

Контакт, от лица которого выставить встречное предложение

price: decimal

Предложенная ставка встречного предложения не б/нал.

currency_id: int32

Валюта встречного предложения. Значение из словаря валют АТИ

nds_price: decimal

Предложенная ставка встречного предложения б/нал с НДС

nds_currency_id: int32

Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ

not_nds_price: decimal

Предложенная ставка встречного предложения б/нал без НДС

not_nds_currency_id: int32

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

note: string (nullable)

Примечание к встречному предложению

prepay_percent: int32

Процент предоплаты
Допустимое значение от 0 до 100

pay_after_max_bank_days: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

loading_date: date (nullable)

Дата загрузки

pay_attributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

• 1 - возможна оплата наличными
• 2 - возможна оплата по безналичному рассчету
• 4 - блиц
• 8 - оплата с НДС
• 16 - возможна предоплата
• 32 - оплата на выгрузке
• 64 - включена ли оплата через некоторое количество банковских дней

}

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

CURL

curl 'https://api.ati.su/gw/cargo-counter-offers-api/integrator/v1/cargos/interception/{carrierViewId}/counter-offers/{cargoCounterOfferId}' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"contact_id":1,"price":100.5,"currency_id":1,"nds_price":100.5,"nds_currency_id":1,"not_nds_price":100.5,"not_nds_currency_id":1,"note":"Примечание","prepay_percent":10,"pay_after_max_bank_days":0,"loading_date":"2024-01-15","pay_attributes":64}'

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", "/gw/cargo-counter-offers-api/integrator/v1/cargos/interception/{carrierViewId}/counter-offers/{cargoCounterOfferId}", "{""contact_id"":1,""price"":100.5,""currency_id"":1,""nds_price"":100.5,""nds_currency_id"":1,""not_nds_price"":100.5,""not_nds_currency_id"":1,""note"":""Примечание"",""prepay_percent"":10,""pay_after_max_bank_days"":0,""loading_date"":""2024-01-15"",""pay_attributes"":64}");

Ответ

200

Модель

{...}

Встречное предложение

id: guid

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

cargo_id: guid

Id груза, на который оставлено встречное предложение

cargo_number: string

Минимальное количество символов: 1

Номер груза

cargo_firm_id: int32

Id фирмы, которой принадлежит груз

firm_id: int32

Id фирмы, которая оставила встречное предложение

added_at: date-time

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

updated_at: date-time

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

price: decimal

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

currency_id: int32

Валюта встречного предложения
Значение из словаря валют АТИ

nds_price: decimal

Предложенная цена встречного предложения с НДС

nds_currency_id: int32

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

not_nds_price: decimal

Предложенная цена встречного предложения без НДС

not_nds_currency_id: int32

Валюта встречного предложения без НДС

counter_offer_source: int32

Обозначение откуда было добавлено встречное предложение

• 0 - Неизвестный источник
• 1 - Мобильное приложение
• 2 - Интегратор
• 3 - Перехват грузов интегратором
• 4 - Страница поиска грузов
• 5 - Перехват машин
• 6 - Сквозное встречное предложение, добавлено автоматически

note: string

Минимальное количество символов: 1

Примечание к встречному предложению
Максимальная длина - 512 символов

pay_attributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

• 1 - возможна оплата наличными
• 2 - возможна оплата по безналичному рассчету
• 4 - блиц
• 8 - оплата с НДС
• 16 - возможна предоплата
• 32 - оплата на выгрузке
• 64 - включена ли оплата через некоторое количество банковских дней

prepay_percent: int32

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

pay_after_max_bank_days: int32

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

loading_date: date

Дата загрузки

is_outdated: boolean

Определяет, просрочено ли встречное предложение. Когда груз редактируют, удаляют, обновляют, встречное предложение помечается просроченным.\

is_cargo_published: boolean

Относится ли встречное предложение к опубликованному грузу

firm_info:

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

ONE-OF

1:{...}

Информация о фирме

total_score: double

Сумма очков фирмы (количество звезд)

status: int32

Тип звезд фирмы

• 0: Серый
• 1: Красный
• 2: Желтый
• 3: Зеленый
• 4: Партнер АТИ
• 5: Сотрудник АТИ
• 6: Гос. органы
• 7: ОДКС

full_firm_name: string

Минимальное количество символов: 1

Полное название фирмы

contact:

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

ONE-OF

1:{...}

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

id: int32

Id контакта в фирме

name: string

Минимальное количество символов: 1

Имя контакта

telephone: string

Минимальное количество символов: 1

Телефон

email: string

Минимальное количество символов: 1

Электронная почта

mobile: string

Минимальное количество символов: 1

Телефон(мобильный)

mobile_operator: string

Минимальное количество символов: 1

Мобильный оператор

location:

Информация о местоположении фирмы

ONE-OF

1:{...}

Информация о городе

city_id: int32

ID города

region_id: int32

ID региона

country_id: int32

ID страны

full_name: string

Минимальное количество символов: 1

Полное название

short_name: string

Минимальное количество символов: 1

Краткое название

is_regional_center: boolean

Является ли региональным центром

fias_id: guid

Id в базе ФИАС

city_name: string

Минимальное количество символов: 1

Название города

region_name: string

Минимальное количество символов: 1

Название региона

country_name: string

Минимальное количество символов: 1

Название страны

country_code: string

Минимальное количество символов: 1

Код страны

}

}

inn: string

Минимальное количество символов: 1

ИНН

}

}

Пример

{...}

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

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

"cargo_number":"CES23786",

"cargo_firm_id":1234,

"firm_id":1234,

"added_at":"2024-01-15T10:30:00+03:00",

"updated_at":"2024-01-15T10:30:00+03:00",

"price":100.5,

"currency_id":1,

"nds_price":100.5,

"nds_currency_id":1,

"not_nds_price":100.5,

"not_nds_currency_id":1,

"counter_offer_source":2,

"note":"Тестовое примечание",

"pay_attributes":0,

"prepay_percent":0,

"pay_after_max_bank_days":0,

"loading_date":"2024-01-15",

"is_outdated":false,

"is_cargo_published":false,

"firm_info":{...}

"total_score":4.5,

"status":3,

"full_firm_name":"ООО Тест",

"contact":{...},

"id":1,

"name":"Иванов Иван",

"telephone":"+74951234567",

"email":"test@test.ru",

"mobile":"+79001234567",

"mobile_operator":"МТС",

"location":{...}

"city_id":1,

"region_id":1,

"country_id":1,

"full_name":"Москва, Россия",

"short_name":"Москва",

"is_regional_center":true,

"fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",

"city_name":"Москва",

"region_name":"Московская область",

"country_name":"Россия",

"country_code":"RU"

}

},

"inn":1234567890

}

}

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

Модель

{...}

error: string

Код ошибки

reason: string (nullable)

Причина ошибки

details:[{...}]

Детали ошибки

property: string

Свойство модели с ошибкой

error: string

Ошибка

reason: string

Причина ошибки

}]

}

Пример

{...}

"error":"string",

"reason":"string",

"details":[...]

{...}

"property":"string",

"error":"string",

"reason":"string"

}

]

}

Консоль

Отправить

Параметры

carrierViewId Идентификатор карточки груза в сценарии перехвата

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

{ "contact_id": 1, "price": 100.5, "currency_id": 1, "nds_price": 100.5, "nds_currency_id": 1, "not_nds_price": 100.5, "not_nds_currency_id": 1, "note": "Примечание", "prepay_percent": 10, "pay_after_max_bank_days": 0, "loading_date": "2024-01-15", "pay_attributes": 64 }

Данная версия метода устарела и её поддержка будет прекращена. Пожалуйста, пользуйтесь актуальной версией API.

put /v1.0/loads/new/interception/{carrierViewId}/responses/edit

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

Запрос

Модель

{...}

response_id: guid

Id отзыва
Только для чтения

read only

load_id: guid

Id груза, на который оставлен отзыв
Только для чтения

read only

load_number: string

Номер груза
Только для чтения

read only

load_firm_id: int32

Id фирмы, которой принадлежит груз
Только для чтения

read only

firm_id: int32

Id фирмы, которая оставила отзыв
Только для чтения

read only

contact_id*: int32

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

added_at: date-time

Дата добавления отзыва
Только для чтения

read only

updated_at: date-time

Дата изменения отзыва
Только для чтения

read only

price*: decimal

Предложенная ставка встречного предложения не б/нал. Если у груза заданы фиксированная ставка (fixed_rate) и без торга (torg), значение должно совпадать с одной из ставок груза (не б/нал, б/нал с НДС или б/нал без НДС). Значение больше 0 и содержит не более 10 символов.

currency_id*: int32

Валюта встречного предложения. Если у груза заданы фиксированная ставка (fixed_rate) и без торга (torg), должна совпадать с валютой груза.
Значение из словаря валют АТИ

nds_price*: decimal

Предложенная ставка встречного предложения б/нал с НДС

nds_currency_id*: int32

Валюта ставки встречного предложения б/нал с НДС. Если у груза заданы фиксированная ставка (fixed_rate) и без торга (torg), должна совпадать с валютой груза.
Значение из словаря валют АТИ

not_nds_price*: decimal

Предложенная ставка встречного предложения б/нал без НДС

not_nds_currency_id*: int32

Валюта ставки встречного предложения б/нал без НДС. Если у груза заданы фиксированная ставка (fixed_rate) и без торга (torg), должна совпадать с валютой груза.
Значение из словаря валют АТИ

note: string

Примечание к встречному предложению
Максимальная длина - 512 символов

pay_attributes*: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

• 1 - возможна оплата наличными
• 2 - возможна оплата по безналичному рассчету
• 4 - блиц
• 8 - оплата с НДС
• 16 - возможна предоплата
• 32 - оплата на выгрузке
• 64 - включена ли оплата через некоторое количество банковских дней

prepay_percent*: int32

Процент предоплаты
Должен быть равен 0 или отсутствовать, если pay_attributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100

pay_after_max_bank_days*: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если pay_attributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

loading_date: date-time (nullable)

Дата, когда предложивший хочет перевезти ваш груз

is_outdated: boolean

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

read only

is_load_published: boolean

Относится ли отзыв к публикующемуся грузу
Только для чтения

read only

is_no_load: boolean

Параметр "Груза нет"

announced_currency_id: int32

Валюта "Озвученной ставки"
Значение из словаря валют АТИ

announced_rate: int32

Озвученная ставка

}

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

CURL

curl 'https://api.ati.su/v1.0/loads/new/interception/{carrierViewId}/responses/edit' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"response_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa7","load_number":"string","load_firm_id":0,"firm_id":0,"contact_id":0,"added_at":"2026-04-28T08:56:55.313Z","updated_at":"2026-04-28T09:00:00.000Z","price":120,"currency_id":2,"nds_price":120,"nds_currency_id":2,"not_nds_price":120,"not_nds_currency_id":2,"note":"string","pay_attributes":0,"prepay_percent":0,"pay_after_max_bank_days":0,"loading_date":"2026-04-28T08:56:55.313Z","is_outdated":false,"is_load_published":true,"is_no_load":false,"announced_currency_id":2,"announced_rate":120}'

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.0/loads/new/interception/{carrierViewId}/responses/edit", "{""response_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""load_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa7"",""load_number"":""string"",""load_firm_id"":0,""firm_id"":0,""contact_id"":0,""added_at"":""2026-04-28T08:56:55.313Z"",""updated_at"":""2026-04-28T09:00:00.000Z"",""price"":120,""currency_id"":2,""nds_price"":120,""nds_currency_id"":2,""not_nds_price"":120,""not_nds_currency_id"":2,""note"":""string"",""pay_attributes"":0,""prepay_percent"":0,""pay_after_max_bank_days"":0,""loading_date"":""2026-04-28T08:56:55.313Z"",""is_outdated"":false,""is_load_published"":true,""is_no_load"":false,""announced_currency_id"":2,""announced_rate"":120}");

Ответ

200

Модель

binary

Пример

"binary"

4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/api/loads/#loads-title-errors)

Модель

{...}

Тело ответа при ошибке запроса методов перехвата груза (HTTP 4xx): пояснение и ключ ошибки.

Reason: string

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

Error: string

Строковый идентификатор сценария ошибки или кода отказа; используйте вместе с общей документацией по ошибкам API грузов.

}

Пример

{...}

"Reason":"string",

"Error":"string"

}

Консоль

Отправить

Параметры

carrierViewId Идентификатор карточки груза в сценарии перехвата

{ "response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "load_id": "3fa85f64-5717-4562-b3fc-2c963f66afa7", "load_number": "string", "load_firm_id": 0, "firm_id": 0, "contact_id": 0, "added_at": "2026-04-28T08:56:55.313Z", "updated_at": "2026-04-28T09:00:00.000Z", "price": 120, "currency_id": 2, "nds_price": 120, "nds_currency_id": 2, "not_nds_price": 120, "not_nds_currency_id": 2, "note": "string", "pay_attributes": 0, "prepay_percent": 0, "pay_after_max_bank_days": 0, "loading_date": "2026-04-28T08:56:55.313Z", "is_outdated": false, "is_load_published": true, "is_no_load": false, "announced_currency_id": 2, "announced_rate": 120 }

Поддержка

По вопросам подключения обращайтесь к Александру Вильде: sas@ati.su, + 7 (812) 602-01-04 доб.108