Личный кабинет позволяет: анализировать информацию об отправленном и полученном грузе; контролировать расходование средств на перевозки; формировать заявки на забор груза. Получить доступ

Группа /cargos/ — операции с грузами

Метод /cargos/status/ — запрос статусов грузов

Доступ

  • Зарегистрированные пользователи

Комментарии

  • Максимальное количество кодов грузов в одном запросе: 15
  • В качестве кода груза можно указывать предварительный или фактический код груза.
  • Возможные значения поля cargos[].info.cargoStatus (статус груза): Принят, Возвращен отправителю, Оформлен, В пути, Прибыл, Готов к выдаче, Выдан на доставку, Выдан на складе, Доставлен, Отправлен на возврат, Утилизирован , Выдан ( мест { количество_мест } из { количество_мест } )
  • В случае, если в запросе к методу поле returnPosition установлено в true, по грузам будут запрошены приблизительные координаты. Если координаты груза известны, они будут добавлены в поле cargos[].info.position ответа в виде строки со значениями широты и долготы, разделенными точкой с запятой. Если координаты не были запрошены, или не известны — в поле ответа cargos[].info.position будет пустая строка.
  • Для груза, который является возвратом документов по другому грузу, в ответе возвращается поле cargos[].cargo.parentCargoCode с кодом исходного груза.
  • Возможные значения поля cargos[].info.cargoStatus (id статуса груза): /cargos/statustable/

Формат запроса

{
   "cargoCodes": [ // Коды грузов [Array]
      "МВПТЗВА-1/1603", // Код груза [String]
      "МВПЗЗЮН-3/0103", 
      "ОКМВБУТ-4/2903",  
      ...
   ],
   "returnPosition": true, // запросить приблизительные координаты груза [Boolean], необязательное поле
   "isOrderNumber": true   // вместо кодов грузов передаются номера заказов клиента [Boolean], необязательное поле
}

Формат ответа

