Оглавление

Создание заказов

Передача заказов в пункт

POST /api/take_pkgs

Передает в систему Glavpunkt.ru данные об отгружаемых заказах, при этом формируется электронная накладная.

Метод позволяет создавать следующие виды заказов:

  1. Выдача в ПВЗ Санкт-Петербурга и Москвы
  2. Курьерская доставка по Санкт-Петербургу и Москве
  3. Выдача по РФ (с отгрузкой только в Санкт-Петербурге)

Пример запроса

{
  login : "userlogin",       // логин интернет-магазина
  token : "xxxx_token_xxxx", // token для авторизации
  comments_client : "комментарий к накладной",
  punkt_id : "Moskovskaya-A16", // Пункт отгрузки заказов
  orders : [
    { // Заказ на выдачу в ПВЗ Санкт-Петербурга
      serv  : 'выдача',
      sku   : "ТEST-1",
      price : 123
    },
    { // Заказ на выдачу в ПВЗ Москвы
      serv  : 'выдача',
      sku   : "ТEST-2",
      price : 123,
      dst_punkt_id: "Msk-Avtozavodskaya-M6" // Пункт в Москве, в котором надо выдать заказ
    },
    { // Заказ на курьерскую доставку
      serv : 'курьерская доставка',
      sku  : "ТEST-2",
      barcode : "830467",
      is_prepaid : 1,
      price : 1000,
      buyer_phone : "79001112233",
      weight: 1,
      delivery: { // Параметры курьерской доставки
        city : "По Петербургу",
        address: "ул. Маяковского д.9",
        date: "25.11.2016",
        time: "с 10 до 18"
      }
    },
    { // Заказ на выдачу по РФ
      serv : 'выдача по РФ',
      sku  : "ТEST-3",
      barcode : "830467",
      price : 5000,
      buyer_phone : "79001112233",
      weight: 1,
      delivery_rf: { // Параметры выдачи по РФ
        city_id: '229',
        pvz_id: '89011'
      }
      client_delivery_price: 100
    }
  ]
}

Справочник параметров заказа

Название параметра Описание Возможные значения Обязательный?
serv Тип заказа выдача‘, ‘курьерская доставка‘, ‘выдача по РФ Да
sku Номер заказа Произвольная строка длиной до 100 символов Да, должен быть уникальным
price Цена заказа / оценочная стоимость (если заказ предоплачен) Положительное число Да
client_delivery_price Стоимость доставки для клиента. Использыется для расчета стоимости к оплате клиентом Положительное число (по-умолчанию ‘0‘) Нет
weight Вес заказа Вес в кг (до 10 кг) Обязательно для следующих типов заказов: ‘курьерская доставка‘,’выдача по РФ‘ и заказов на перемещение
barcode Штрих-код заказа Произвольная строка длиной до 100 символов Нет
is_prepaid Признак, что заказ предоплачен 1‘ если заказ предоплачен, ‘0‘ - не предоплачен (по-умолчанию ‘0‘) Нет
buyer_fio ФИО клиента Произвольная строка длиной до 255 символов Нет
buyer_phone Телефон клиента Указывайте телефон, на который клиент сможет получить SMS с информацией о прибытии заказа в ПВЗ. Пример: 79001112233 Обязательно для заказов с типом ‘курьерская доставка
comment Комментарий к заказу Произвольная строка длиной до 255 символов Нет
dst_punkt_id ID пункта назначения в случае перемещения заказа См. Список ПВЗ в Спб и Мск Нет
items_count Количество мест в заказе Не более 20 мест (по-умолчанию ‘1‘) Нет
partial_giveout_disabled Выдача заказа по частям запрещена 1‘ если заказ нельзя выдавать частично (по-умолчанию ‘0‘) Нет
delivery Параметры курьерской доставки См. Параметры курьерской доставки Обязательно для заказа: ‘курьерская доставка
delivery_rf Доступно только для заказов, отгружаемых на ПВЗ в г. Санкт-Петербург. Параметры выдачи заказа по РФ См. Параметры выдачи заказа по РФ Обязательно для заказа: ‘выдача по РФ

Параметры курьерской доставки

Название параметра Описание Возможные значения Обязательный?
city Населенный пункт для доставки

Для доставки по Спб указать “По Петербургу”, для Москвы - “По Москве”.

Для доставки по Ленинградской области см. Населенные пункты лен.области для курьерской доставки

Для доставки по Московской области см. Населенные пункты мос.области для курьерской доставки

Да
address Адрес доставки Подробный адрес доставки Да
date Дата доставки dd.mm.yyyy Да
time Временной интервал доставки Например, “с 10 до 18” Да
18_21 Доставить в вечерний интервал. Стоимость доставки возрастает на 50%. Доступно только для заказов с доставкой “По Петербургу” (не включая область) 1‘ если необходимо, ‘0‘ - если не требуется (по-умолчанию ‘0‘) Нет

Параметры выдачи заказа по РФ

Название параметра Описание Возможные значения Обязательный?
city_id Код города доставки См Города России (для услуги выдача по РФ) Да
pvz_id Код пункта выдачи в указанном городе См Список пунктов для выдачи по РФ Да

Ответ

если заказы сохранены успешно

{
   result : "ok",
   docnum : 2123 // номер накладной
}

если произошла ошибка

{
   result  : "error",
   message : "сообщение об ошибке"
}