Оглавление

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

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

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 : 'SPB', // либо 'Санкт-Петербург'
        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: 'AMR',
        pvz_id: 'RF27141'
      }
      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 Код населенного пункта для доставки.

Для доставки по Спб указать “SPB”, для Москвы - “MSK”. Указание названия города возможно, но для повышения точности рекомендуем передавать его код.

См. Города России для услуги курьерская доставка

Да
address Адрес доставки Подробный адрес доставки Да
date Дата доставки dd.mm.yyyy Да, если доставка по Спб, Мск и их областям. Для остальных регионов не обязательно.
time Временной интервал доставки

Допустимые форматы: “с 10 до 18”, “10:00-18:00”, “с 10:00 до 18:00”.

См. все допустимые интервалы по Москве и Санкт-Петербургу.

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

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

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

Ответ

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

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

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

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

Формирование заказов из товаров на складе

POST /api/take_pkgs_from_goods

Метод позволяет сформировать заказ из товаров, находящихся на складе Glavpunkt.ru При этом формируется электронная накладная.

Параметры метода такие же, как в /api/take_pkgs. Единственное отличие, в массиве заказа надо указывать обязательное поле goods. Поле price сверяется с суммой, равной стоимости передаваемых товаров.

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

{
  login : "userlogin",       // логин интернет-магазина
  token : "xxxx_token_xxxx", // token для авторизации
  comments_client : "создание заказов из товаров",
  punkt_id : "Moskovskaya-A16", // Пункт, где надо сформировать заказы
  orders : [
    {
      serv  : 'выдача',
      sku   : "ТEST-1",
      price : 200, // Общая стоимость всех товаров в заказе, с учетом количества
      goods: [
        {
          good_id: 123, // ID товара
          count: 1 // Кол-во товара
        }
      ]
    },
    {
      serv  : 'выдача',
      sku   : "ТEST-2",
      price : 500,
      goods: [
        {
          good_id: 124,
          count: 2
        },
        {
          good_id: 125,
          count: 3
        }
      ]
    }
  ]
}

Для получения остатков товаров на складе, см. Получить товары, находящиеся в Главпункте

Ответ

если заказы сформированы успешно

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

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

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