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

Группа /preregistration/ — предварительное оформление грузов

Метод /preregistration/submit/ — подача заявки на предварительное оформление

Доступ

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

Комментарии

  • Максимальное количество грузов в одной заявке (и объектов с информацией о грузах в ответе) — 30
  • Коды грузов и штрих-коды, возвращаемые этим методом являются предварительными и могут изменится при фактической приёмке груза
  • Указывая получателей для грузов можно указать данные получателя как в объекте cargos[].receiver, так и указав код получателя из справочника получателей в поле cargos[].receiverCode. Для одного груза надо заполнить только одно из этих полей (объект cargos[].receiver или код cargos[].receiverCode).
  • Услуга наложенного платежа cargos[].services.cashOnDelivery может быть доступна только при заключении договора на оказание данной услуги.
  • Замечания по валидации
    • В случае, если в городе получателя cargos[].receiver.city нет филиала ПЭК, и этот город не является одним из городов "Золотого Кольца", обязателен заказ услуги "доставка" cargos[].services.delivery для этого груза.
    • В случае, если город получателя cargos[].receiver.city груза совпадает с городом отправителя заявки sender.city, обязательно заказывать услугу "доставка" cargos[].services.delivery для этого груза.
    • Для груза обязательно заказывать услугу "доставка" cargos[].services.delivery, если для него выбрана услуга "возврат документов" cargos[].services.documentsReturning.
    • При заказе услуги наложенного платежа cargos[].services.cashOnDelivery сумма сопроводительных документов cargos[].common.accompanyingDocumentsSum и заявленная стоимость груза cargos[].services.insurance.cost устанавливаются равными фактической стоимости товара cargos[].common.actualCost.
    • Установка соответствующего значения в поле includeTES позволяет настраивать включение транспортно-экспедиционных услуг (ТЭУ) в сумму наложенного платежа (НП) для каждого груза или исключение ТЭУ из суммы НП: true— за услуги платит отправитель из суммы НП, false— за услуги платит получатель сверх суммы НП.
    • При указании идентификатора склада cargos[].receiver.warehouseId (его можно выбрать из справочника филиалов, поле branches[].warehouses[].id) следует помнить, что он будет проигнорирован, если заказана услуга доставки.

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