{
   "cargos": [ // Статусы грузов [Array]
      {
	  
      "info": { // Общая информация о грузе [Object]
         "cargoStatus": "выдан", // Статус груза [String]
         "cargoStatusId": 8, // id статуса груза [Number]
         "takeOnStockDateTime": "2011-03-01T13:51:40", // Дата и время сдачи груза [DateTime]
         "takeOnStockPackageState": "ВОЗВРАТНАЯ ТАРА, Внешние повреждения", // Состояние упаковки при сдаче груза
         "sendingDateTime": null, // Дата и время отправки груза [DateTime]
         "arrivalDateTime": "2011-03-05T11:15:20", // Дата и время прибытия [DateTime]
         "giveOutDateTime": "2011-03-10T09:24:24", // Дата и время выдачи [DateTime]
         "arrivalPlanDateTime": "2011-03-04T08:17:59", // Дата и время планового прибытия [DateTime]
         "position": "56.304143;43.490851", // Приблизительные координаты [String]
         "сallStatus": "Оповещен получатель", // Статус по оповещению [String]
         "сallStatusDateTime": "2015-05-21T00:00:00+03:00", // Дата статуса по оповещению [DateTime]
         "storage": "2015-05-21T00:00:00+03:00" // Вынужденное хранения [DateTime]
      },
	  
      "cargo": { // Параметры груза [Object]
         "code": "МВПТЗВА-2/0719", // Код груза [String]
         "preliminaryCode": "МВПТЗВА-N/0719", // Предварительный код груза [String]
         // возвращается для груза, который является возвратом документов по др. грузу
         "parentCargoCode": "КТМЮГИИ-1/2011", // Возврат документов по грузу [String]
         "amount": 3.0, // Количество мест [Number]
         "amountProcessed": 2.0, // Количество прибывших мест [Number]
         "weight": 26.0, // Вес, кг [Number]
         "volume": 0.25, // Объем, м3 [Number]
         "description": "Запчасти", // Наименование груза [String]
         "orderNumber": "№23434-АБ", // Номер заказа клиента [String]
         "cargoBarCode": "555810002522", // Штрих-код груза [String]
         "positionBarCodes": [ // Штрих-коды грузомест [Array]
          "5558100025220001"
         ]
      },

      "services": { // Услуги [Object]
         "items": [ // Массив услуг [Array]
            {
               "branch": "Петрозаводск", // Филиал [String]
               "description": "Перевозка Петрозаводск - Москва Восток", // Описание [String]
               "price": 300.0, // Стоимость, руб. [Number]
               "payerType": 1, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
               "payerName": "Иванов" // Описание [String]
            },
            {
               "branch": "Петрозаводск", // Филиал [String]
               "description": "Защитная транспортировочная упаковка Петрозаводск", // Описание [String]
               "price": 150.0, // Стоимость, руб. [Number]
               "payerType": 1, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
               "payerName": "Иванов" // Описание [String]
            }
         ],
         "sum": 450.0, // Итого, руб. [Number]
         "discount": 0.0, // Скидка [Number]
         "hardPack": false, // Защитная транспортировочная упаковка [Boolean]
         "insurance": false, // Страхование [Boolean]
         "resendDocs": false, // Пересылка документов [Boolean]
         "freeService": false, // Бесплатное предоставление услуг [Boolean]
         "debt": 17075.37, // Задолженность, руб. [Number]
         "debtList": [     // Задолженность, мультивал. [Number]
             {
                 "debt": 17075.37,
                 "currency": "руб."
             },
             {
                 "debt": 96417.25,
                 "currency": "KZT"
             }
         ]
      }, 

      "sender": { // Отправитель [Object]
         "branch": "Петрозаводск", // Филиал [String]
         "sender": "Наименование организации", // Наименование [String]
         "person": "Иван Иванович Иванов", // Ответственное лицо [String]
         "phone": "11-11-11,12-12-12" // Телефоны [String]
      }, 

      "receiver": { // Получатель [Object]
         "branch": { // Филиал получателя [Object]
            "city": "Москва Восток", // Филиал [String]
            "address": "1-й Вязовский пр., д. 4, 109428", // Адрес [String]
            "phone": "(495) 925-88-14, 790-76-82", // Телефоны [String]
            "email": "pecom@pecom.ru", // Email [String]
            "url": "", // Адрес сайта [String]
         },
         "receiver": "Наименование организации", // Наименование [String]
         "person": "Фёдоров Фёдор Фёдорович", // Ответственное лицо [String]
         "phone": "333-33-33" // Телефоны [String]
      }

   },

   {
   ... // Информация о втором грузе, в формате, аналогичном первому объекту массива "cargos" выше
   },

   {
   ... // Информация о третьем грузе, в формате, аналогичном первому объекту массива "cargos" выше
   },

   ...

   ]
}

Метод /cargos/basicstatus/ — базовая информация о статусе грузов

Доступ

  • Зарегистрированные пользователи
  • Сторонние неперсонифицированные приложения

Комментарии

  • Максимальное количество кодов грузов в одном запросе: 5
  • В качестве кода груза можно указывать предварительный или фактический код груза.
  • Возможные значения поля cargos[].info.cargoStatus (статус груза): Принят, Возвращен отправителю, Оформлен, В пути, Прибыл, Готов к выдаче, Выдан на доставку, Выдан на складе, Доставлен, Отправлен на возврат, Утилизирован , Выдан ( мест { количество_мест } из { количество_мест } )

Формат запроса

{
   "cargoCodes": [ // Коды грузов [Array]
      "МВПТЗВА-1/1603", // Код груза [String]
      "МВПЗЗЮН-3/0103", 
      "ОКМВБУТ-4/2903",  
      ...
   ],
   "isOrderNumber": true   // вместо кодов грузов передаются номера заказов клиента [Boolean], необязательное поле
}

Формат ответа

