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

Группа /cargopickupnetwork/ — операции с сетевыми заявками

Метод /cargopickupnetwork/availabletypebarcode/ — Список типов штрих-кодов

Доступ

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

Комментарии

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

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

{}

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

{
    [ // Массив типов штрих-кодов [Array]
        {
            "type": "CODE128" // Тип штрих-кода [String]
        },
        {"type": "EAN13"},
        ...
    ]
}

Метод /cargopickupnetwork/submit/ — оформление заявки

Доступ

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

Комментарии

  • Максимальное количество грузов в одной заявке (и объектов с информацией о грузах в ответе) — 30
  • Коды грузов и штрих-коды, возвращаемые этим методом являются предварительными и могут изменится при фактической приёмке груза
  • В элементах массива cargos.items[] с данными о грузах необходимо либо указывать данные получателя в объекте cargos.items[].receiver, либо указать код получателя из справочника получателей в поле cargos.items[].receiverCode. Для каждого объекта следует заполнять только одно из этих двух полей, второе следует оставлять пустым.
  • У объекта cargos.items[].services.(услуга).payer.other для услуг pickUp (забор), transporting (перевозка), delivery (доставка), insurance (страховка) добавилось поле paymentCity (город оплаты за услугу), обязательное для заполнения.
  • Можно указать штрих-коды для позиций грузов. Для этого надо во-первых для всей заявки в поле cargos.common.typeClientBarcode указать тип штрих-кода, регистр при указании типа штрих-кода не важен. Список допустимых типов штрих-кодов можно получить с помощью метода /cargopickupnetwork/availabletypebarcode. Для каждого груза нужно указать массив со штрих-кодами позиций груза в поле cargos.items[].cargo.clientPositionsBarcode. Штрих-кодов не должно быть указано больше, чем позиций груза (cargos.items[].cargo.positionsCount).
  • Услуга наложенного платежа cargos.items[].services.cashOnDelivery может быть доступна только при заключении договора на оказание данной услуги.

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

