Добавление (редактирование) новой структуры отзыва на груз [1.0]

Описание

Добавление либо редактирование отзыва на чужой груз.  

Структура URL

HTTP метод: PUT, ресурс: <base_url>/loads/new/<id_груза>/responses

Результат

Новая структура "Отзыв на груз", описывающая отзыв на груз с поддержкой встречных предложений с несколькими ставками.

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

Прочитать подробнее об указанных ниже параметрах можно здесь.

НазваниеСпособ передачи параметраОбязательный
LoadIdURL +
ContactIdBODY+

Price

BODY+/-
CurrencyIdBODY+/-
NdsPriceBODY+/-
NdsCurrencyIdBODY+/-
NotNdsPriceBODY+/-
NotNdsCurrencyIdBODY+/-
NoteBODY 
PayAttributesBODY 
PrepayPercentBODY 
PayAfterMaxBankDaysBODY 
LoadingDateBODY 

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

Запрос

PUT, http://api.ati.su/loads/new/039f2943-da4d-e211-b493-14dae93e0938/responses

Далее приведен пример тела запроса для добавления отзыва на груз.

 

 

{
    "Price": 777.77,
    "CurrencyId": 13, 
    "NdsPrice": 88.08,
    "NdsCurrencyId": 1,
    "NotNdsPrice":9.99,
    "NotNdsCurrencyId": 21,
    "Note": "TEST",
    "PayAttributes": 80, 
    "PrepayPercent":55, 
    "PayAfterMaxBankDays": 5,
    "LoadingDate": "2018-10-10",
    "ContactId": 2
}

Требования

  • отзыв нельзя добавить к своему грузу;
  • вы имеете право оставлять отзывы в соответствии с оплаченными услугами:
    • если у вас оплачена услуга "Все грузы", вы можете оставлять отзывы для всех грузов;
    • если у вас оплачена услуга "Грузы по России", вы можете оставлять отзывы для всех грузов, у которых страна загрузки и разгрузки – Россия;
    • если у вас оплачена услуга "Грузы вне России", вы можете оставлять отзывы для всех грузов, у которых страна загрузки и страна разгрузки – не Россия;
    • если у владельца груза оплачена услуга "Грузы для всех", вы можете оставлять отзыв к данному грузу в любом случае.

Ответ

Ответ содержит добавленный отзыв в случае успешного завершения операции либо сообщение об ошибке с кодом и расшифровкой. 

 {
    "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": false,
    "IsLoadPublished": true,
    "IsNoLoad": false,
    "AnnouncedCurrencyId": 0,
    "AnnouncedRate": 0,
    "FirmInfo": {
        "TotalScore": 4.25,
        "Status": 1,
        "FullFirmName": "Аксенов Геннадий Васильевич, ИП",
        "Contact": {
            "Id": 2,
            "Name": "Gennadij",
            "Telephone": "",
            "Email": "gennadij123@inbox.ru",
            "Icq": "",
            "Mobile": "+7 (900) 4585625",
            "MobileOperator": null,
            "SkypeName": "123gennadij123",
            "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": "800100006856"
    }
}

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

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

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