Получение новой структуры отзыва на архивный груз [1.0]

Описание

Получение отзывов на архивный груз фирмы. На данный момент можно получить только встречные предложения.

Структура URL

HTTP метод: GET, ресурс: <base_url>/unpublished-loads/new/<id_груза>/responses?dateFrom=<datetime>

Результат

Массив новых структур "Отзыв на груз", представляющий набор отзывов для данного архивного груза.

Список параметров

Название
Описание
Способ передачи параметра
Обязательный
id_грузаId груза, для которого необходимо получить отзывыURL+
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(Москва)

URL 

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

Запрос

GET, http://api.ati.su/unpublished-loads/new/35c32943-da4d-e211-b493-14dae93e0938/responses?dateFrom=2016-04-27T19:01:58Z

Ответ

Массив отзывов на указанный груз фирмы

[
    {
        "ResponseId": "b13d9bc3-70c2-e811-80be-003048db0139",
        "LoadId": "980dc9a4-9c02-4e29-b132-ee14a697e0da",
        "LoadFirmId": 1254147,
        "FirmId": 1723254,
        "FirmName": "Марков Е.В.",
        "ContactId": 2,
        "AddedAt": "2018-09-27T16:17:01.863Z",
        "UpdatedAt": "2018-09-27T16:17:01.863Z",
        "Price": 777.77,
        "CurrencyId": 13,
        "NdsPrice": 88.08,
        "NdsCurrencyId": 1,
        "NotNdsPrice": 9.99,
        "NotNdsCurrencyId": 21,
        "CounterOfferSource": 4,
        "Note": "TEST",
        "PayAttributes": 81,
        "PrepayPercent": 55,
        "PayAfterMaxBankDays": 5,
        "LoadingDate": "2018-10-10T00:00:00",
        "IsOutdated": true,
        "IsLoadPublished": false,
        "IsNoLoad": false,
        "AnnouncedCurrencyId": 0,
        "AnnouncedRate": 0,
        "FirmInfo": {
            "TotalScore": 4.25,
            "Status": 1,
            "FullFirmName": "Марков Е.В., ИП",
            "Contact": {
                "Id": 2,
                "Name": "Евгений Витальевич",
                "Telephone": "",
                "Email": "markov.co@inbox.ru",
                "Icq": "",
                "Mobile": "+7 (920) 4585625",
                "MobileOperator": null,
                "SkypeName": "markov.co",
                "CityId": 5094,
                "Location": {
                    "CityId": 5094,
                    "RegionId": 87,
                    "CountryId": 1,
                    "FullName": "Агинское, Забайкальский край, Россия",
                    "ShortName": "Агинское, Забайкальский край",
                    "IsRegionalCenter": false,
                    "CitySize": 1,
                    "FiasId": "62c73092-9096-4cf9-8f76-16e004dd0ac3",
                    "Attributes": 0,
                    "CityName": "Агинское",
                    "RegionName": "Забайкальский край",
                    "CountryName": "Россия",
                    "CountryCodeName": "RUS"
                }
            },
            "Inn": "800199016856"
        }
    },
    {
        "ResponseId": "43279d33-7fc2-e811-80be-003048db0139",
        "LoadId": "980dc9a4-9c02-4e29-b132-ee14a697e0da",
        "LoadFirmId": 1254147,
        "FirmId": 1428219,
        "FirmName": "Тестовая Регистрация",
        "ContactId": 0,
        "AddedAt": "2018-09-27T18:00:22.737Z",
        "UpdatedAt": "2018-09-27T18:00:22.737Z",
        "Price": 234.5,
        "CurrencyId": 18,
        "NdsPrice": 6547.89,
        "NdsCurrencyId": 34,
        "NotNdsPrice": 333,
        "NotNdsCurrencyId": 17,
        "CounterOfferSource": 4,
        "Note": "ТЕСТОВАЯ",
        "PayAttributes": 113,
        "PrepayPercent": 33,
        "PayAfterMaxBankDays": 8,
        "LoadingDate": "2018-09-27T00:00:00",
        "IsOutdated": true,
        "IsLoadPublished": false,
        "IsNoLoad": false,
        "AnnouncedCurrencyId": 0,
        "AnnouncedRate": 0,
        "FirmInfo": {
            "TotalScore": 2.7,
            "Status": 0,
            "FullFirmName": "Тестовая Регистрация, ИП",
            "Contact": {
                "Id": 0,
                "Name": "Маркова Елена Вениаминовна",
                "Telephone": "",
                "Email": "",
                "Icq": "247770376",
                "Mobile": "",
                "MobileOperator": null,
                "SkypeName": "",
                "CityId": null,
                "Location": {
                    "CityId": 0,
                    "RegionId": null,
                    "CountryId": null,
                    "FullName": "",
                    "ShortName": null,
                    "IsRegionalCenter": false,
                    "CitySize": 0,
                    "FiasId": null,
                    "Attributes": 0,
                    "CityName": null,
                    "RegionName": null,
                    "CountryName": null,
                    "CountryCodeName": null
                }
            },
            "Inn": "46546555555"
        }
    }
]

 

Список ответов сервера

Каждая ошибка кроме HTTP кода имеет уникальный строковый код. Подробнее..

HTTP код ответа
Код ошибки
Сообщение
200--Операция завершена успешно
401--Требуется авторизация
404load_not_found_errorГруз не найден