Универсальный передаточный документ (УПД) представляет собой унифицированный документ, который включает в себя счет-фактуру, дополненный реквизитами первичного документа об отгрузке и приемке товара. 

Универсальный передаточный документ заполняется на основании данных чека продажи и карты клиента. Полнота УПД обеспечивается наличием в БД Dictionaries следующих таблиц:

• Client. Связка с организацией, на которую будет выписан УПД осуществляется по полю organizationcode.
• Organization. В данном случае под организацией понимаются юридические лица, которые являются клиентами торговой сети (в УПД этими данными заполняется раздел Покупатель).
• Shop. Указываются данные продавца и грузоотправителя (в УПД этими данными заполняется раздел Продавец).
• Tmc. Поле manufacturercountrycode, в котором указывается связка с таблицей стран-производителей Country.
• Country. Страна происхождения товара.

Настройка принтера (на примере принтеров HP)

Для возможности печати УПД из кассы необходимо выполнить следующие шаги:

1. Установить пакет artix45-print, выполнив команду:

   aptitude install artix45-print

   Пакет используется для конвертации документов из формата html (в котором формируется отчет) в pdf (в котором выполняется печать отчета).

2. Подключить и настроить принтер. Для этого:

   1. Указать репозиторий для скачивания и установки пакета, содержащего библиотеки для работы с принтером:

      Для trusty

      deb http://ru.archive.ubuntu.com/ubuntu/ trusty main restricted universe

      Для lucid

      deb http://update.artix.su/ubuntu lucid-security main multiverse restricted universe
      deb http://update.artix.su/repository/ubuntu lucid-updates main multiverse restricted universe
      deb http://update.artix.su/repository/ubuntu lucid main multiverse restricted universe

   2. После указания репозитория необходимо установить пакет hplip, выполнив команду:

      aptitude install hplip

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

      hp-setup -i

      При настройке принтера указать последовательно данные:

      1. usb

      2. download plug-in from HP

      3. accept the license terms for plug-in

      4. use model name:...

      5. PPD file is correct
      6. "some printer description"
      7. Enter
      8. Print test page

   4. Установить пакет cups, обеспечивающий управление принтером из ОС Ubuntu, выполнив команду:

      aptitude install cups

   5. Настроить пакет cups в конфигурационном файле /etc/cups/cupsd.conf, указав в нем ip-адрес кассы и порт 631.
3. Для возможности просмотра настроек принтера и задач на печать необходимо:

   1. Выполнить команды:

      Для lucid

      service cups restart

      Для trusty

      service cups restart
      service cups-browsed restart

   2. Для встроенного браузера указать ссылку на страницу https://<ip-адрес_кассы>:631/

Печать универсального передаточного документа

Автоматическая печать

Для автоматической печати универсального передаточного документа необходимо, чтобы в карточке клиента был заполнен уникальный код организации (БД Dictionaries таблица Client поле organizationcode).

Для печати универсального передаточного документа необходимо включить плагин printwaybill в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d в секции [plugins].

• при значении on при закрытии чека печатается счет-фактура. Поведение по умолчанию;
• при значении off при закрытии чека счет-фактура не печатается.

[plugins]
; Включение и выключение плагина для возможности печати счета-фактуры
; по умолчанию on
printwaybill = on

Кассовое ПО запрашивает номер УПД с кассового сервера (КС, ЦКС или МКС). Подключение к серверу настраивается в секции [Waybill] в конфигурационном файле /linuxcash/cash/conf/ncash.ini.

[Waybill]

; Адрес сервера, на который отправляются запросы на получение и обновление статуса номера счета-фактуры. По умолчанию http://localhost:8080
; serverUrl = "http://localhost:8080"

; Таймаут обращения к серверу в секундах. По умолчанию 30
; timeout = 30

; Количество экземпляров передаточного документа, которое нужно распечатать при закрытии чека (если печать была подтверждена)
; По умочанию 2
; numberToPrint = 2

При добавлении карты клиента в чек проверяется наличие кода организации, который свидетельствует о том, что карта выдана на юридическое лицо. Если поле заполнено, то при добавлении карты на экран выводится диалоговое окно с сообщением "Выполнить печать счета-фактуры при закрытии чека?".

• При подтверждении операции выполняется запрос на сервер для получения номера УПД.
  • Если номер успешно получен, то после закрытия чека будет напечатан УПД, в БД Documents в таблицу Document в поле waybillprinted будет установлено значение 1 (УПД напечатан), а в поле waybillnumber полученный номер УПД.
  • Если при получении номера УПД произошла ошибка, то на экране кассира отобразится сообщение "Не удалось получить номер счета-фактуры. Повторить? Иначе счет-фактура не будет напечатан".
• При отказе от печати СФ после закрытия чека продажи УПД не печатается, поля waybillprinted и waybillnumber не заполняются.

Задать количество распечатанных экземпляров УПД можно при помощи параметра numberToPrint в секции [Waybill] в конфигурационном файле /linuxcash/cash/conf/ncash.ini. По умолчанию печатается 2 экземпляра УПД.

При замене карты в чеке требуется повторно подтвердить необходимость печати УПД. Если в чек была добавлена еще одна карта с привязкой к юр.лицу, то подтверждение не требуется, УПД будет напечатан на юр.лицо из последней добавленной карты.

Запрет продажи алкоголя на юридическое лицо

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

• Если чек содержит алкогольную продукцию, то при подтверждении печати счета-фактуры на экран будет выведено предупреждение "Продажа алкоголя на юридическое лицо запрещена. Алкогольную продукцию необходимо сторнировать из чека". При попытке закрыть чек без сторнирования алкогольной продукции, предупреждение будет выведено повторно.
• Если печать счета-фактуры была подтверждена, то при попытке добавления алкогольной продукции в чек на экран будет выведено предупреждение "Продажа алкоголя на юридическое лицо запрещена. Товар не может быть добавлен в чек".

Печать по кнопке

Печать УПД последнего закрытого документа

Для настройки печати универсального передаточного документа необходимо в утилите администрирования Yuki задать клавишу с действием "Печать УПД" и назначить этому действию команду COMMAND_OPERATION. В параметрах действия необходимо указать:

Печать универсального передаточного документа выполняется по нажатию клавиши "Печать УПД". Печать документа производится в соответствии с настроенными правилами печати отчета.

Печать УПД для ранее закрытых документов

Для печати копии УПД (счета-фактуры) по кнопке в утилите администрирования Yuki необходимо настроить пункт меню "Печать УПД" с командой COMMAND_PRINTWAYBILL с параметром useLastDocument, который определяет какой документ необходимо распечатать:

• при значении true будет напечатан УПД для последнего закрытого чека;
• при значении false / отсутствии параметра будет предложено выбрать смену и документ.

О настройке пунктов меню подробнее можно прочитать в разделе "Настройка действий".

При печати УПД из главного меню осуществляется выбор смены и документа. Поиск возможен как в текущей смене, так и в любой из закрытых смен на кассе.

Работа с универсальным передаточным документом в кластерном режиме

При использовании кластерного режима возникает необходимость вести УПД отдельно для каждого из клиентов, подключенных к кассовому серверу. В этом случае при получении номера УПД касса отправляет на кассовый сервер запрос, включающий идентификатор кластера. При подключении к кассовому серверу в файле настроек sync-агента /linuxcash/cash/sync/properties/cash.ini устанавливается ID кластера.