{
  "common":{ // Общие данные по заявке [Object]
    "applicationDate":"2012-05-15", // Дата выполнение заявки [Date]
    "responsiblePerson":"Коновалов Г.В", // ФИО ответственного за оформление заявки [String]

    "description":"Тестовый груз" // Описание груза [String]
                                  // поле обязательно для заполнения, если не во всех грузах заявки
                                  // проставлено описание груза (cargos.items[].cargo.description)
  },
  "sender":{ // Данные об отправителе [Object]
    "inn":"7716542310", // ИНН [String], поле необязательно
    "city":"Омск", // Город отправителя [City]
    "title":"Наименование организации", // Наименование отправителя [String]
    "person":"Иванов Иван Иванович", // Контактное лицо [String]
    "phone":"22-33-44", // Телефон [String]
    "email":"example@example.com", // E-mail [String], поле необязательно
    "addressOffice":"ул. Антонова, д. 2", // Адрес офиса [String]
    "addressStock":"ул. Боровиковского, 17, строение 5", // Адрес склада [String]
    "workTimeFrom":"10:15", // Время начала рабочего дня [Time], поле необязательно
    "workTimeTo":"18:00", // Время окончания рабочего дня [Time], поле необязательно
    "lunchBreakFrom":"14:00", // Время начала обеденного перерыва [Time], поле необязательно
    "lunchBreakTo":"15:00" // Время окончания обеденного перерыва [Time], поле необязательно

  },
  "cargos":{ // Данные о позициях [Object]
    "common":{ // Общие данные для всех позиций [Object], поле необязательно

      /*
        Если этот объект определён, указывать размеры для каждого груза необязательно
      */
      "cargoTotals": { // Общие размеры, объём и весь груза [Object], 
                       // поле необязательно                       
        "volume":10, // Общий объём, м3 [Number]
        "weight":200, // Общий вес, кг [Number]
        "maxDimension":10, // Максимальный габарит, м [Number]
        "positionsCount":5 // Общее количество мест, шт [Number]
      },

      /*
        Структура объектов "payer" одинакова для всех случаев и описывается один раз
      */

      /*
        Если определёны элементы этого объекта, указывать плательщиков
        для каждого груза необязательно (детальнее см. ниже)

        Это можно использовать для реализации сценариев "за доставку всех грузов платит получатель"
        или "за перевозку грузов платит отправитель"
      */
      "services":{ // Определение плательщиков для всех грузов [Object], 
                   // поле необязательно                                       

        "pickUp":{ // Плательщик за услугу забора груза [Object], поле необязательно
           "payer": { // Плательщик [Object]
             "type":3, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
             "other":{ // Данные о плательщике-третьем лице [Object], поле обязательно если "type":3
                "inn":"7716542310", // ИНН, поле необязательно [String]
                "title":"Тестовая компания", // Наименование [String]
                "paymentCity":"Омск", // Город оплаты за услугу [City]
                "phone":"22-33-44" // Телефон [String]
                
                }
            }
        },

        "transporting":{ // Плательщик за услугу перевозки [Object], поле необязательно
          "payer":{ // Плательщик [Object] (детальное описание см. выше)
            "type":1
          }
        },

        "delivery":{ // Плательщик за услугу доставки [Object], поле необязательно
          "payer":{ // Плательщик [Object] (детальное описание см. выше)
            "type":1
          }
        },

        "insurance":{ // Плательщик за услугу страхования [Object], поле необязательно
          "payer":{ // Плательщик [Object] (детальное описание см. выше)
            "type":1
          }
        }

      },
      "typeClientBarcode": "EAN13" // Тип штрих-кодов, указанных для мест грузов заявки [String]
                                   // тип штрих-кода можно набирать символами любого регистра
    },
    "items":[ // Данные о грузах [Array]
      { // Информация об одном грузе [Object]

        // напомню, что надо заполнить только одно из полей receiver и receiverCode.
        "receiver":{ // Получатель [Object]
          "inn":"7716542310", // ИНН [String], поле необязательно
          "city":"Санкт-Петербург", // Город получателя [City]
          "title":"Наименование организации", // Наименование получателя [String]
          "person":"Петров Петр Васильевич", // Контактное лицо [String]
          "phone":"33-44-55"  // Телефон [String]
          
        },
        "receiverCode":"99441e15-8f8a-47b7-ab3c-41d38d0705c3", // Код получателя из справочника [String]

        "cargo":{ // Параметры груза [Object]
          "transporting":1, // Тип перевозки (1 - авто, 2 - авиа) [Number]

          "description": "обувь", // Описание груза [String]
                                  // поле обязательно для всех грузов если не заполнено
                                  // общее описание для заявки (common.description)

          "orderNumber":"№23434-АБ", // Номер заказа клиента [String], поле необязательно
          "weight":2.5, // Вес, кг [Number], поле необязательно, если указаны общие данные
          "volume":0.1, // Объём, м3 [Number], поле необязательно, если указаны общие данные
          "width":0.12, // Ширина, м [Number], поле необязательно, если указаны общие данные
          "length":0.3, // Длина, м [Number], поле необязательно, если указаны общие данные
          "height":0.4, // Высота, м [Number], поле необязательно, если указаны общие данные
          "positionsCount":2 // Количество мест, шт [Number],
                             // поле необязательно, если указаны общие данные
          "clientPositionsBarcode": [ // Штрих-коды мест груза [Array]
                                      // Если для груза заданы штрих-коды для заявки обязательно
                                      // указать тип используемых штрих-кодов
                                      // cargos.common.typeClientBarcode
                "123654789", // Штрих-код клиента [String]
                ...
            ]
        },
        "conditions":{ // Условия перевозки [Object]
          "isOpenCar":false, // Необходима открытая машина [Boolean] 
          "isSideLoad":true, // Необходима боковая погрузка [Boolean]
          "isDayByDay":false, // Необходим забор день в день [Boolean]
          "isSpecialEquipment":false, // Необходимо специальное оборудование [Boolean], 
                                      // поле необязательно, если не указано считается равным false
          "isUncovered":false, // Необходима растентовка [Boolean], 
                               // поле необязательно, если не указано считается равным false
          "isFast":true, // Необходима скоростная перевозка [Boolean]
          "isLoading":false // Необходима погрузка силами «ПЭК» [Boolean]
        },
        "services":{ // Услуги [Object]
          "pickUp":{ // Услуга забора груза [Object], 
                     // поле необязательно, если указан плательщик за эту услугу
                     // для всех грузов
            "payer":{  // Плательщик [Object] (детальное описание см. выше)
              "type":2
            }
          },
          "transporting":{ // Перевозка [Object]
                           // поле необязательно, если указан плательщик за эту услугу
                           // для всех грузов
            "payer":{ // Плательщик [Object] (детальное описание см. выше)
             "type":1
            }
          },

          /* 
            Услуги, заказ которых необязателен имеют поле enabled [Boolean]
			
            Для услуг доставки и страхования поле "payer" необязательно, если выполняется одно 
            из двух условий:
              а) "enabled":false (т.е. услуга не заказана)
              б) "enabled":true и данные о плательщике определены в объекте cargos.common.services
                 (т.е. услуга заказана и данные о плательщике указаны для всех позиций сразу)

            Для остальных услуг поле "payer" обязательно, если услуга заказана ("enabled":true)

            Допустимо переопределять плательщиков, к примеру: в наборе из 10 грузов за перевозку 9
            платит отправитель, а за перевозку одного — получатель. В этом случае в объекте
            cargos.common.services можно указать плательщиком за услугу перевозки для всех грузов
            отправителя (и не указывать отдельно для каждого из них), а для единственного груза 
            за перевозку которого платит получатель указать плательщика в этом объекте.
          */

          "delivery":{ // Доставка [Object]
            "enabled":true, // Заказана ли услуга [Boolean]
            "avisationDateTime": "2013-04-02", // Дата авизации [DateTime], поле необязательно
            "address":"ул. Садовая 2, кв. 5", // Адрес доставки [String], 
                                             // поле обязательно, если "enabled":true
            "payer":{ // Плательщик [Object] (детальное описание см. выше),
                      // поле необязательно при определённых условиях (см. выше)
              "type":1
            }
          },

          "insurance":{ // Страховка [Object]
            "enabled":true, // Заказана ли услуга [Boolean]
            "cost":20000.25, // Оценочная стоимость, руб [Number], 
                            // поле обязательно, если "enabled":true
            "payer":{ // Плательщик [Object] (детальное описание см. выше),
                      // поле необязательно при определённых условиях (см. выше)
              "type":1
            }
          },

          "documentsReturning":{ // Возврат документов [Object]
            "enabled":true, // Заказана ли услуга [Boolean]
            "payer":{ // Плательщик [Object] (детальное описание см. выше),
                      // поле необязательно при определённых условиях (см. выше)
              "type":1 
            }
          },
          
          "strapping":{ // Упаковка стреппинг-лентой [Object]
            "enabled":false // Заказана ли услуга [Boolean]
          },
        
          "sealing":{ // Пломбировка [Object]
            "enabled":true, // Заказана ли услуга [Boolean]
            "positionsCount":12, // Количество мест для пломбировки [Number]
            "payer":{ // Плательщик [Object] (детальное описание см. выше),
                      // поле необязательно при определённых условиях (см. выше)
              "type":3,
              "other":{
                "inn":"7716542310",
                "title":"Тестовая компания",
                "phone":"22-33-44"
              }
            }
          },

          "hardPacking":{ // Защитная транспортировочная упаковка [Object]
            "enabled":true, // Заказана ли услуга [Boolean]
            "positionsCount":5, // Количество мест в ЗТУ [Number]
            "payer":{ // Плательщик [Object] (детальное описание см. выше),
                      // поле необязательно при определённых условиях (см. выше)
              "type":1
            }
          },
    
          "cashOnDelivery": {
              "enabled": true, // Заказана услуга наложенного платежа
              "cashOnDeliverySum":456.26, // Общая стоимость заказа (сумма НП) обязательно, если заказана услуга НП [Number]
              "actualCost":789.36, // Объявленная стоимость товара, обязательно для НП [Number]
              "includeTES":false // За услуги платит отправитель из суммы НП [Boolean]
          }
        }
      },
    	 
      {  // Информация об одном грузе [Object]
        ... 
      }

      ... 

    ] // items
  }
}

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

{
  "documentId": 16, // Номер заявки [Number]
  "cargos":[ // Информация о принятии данных грузов, описанных в заявках [Array]
    { // Объект с информацией о приёме одной заявки [Object]
        "cargoCode": "МВПТЗВА-1/1603", // Код груза [String]
        "barсode": "1234567890123" // Значение для штрих-кода в формате EAN-13 [String]
        "orderNumber": "12345" // Номер заказа [String]
        "positions": [ // Информация о местах [Array]
          { // Информация об одном месте [Object]
            "barcode": "12345678901230001" // Значение для штрих-кода 
                                           // в формате CODE-128/EAN-128 [String]
          },
          ...
        ],
        "typeClientBarcode": "EAN13", // Тип штрих-кода [String]
        "clientPositionsBarcode": [ // Штрих-коды клиента [Array]
            "123654789", // штрих-код клиента [String]
            "123654798",
            ...
        ]
    }, 
    ...
  ]
}
Онлайн-чат

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