Группа /preregistration/ — заявки на перевозку (авто, авиа) с забором груза от адреса отправителя и предварительное оформление
Метод /preregistration/submit/ — единый метод подачи заявок
Доступ
- Зарегистрированные пользователи
Комментарии
- Максимальное количество грузов в одной заявке для orderType = 0 и 14 — 50, для orderType = 3 и 4 - 1.
- ВАЖНО! Использование технологии "Упрощенный забор": раздельной подачи "Заказа на машину" и "Заказа на перевозку" (orderType = 4), возможно, только после подключения услуги менеджером со стороны ПЭК. Вызов машины по этой технологии осуществляется только после подачи отдельного "Заказа на машину"
- При подаче "Заказа на перевозку" (orderType = 4) реквизиты с требованиями к машине забора заполнять необходимо, но они будут проигнорированы, требования к машине имеет смысл передавать при подаче "Заказа на машину". Адрес забора в "Заказе на перевозку" и "Заказе на машину" должны в точности совпадать.
- Быстро получить ID склада основного отделения любого филиала можно используя метод
/branches/findzonebyaddress/. В ответе метода реквизит mainWarehouseId. Основное отделение является центральным складом конкретного филиала, из которого можно заказать доставку до адреса или ПВЗ, который относится к зоне обслуживаемого филиала.
Например, по адресу «Самарская область, город Отрадный», основным является отделение филиала «Самара» по адресу: ул. Земеца, д. 32 литера 354, так как город Отрадный обслуживает филиал «Самара».
- Указать получателей для грузов можно в объекте
cargos[].receiver.
- Услуга наложенного платежа
cargos[].services.cashOnDelivery может быть доступна при заключении договора на оказание данной услуги и для тарифа/продукта EasyWay.
- Для работы с продуктами/ тарифами EasyWay (12) и ДТС Автоперевозка (7) требуется заключение дополнительного соглашения на соответствующий продукт.
- Замечания по валидации
- При заказе услуги наложенного платежа
cargos[].services.cashOnDelivery заявленная стоимость груза cargos[].services.insurance.cost устанавливается равной фактической стоимости товара cargos[].services.cashOnDelivery.actualCost.
- Установка соответствующего значения в поле
includeTES позволяет настраивать включение транспортно-экспедиционных услуг (ТЭУ) в сумму наложенного платежа (НП) для каждого груза или исключение ТЭУ из суммы НП: true— за услуги платит отправитель из суммы НП, false— за услуги платит получатель сверх суммы НП.
- При указании идентификатора склада
sender.warehouseId следует помнить, что он будет проигнорирован, если заказана услуга забор от адреса отправителя.
- При указании идентификатора склада
cargos[].receiver.warehouseId следует помнить, что он будет проигнорирован, если заказана услуга доставки.
cargo.services.delivery.avisationDateTime, cargo.services.delivery.dateOfDelivery При передаче выполняется проверка на возможность выполнения заявок в указанные даты по процессам компании- Архив с примерами минимальных запросов Preregistration (.zip, 7Кб)
Формат запроса
{
"common": { // Общие данные [Object]
"orderType": 0, // Способ передачи груза в ПЭК [Number].
// 0 - Самопривоз на склад ПЭК (по умолчанию),
// 3 - Забор от отправителя (Заказ "На машину и перевозку"),
// 4 - Заказ "На перевозку (с отдельным Заказом на машину)",
// 14 - Сетевая заявка на забор груза.
// Для type = 7 "ДТС Автоперевозка" допустимо указание orderType 0 (по умолчанию) или 14.
"plannedDate": "2020-01-01", // Планируемая дата передачи груза в ПЭК [String]. Обязательный для orderType 3, 4 и 14.
// Обязательно для orderType 0, 14 при type = 7 "ДТС Автоперевозка".
"callToScheduleCar": true // Звонить отправителю для подтверждения Забора [Boolean]. Необязательный, имеет смысл для только orderType=3. По-умолчанию true. Признак необходимости звонка отправителю для согласования/уточнения деталей Забора груза до планирования машины. true - оператор будет звонить для согласования, false - оператор не будет звонить. Машина будет запланирована автоматически.
},
"pickUpDetails": { // Данные по забору груза [Object]. Обязателен для orderType 3, 4 и 14.
// Если orderType 0, то данный объект передавать не нужно.
"coordinates": { // Необязательный параметр координат адреса [Object]. Имеет смысл только
// при заказанной услуге забора от адреса (orderType 3, 4, 14). Если переданы,
// то имеют приоритет над строкой адреса (информация в строке адреса служит
// как дополнительная и не влияет на определение точки отправления)
"latitude" : "55.761011", // Географическая широта [String]
"longitude" : "37.627553" // Географическая долгота [String]
},
"addressStockComment": "вход со второго этажа", // Произвольная пометка для операции забора [String], поле необязательно.
// Если для получения груза нужно предварительно получить документы по другому
// адресу, то в данном поле дополнительно необходимо указать: "Требуется забор
// документов на другом адресе".
/*
Интервал времени забора должен составлять минимум 4 часа.
Рекомендуем сверять даты и интервалы времени по дате забора от даты
запроса "requestdatetime" в методе /CALCULATOR/CHECKDELIVERYDATE/
*/
"periodTimeFrom": "11:00:00", // Время начала интервала забора груза [Time], поле необязательно
"periodTimeTo": "15:00:00", // Время окончания интервала забора груза [Time], поле необязательно
"addressForDocuments": "Россия, Чувашская Республика, Чебоксарский муниципальный округ, посёлок городского типа Кугеси, Советская улица, 4А",
//Адрес, по которому находятся документы на получение груза. Имеет смысл заполнять только при указании в поле addressStockComment
//комментария по забору документов по другому адресу [String]. Услуга оказывается за дополнительную плату, поле необязательно
"addressForDocumentsComment": "пятый подъезд", // Комментарий к забору документов по другому адресу [String], поле необязательно
"isLoading": false, // Необходима погрузка силами «ПЭК» [Boolean], поле необязательно. По умолчанию false.
"isHydrolift":false, // Необходима погрузка с использованием Гидролифта силами «ПЭК» [Boolean], поле необязательно.
// По умолчанию false. Услуга предоставляется только в городах Москва, Санкт-Петербург и Калининград.
"floor": 8, // Этаж, с которого необходимо забрать груз [Number], поле необязательно.
"isElevator": true, // Есть лифт [Boolean], поле необязательно.
"carryingDistance": 150, // Метры переноски груза, поле необязательно [Number]
"isSpecialEquipment": false, // Необходима машина со специальным оборудованием [Boolean],
// поле необязательно, если не указано считается равным false
"isOpenCar": false, // Необходима открытая машина [Boolean], поле необязательно, если не указано считается равным false
"isSideLoad": true, // Необходима боковая погрузка [Boolean], поле необязательно, если не указано считается равным false
"isUncovered": false, // Необходима растентовка [Boolean], поле необязательно, если не указано считается равным false
"isAuthorityNeeded": false // Для получения груза необходима доверенность «ПЭК». True - необходима доверенность ПЭК,
// false - необходима доверенность клиента [Boolean]
},
"sender":{ // Данные об отправителе [Object]
"warehouseId":"521fc4dd-6650-11e3-a392-00155d505c08", // Идентификатор склада, куда будет привезен груз [String]. Обязателен для orderType 0.
// Игнорируется для orderType 3, 4 и 14 - см.
"addressStock":"Россия, Республика Татарстан, Казань, Кировский район, жилой массив Займище, Садовая улица, 2", // Адрес, по которому необходимо забрать груз [String].
// Обязателен для orderType 3, 4 и 14. Для успешного
// определения координат адреса забора, передавайте
// все составляющие адреса в такой последовательности:
// страна, регион, район, населенный пункт, улица, дом,
// квартира и разделяйте их запятыми. Запрещено в данной
// строке указывать данные, не являющиеся частью адреса
//
"countryOfRegistrationCode": "643", // Код страны регистрации по классификатору [String].
// Необязательно, рекомендуется к заполнению. По умолчанию: 643 - Россия.
// Для type = 7 "ДТС Автоперевозка" возможные значения: 643 - Россия и 112 - Беларусь
"legalForm": 1, // Тип контрагента [Number]. Обязательно. Значения:
// 1 - Юридическое лицо, 2 - Индивидуальный предприниматель, 3 - Физическое лицо.
"inn":"7716512010", // ИНН [String], поле обязательно для Юридических лиц.
"kpp":"773301001", // КПП [String], поле необязательно. Если передан ИНН, но не передан КПП, то для юр.лиц будет использован КПП головной организации.
"fs": "ООО", // Сокращенная форма собственности юр.лица/индивидуального предпринимателя (из списка ПЭК) [String]. Необзательно.
"title":"Наименование организации", // Наименование юр.лица/ИП или ФИО физ.лица [String]. Обязательно
"individual"{ // Обязательно, если контрагент-отправитель - физическое лицо (для юр.лиц и ИП не передавать).
"firstName":"Иван", // Имя или первая буква имени (инициал) [String].
"lastName":"Иванов", // Фамилия [String].
"patronymic":"Иванович" // Отчество или первая буква отчества (инициал), если имеется [String].
},
"personPhones": // Список телефонов контактного лица для связи по вопросам забора груза. Обязательно.
// Список должен содержать не менее 1, но не более 3-х номеров телефонов.
[
{
"phone": "+74956601111", // Контактный номер телефона отправителя [String]. Обязательно.
// Необходимо передавать номер телефона в международном формате через «+»,
// код страны и города обязательны, без пробелов и дополнительных символов ТОЛЬКО цифры,
// например, +74956601111. Максимум 19 символов.
"additional": "1245" // Добавочный номер телефона отправителя [String]. Необязательно. Не более 10 цифр.
}
],
"person":"Иванов Иван", // Контактное лицо [String]. Обязательно
"email":"example@example.com", // E-mail [String], поле необязательно
"identityCard":{ // Документ удостоверяющий личность [Object]. Обязательно для Физических лиц (для юр.лиц и ИП не передавать).
"typeGuid":"982d33e2-bee6-453a-992e-11d13fa66fa7", // Уникальный идентификатор типа документа [String], который разрешено использовать
// для страны отправления, можно получить методом /branches/countrytypeidentitydocument/.
"series":"1234", // Серия [String].
"number":"56789", // Номер [String].
"date":"1985-01-01", // Дата выдачи документа, удостоверяющего личность [Date].
"note":"", // служебное поле для других документов [String].
"taxpayerID":"123456789012", // Налоговый номер отправителя [String]: ПИН (Кыргызстан), ИИН (Казахстан), УПН (Беларусь) и т.п.
// Обязательно для международных перевозок, но необязателен, если отправление из РФ.
"taxpayerCountryCode":"398" // Код страны, выдавшей налоговый номер [String]. Обязателен для международных перевозок,
// но необязателен, если отправление из РФ. По умолчанию 643.
}
}
},
"cargos":[ // Данные о грузах [Array]
{ // Данные об одном грузе [Object]
"common":{ // Общие данные о грузе [Object]
"customerCorrelation":"№23434-АБ", // Произвольное значение для синхронизации на стороне клиента [String], поле необязательно
"type":"3", // Идентификатор продукта/тарифа [Number]. Обязательно.
// Возможные значения: 3 - LTL (сборный груз), 1 - Express Авиаперевозка,
// 12 - EasyWay, 5 - Express Автоперевозка, 7 - ДТС Автоперевозка
// Полный список доступных в API продуктов/тарифов можно получить
// методом /typesOfDelivery/all/. ВАЖНО! Сетевая заявка на забор
// orderType: 14 поддерживает только три продукта type = 3 "LTL (Сборный груз)",
// type = 1 "Express Авиаперевозка" и type = 7 "ДТС Автоперевозка"
"palletType":1, // Тип паллета [Number], поле используется и обязательно только для type = 7 "ДТС Автоперевозка" для orderType 0 и 14.
// Возможные значения: 1-120х80, 2-100х100, 3-120х120, 4-100х120
"palletCount":1, // Количество паллет [Number], поле обязательно для type = 7 "ДТС Автоперевозка"
"weight":14,5, // Общий вес груза, кг [Number], Обязательно для orderType 3, 4, 14 при type 12 = "EasyWay".
// Обязательно для orderType 0, 14 при type = 7 "ДТС Автоперевозка".
"volume":0.23, // Общий объём груза, м3 [Number], Обязательно для orderType 3, 4, 14 при type 12 = "EasyWay".
// Обязательно для orderType 0, 14 при type = 7 "ДТС Автоперевозка".
"width":0.8, // Примерная наибольшая ширина из всех мест, м [Number]. Обязательно для orderType 3, 4, 14. Игнорируется при type = 7 "ДТС Автоперевозка".
"length":0.5, // Примерная наибольшая длина из всех мест, м [Number]. Обязательно для orderType 3, 4, 14. Игнорируется при type = 7 "ДТС Автоперевозка".
"height":0.45, // Примерная наибольшая высота из всех мест, м [Number]. Обязательно для orderType 3, 4, 14.
// Обязательно для orderType 0, 14 при type = 7 "ДТС Автоперевозка".
"accompanyingDocuments":true, // Есть комплект сопроводительных документов [Boolean]
// Для type = 7 "ДТС Автоперевозка" есть возможность указать дополнительные поля по сопроводительным документам
"accompanyingDocumentsName": 1, // Наименование документа [String], необязательно. Возможные значения: 1-УПД, 2 - ТОРГ12
"accompanyingDocumentsNumber": «АБВ-123», // Номер документа-№ [String], поле необязательно.
"accompanyingDocumentsDate":"2013-04-02", // Дата документа [Date], поле необязательно.
"accompanyingDocumentsNumberTTN": «Т-111» // Номер ТТН [String], поле необязательно.
"positionsCount":1, // Количество мест [Number]. Обязательно
"description":"Мебель", // Общее название содержания груза/заказа [String]. Обязательно. Список наименований груза можно получить, используя метод /cargocontent/all/
"orderNumber":"№23434-АБ", // Номер заказа клиента [String], поле необязательно, максимальная длина поля 50 символов
"paymentForm":1, // Форма оплаты (1 - Банк, 2 - Касса) [Number], поле необязательно,
// если значение не указано, равно "Банк" по умолчанию
"typeClientBarcode":"CODE128", // Тип штрих-кодов, указанных для мест грузов заявки [String]
// список допустимых типов штрих-кодов можно получить с помощью метода availabletypebarcode
// тип штрих-кода можно набирать символами любого регистра
"clientPositionsBarcode":[ // Ваши штрих-коды мест груза [Array]. Применимо при подключенной услуге "Приемка по штрих-кодам клиента" и для продукта EasyWay (type 12)
"123654789", // Штрих-код клиента [String]
...
],
"cargoPlaceList": [ // Массив с габаритами каждого грузоместа клиента. Необязательно. Имеет смысл при подключенной услуге "Доверительная приемка".
// Для продукта EasyWay (type 12) услуга подключена по умолчанию (передача данных так же не обязательна).
// Если передан массив с габаритами каждого грузоместа, то проводим проверку на сравнение общих Веса и Объёма груза, переданных в массиве "cargos",
// с суммарными Весом и Объёмом, рассчитанными в массиве грузомест "cargoPlaceList". Должны совпадать. Сначала вычисляем суммарный вес и
// суммарный объём (объём одного грузоместа вычисляем: длина*ширина*высота) по всем элементам массива "cargoPlaceList", затем округляем
// (всегда вверх до сотых!) и сравниваем с общими объёмом и весом в массиве "cargos" (округленными также вверх до сотых!)
{ // если габариты не будут заполненны услуга "Доверительная приемка" не будет оказана
"quantity": 1, // Количество мест одинаковых габаритов [Number]. Обязательно
"weight": 2.5, // Вес одного места, кг [Number]. Обязательно
"length": 0.5, // Длина одного места, м [Number]. Обязательно
"height": 0.5, // Высота одного места, м [Number]. Обязательно
"width": 0.25, // Ширина одного места, м [Number]. Обязательно
"volume": 0.06 //Объем одного места, м3 [Number]. Обязательно
},
{ // если габариты не будут заполнены, услуга "Доверительная приемка" не будет оказана
"quantity": 1, // Количество мест одинаковых габаритов [Number]. Обязательно
"weight": 12, // Вес одного места, кг [Number]. Обязательно
"length": 0.8, // Длина одного места, м [Number]. Обязательно
"height": 0.45, // Высота одного места, м [Number]. Обязательно
"width": 0.45, // Ширина одного места, м [Number]. Обязательно
"volume": 0.16 //Объем одного места, м3 [Number]. Обязательно
}
]
},
"receiver":{ // Получатель [Object]
"GLN": 1234567891234, // Уникальный код идентификации Получателя и его местоположения [Number],
// поле необязательно. Используется только для type = 7 "ДТС Автоперевозка".
// Переданный код GLN имеет приоритет над данными получателя и адресом получения
"warehouseId":"36cf9b5e-a415-11dc-a911-000a5e19ccb4", // Идентификатор конкретного склада получения груза [String]. Необязательно - см.
"addressStock":"Россия, Республика Башкортостан, Уфимский район, село Михайловка, Садовая улица, 9", // Адрес доставки груза [String]. Обязательно при заказе услуги Доставка
// до адреса получателя. Для успешного определения координат адреса доставки,
// передавайте все составляющие адреса в такой последовательности: страна,
// регион, район, населенный пункт, улица, дом, квартира и разделяйте их
// запятыми. Запрещено в данной строке указывать данные, не являющиеся
// частью адреса . При отправке до отделения или ПВЗ и
// заполненном warehouseId данное поле необязательно для заполнения.
// При передаче кода GLN данный параметр имеет меньший приоритет.
"coordinates" : { // Необязательный параметр координат адреса, имеет смысл только при заказанной доставке до адреса
// Если переданы, то имеют приоритет над строкой адреса (информация в строке адреса служит как
// дополнительная и не влияет на определение точки назначения).
"latitude" : "55.761011",
"longitude" : "37.627553"
},
"comment":"второй поворот направо", // Комментарий к доставке [String]. Если заказывается доставка, то в поле указывается комментарий к доставке.
"countryOfRegistrationCode": "643", // Код страны регистрации по классификатору [String].
// Необязательно, рекомендуется к заполнению. По умолчанию: 643 - Россия.
// Для type = 7 "ДТС Автоперевозка" возможные значения: 643 - Россия и 112 - Беларусь
"legalForm": 1, // Тип контрагента [Number]. Обязательно. Значения:
// 1 - Юридическое лицо, 2 - Индивидуальный предприниматель, 3 - Физическое лицо.
// При передаче кода GLN данный параметр имеет меньший приоритет.
"inn":"7716542310", // ИНН [String], обязательно для Юридических лиц и ИП (для физических лиц не передавать).
// При передаче кода GLN данный параметр имеет меньший приоритет.
"kpp":"773301001", // КПП [String], поле необязательно. Если передан ИНН, но не передан КПП, то для юр.лиц будет использован КПП головной организации.
// При передаче кода GLN данный параметр имеет меньший приоритет.
"fs": "ООО", // Сокращенная форма собственности юр.лица/индивидуального предпринимателя (из списка ПЭК) [String].
// При передаче кода GLN данный параметр имеет меньший приоритет.
"title":"Наименование организации", // Наименование юр.лица/ИП или ФИО физ.лица [String]. Обязательно
// При передаче кода GLN данный параметр имеет меньший приоритет.
"individual"{ // Обязательно, если контрагент-получатель - физическое лицо (для юр.лиц и ИП не передавать).
"firstName":"Петр", // Имя или первая буква имени (инициал) [String].
"lastName":"Петров", // Фамилия [String].
"patronymic":"Петрович" // Отчество или первая буква отчества (инициал), если имеется [String].
},
"personPhones": // Список телефонов контактного лица для связи по вопросам доставки груза. Обязательно.
// Список должен содержать не менее 1, но не более 3-х номеров телефонов.
// ВАЖНО! При заказанной услуге "выдача по СМС физ.лицу" допускается передавать только ОДИН
// контактный номер телефона, который умеет принимать СМС. Указание добавочного не допускается.
[
{
"phone": "+74956601111", // Контактный номер телефона получателя [String]. Обязательно.
// Необходимо передавать номер телефона в международном формате через «+»,
// код страны и города обязательны, без пробелов и дополнительных символов ТОЛЬКО цифры,
// например, +74956601111. Максимум 19 символов.
"additional": "1245" // Добавочный номер телефона получателя [String]. Необязательно. Не более 10 цифр
}
],
"person":"Петров Петр", // Контактное лицо [String]. Обязательно.
"email":"example@example.com",// E-mail [String], поле необязательно.
"identityCard":{ // Документ удостоверяющий личность [Object]. Обязательно для Физических лиц (для юр.лиц и ИП не передавать)
"typeGuid":"982d33e2-bee6-453a-992e-11d13fa66fa7", // Уникальный идентификатор типа документа [String], который разрешено использовать
// для страны получения, можно получить методом /branches/countrytypeidentitydocument/.
"series":"1234", // Серия [String].
"number":"56789", // Номер [String].
"date":"1985-01-01", // Дата выдачи документа, удостоверяющего личность [Date].
"note":"", // Служебное поле для других документов [String].
"taxpayerID":"123456789012", // Налоговый номер получателя [String]: ПИН (Кыргызстан), ИИН (Казахстан), УПН (Беларусь) и т.п.
// Обязателен для международных перевозок, но необязателен, если получение в РФ.
"taxpayerCountryCode":"398" // Код страны, выдавшей налоговый номер [String]. Обязателен для международных
// перевозок, но необязателен, если получение в РФ. По умолчанию 643.
}
},
/*
Услуги, заказ которых необязателен имеют поле enabled [Boolean]
Формат объектов "payer" одинаков для всех услуг, поле необязательно, если
услуга опциональная и "enabled":false.
Когда блок "payer" не передан, то плательщиком будет выбран отправитель,
город оплаты - город отправления. Для исключения неоднозначности
рекомендуем всегда прямо указывать плательщика по каждой услуге.
Правила заполнения "paymentCity" для любой услуги см.
*/
"services":{ // Услуги [Object]
"email":"example@example.com", // Email для бухгалтерских уведомлений [String], поле необязательно
"transporting":{ // Перевозка [Object]
"payer":{ // Плательщик [Object] (детальное описание см. ниже)
"type":1,
"paymentCity":"Курск" // Наименование филиала оплаты за услугу [String]. Необязательно. См.
}
},
"pickUp": { // Забор груза [Object]. Обязателен для orderType 3, 4 и 14.
// Для orderType 0 можно не передавать.
"payer": { // Плательщик [Object] (детальное описание см. ниже)
"type": 1, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]. Обязательно.
"paymentCity": "Курск" // Наименование филиала оплаты за услугу [String]. Необязательно. См. комментарий
// Остальные поля не указываются, т.к. плательщик отправитель
}
},
"hardPacking":{ // Защитная транспортировочная упаковка [Object]
"enabled":false, // Заказана ли услуга [Boolean]
"payer":{ // Плательщик [Object] (детальное описание см. ниже)
"type":2,
"paymentCity":"Астрахань" // Наименование филиала оплаты за услугу [String]. Необязательно. См.
}
},
"insurance":{ // Страхование [Object]
"enabled":true, // Заказана ли услуга [Boolean]
"cost": 20000, // Стоимость груза (сумма, на которую будет застрахован груз), руб [Number], поле обязательно, если "enabled":true
"payer":{ // Плательщик [Object]
"type":2,
"paymentCity":"Астрахань" // Наименование филиала оплаты за услугу [String]. Необязательно. См.
}
},
"sealing":{ // Пломбировка [Object]
"enabled":true, // Заказана ли услуга (обязательна только до 3 кг) [Boolean]
"payer":{ // Плательщик [Object]
"type":3, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
"other":{ // Данные о плательщике-третьем лице [Object], поле обязательно если "type":3
"inn":"7716542310", // ИНН третьего лица [String], обязательно для Юридических лиц и ИП (для физических лиц не передавать)
"fs": "ООО", // сокращенная форма собственности юр.лица/индивидуального предпринимателя (из списка ПЭК) [String]. Необзательно.
"countryOfRegistrationCode": "643", // Код страны регистрации по классификатору строка [String]. Необязательно, рекомендуется к заполнению. По умолчанию: 643 - Россия
"legalForm": 1, // Тип контрагента [Number]. Необязательно, если не передан реквизит countryOfRegistrationCode. Рекомендуется к заполнению.
// Значения: 1 - Юридическое лицо, 2 - Индивидуальный предприниматель, 3 - Физическое лицо
// Указание значения 3 недоступно при type = 7 "ДТС Автоперевозка"
"title":"Тестовая компания", // Наименование [String], обязательно
"phone":"894956601111", // Телефон [String], обязательно
"identityCard":{ // Документ удостоверяющий личность [Object]. Обязательно, если плательщик третье лицо (type=3) является Физическом лицом (для юр.лиц и ИП не передавать)
"type": 10, // тип документа [Number]. Возможные значения: 1 - Паспорт (прочие страны),
// 2 - Разрешение на временное проживание, 3 - Водительское удостоверение,
// 4 - Вид на жительство, 6 - Удостоверение беженца, 10 - Паспорт гражданина РФ"
"series":"1234", // Серия [String]
"number":"56789", // Номер [String]
"date":"1985-01-01", // Дата выдачи документа, удостоверяющего личность [Date]
"note":"" // служебное поле для других документов [String]
}
},
"paymentCity":"Астрахань" // Наименование филиала оплаты за услугу [String]. См.
// Обязательно в этом примере, т.к. за услугу sealing плательщик указан третье лицо (type=3).
}
},
"strapping":{ // Упаковка стреппинг-лентой [Object]
"enabled":true, // Заказана ли услуга [Boolean]
"payer":{ // Плательщик [Object]
"type":2,
"paymentCity":"Коломна" // Наименование филиала оплаты за услугу [String]. Необязательно. См.
}
},
"documentsReturning":{ // Возврат документов [Object]
"enabled":false // Заказана ли услуга [Boolean]
},
"delivery":{ // Доставка [Object]
"enabled":true, // Заказана ли услуга [Boolean]
// Заказ услуги обязателен при type = 7 "ДТС Автоперевозка".
"avisationDateTime":"2013-04-02Т00:00:00 ", // Дата и время авизации [DateTime], поле необязательно. По умолчанию передается 00:00:00,
// если время авизации не указанно, доставку будут осуществлять в любое время указанной даты.
// Указывается локальное время по адресу доставки.
"dateOfDelivery": "2013-04-02", // Плановая дата доставки [Date], поле необязательно
"dateOfDeliveryCheck": true // Требуется ли проверять передаваемую дату доставки на предмет ее выполнимости. По умолчанию дата доставки не проверяется. Поле необязательно. [Boolean]
"payer":{ // Плательщик [Object]
"type":2,
"paymentCity":"Волгоград" // Наименование филиала оплаты за услугу [String]. Необязательно. См.
},
"isLoading":true, // Необходима разгрузка силами «ПЭК», поле необязательно [Boolean]
"floor":8, // Этаж, поле необязательно [Number]
"isElevator":true, // Есть лифт, поле необязательно [Boolean]
"carryingDistance":150 // Метры переноски груза, поле необязательно [Number]
},
"storing":{ // Ответственное хранение, поле необязательно [Object]
"enabled":false // Заказана ли услуга [Boolean]
},
"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 - Применяется при использовании иных единиц измерения
}]
}
}
}, // services
"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]
}
] // billingNumbers
} // billing
},
{ // Данные об одном грузе [Object]
...
},
...
] // cargos
}
Формат ответа
{
"documentId": 136, // Номер заявки [Number]
"sender": { // Информация об адресе отправителя
"warehouseID": "36cf9b56-a415-11dc-a911-000a5e19ccb4", // Идентификатор склада отправления. Значение Null, если заказана услуга забора груза от отправителя [String]
"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]
"orderNumber":"12345", // Номер заказа [String]
"stockTitle":"МВ11", // Наименование склада приема груза [String], поле необязательно
"customerCorrelation":"№23434-АБ", // Произвольное значение для синхронизации на стороне клиента [String]
"positions": [ // Информация о местах [Array]
{ // Информация об одном месте [Object]
"barcode":"9999409506440001" // Значение для штрих-кода
// в формате CODE-128/EAN-128 [String]
},
...
],
"clientPositionsBarcode": [ // Штрих-коды мест груза [Array]
"123654789", // Штрих-код клиента [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]
...
]
}
Метод /preregistration/availabletypebarcode/ — Список типов штрих-кодов
Доступ
- Зарегистрированные пользователи
- Сторонние неперсонифицированные приложения, прошедшие проверку
Комментарии
- С помощью метода можно получить список наименований типов штрих-кодов, которые можно указывать для мест грузов при подачи заявки
Формат запроса
{}
Формат ответа
{
[ // Массив типов штрих-кодов [Array]
{
"type": "CODE128" // Тип штрих-кода [String]
},
{"type": "EAN13"},
...
]
}