{
   "cargos": [ // Статусы грузов [Array]
      {
	  
      "info": { // Общая информация о грузе [Object]
         "cargoStatus": "выдан", // Статус груза [String]
         "takeOnStockDateTime": "2011-03-01T13:51:40", // Дата и время сдачи груза [DateTime]
         "sendingDateTime": null, // Дата и время отправки груза [DateTime]
         "arrivalDateTime": "2011-03-05T11:15:20", // Дата и время прибытия [DateTime]
         "giveOutDateTime": "2011-03-10T09:24:24", // Дата и время выдачи [DateTime]
         "arrivalPlanDateTime": "2011-03-04T08:17:59" // Дата и время планового прибытия [DateTime]         
      },
	  
      "cargo": { // Параметры груза [Object]
         "code": "МВПТЗВА-2/0719", // Код груза [String]
         "preliminaryCode": "МВПТЗВА-N/0719", // Предварительный код груза [String]
         "cargoBarCode": "555810002522", // Штрих-код груза [String]
         "positionBarCodes": [ // Штрих-коды грузомест [Array]
          "5558100025220001"
         ]
      }      
   },

   {
   ... // Информация о втором грузе, в формате, аналогичном первому объекту массива "cargos" выше
   },

   {
   ... // Информация о третьем грузе, в формате, аналогичном первому объекту массива "cargos" выше
   },

   ...

   ]
}

Метод /cargos/details/ — информация о грузе, фотографии

Доступ

  • Зарегистрированные пользователи

Комментарии

  • Фотографии доступны только для грузов, отправленных из филиала Москва Восток.

Формат запроса

{
   "cargoCode": "МВКРАБВ-19\/0108" // Код груза [String]
}

Формат ответа

{
  "cargoCode":"МВКРАБВ-19\/0108", // Код груза [String]
  "senderInn": "7716542310", // ИНН отправителя [String] 
  "details":[ // Информация о составе груза [Array]
    {
      "positionsCount":8, // Количество мест [Number]
      "volume":0.75, // Объём, м3 [Number]
      "weight":196, // Вес, кг [Number]
      "photos":[ // Фотографии [Array]
        { // Информация о фотографии [Object]
          "mimeType":"image\/jpeg", // MIME-тип [String]
          "filename":"ebf646be-b89b-4318-8810-0a502999ed43.jpg", // Имя файла [String]
          "data":"/9j/4AAQSkZJRgABAQEBLAEsAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsK
                  CwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQU
                  ...
                  LXFlDUC+l4A9IMKfYCT/AABBDY2E7QqdtV2V0TFFJZmpenzodS23OoSl0bt1bSrhKlD1zZIsTpbx
                  QQB//9k=" // Содержимое файла [Binary]
        },
        {
          "mimeType":"image\/jpeg",
          "filename":"090dd3e5-c665-4909-a56f-f2d3b3e7895e.jpg",
          "data":"/9j/4AAQSkZJRgABAQEBLAEsAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsK
                  CwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQU
                  ...
                  LXFlDUC+l4A9IMKfYCT/AABBDY2E7QqdtV2V0TFFJZmpenzodS23OoSl0bt1bSrhKlD1zZIsTpbx
                  QQB//9k="
        }
      ]
    },
	...
  ] 
}

Метод /cargos/list/ — список отправок\получений за период

Доступ

  • Зарегистрированные пользователи

Комментарии

  • Максимальная длительность периода для запроса — 60 календарных дней
  • Максимальное количество записей, возвращаемых одним запросом — 1500 записей
  • Возможные значения поля cargos[].cargoStatus (статус груза): Принят, Возвращен отправителю, Оформлен, В пути, Прибыл, Готов к выдаче, Выдан на доставку, Выдан на складе, Доставлен, Отправлен на возврат, Утилизирован , Выдан ( мест { количество_мест } из { количество_мест } )

Формат запроса

