Редактирование груза [1.0]

Описание

Редактирование груза с помощью API. Перед редактированием происходит сначала проверка на возможность объединения грузов, а потом проверка на дублирование .  

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

Структура URL

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

Результат

Структура "Груз", описывающая отредактированный груз.

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

Список всех параметров груза с их описанием вы можете посмотреть здесь: Описание структуры "Груз"

НазваниеСпособ передачи параметраОбязательный
IdURL+
ContactId1BODY+
ContactId2BODY 
NoteBODY 
FirstDateBODY 
LastDateBODY 
DateTypeBODY 
PeriodicityIdBODY 
KrugoreisBODY 
LoadingBODY+
ExtraPointsBODY 
UnloadingBODY+
CargoBODY+
TransportBODY+
StealthBODY 
BoardsBODY 
PriorityViewBODY 
LoadMetaBODY 
DealBODY

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

Запрос

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

Далее приведен пример JSON для редактирования груза.

 

{
  "ContactId1": 0,
  "ContactId2": 2,
  "Note": "Тестовый груз",
  "FirstDate": "2016-04-18T12:00:00.510",
  "LastDate": "2016-04-18T12:00:00.510",
  "DateType": 0,
  "PeriodicityId": 0,
  "Krugoreis": true,
  "Zimnik": false,
  "Ferries": false,
  "Loading": {
    "CityId": 1,
    "Latitude": 59.9701335,
    "Longitude": 30.3387451,
    "Street": "улица Смолячкова, 3",
    "TimeStart": "1900-01-01T03:21:01",
    "TimeEnd": "1900-01-01T04:32:01",
    "LargeCities": [
      135,
      170
    ]
  },
  "ExtraPoints": [
    {
      "CityId": 89,
      "PointType": 1
    },
    {
      "CityId": 60,
      "PointType": 3
    },
    {
      "CityId": 270,
      "PointType": 3
    },
    {
      "CityId": 80,
      "PointType": 2
    },
    {
      "CityId": 200,
      "PointType": 1
    }
  ],
  "Unloading": {
    "CityId": 3611,
    "Latitude": 55.7201493,
    "Longitude": 37.5540161,
    "Street": "Новолужнецкий проезд, 11 строение 1",
    "TimeStart": "1900-01-01T05:43:01",
    "TimeEnd": "1900-01-01T06:54:01",
    "LargeCities": [
      251,
      1262
    ]
  },
  "Cargo": {
    "Weight": 1.2,
    "Volume": 1.9,
    "ADR": 8,
    "CargoTypeId": 59,
    "CargoType": "Наименование",
    "PackType": 2,
    "PalletCount": 5,
    "BeltCount": 6,
    "DogruzType": 2,
    "SborGruz": true,
    "Size": {
      "Length": 1,
      "Width": 2,
      "Height": 3,
      "LengthHighlight": true,
      "WidthHighlight": true,
      "HeightHighlight": true
    }
  },
  "Transport": {
    "CarType": 12,
    "LoadingType": 7,
    "LoadingLogicalOperator": "AND",
    "UnloadingType": 4102,
    "UnloadingLogicalOperator": "OR",
    "TrucksQuantity": 1,
    "TemperatureFrom": 33,
    "TemperatureTo": 36,
    "Stsepka": true,
    "Pnevmohod": true,
    "Koniki": true,
    "TIR": true,
    "CMR": true,
    "T1": true,
    "SanPassport": true
  },
  "Payment": {
    "CurrencyId": 1,
    "MoneyType": 23,
    "RateSum": 123,
    "SumWithNDS": 432,
    "SumWithoutNDS": 454,
    "PrepayPercent": 50,
    "PrepayPercentEnabled": true,
    "PayDays": 9,
    "PayDaysEnabled": true,
    "FixedRate": true,
    "Torg": true,
    "DirectContract": true,
    "OnUnloading": false
  },
 "Boards": [
      {
        "BoardId": "56e18fe1bf80ea575cbd5c47",
        "PublicationTime": "2016-08-11T11:42:00.307Z",
        "PublicationOption": 0
      },
      {
        "BoardId": "a0a0a0a0a0a0a0a0a0a0a0a0",
        "PublicationTime": null,
        "PublicationOption": 4
      }
  ],
  "PriorityView": {
  	"DailyLimit": 5,
    "IsForPayedOnly": true,
   	"OrderLimit": 50,
   	"ViewRate": 0.5,
    "MoneySpentPerDay": 0.0,
    "MoneySpentPerOrder" : 0.0
  },
  "TruePrice": 0,
  "TrueCurrencyId": 0,
  "ResponseCount": null,
  "OfferCount": null,
  "SmsEnabled": null,
  "InsuredMinTariff": 0,
  "LoadMeta": {
      "LoadMetaId": "f10420a3-3e6d-462c-a90b-f22ec58ab4dc",
      "MetaData": "Данные груза"
  },
  "Deal": {
        "DealType": 2,
        "FixedRates": [],
        "Auction": {
            "StartRate": 3819,
            "AcceptSecondPayType": false,
            "Currency": 1,
            "Step": 500,
            "PaymentType": 1,
            "EndDate": "2019-04-05T09:00:41.56Z",
            "TimeToProvideDocuments": 3,
            "AutoRenew": false,
            "RenewTime": null,
            "RaiseBid": false,
            "MaxRate": null,
            "RaiseBidInterval": null,
            "ResponseInMinutes": null,
            "Duration": 30,
            "StartSinceFirstBet": false,
        }
    }
}

Примечание

  1. Все поля, заявленные в параметрах, влияют на редактируемый груз. Любые другие поля могут быть вписаны в json, но не будут влиять на редактируемый груз.
  2. Id должен быть валидным Guid'ом. 

Ответ

Если редактирование прошло успешно, то в ответе придет сохраненный груз.

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

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

HTTP код ответа
Код ошибки
Сообщение
200--Операция завершена успешно
202--Груз был объединен с другим грузом. Подробнее...
400json_validation_errorОшибка валидации груза
400deserialization_errorОшибка десериализации тела запроса
401--Требуется авторизация
403access_denied_errorОшибка доступа
404load_not_found_errorГруз не найден
409load_conflict_errorИмеется груз со схожими параметрами, добавление не происходит. Подробнее...