Опубликованные грузы
Методы для работы с грузами
Добавление груза
Перед добавлением происходит сначала проверка на возможность объединения грузов, а потом проверка на дублирование.
Пожалуйста, пользуйтесь актуальной версией API.
Редактирование груза
Перед редактированием происходит сначала проверка на возможность объединения грузов, а потом проверка на дублирование.
При редактировании груза, как и при добавлении, нужно указывать все необходимые параметры, а не только изменяемые.
Пожалуйста, пользуйтесь актуальной версией API.
Получение одного груза
Пожалуйста, пользуйтесь актуальной версией API.
Получение всех своих грузов
Доступен фильтр по контакту. При передаче значения в contactId
будут получены только те грузы, у которых ContactId1 == contactId
либо ContactId2 == contactId
.
Получать этим методом чужие грузы с общей площадки нельзя. Метод предназначен для работы со своими грузами.
Обновление одного груза
Обновление нескольких грузов
Удаление одного груза
Удаление нескольких грузов
Изменение приоритетного показа
Удаление приоритетного показа
Методы для работы с комментариями к грузам
Получение всех комментариев ко всем грузам для текущей фирмы
Ответ будет представлен в виде словаря, где ключ - это id груза, а значение - массив структуры “комментарий”.
Получение всех комментариев к грузу для текущей фирмы
Добавление либо редактирование комментария к грузу
При редактировании комментария у изменённого комментария поменяется CommentId
.
Требования к комментарию
- комментарий не может быть пустым
- длина комментария не более 128 символов
- если для фирмы включен режим раздельного доступа, то количество комментариев к одному грузу ограничено одним комментарием на контакт, иначе – одним комментарием на фирму
Удаление комментария у груза
Методы для работы с отзывами к грузам
Отзыв может быть “Встречным предложением” с одной или несколькими ставками, “Груза нет”, “Озвученная ставка”.
Требования к дате, передаваемой в dateFrom
при отправке запросов на получение отзывов:
- Дата в UTC, начиная с которой необходимо показывать отзывы. Если ничего не передано, значит показываем абсолютно все отзывы
- Формат даты:
yyyy-mm-ddThh:mm:ss<timezone_specifier>
, гдеtimezone_specifier
обозначает спецификатор часового пояса, например:Z
- дата в формате UTC. Пример, 2016-04-28T20:01:57Z;-hh:mm
- часовой пояс UTC-hh:mm. Пример UTC-1: 2016-04-28T20:01:57-01:00;%2Bhh:mm
- часовой пояс UTC+hh:mm. Пример UTC+1: 2016-04-28T20:01:57%2B01:00;
- Если модификатора часового пояса нет, дата отправляется в формате UTC+3(Москва)
Получение встречных предложений на грузы фирмы с одной или несколькими ставками
Получение отзывов на любой груз по ID
Если груз принадлежит вашей фирме, то вернутся все отзывы на ваш груз с полной информацией. Если груз принадлежит чужой фирме, то вернутся все отзывы на этот груз, но при этом все отзывы, кроме вашего, будут иметь в поле FirmInfo.Contact
значение null.
Получение отзывов на заданные грузы фирмы в виде словаря
Ответ будет представлен в виде словаря, где ключ – id груза, а значение - массив структур “отзыв на груз”, содержащий:
Result
, представляющий набор отзывов для данного груза;Status
, представляющий статус груза: если груз с таким id не найден у вашей фирмы, статус равен 1, иначе статус равен 0. Если у груза статус равен 1, то массив отзывов всегда пуст.
Список ключей словаря полностью совпадает со списком грузов, для которых были запрошены отзывы.
Добавление либо редактирование отзыва на чужой груз
Удаление отзыва на груз
При удалении встречного предложения у своего груза, необходимо заполнить как loadId
, так и ids
.
При удалении отзыва на чужой груза, необходимо передать loadId
.
Методы для поиска грузов
Поиск грузов на площадках
В теле ответа находится массив грузов, которые опубликованы на выбранных площадках. В грузах будут указаны только те площадки, в которых дата публикации меньше текущей.
Если массив boardIds
пуст, будут получены грузы со всех возможных площадок.
Методы для добавления документа к грузу
Создание документа в АТИ-Доках на груз
Данный метод позволяет создавать следующие типы документов:
- заказ
- заказ (табличный вид)
- заявка (к договору)
- заявка к договору (табличный вид)
- поручение экспедитору
Тип создаваемого документа должен быть передан в documentType
в том же виде, как он указан выше.