Группа /cargopickup/ — операции с заявками
Метод /cargopickup/submit/ — оформление заявки
Доступ
- Зарегистрированные пользователи
- Сторонние неперсонифицированные приложения
Комментарии
- ВАЖНО! Использование технологии "Упрощенный забор": раздельной подачи "Заказа на машину" и "Заказа на перевозку" (pickupType = 4), возможно, только после подключения услуги менеджером со стороны ПЭК. Вызов машины по этой технологии осуществляется только после подачи отдельного "Заказа на машину".
- При подаче "Заказа на перевозку" (pickupType = 4) реквизиты с требованиями к машине забора заполнять необходимо, но они будут проигнорированы, требования к машине имеет смысл передавать при подаче "Заказа на машину". Адрес забора в "Заказе на перевозку" и "Заказе на машину" должны в точности совпадать.
- Услуга наложенного платежа
services.cashOnDelivery может быть доступна при заключении договора на оказание данной услуги и для тарифа/продукта EasyWay.
- Для работы с тарифом EasyWay требуется заключение дополнительного соглашения.
- Установка соответствующего значения в поле
includeTES позволяет настраивать включение транспортно-экспедиционных услуг (ТЭУ) в сумму наложенного платежа (НП) для каждого груза или исключение ТЭУ из суммы НП: true— за услуги платит отправитель из суммы НП, false— за услуги платит получатель сверх суммы НП
- Быстро получить ID склада основного отделения любого филиала можно используя метод
/branches/findzonebyaddress/. В ответе метода реквизит mainWarehouseId. Основное отделение является центральным складом конкретного филиала, из которого можно заказать доставку до адреса или ПВЗ, который относится к зоне обслуживаемого филиала.
Например, по адресу «Самарская область, город Отрадный», основным является отделение филиала «Самара» по адресу: ул. Земеца, д. 32 литера 354, так как город Отрадный обслуживает филиал «Самара».
- При указании идентификатора склада
receiver.warehouseId следует помнить, что он будет проигнорирован, если заказана услуга доставки
isDocumentsReturn— при заказанной услуге "Возврат документов" создается отдельный груз "Возвратные документы", который направляется в отделение-отправитель. При необходимости клиент может отдельно заказать доставку этого груза по нужному адресуcommon.applicationDate, receiver.avisationDateTime, receiver.dateOfDelivery При передаче выполняется проверка на возможность выполнения заявок в указанные даты по процессам компании- Архив с примерами минимальных запросов CargoPickup (.zip, 6Кб)
Формат запроса
{
"common":{ // Общие данные [Object]
"type":"1", // Идентификатор продукта/тарифа [Number]. Обязательно. Возможные значения: 3 - LTL (сборный груз), 12 - EasyWay, 5 - Express Автоперевозка, 1- Express Авиаперевозка
// Полный список доступных в API продуктов/тарифов можно получить методом /typesOfDelivery/all/
"pickupType": 1, // Тип заявки на забор [Number]. Не обязательно. Возможные значения: 1 - Заказ "На машину и перевозку (разовый забор)" (по умолчанию), 4 - Заказ "На перевозку (с отдельным Заказом на машину)"
"applicationDate":"2012-02-25", // Планируемая дата забора груза [Date]. Обязательно.
"callToScheduleCar": true, // Звонить отправителю для подтверждения заявки [Boolean]. Необязательный. По-умолчанию true. Признак необходимости звонка отправителю для согласования/уточнения деталей Забора груза до планирования машины. true - оператор будет звонить для согласования, false - оператор не будет звонить. Машина будет запланирована автоматически.
"description":"Мебель", // Общее название перевозимых грузов [String]. Обязательно
// Значение необходимо выбрать из ответа метода /cargocontent/all/
"weight":14.5, // Вес груза, кг [Number]
"volume":0.22, // Объём груза, м3 [Number]
"positionsCount":2, // Количество мест, шт [Number]
"width":0.8, // Примерная наибольшая ширина из всех мест, м [Number]. Обязательно
"length":0.5, // Примерная наибольшая длина из всех мест, м [Number]. Обязательно
"height":0.45, // Примерная наибольшая высота из всех мест, м [Number]. Обязательно
"isFragile":true, // Хрупкий груз [Boolean]
"isGlass":false, // Стекло [Boolean]
"isLiquid":true, // Жидкость [Boolean]
"isOpenCar":false, // Необходима открытая машина [Boolean]
"isSideLoad":true, // Необходима боковая погрузка [Boolean]
"isSpecialEquipment":false, // Необходима машина со специальным оборудованием [Boolean],
// поле необязательно, если не указано считается равным false
"isUncovered":false, // Необходима растентовка [Boolean],
// поле необязательно, если не указано считается равным false
"whoRegisterApplication":1, // Представитель какой стороны оформляет заявки
// (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"responsiblePerson":"Сидоров Петр Иванович", // ФИО ответственного за оформление заявки [String]
"typeClientBarcode": "CODE128", // Тип Ваших штрих-кодов, указанных для мест грузов заявки [String]
// список допустимых типов штрих-кодов можно получить с помощью метода availabletypebarcode
// тип штрих-кода можно набирать символами любого регистра
"clientPositionsBarcode": [ // Ваши штрих-коды мест груза [Array]. Применимо при подключенной услуге "Приемка по штрих-кодам клиента" и для продукта EasyWay (type 12)
"123654789", // Штрих-код клиента [String]
...
],
"cargoPlaceList": [ // Массив с габаритами каждого грузоместа клиента. Необзательно. Имеет смысл при подключенной услуге "Доверительная приемка". Для продукта EasyWay (type 12) услуга подключена по умолчанию (передача данных так же не обязательна)
{ // если габариты не будут заполненны услуга "Доверительная приемка" не будет оказана
"quantity": 1, // Количество мест одинаковых габаритов [Number], Обязательно
"weight": 2.5, // Вес одного места, кг [Number], Обязательно
"length": 0.5, // Длина одного места, м [Number], Обязательно
"height": 0.5, // Высота одного места, м [Number], Обязательно
"width": 0.25, // Ширина одного места, м [Number], Обязательно
},
{ // если габариты не будут заполненны услуга "Доверительная приемка" не будет оказана
"quantity": 1, // Количество мест одинаковых габаритов [Number], Обязательно
"weight": 12, // Вес одного места, кг [Number], Обязательно
"length": 0.8, // Длина одного места, м [Number], Обязательно
"height": 0.45, // Высота одного места, м [Number], Обязательно
"width": 0.45, // Ширина одного места, м [Number], Обязательно
}
],
"customerCorrelation":"№23434-АБ", // Произвольное значение для синхронизации на стороне клиента [String], поле необязательно
"adjustDimensions":false // Позволять перестановку габаритов с целью преодоления ограничений длины/ширины/высоты, поле необязательно
},
"services":{ // Услуги [Object]
"isHP":true, // Изготовление защитной транспортировочной упаковки [Boolean]
"isInsurance":true, // Дополнительное страхование груза [Boolean]
"isInsurancePrice":250.17, // Стоимость груза (сумма, на которую будет застрахован груз), руб [Number]
// поле обязательно, если "isInsurance":true
"isSealing":false, // Пломбировка груза (обязательна только до 3 кг) [Boolean]
"isSealingPositionsCount":null, // Количество мест для пломбировки [Number]
// поле обязательно, если "isSealing":true
"isStrapping":false, // Упаковка груза стреппинг-лентой [Boolean]
"accompanyingDocuments":true, // Есть комплект сопроводительных документов [Boolean]
"isDocumentsReturn":true, // Возврат документов [Boolean]
"isLoading":false, // Необходима погрузка силами «ПЭК» [Boolean]
"floor":8, // Этаж с которого необходимо забрать груз, поле необязательно [Number]
"isElevator":true, // Есть лифт, поле необязательно [Boolean]
"carryingDistance":150, // Метров переноски груза, поле необязательно [Number]
"email":"example@example.com", // Email для бухгалтерских уведомлений [String], поле необязательно
"cashOnDelivery": { // Наложенный платеж [Object]. Перед выдачей груза/ заказа взять деньги с получателя в пользу отправителя.
// Обязательность реквизитов внутри блока указана только для случая, когда услуга "Наложенный платеж" заказана.
// При незаказанной услуге весь блок и все реквизиты внутри не обязательны.
// Обращаем Ваше внимание, что большинство параметров в блоке "cashOnDelivery" необходимы для оформления кассового чека
// (чека ККМ) в соответствии с законодательством Российской Федерации. Все ограничения и требования к формату данных
// исходят из требований, предъявляемых законодательством РФ для оформления кассовых чеков. За некорректное оформление
// кассовых чеков предусмотрены значительные штрафы, как на компанию, в пользу которой взымаются денежные средства, так
// и на компанию, оформляющую кассовый чек. Кассовый чек относится к документам бухгалтерского учёта. Данные и правила
// заполнения реквизитов кассовых чеков, оформляемых при приеме денежных средство в рамках Наложенного платежа,
// необходимо уточнять у сотрудников бухгалтерии и/или финансового отдела Вашей компании.
// Просим Вас подойти ответственно к вопросу корректности заполнения данных блока "cashOnDelivery" при подаче заявки.
// Не допускается передача ложных сведений.
"enabled": true, // Заказана услуга наложенного платежа [Boolean], поле обязательно только для заказа сервиса "Наложенный платеж" [Number]
"cashOnDeliverySum": 15500.00, // Сумма наложенного платежа, руб. [Number]. Обязательно. Указывается общая сумма, которую нужно взять с получателя груза в рамках сервиса "Наложенный платеж".
// ВАЖНО! Данная сумма должна была равна сумме всех Дополнительных услуг (sellerServices/sumIncludingVAT)
// и сумме средств, взимаемых с получателя в рамках наложенного платежа за каждый товар (specification/specifications/sumTotal).
// Данные по переданным услугам и товарам будут отражены в кассовом чеке в полном соответствии с законодательством РФ
"actualCost": 20000.00, // Объявленная стоимость груза [Number]. При заказе сервиса "Наложенный платеж" объявленная стоимость груза для страхования берется из этого реквизита
"includeTES": false, // Стоимость транспортных услуг ПЭК оплачивается Отправителем [Boolean]. При заказе сервиса "Наложенный платеж" плательщики, указанные в блоках "payments" запроса, всегда игнорируются.
// При значении false - плательщиком за все услуги ПЭК при оформлении будет выставлен получатель груза.
// При значении true - плательщиком за все услуги ПЭК при оформлении будет выставлен отправитель груза.
// Предполагается, что услуги перевозки для Получателя бесплатные, оплачены Отправителю заранее или включены в сумму Наложенного платежа (например, через услуги Отправителя)
"sellerPhone": "+74996651111", // Телефон организации (интернет магазина), которая при доставке товара оказывает собственные дополнительные услуги [String]
// Необходим для указания в кассовом чеке по требованиям законодательства РФ
// Обязателен к заполнению в случае указания доп. услуг в блоке "sellerServices":[], в других случаях не требуется
// Список дополнительных услуг предопределен и ограничен (см. ниже). Необходимо корректно ввести номер телефона
// в международном формате через «+», код страны и города обязательны, без пробелов и дополнительных символов
// ТОЛЬКО цифры, например, +74996651111. Максимум 19 символов
"sellerServices": [{ // Список услуг, за которые отправитель взимает плату с получателя груза в рамках сервиса "Наложенный платеж"[Object]. НЕ обязательно. Данные услуги будут отражены в кассовом чеке. При формировании кассового чека (чека КММ) поставщиком услуг, согласно договору с ПЭК, всегда указывается Отправитель груза.
"type": 1, // Список дополнительных услуг, предоставляемых Грузоотправителем Грузополучателю (Покупателю)[Number]. Обязательно.
// 1 - Доставка,
// 2 - Курьерская доставка,
// 3 - Доставка и выдача на терминале,
// 4 - Доставка и выдача на ПВЗ,
// 5 - Подъем на этаж,
// 6 - Доставка интернет-магазина,
// 7 - Погрузо-разгрузочные работы интернет-магазина
"rateVAT": "НДС20", // Ставка НДС [String]. Обязательно. Ожидаемые значения: "НДС20" - НДС 20%, "НДС10" - НДС 10%, "НДС0" - НДС 0% или "БезНДС" - Без НДС
"sumIncludingVAT": 500.00, // Сумма услуги Отправителя, которую ПЭК возьмет с получателя в рамках сервиса "Наложенный платеж" и отразит в кассовом чеке (с НДС), руб. [Number]. Обязательно.
}
],
"specification": { // Товары в заказе/ грузе с указанием условий передачи Получателю [Object]. Обязательно
"specifications": [{ // Перечень товаров для отражения в кассовом чеке. Обязательно
"vendorCode": "32711600Y", // Артикул товара для кассового чека [String]. Обязательно
"title": "Велосипед AlcaPlast A75", // Наименование товара для кассового чека [String]. Обязательно
"amount": 1, // Количество [Number]. Обязательно. Для маркированных товаров всегда = 1
"rateVAT": "НДС20", // Ставка НДС [String]. Обязательно. Ожидаемые значения: "НДС20" - НДС 20%, "НДС10" - НДС 10%, "НДС0" - НДС 0% или "БезНДС" - Без НДС
"actualCostPerUnit": 20000.00, // Объявленная ценность за ед., в т.ч. НДС, руб. [Number]. Обязательно. Цена 1 единицы товара для покупателя (не влияет на сумму наложенного платежа)
"actualCostTotal": 20000.00, // Объявленная ценность всего, руб., в т.ч. НДС [Number]. Обязательно. Общая стоимость товаров в строке для покупателя (не влияет на сумму наложенного платежа)
"sumPerUnit": 15000.00, // Цена 1 единицы товара, которую ПЭК должен взять с Грузополучателя/ Покупателя за каждую единицу товара (сумма с НДС), руб. [Number]. Обязательно.
"sumTotal": 15000.00, // Сумма, которую ПЭК должен взять с Грузополучателя/ Покупателя по данной строке товаров (сумма с НДС), руб. [Number]. Обязательно. Данная сумма будет в кассовом чеке.
"calculationSubject": 33, // Признак Предмета Расчета [Number]. Обязательно. Обязательный реквизит кассового чека.
// Допустимые значения: 1 – Товар (по умолчанию), 33 – Товар маркированный. Для товаров с типом 33 обязательно заполнять реквизиты: MarkingСode и groupMarkedGood.
// В случае если здесь не указано значение 33, то информация из реквизитов _ _MarkingСode и groupMarkedGood будет проигнорирована, даже если реквизиты будут переданы.
// Если, на момент подачи заявки, вы не знаете код маркировки, который будет отгружен, то вам необходимо: перейти на раздельную подачу заказа машины и заказов. И подавать заказы c товарами по интеграции, когда коды маркировки известны.
"markingCode": "0102900062468795215WPdVbh%28NlpcV91EE0792k%2B8jxUo%2BUyCuP8uendJyT%2B%2BQ83VprziatOcACBJO5yY%3D", // Код маркировки (КМ) [String]. Обязательное поле, если "calculationSubject": 33, в других случаях не заполняется.
// Код маркировки передается целиком, включая "крипто-хвост" (коды проверки). Код маркировки может как содержать, так и не содержать, спецсимволы, разделители групп. Код маркировки следует преобразовать URL Кодированием. Пример:
// КМ до кодирования: "0102900062468795215WPdVbh(NlpcV91EE0792k+8jxUo+UyCuP8uendJyT++Q83VprziatOcACBJO5yY="
// КМ после кодирования: "0102900062468795215WPdVbh%28NlpcV91EE0792k%2B8jxUo%2BUyCuP8uendJyT%2B%2BQ83VprziatOcACBJO5yY%3D"
"groupMarkedGood": 9, // Товарная группа маркированного товара [Number]. Обязательно при calculationSubject = 33 (товар маркированный), в других случаях не заполняется. Допустимые значения: 1 - lp - Текстиль, 2 - shoes – Обувь, 4 - perfumery – Парфюм, 5 - tires – Шины, 6 - electronics – Фото, 9 - bicycle – Велосипеды, 10 - wheelchairs - Медицинские изделия, 17 - bio – БАДЫ, 19 - antiseptic – Антисептики.
"vendorINN": "7712345678", // ИНН владельца товара (с точки зрения бухгалтерского учёта) для указания в кассовом чеке [String].
// Обязательно. Ожидается 10 цифр для юридических лиц или 12 цифр для ИП.
"vendorName": "ООО «Чей Товар»", // Наименование владельца товара (с точки зрения бух.учёта) для указания в кассовом чеке [String].
// Обязательно.
"vendorPhone": "+79031112255", // Телефон владельца товара (с точки зрения бух.учёта) для указания в кассовом чеке [String].
// Обязательно. Необходимо корректно ввести номер телефона в международном формате через «+»,
// код страны и города обязательны, без пробелов и дополнительных символов ТОЛЬКО цифры,
// например, +74956651111. Максимум 19 символов
"measureOfQuantity": 0 // Мера количества предмета расчета (всегда шт.) [Number]. Необязательный реквизит. По умолчанию "0 (шт.)".
// Применяется для предметов расчета, которые могут быть реализованы поштучно или единицами,
// если "calculationSubject": 33, то всегда "measureOfQuantity": 0,
// если "calculationSubject": 1, то "measureOfQuantity": 0, либо значение из предопределенного списка:
// 10 - г(Грамм),
// 11 - кг(Килограмм),
// 12 - т(Тонна),
// 20 - см(Сантиметр),
// 21 - дм(Дециметр),
// 22 - м(Метр),
// 30 - кв.см(Квадратный сантиметр),
// 31 - кв.дм(Квадратный дециметр),
// 32 - кв.м(Квадратный метр),
// 40 - мл(Миллилитр),
// 41 - л(Литр),
// 42 - куб.м(Кубический метр),
// 255 - Применяется при использовании иных единиц измерения
}]
}
}
},
"sender":{ // Отправитель [Object]
"inn":"7716542310", // ИНН [String], поле обязательно для Юридических лиц
"kpp":"773301001", // КПП [String], поле необязательно. Если передан ИНН, но не передан КПП, то для юр.лиц будет использован КПП головной организации
"fs": "ООО", // сокращенная форма собственности юр.лица/индивидуального предпринимателя (из списка ПЭК) [String]. Необзательно.
"countryOfRegistrationCode": "643", // Код страны регистрации по классификатору строка [String]. Необязательно, рекомендуется к заполнению. По умолчанию: 643 - Россия
"legalForm": 1, // Тип контрагента [Number]. Обязательно
// Значения: 1 - Юридическое лицо, 2 - Индивидуальный предприниматель, 3 - Физическое лицо
"title":"Наименование организации", // Наименование юр.лица/ИП или ФИО физ.лица [String]. Обязательно
"person":"Иванов Иван Иванович", // Контактное лицо [String]. Обязательно
"personPhones": // Список телефонов контактного лица для связи по вопросам забора груза. Обязательно.
// Список должен содержать не менее 1, но не более 3-х номеров номеров телефонов.
[
{
"phone": "+74956601111", // Контактный номер телефона отправителя [String]. Обязательно.
// Необходимо передавать номер телефона в международном формате через «+»,
// код страны и города обязательны, без пробелов и дополнительных символов ТОЛЬКО цифры,
// например, +74956601111. Максимум 19 символов
"additional": "1245" // Добавочный номер телефона отправителя [String]. Необязательно. Не более 10 цифр
}
],
"email":"example@example.com", // E-mail [String], поле необязательно
"addressStock":"Россия, Республика Татарстан, Казань, Кировский район, жилой массив Займище, Садовая улица, 2", // Адрес, по которому необходимо забрать груз [String].
// Обязателен для pickupType 1 и 4. Для успешного
// определения координат адреса забора, передавайте
// все составляющие адреса в такой последовательности:
// страна, регион, район, населенный пункт, улица, дом,
// квартира и разделяйте их запятыми. Запрещено в данной
// строке указывать данные, не являющиеся частью адреса
//
"addressStockComment":"вход со второго этажа", // Произвольная пометка для операции. Если для получения груза нужно предварительно получить документы по другому адресу, то в в данном поле дополнительно необходимо указать: "Требует забор документов на другом адресе." [String], поле необязательно
"addressOffice":"Россия, Чувашская Республика, Чебоксарский муниципальный округ, посёлок городского типа Кугеси, Советская улица, 4А", // Адрес, по которому находятся документы на получения груза. Имеет смысл заполнять только при указании в поле addressStockComment комментария по забору документов по другому адресу [String]. Услуга оказывается за дополнительную плату, поле необязательно
"addressOfficeComment":"пятый подъезд", // Комментарий к адресу офиса [String], поле необязательно
/*
Координаты для подачи машины по адресу склада, необязательны.
Если переданы, то имеют приоритет над строкой адреса
(информация в строке адреса служит как дополнительная и
не влияет на определение точки назначения).
*/
"latitudeForCar":55.432025, // Географическая широта [String]
"longitudeForCar":37.545734,// Географическая долгота [String]
"workTimeFrom":"09:00", // Время начала рабочего дня [Time], поле необязательно
"workTimeTo":"18:00", // Время окончания рабочего дня [Time], поле необязательно
"lunchBreakFrom":"14:00", // Время начала обеденного перерыва [Time], поле необязательно
"lunchBreakTo":"15:00", // Время окончания обеденного перерыва [Time], поле необязательно
"cargoDocumentNumber":"ЕК-419987234С", // Номер счета на оплату груза накладной
// или номер заказа клиента
// или номер другого документа на груз [String], максимальная длина поля 50 символов
"isAuthorityNeeded":false, // Для получения груза необходима доверенность «ПЭК»
// (иначе, доверенность клиента) [Boolean]
"identityCard":{ // Документ удостоверяющий личность [Object]. Обязательно для Физических лиц (для юр.лиц и ИП не передавать)
"type": 10, // тип документа [Number]. Возможные значения: 1 - Паспорт (прочие страны),
// 2 - Разрешение на временное проживание, 3 - Водительское удостоверение,
// 4 - Вид на жительство, 6 - Удостоверение беженца, 10 - Паспорт гражданина РФ"
"series":"1234", // Серия [String]
"number":"56789", // Номер [String]
"date":"1985-01-01", // Дата выдачи документа, удостоверяющего личность [Date]
"note":"" // служебное поле для других документов [String]
}
},
"receiver":{ // Получатель [Object]
"inn":"7716542310", // ИНН [String], обязательно для Юридических лиц и ИП (для физических лиц не передавать).
"kpp":"773301001", // КПП [String], поле необязательно. Если передан ИНН, но не передан КПП, то для юр.лиц будет использован КПП головной организации
"fs": "ООО", // сокращенная форма собственности юр.лица/индивидуального предпринимателя (из списка ПЭК) [String]. Необзательно.
"countryOfRegistrationCode": "643", // Код страны регистрации по классификатору строка [String]. Необязательно, рекомендуется к заполнению. По умолчанию: 643 - Россия
"legalForm": 1, // Тип контрагента [Number]. Обязательно
// Значения: 1 - Юридическое лицо, 2 - Индивидуальный предприниматель, 3 - Физическое лицо
"title":"Наименование организации", // Наименование юр.лица/ИП или ФИО физ.лица [String]. Обязательно
"person":"Ворожбян Андрей Васильевич", // Контактное лицо [String]. Обязательно
"personPhones": // Список телефонов контактного лица для связи по вопросам доставки груза. Обязательно.
// Список должен содержать не менее 1, но не более 3-х номеров номеров телефонов.
// ВАЖНО! При заказанной услуге "выдача по СМС физ.лицу" допускается передавать только ОДИН
// контактный номер телефона, который умеет принимать СМС. Указание добавочного не допускается.
[
{
"phone": "+74956601111", // Контактный номер телефона получателя [String]. Обязательно.
// Необходимо передавать номер телефона в международном формате через «+»,
// код страны и города обязательны, без пробелов и дополнительных символов ТОЛЬКО цифры,
// например, +74956601111. Максимум 19 символов
"additional": "1245" // Добавочный номер телефона получателя [String]. Необязательно. Не более 10 цифр
}
],
"email":"example@example.com", // E-mail [String], поле необязательно
"isCityDeliveryNeeded":true, // Необходима доставка по городу получателя [Boolean]
"isLoading":true, // Необходима разгрузка силами «ПЭК», поле необязательно [Boolean]
"floor":15, // Этаж на который необходимо занести груз, поле необязательно [Number]
"isElevator":false, // Есть лифт, поле необязательно [Boolean]
"carryingDistance":30, // Метров переноски груза, поле необязательно [Number]
"isCityDeliveryNeededAddress":"Россия, Санкт-Петербург, Пушкинский район, посёлок Шушары, Автозаводская улица, 2А", // Адрес доставки груза [String] .
// Поле обязательно, если "isCityDeliveryNeeded":true. Для успешного
// определения координат адреса доставки, передавайте все составляющие
// адреса в такой последовательности: страна, регион, район, населенный
// пункт, улица, дом, квартира и разделяйте их запятыми. Запрещено
// в данной строке указывать данные, не являющиеся частью адреса.
"coordinates" : { // Необязательный параметр координат адреса, имеет смысл только при заказанной доставке до адреса
// Если переданы, то имеют приоритет над строкой адреса (информация в строке адреса служит как
// дополнительная и не влияет на определение точки назначения)
"latitude" : "55.761011",
"longitude" : "37.627553"
},
"isCityDeliveryNeededAddressComment":"Вход со двора", // Комментарий к адресу доставки
// [String], необязательное поле
"avisationDateTime": "2013-04-02", // Дата авизации [Date], поле необязательно
"dateOfDelivery": "2013-04-02", // Плановая дата доставки [Date], поле необязательно
"dateOfDeliveryCheck": true, // Требуется ли проверять передаваемую дату доставки на предмет ее выполнимости. По умолчанию дата доставки не проверяется. Поле необязательно. [Boolean]
"warehouseId":"36cf9b5e-a415-11dc-a911-000a5e19ccb4", // Идентификатор склада [String] - см.
"identityCard":{ // Документ удостоверяющий личность [Object]. Обязательно для Физических лиц (для юр.лиц и ИП не передавать)
"type": 10, // тип документа [Number]. Возможные значения: 1 - Паспорт (прочие страны),
// 2 - Разрешение на временное проживание, 3 - Водительское удостоверение,
// 4 - Вид на жительство, 6 - Удостоверение беженца, 10 - Паспорт гражданина РФ"
"series":"1234", // Серия [String]
"number":"56789", // Номер [String]
"date":"1985-01-01", // Дата выдачи документа, удостоверяющего личность [Date]
"note":"" // служебное поле для других документов [String]
}
},
/*
Правила заполнения "paymentCity" для любой услуги см. .
*/
"payments":{ // Оплата [Object]
"pickUp":{ // Оплата забора груза [Object]
"type":1, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"paymentCity":"Санкт-Петербург" // Наименование филиала оплаты за услугу [String]. Необязательно. См.
// Остальные поля не указываются, т.к. плательщик отправитель
},
"moving":{ // Оплата перевозки [Object]
"type":2, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"paymentCity":"Курск" // Наименование филиала оплаты за услугу [String]. Необязательно. См.
// Остальные поля не указываются, т.к. плательщик получатель
},
"insurance":{ // Оплата страхования [Object],
// поле обязательно если services.isInsurance = true
"type":2, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"paymentCity":"Москва" // Наименование филиала оплаты за услугу [String]. Необязательно. См.
// Остальные поля не указываются, т.к. плательщик получатель
},
"delivery":{ // Оплата доставки по городу получателя [Object],
// поле обязательно если receiver.isCityDeliveryNeeded = true
"type":3, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"paymentCity":"Москва", // Наименование филиала оплаты за услугу [String]. См.
// Обязательно в этом примере, т.к. за услугу delivery плательщик указан третье лицо (type=3).
"inn":"7716542310", // ИНН третьего лица [String], обязательно для Юридических лиц и ИП (для физ.лиц не передавать)
"fs": "ООО", // сокращенная форма собственности юр.лица/индивидуального предпринимателя (из списка ПЭК) [String]. Необзательно.
"countryOfRegistrationCode": "643", // Код страны регистрации по классификатору строка [String]. Необязательно, рекомендуется к заполнению. По умолчанию: 643 - Россия
"legalForm": 1, // Тип контрагента [Number]. Необязательное, если не передан реквизит countryOfRegistrationCode. Рекомендуется к заполнению. Значения: 1 - Юридическое лицо, 2 - Индивидуальный предприниматель, 3 - Физическое лицо
"title":"ОАО \"Заливные луга\"", // Наименование третьего лица [String],
// поле обязательно, если "type":3
"phone":"12-12-12", // Телефон третьего лица [String],
// поле обязательно, если "type":3
"identityCard":{ // Документ удостоверяющий личность [Object]
// Обязательно, если плательщик 3-е лицо (type=3) является Физическом лицом (для юр.лиц и ИП не передавать)
"type": 10, // тип документа [Number]. Возможные значения: 1 - Паспорт (прочие страны),
// 2 - Разрешение на временное проживание, 3 - Водительское удостоверение,
// 4 - Вид на жительство, 6 - Удостоверение беженца, 10 - Паспорт гражданина РФ"
"series":"1234", // Серия [String]
"number":"56789", // Номер [String]
"date":"1985-01-01", // Дата выдачи документа, удостоверяющего личность [Date]
"note":"" // служебное поле для других документов [String]
}
},
"hardPacking":{ // Оплата услуги изготовления защитной транспортировочной упаковки [Object]
"type":1, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"paymentCity":"Санкт-Петербург" // Наименование филиала оплаты за услугу [String]. Необязательно. См.
// Остальные поля не указываются, т.к. плательщик отправитель
},
"sealing": { // Оплата услуги пломбировки груза [Object]
"type": 1, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"paymentCity": "Чита", // Наименование филиала оплаты за услугу [String]. Необязательно. См.
// Остальные поля не указываются, т.к. плательщик отправитель
},
"strapping": { // Оплата услуги стреппинг-ленты для груза [Object]
"type": 1, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"paymentCity": "Челябинск", // Наименование филиала оплаты за услугу [String]. Необязательно. См.
// Остальные поля не указываются, т.к. плательщик отправитель
}
},
"refusalWarehouse": { // Информация о порядке возврата отказных/невостребованных грузов (актуально только для грузов EasyWay, в остальных продуктах игнорируется).
// Заполняется только если получатель возврата отличается от Отправителя или Способ возврата отличается от способа передачи и грузов в EasyWay
// Например, при отправке мы забираем у Вас со склада, а возвратные грузы Вы забираете самостоятельно с нашего склада [Object]
"type": 1, // Способ возврата отказных грузов 0 - самовывоз, 1 - доставим до Вашего склада. Обязательный, если передается блок [Number]
"recipient": { // Блок для указания получателя возвратного груза. Необязателен. Заполняется если возвратный груз будет получать не Отправитель [Object]
"inn": "7714850334", // ИНН получателя возвратного груза. Обязательный, если передается блок [String]
"kpp": "773301001", // КПП получателя возвратного груза. Необязательный [String]
"title": "ООО Отправитель", // Наименование получателя возвратного груза. Обязательный, если передается блок [String]
"person": "Сидоров Иван", // Имя контактного лица получателя возвратного груза. Обязательный, если передается блок [String]
"phone": "9055089784" // Телефон контактного лица получателя возвратного груза. Обязательный, если передается блок [String]
},
"address": "Москва, Сормовский проезд, 7А, корпус 2" // Поле не обязательно. Заполняется, если в RefusalWarehouse / Type указано 1 (доставка до Вашего адреса) и адрес возврата отличается от адреса с которого забирается заказ/груз.
// Адрес возврата обязательно должен относится к тому же филиалу, в котором будет передача заказа в ПЭК. [String]
},
"billing":{ // Биллинг [Object], необязательное поле
"billingNumbers":[ // Номера по биллингу
{ // Объект номера по биллингу [Object]
"billingNo": "БС-23417КЛМ", // Номер по биллингу [String]
"billingSum": 900000 // Сумма по биллингу [Number]
},
{ // Объект номера по биллингу [Object]
"billingNo": "97923FR19C", // Номер по биллингу [String]
"billingSum": 1000000 // Сумма по биллингу [Number]
}
]
},
"files":[ //Файлы [Array], необязательно. Информация к операции Забора груза с адреса клиента (например, схема проезда).
{ // Информация о файле [Object]
"mimeType":"image\/jpeg", // MIME-тип [String]
"filename":"как_проехать.jpg", // Имя файла [String]
"description":"Схема проезда", // Комментарий к файлу [String]
"data":"/9j/4AAQSkZJRgABAQEBLAEsAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsK
CwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQU
...
LXFlDUC+l4A9IMKfYCT/AABBDY2E7QqdtV2V0TFFJZmpenzodS23OoSl0bt1bSrhKlD1zZIsTpbx
QQB//9k=" // Содержимое файла [Binary]
},
{
"mimeType":"image\/jpeg",
"filename":"реквизиты.jpg",
"description":"Реквизиты получателя",
"data":"/9j/4AAQSkZJRgABAQEBLAEsAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsK
CwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQU
...
LXFlDUC+l4A9IMKfYCT/AABBDY2E7QqdtV2V0TFFJZmpenzodS23OoSl0bt1bSrhKlD1zZIsTpbx
QQB//9k="
}
]
}
Формат ответа
{
"documentId": 365, // Номер заявки [Number]
"customerCorrelation":"№23434-АБ", // Произвольное значение для синхронизации на стороне клиента [String]
"sender": { // Информация об адресе отправителя
"warehouseID": null,
"addressNormal": "357528, Ставропольский край, г. Пятигорск, ул. Егоршина, д.6 с.1", // Нормализованный адрес как он был идентифицирован системами ПЭК [String]
"coordinates": { // Координаты адреса подачи машины (переданные в запросе или определенные системой ПЭК)
"latitude": 44.041111, [Double]
"longitude": 43.001859 [Double]
}
},
"cargos":[ // Информация о принятии данных грузов, описанных в заявках [Array]
{ // Объект с информацией о приёме одной заявки [Object]
"cargoCode": "999940950644", // Код груза [String]
"barсode": "999940950644" // Значение для штрих-кода в формате EAN-13 [String]
"positions": [ // Информация о местах [Array]
{ // Информация об одном месте [Object]
"barcode": "9999409506440001" // Значение для штрих-кода
// в формате CODE-128/EAN-128 [String]
},
...
],
"receiver": { // Информация об адресе получателя
"warehouseId": "c496b0d2-8e45-11df-bb3b-0019bbc941ce", // Идентификатор склада получения груза (если заказана доставка до адреса, то null) [String]
"addressNormal": "160002, Вологодская обл, Вологда г, Вологда, ул. Ильюшина, д. 9 Б", // Адрес склада получения или нормализованный адрес доставки (что заказано) [String]
"coordinates": { // Координаты склада получения или адреса доставки (что заказано)
"latitude": 59.207921893678, [Double]
"longitude": 39.820086858791 [Double]
}
}
},
"notifications": ["При создании заявки не удалось проверить возможность выполнения перевозки к желаемой дате", "..."] // Важные оповещения, которые могут повлиять на сроки/стоимость перевозки. [][String]
]
}
Метод /cargopickup/submit/ — ПОДАЧА ЗАКАЗА "НА МАШИНУ" (упрощенный забор) к заказам на перевозку
Доступ
- Зарегистрированные пользователи
Комментарии
- Приведено описание запроса для подачи заказа на машину в рамках услуги "Упрощенный забор" (когда заявки на перевозку грузов и машина для забора этих заявок от отправителя подаются отдельно)
- ВАЖНО! Использование технологии "Упрощенный забор": раздельной подачи "Заказа на машину" и "Заказа на перевозку" возможно, только после подключения услуги менеджером со стороны ПЭК.
- Код груза, возвращаемые этим методом являются идентификатором Заказа машины для забора груза. По нему можно отслеживать статус выполнения забора. После приемки на склад ПЭК грузов по "заказам на перевозку" статус перевозки этих заказов/грузов отслеживается по их трэк номерам.
common.applicationDate при передаче выполняется проверка на возможность выполнения заявок в указанные даты по процессам компании- Скачать минимальный запрос: Заказ машины - минимальный запрос.json
Формат запроса
{
"common":{ // Общие данные [Object]
"type": 12, // Идентификатор продукта/тарифа [Number]. Обязательно. Возможные значения: 3 - LTL (сборный груз), 12 - EasyWay, 5 - Express Автоперевозка, 1- Express Авиаперевозка
// Полный список доступных в API продуктов/тарифов можно получить методом /typesOfDelivery/all/
"pickupType": 3, // Признак подачи заказа машины [Number]. Обязательно
"applicationDate":"2012-02-25", // Планируемая дата забора груза [Date]. Обязательно.
"callToScheduleCar": true, // Звонить отправителю для подтверждения заявки [Boolean]. НеОбязательно. По-умолчанию true. Признак необходимости звонка отправителю для согласования/уточнения деталей Заказа машины до планирования машины. true - оператор будет звонить для согласования, false - оператор не будет звонить и машина будет запланирована автоматически.
"description":"Мебель", // Общее название перевозимых грузов [String]. Обязательно
// Значение необходимо выбрать из ответа метода /cargocontent/all/
"weight":200, // Общий вес заказов/грузов, который должна забрать машина, кг [Number]. Обязательно
"volume":2, // Общий вес заказов/грузов, который должна забрать машина, м3 [Number]. Обязательно
"positionsCount":1, // Примерное количество мест, шт [Number]. Обязательно.
"width":0.12, // Примерная наибольшая ширина из всех мест, м [Number]. Обязательно
"length":0.3, // Примерная наибольшая длина из всех мест, м [Number]. Обязательно
"height":0.4, // Примерная наибольшая высота из всех мест, м [Number]. Обязательно
"isOpenCar":false, // Необходима открытая машина [Boolean]. Обязательно
"isSideLoad":true, // Необходима боковая погрузка [Boolean]. Обязательно
"isSpecialEquipment":false, // Необходима машина со специальным оборудованием [Boolean]. Необязательно. По умолчанию false
"isUncovered":false, // Необходима растентовка [Boolean]. Необязательно. По умолчанию false
"whoRegisterApplication":1, // Представитель какой стороны оформляет заявки. Обязательно
// (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"responsiblePerson":"Сидоров Петр Иванович", // ФИО ответственного за оформление заявки [String]. Обязательно
},
"services":{ // Услуги [Object]
"isLoading":false, // Необходима погрузка силами «ПЭК» [Boolean]. Обязательно
"floor":8, // Этаж с которого необходимо забрать груз, поле необязательно [Number]
"isElevator":true, // Есть лифт, поле необязательно [Boolean]
"carryingDistance":150, // Метров переноски груза, поле необязательно [Number]
},
"sender": { // Данные об отправителе [Object]
"inn": "7716512010", // ИНН [String], поле обязательно для Юридических лиц
"kpp": "773301001", // КПП [String], поле необязательно. Если передан ИНН, но не передан КПП, то для юр.лиц будет использован КПП головной организации
"fs": "ООО", // Сокращенная форма собственности юр.лица/индивидуального предпринимателя (из списка ПЭК) [String]. Необязательно.
"countryOfRegistrationCode": "643", // Код страны регистрации по классификатору строка [String]. Необязательно.
// Рекомендуется к заполнению. По умолчанию: 643 - Россия
"legalForm": 1, // Тип контрагента [Number]. Обязательно
// Значения: 1 - Юридическое лицо, 2 - Индивидуальный предприниматель, 3 - Физическое лицо
"title": "ООО Отправитель грузов", // Наименование юр.лица/ИП или ФИО физ.лица [String]. Обязательно
"person": "Иванов Иван", // Контактное лицо [String]. Обязательно"
"personPhones": // Список телефонов контактного лица для связи по вопросам забора груза. Обязательно.
// Список должен содержать не менее 1, но не более 3-х номеров номеров телефонов.
[
{
"phone": "+74956601111", // Контактный номер телефона отправителя [String]. Обязательно.
// Необходимо передавать номер телефона в международном формате через «+»,
// код страны и города обязательны, без пробелов и дополнительных символов ТОЛЬКО цифры,
// например, +74956601111. Максимум 19 символов
"additional": "1245" // Добавочный номер телефона отправителя [String]. Необязательно. Не более 10 цифр
}
],
"addressStock": "Россия, Республика Татарстан, Казань, Садовая улица, 2", // Адрес, по которому необходимо забрать груз [String]. Обязательно
// Для успешного определения координат адреса забора, передавайте все
// составляющие адреса в такой последовательности: страна, регион, район,
// населенный пункт, улица, дом, квартира и разделяйте их запятыми.
// Запрещено в данной строке указывать данные, не являющиеся частью адреса
//
"addressStockComment":"вход со второго этажа", // Произвольная пометка для операции [String]. Если для получения груза нужно предварительно получить документы
// по другому адресу, то в в данном поле дополнительно необходимо указать: "Требует забор документов на другом
// адресе. Поле необязательно
"addressOffice":"Республика Татарстан, Казань, жилой массив Аметьево, улица Мичурина, 4",// Адрес, по которому находятся документы на получения груза [String].
// Имеет смысл заполнять только при указании в поле addressStockComment
// комментария по забору документов по другому адресу. Услуга оказывается
// за дополнительную плату. Поле необязательно
"addressOfficeComment":"пятый подъезд", // Комментарий к адресу офиса [String], поле необязательно
"latitudeForCar":55.432025, // Координаты для подачи машины по адресу склада [String]
"longitudeForCar":37.545734, // Координаты для подачи машины [String]
"workTimeFrom":"09:00", // Время начала рабочего дня [Time], поле необязательно
"workTimeTo":"18:00", // Время окончания рабочего дня [Time], поле необязательно
"lunchBreakFrom":"14:00", // Время начала обеденного перерыва [Time], поле необязательно
"lunchBreakTo":"15:00", // Время окончания обеденного перерыва [Time], поле необязательно
"identityCard": { // Документ удостоверяющий личность [Object]. Обязательно для Физических лиц (для юр.лиц и ИП не передавать)
"type": 10, // тип документа [Number]. Возможные значения: 1 - Паспорт (прочие страны),
// 2 - Разрешение на временное проживание, 3 - Водительское удостоверение,
// 4 - Вид на жительство, 6 - Удостоверение беженца, 10 - Паспорт гражданина РФ"
"series": "1234", // Серия [String]
"number": "56789", // Номер [String]
"date": "1985-01-01", // Дата выдачи документа, удостоверяющего личность [Date]
"note": "" // служебное поле для других документов [String]
}
}
}
Формат ответа
{
"documentId": 365, // Номер заявки [Number]
"customerCorrelation":"№23434-АБ", // Произвольное значение для синхронизации на стороне клиента [String]
"sender": { // Информация об адресе отправителя
"warehouseID": null,
"addressNormal": "357528, Ставропольский край, г. Пятигорск, ул. Егоршина, д.6 с.1", // Нормализованный адрес как он был идентифицирован системами ПЭК [String]
"coordinates": { // Координаты адреса подачи машины (переданные в запросе или определенные системой ПЭК)
"latitude": 44.041111, [Double]
"longitude": 43.001859 [Double]
}
},
"cargos":[ // Информация о принятии данных грузов, описанных в заявках [Array]
{ // Объект с информацией о приёме одной заявки [Object]
"cargoCode": "999940950644", // Код груза [String]
"barсode": "999940950644" // Значение для штрих-кода в формате EAN-13 [String]
"positions": [ // Информация о местах [Array]
{ // Информация об одном месте [Object]
"barcode": "9999409506440001" // Значение для штрих-кода
// в формате CODE-128/EAN-128 [String]
},
...
],
"receiver": { // Информация об адресе получателя
"warehouseId": "c496b0d2-8e45-11df-bb3b-0019bbc941ce", // Идентификатор склада получения груза (если заказана доставка до адреса, то null) [String]
"addressNormal": "160002, Вологодская обл, Вологда г, Вологда, ул. Ильюшина, д. 9 Б", // Адрес склада получения или нормализованный адрес доставки (что заказано) [String]
"coordinates": { // Координаты склада получения или адреса доставки (что заказано)
"latitude": 59.207921893678, [Double]
"longitude": 39.820086858791 [Double]
}
}
},
"notifications": ["При создании заявки не удалось проверить возможность выполнения перевозки к желаемой дате", "..."] // Важные оповещения, которые могут повлиять на сроки/стоимость перевозки. [][String]
]
}
Метод /cargopickup/status/ — статус оказания услуги "Забор груза"
Доступ
- Зарегистрированные пользователи
- Сторонние неперсонифицированные приложения
Формат запроса
{
"cargoCodes": [
"780339690775" // Код груза [String]
]
}
Формат ответа
[
{
"pickupDate": "02.28.2017", // Дата забора груза [Date]
"cargoCode": "780339690775", // Код груза [String]
"fenceStatus": "Заявка на забор согласована 01.03.2017",// Статус заявки на забор [String]
"carDriver": null, // ФИО водителя [String]
"carDriverPhone": null, // Номер телефона водителя [String]
"carNumber": null, // Номер машины [String]
"carBrand": null, // Наименование машины [String]
"intakeStatus": "Забор груза аннулирован", // Статус забора [String]
"intakeStatusCode": 4500, // Код статуса забора [String].
"intervalFrom": "09:00:00", // Время, с [TimeSpan]
"intervalTo": "13:00:00", // Время, до [TimeSpan]
"intervalLunchBreakFrom": "00:00:00", // Перерыв, с [TimeSpan]
"intervalLunchBreakTo": "00:00:00", // Перерыв, до [TimeSpan]
"error": "Данные не получены" // Поле выводится только при возникновении ошибки [String]
}
]
// Ответ с ошибкой
{
"error": {
"title": "Запрашиваемые вами грузы не найдены",
"message": "Запрашиваемые вами грузы не найдены: 780339690775",
"error": null,
"status": 200
}
}
Метод /cargopickup/checkOrderedPickupType3Car/ — статус заявки на забор при подключеной услуге "Упрощенный заказ машины"
Доступ
- Зарегистрированные пользователи
- Сторонние неперсонифицированные приложения
Комментарии
- Метод работает при подключеной услуге "Упрощенный заказ машины" и возвращает ранее отправленные методом
/cargopickup/submit/ заказы на машины (со значением параметра "pickupType": 3). Может использоваться для проверки ранее поданного заказа на машину и получения его статуса.
Формат запроса
{
"intakePlanDateTime": "2022-05-30", // Плановая дата выполнения [Date], поле обязательно. Дата забора груза, на которую проверяется наличие заказа машины.
"senderInn": "9956012354" // ИНН отправителя [String], поле необязательно
}
Формат ответа
{
"orders": [{
"order": "772847558824", // Номер груза/трэк-номер, который был получен при создании заявки
"status": "Принят", // Статус операции забора груза
"weight": 40.0, // Вес, на который заказана машина
"volume": 0.03, // Объем, на который заказана машина
"senderInn": "9956012354", // ИНН отправителя
"senderTitle": "ООО «НьюФэшн»", // Наименование отправителя
"senderCity": "Москва Восток", // Филиал отправления
"senderAddressStock": "Москва, Сормовский проезд, 7А, корпус 2" // Адрес забора
},
...
]
}
