====== Формирование этикеток для Pickpoint ======

Для удобства отправки посылок служба доставки Pickpoint разрешает магазинам самостоятельно упаковывать посылки и клеить на них свои этикетки. Из обязательной информации на этикетке должны быть: 
  * Идентификатор точки PickPoint;
  * Название интернет-магазина;
  * Номер отправления;
  * Внутренний номер заказа в интернет магазине;
  * ФИО получателя;
  * Моб. тел. получателя;
  * Штрих-код PickPoint.

Здесь идентификатор точки Pickpoint запрашивается при оформлении заказа, номер отправления получается во время регистрации отправления через API, штрих-код генерируется на основе уникального номера из диапазона выданного службой доставки, остальная информация либо постоянна, либо берется из данных заказа.

Данное решение позволяет организовать формирование PDF-файлов с этикетками для последующей их печати, а также позволяет осуществлять вызов курьера из ЦА.

===== Начальные требования =====

  - Для работы модуля понадобится диапазон значений для формирования штрих-кодов, его можно запросить у поддержки Pickpoint.
  - У заказа должны быть следующие свойства (решение может работать и без них):
    * point_number — Номер пункта выдачи;
    * departure_number — Номер отправления.

===== Установка решения =====

  * Загрузить {{ :private:koding:hostcms:modules:shop:order:deliverystickers.zip |файлы решения}} в корень сайта, среди зависимостей используется [[private:koding:hostcms:reshenija:pdf|решение для генерации PDF-файлов]] и Kad_Module, они уже есть в архиве.
  * Перейти в раздел Система → Модули и добавить новый модуль:
    * Название: «Формирование этикеток»;
    * Путь к модулю: ''deliverystickers'';
    * Снять флажок «Активен»;
    * Нажать на кнопку «Сохранить».
  * В списке модулей зажечь флажок активности.
  * Слева в меню должен появиться раздел «Формирование этикеток».
  * Создать конфигурационный файл с примерно следующим содержанием:<code php><?php

return array(
	'range' => array(111111111, 222222222), // Диапазон, выданный Pickpoint
	'url' => 'http://e-solution.pickpoint.ru/api/',
	'login' => 'login',
	'password' => 'password',
	'ikn' => '3333333331'
);</code>

===== Описание работы =====

Для формирования этикеток переходим в раздел «Формирование этикеток», выбираем заказы, для которых необходимо сформировать этикетки и нажимаем на кнопку «Сформировать». При многократном формировании этикетки для одного и того же заказа ему каждый раз выдается новый штрих-код.

{{:private:koding:hostcms:modules:shop:order:pasted:20180312-093343.png}}

Выше списка заказов появится информация об успешном формировании PDF-файла и ссылка на его скачивание, файлы с этикетками хранятся в директории ''/hostcmsfiles/deliverystickers''.

Файл с этикетками выглядит следующим образом:

{{:private:koding:hostcms:modules:shop:order:pasted:20180312-093502.png}}