{
  "dateBegin": "2012-08-01T11:15:20", // Дата и время начала запрашиваемого периода [DateTime]
  "dateEnd": "2012-08-10T11:55:20" // Дата и время конца запрашиваемого периода [DateTime]
}

Формат ответа

{
 "cargos":[ // Информация о грузах [Array]
    { // Информация об одном грузе [Object]
      "code":"МВОКАБВ-1\/1102", // Код груза [String]
      "cargoStatus":"Выдан", // Статус груза [Number]
      "description":"Посуда", // Наименование груза [String]
      "positionsCount":1, // Количество мест [Number]
      "sum":305, // Сумма, руб. [Number]
      "weight":8, // Вес, кг [Number]
      "volume":0.18, // Объём, м3 [Number]
      "senderTitle":"Иванов Иван Иванович", // Наименование отправителя [String]
      "senderCity":"Орск", // Город отправителя [City]
      "receiverTitle":"Ворожбян Андрей Васильевич", // Наименование получателя [String]
      "receiverCity":"Москва Восток", // Город получателя [City]
      "takeOnStockDateTime":"2011-02-11T10:59:27", // Дата и время сдачи груза [DateTime]
      "fillStartDateTime":null, // Дата и время начала погрузки [DateTime]
      "fillFinish":null, // Дата и время окончания погрузки [DateTime]
      "sendingDateTime":"2011-02-11T19:30:00", // Дата и время отправки [DateTime]
      "arrivalDateTime":"2011-02-15T23:33:19", // Дата и время прибытия [DateTime]
      "arrivalPlanDateTime":null, // Дата и время планового прибытия [DateTime]      
      "giveOutDateTime":"2011-02-19T09:56:50", // Дата и время выдачи [DateTime]
      "giveOutActualDateTime":null, // Фактическая дата выдачи со склада [DateTime]
      "orderNumber": "№23434-АБ", // Номер заказа клиента [String]
      "barCode": "1234567890", // Штрих-код груза [String]
      "callStatus": "Оповещен получатель", // Статус оповещения [String],
      "callStatusDate": "2011-02-19T09:56:50", // Дата и время оповещения [DateTime],
      "storage": "2015-05-21T00:00:00+03:00" // Вынужденное хранения [DateTime]
    },
    ...
 ]
}
	

Метод /cargos/statushistory/ — история статусов по грузу

Доступ

  • Зарегистрированные пользователи

Формат запроса

{
   "cargoCode":"МВПТЗВА-1/1603" // Код груза [String]
}

Формат ответа

[{
    "status": "Выдан",
    "date": "21.01.2016, 13:36"
}, {
    "status": "Прибыл",
    "date": "20.01.2016, 14:25"
}, {
    "status": "В пути",
    "date": "04.01.2016, 21:10"
}, {
    "status": "Принят",
    "date": "29.12.2015, 11:24"
}] 

Метод /cargos/statustable/ — список доступных статусов по грузам

Доступ

  • Зарегистрированные пользователи

Комментарии

  • Значения используются в поле id статуса груза в методе /cargos/status/

Формат запроса

// Пустой объект или null
{
}

Формат ответа

[
    {
        "id": 1,
        "name": "Принят"
    },
    {
        "id": 2,
        "name": "Возвращен отправителю"
    },
    {
        "id": 3,
        "name": "Оформлен"
    },
    {
        "id": 4,
        "name": "В пути"
    },
    {
        "id": 5,
        "name": "Прибыл"
    },
    {
        "id": 6,
        "name": "Готов к выдаче"
    },
    {
        "id": 7,
        "name": "Выдан на доставку"
    },
    {
        "id": 8,
        "name": "Выдан на складе"
    },
    {
        "id": 9,
        "name": "Доставлен"
    },
    {
        "id": 10,
        "name": "Отправлен на возврат"
    },
    {
        "id": 11,
        "name": "Утилизирован"
    },
    {
        "id": 12,
        "name": "Выдан ( мест { количество_мест } из { количество_мест } )"
    }
]
Онлайн-чат

Список филиалов