{
  "sender":{ // Данные об отправителе [Object]
    "inn":"7716512010", // ИНН [String], поле необязательно
    "city":"Москва Восток", // Город [String]
    "fs":"ЗАО", // Форма собственности [String], поле необязательно
    "title":"Наименование организации", // Наименование отправителя [String]
    "phone":"22-33-44", // Телефон [String]
    "phoneAdditional":"1234", // добавочный номер (максимум 10 символов) [String]
    "person":"Иванов Иван", // Контактное лицо [String]
    "warehouseId":"521fc4dd-6650-11e3-a392-00155d505c08", // Идентификатор склада [String]
    "identityCard":{ // Документ удостоверяющий личность  [Object]
        "type": 10, // тип документа [Number] (1 - ПАСПОРТ ИНОСТРАННОГО ГРАЖДАНИНА,
                    // 2 - РАЗРЕШЕННИЕ НА ВРЕМЕННОЕ ПРОЖИВАНИЕ, 3 - ВОДИТЕЛЬСКОЕ УДОСТОВЕРЕНИЕ,
                    // 4 - ВИД НА ЖИТЕЛЬСТВО, 5 - ЗАГРАНИЧНЫЙ ПАСПОРТ, 6 - УДОСТОВЕРЕНИЕ БЕЖЕНЦА,
                    // 7 - ВРЕМЕННОЕ УДОСТОВЕРЕНИЕ ЛИЧНОСТИ ГРАЖДАНИНА РФ, 
                    // 8 - СВИДЕТЕЛЬСТВО О ПРЕДОСТАВЛЕНИИ ВРЕМЕННОГО УБЕЖИЩА НА ТЕРРИТОРИИ РФ,
                    // 9 - ПАСПОРТ МОРЯКА, 10 - ПАСПОРТ ГРАЖДАНИНА РФ, 
                    // 11 - СВИДЕТЕЛЬСТВО О РАССМОТРЕНИИ ХОДАТАЙСТВА О ПРИЗНАНИИ БЕЖЕНЦЕМ,
                    // 12 - ВОЕННЫЙ  БИЛЕТ)
        "series":"1234", // Серия [String]
        "number":"56789", // Номер [String]
        "date":"1985-01-01", // Дата [DateTime]
        "note":"" // служебное поле для других документов [String]
    }
  },
  "cargos":[ // Данные о грузах [Array]
    { // Данные об одном грузе [Object]
      "common":{ // Общие данные о грузе [Object]
        "type":"3", // Тип перевозки (1 - Авиаперевозка, 3 - Автоперевозка) [Number]
        "weight":10, // Общий вес груза, кг [Number], в данный момент поле необязательно
        "volume":0.3, // Общий объём груза, м3 [Number], поле необязательно
        "width":0.12, // Ширина, м [Number], поле необязательно
        "length":0.3, // Длина, м [Number], поле необязательно
        "height":0.4, // Высота, м [Number], поле необязательно
        
        "actualCost":789.36, // Объявленная стоимость товара, обязательно для НП [Number]
        "includeTES":false, // За услуги платит получатель сверх суммы НП [Boolean]
        "accompanyingDocuments":true, // Есть комплект сопроводительных документов [Boolean]
        "accompanyingDocumentsNumbers":"№34-БВ, №23-БВ", // Номера сопроводительных 
                                                         // документов [String], 
                                                         // поле обязательно, если 
                                                         // "accompanyingDocuments":true 
        "accompanyingDocumentsSum":124.02, // Сумма сопроводительных документов [Number], 
                                           // поле обязательно, если "accompanyingDocuments":true 
        "positionsCount":1, // Количество мест [Number]
        "description":"Мебель", // Описание груза [String]
        "orderNumber":"№23434-АБ", // Номер заказа клиента [String], поле необязательно
        "paymentForm":1, // Форма оплаты (1 - Банк, 2 - Касса) [Number], поле необязательно,
                         // если значение не указано, равно "Банк" по умолчанию
        "typeClientBarcode":"CODE128", // Тип штрих-кодов, указанных для мест грузов заявки [String]
                                    // тип штрих-кода можно набирать символами любого регистра
        "clientPriority":1, // приоритет [Number]
        "clientPositionsBarcode":[     // Штрих-коды мест груза [Array]
                "123654789", // Штрих-код клиента [String]
                ...
                ],

        
      },

      // напомню, что для одного груза надо заполнить только одно из полей receiver и receiverCode.
      "receiver":{ // Получатель [Object]
        "inn":"7716542310", // ИНН [String], поле необязательно
        "city":"Санкт-Петербург Обухово", // Город получателя [City]
        "fs":"ЗАО", // Форма собственности [String], поле необязательно
        "title":"Наименование организации", // Наименование получателя [String]
        "phone":"88-99-00", // Телефон [String]
        "phoneAdditional":"1234", // добавочный номер (максимум 10 символов) [String]
        "comment":"второй поворот направо", // Комментарий [String]
        "addressStock":"ул. Саровского, 11", // Адрес склада [String], поле необязательно
        "person":"Петров Петр", // Контактное лицо [String]
        "warehouseId":"36cf9b5e-a415-11dc-a911-000a5e19ccb4", // Идентификатор склада [String]
        "identityCard":{ // Документ удостоверяющий личность  [Object]
            "type": 10, // тип документа [Number] (1 - ПАСПОРТ ИНОСТРАННОГО ГРАЖДАНИНА,
                        // 2 - РАЗРЕШЕННИЕ НА ВРЕМЕННОЕ ПРОЖИВАНИЕ, 3 - ВОДИТЕЛЬСКОЕ УДОСТОВЕРЕНИЕ,
                        // 4 - ВИД НА ЖИТЕЛЬСТВО, 5 - ЗАГРАНИЧНЫЙ ПАСПОРТ, 6 - УДОСТОВЕРЕНИЕ БЕЖЕНЦА,
                        // 7 - ВРЕМЕННОЕ УДОСТОВЕРЕНИЕ ЛИЧНОСТИ ГРАЖДАНИНА РФ, 
                        // 8 - СВИДЕТЕЛЬСТВО О ПРЕДОСТАВЛЕНИИ ВРЕМЕННОГО УБЕЖИЩА НА ТЕРРИТОРИИ РФ,
                        // 9 - ПАСПОРТ МОРЯКА, 10 - ПАСПОРТ ГРАЖДАНИНА РФ, 
                        // 11 - СВИДЕТЕЛЬСТВО О РАССМОТРЕНИИ ХОДАТАЙСТВА О ПРИЗНАНИИ БЕЖЕНЦЕМ,
                        // 12 - ВОЕННЫЙ  БИЛЕТ)
            "series":"1234", // Серия [String]
            "number":"56789", // Номер [String]
            "date":"1985-01-01", // Дата [DateTime]
            "note":"" // служебное поле для других документов [String]
        }
      },
      "receiverCode":"99441e15-8f8a-47b7-ab3c-41d38d0705c3", // Код получателя из справочника [String]

      /* 
          Услуги, заказ которых необязателен имеют поле enabled [Boolean]
          Формат объектов "payer" одинаков для всех услуг, поле необязательно, если
          услуга опциональная и "enabled":false.           
      */
      "services":{ // Услуги [Object]
        "email":"example@example.com", // Email для бухгалтерских уведомлений [String], поле необязательно
        "transporting":{ // Перевозка [Object]
          "payer":{ // Плательщик [Object] (детальное описание см. ниже)
            "type":1,
            "paymentCity":"Курск" // Город оплаты за услугу [City]
          }
        },
        "hardPacking":{ // Защитная транспортировочная упаковка [Object]
          "enabled":false, // Заказана ли услуга [Boolean]          
        },
        	
        "insurance":{ // Страхование [Object]
          "enabled":true, // Заказана ли услуга [Boolean]
          "cost": 20000, // Оценочная стоимость, руб [Number], поле обязательно, если "enabled":true
          "payer":{ // Плательщик [Object]
            "type":2,
            "paymentCity":"Астрахань" // Город оплаты за услугу [City]
          }
        },
        "sealing":{ // Пломбировка [Object]
          "enabled":true, // Заказана ли услуга [Boolean]
          "payer":{ // Плательщик [Object]
            "type":3, // Плательщик (1 - отправитель, 2 - получатель, 3 - третье лицо) [Number]
            "other":{ // Данные о плательщике-третьем лице [Object], поле обязательно если "type":3
              "inn":"7716542310", // ИНН, поле необязательно [String]
              "title":"Тестовая компания", // Наименование [String]
              "phone":"22-33-44", // Телефон [String]
              "identityCard":{ // Документ удостоверяющий личность  [Object]
                    "type": 10, // тип документа [Number] (1 - ПАСПОРТ ИНОСТРАННОГО ГРАЖДАНИНА,
                                // 2 - РАЗРЕШЕННИЕ НА ВРЕМЕННОЕ ПРОЖИВАНИЕ, 3 - ВОДИТЕЛЬСКОЕ УДОСТОВЕРЕНИЕ,
                                // 4 - ВИД НА ЖИТЕЛЬСТВО, 5 - ЗАГРАНИЧНЫЙ ПАСПОРТ, 6 - УДОСТОВЕРЕНИЕ БЕЖЕНЦА,
                                // 7 - ВРЕМЕННОЕ УДОСТОВЕРЕНИЕ ЛИЧНОСТИ ГРАЖДАНИНА РФ, 
                                // 8 - СВИДЕТЕЛЬСТВО О ПРЕДОСТАВЛЕНИИ ВРЕМЕННОГО УБЕЖИЩА НА ТЕРРИТОРИИ РФ,
                                // 9 - ПАСПОРТ МОРЯКА, 10 - ПАСПОРТ ГРАЖДАНИНА РФ, 
                                // 11 - СВИДЕТЕЛЬСТВО О РАССМОТРЕНИИ ХОДАТАЙСТВА О ПРИЗНАНИИ БЕЖЕНЦЕМ,
                                // 12 - ВОЕННЫЙ  БИЛЕТ)
                    "series":"1234", // Серия [String]
                    "number":"56789", // Номер [String]
                    "date":"1985-01-01", // Дата [DateTime]
                    "note":"" // служебное поле для других документов [String]
              }
            },
            "paymentCity":"Астрахань" // Город оплаты за услугу [City]
          }
        },
        "strapping":{ // Упаковка стреппинг-лентой [Object]
          "enabled":true, // Заказана ли услуга [Boolean]
          "payer":{ // Плательщик [Object]
            "type":2,
            "paymentCity":"Коломна" // Город оплаты за услугу [City]
          }
        },
        "documentsReturning":{ // Возврат документов [Object]
          "enabled":false // Заказана ли услуга [Boolean]
        },
        "delivery":{ // Доставка [Object]
          "enabled":true, // Заказана ли услуга [Boolean]
          "avisationDateTime":"2013-04-02", // Дата авизации [DateTime], поле необязательно
          "payer":{ // Плательщик [Object]
            "type":2,
            "paymentCity":"Волгоград" // Город оплаты за услугу [City]
          },
          "isLoading":true, // Необходима погрузка силами «ПЭК», поле необязательно [Boolean]
          "floor":8, // Этаж, поле необязательно [Number]
          "isElevator":true, // Есть лифт, поле необязательно [Boolean]
          "carryingDistance":150 // Метры переноски груза, поле необязательно [Number]
        },
        "storing":{ // Ответственное хранение, поле необязательно [Object]
          "enabled":false // Заказана ли услуга [Boolean]
        },
        "cashOnDelivery":{ // Наложенный платеж [Object]
            "enabled":true, // Заказана услуга наложенного платежа [Boolean], поле обязательно, если заказана услуга НП [Number]
            "cashOnDeliverySum":456.26, // Общая стоимость заказа (сумма НП) [Number]
            "actualCost":789.36, // Объявленная стоимость товара [Number]
            "includeTES":false, // За услуги платит получатель сверх суммы НП [Boolean]
            "isPartialDistributionAllowed":true, // Возможна частичная выдача [Boolean], поле необязательно      
            "isOpenAndInspectAllowed":true, // Возможно вскрытие и внутритарный осмотр [Boolean], поле необязательно
            "orderNumber":"№23434-АБ", // Номер заказа клиента [String], поле необязательно
            "sellerINN":"7716542310", // ИНН отправителя (продавца) [String], поле необязательно
            "sellerTitle":"Наименование организации", // Наименование отправителя (продавца) [String], поле необязательно
            "sellerPhone":"88-99-00", // Телефон [String], поле необязательно
            "sellerServices":[{ // Дополнительные услуги [Object]
               "type":1, // Список дополнительных услуг, предоставляемых Грузотправителем [Number]
                         // 1 - Доставка,
                         // 2 - Курьерская доставка,
                         // 3 - Доставка и выдача на терминале,
                         // 4 - Доставка и выдача на ПВЗ,
                         // 5 - Подъем на этаж
                "rateVAT": "НДС18", // Ставка НДС [String]
                "sumIncludingVAT": 68403.17, // Стоимость дополнительных услуг, в т.ч. НДС, руб. [Number]        
            }],
            "specification":{ // Частичная выдача груза [Object] 
              "takeDeliveryZeroSum":true, // Брать сумму «доставки» при полном отказе получателя [Boolean]
              "amountDeliveryMandatory":300, // Обязательная сумма доставки. Обязательно если takeDeliveryZeroSum = true [Number]
              "specifications":[{ // состав спецификации
                "vendorCode":"32711600Y", // Артикул [String]
                "title":"Гофра AlcaPlast A75", // Наименование позиции [String]
                "amount":1, // Количество [Number]
                "kit":true, // Комплект [Boolean]
                "rateVAT": "18%", // Ставка НДС [String]
                "actualCostPerUnit":123.36, // Объявленная ценность за ед., в т.ч. НДС, руб. [Number]
                "sumPerUnit":123.36, // К оплате с Грузополучателя за ед., в т.ч. НДС, руб. [Number]
                "actualCostTotal":123.36, // Объявленная ценность всего, руб., в т.ч. НДС [Number]
                "sumTotal":123.36, // К оплате с Грузополучателя всего, руб., в т.ч. НДС, руб. [Number]
                "fitting":true, // Примерка [Boolean]
                "openingIndividualPacking":true // Вскрытие инд. упаковки [Boolean]
               }]
         }
       } // services
      
       "billing":{ // Биллинг [Object], необязательное поле
         "billingNumbers":[ // Номера по биллингу
           { // Объект номера по биллингу [Object]
             "billingNo":"БС-23417КЛМ", // Номер по биллингу [String]
             "billingSum": 900000 // Сумма по биллингу [Number]
           },
           { // Объект номера по биллингу [Object]
             "billingNo":"97923FR19C", // Номер по биллингу [String]
             "billingSum": 1000000 // Сумма по биллингу [Number]
           }
         ] // billingNumbers
       } // billing    
    },

    { // Данные об одном грузе [Object]
       ...
    },

    ...

  ] // cargos
}

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

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

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