Универсальный передаточный документ (УПД) представляет собой унифицированный документ, который включает в себя счет-фактуру, дополненный реквизитами первичного документа об отгрузке и приемке товара.
Универсальный передаточный документ заполняется на основании данных чека продажи и карты клиента. Полнота УПД обеспечивается наличием в БД Dictionaries
следующих таблиц:
Client
. Связка с организацией, на которую будет выписан УПД осуществляется по полю organizationcode.
Organization
. В данном случае под организацией понимаются юридические лица, которые являются клиентами торговой сети (в УПД этими данными заполняется раздел Покупатель).Shop
. Указываются данные продавца и грузоотправителя (в УПД этими данными заполняется раздел Продавец).Tmc
. Поле manufacturercountrycode
, в котором указывается связка с таблицей стран-производителей Country
.Country
. Страна происхождения товара.Тестирование функционала проводилось на модели HP LaserJet P1102. |
Для возможности печати УПД из кассы необходимо выполнить следующие шаги:
Установить пакет artix45-print
, выполнив команду:
aptitude install artix45-print |
Пакет используется для конвертации документов из формата html
(в котором формируется отчет) в pdf
(в котором выполняется печать отчета).
Указать репозиторий для скачивания и установки пакета, содержащего библиотеки для работы с принтером:
deb http://ru.archive.ubuntu.com/ubuntu/ trusty main restricted universe |
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 |
После указания репозитория необходимо установить пакет hplip
, выполнив команду:
aptitude install hplip |
Для настройки принтера выполнить команду:
hp-setup -i |
При настройке принтера указать последовательно данные:
usb
download plug-in from HP
accept the license terms for plug-in
use model name:...
PPD file is correct
"some printer description"
Enter
Print test page
Установить пакет cups
, обеспечивающий управление принтером из ОС Ubuntu, выполнив команду:
aptitude install cups |
cups
в конфигурационном файле /etc/cups/cupsd.conf
, указав в нем ip-адрес кассы и порт 631.Выполнить команды:
service cups restart |
service cups restart service cups-browsed restart |
Для встроенного браузера указать ссылку на страницу https://<ip-адрес_кассы>:631/
Начиная с версии 4.6.104 с помощью автоматической печати создается два экземпляра универсального передаточного документа - для клиента и для магазина. Начиная с версии 4.6.120 добавлено получение номера УПД с кассового сервера. |
Для автоматической печати универсального передаточного документа необходимо, чтобы в карточке клиента был заполнен уникальный код организации (БД Dictionaries
таблица Client
поле organizationcode
).
Для печати универсального передаточного документа необходимо включить плагин printwaybill
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d
в секции [plugins]
.
on
при закрытии чека печатается счет-фактура. Поведение по умолчанию;off
при закрытии чека счет-фактура не печатается.Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
printwaybill | строковый | Включение и выключение плагина для возможности печати счета-фактуры | По умолчанию on |
[plugins] ; Включение и выключение плагина для возможности печати счета-фактуры ; по умолчанию on printwaybill = on |
Кассовое ПО запрашивает номер УПД с кассового сервера (КС, ЦКС или МКС). Подключение к серверу настраивается в секции [Waybill]
в конфигурационном файле /linuxcash/cash/conf/ncash.ini
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
serverUrl | строковый | Адрес сервера, на который отправляются запросы на получение и обновление статуса номера счета-фактуры | По умолчанию Для работы с КС используется следующий url: |
timeout | числовой | Таймаут обращения к серверу в секундах | По умолчанию 30 |
numberToPrint | числовой | Количество экземпляров передаточного документа, которое нужно распечатать при закрытии чека, если печать была подтверждена | По умолчанию 2 |
[Waybill] ; Адрес сервера, на который отправляются запросы на получение и обновление статуса номера счета-фактуры. По умолчанию http://localhost:8080 ; serverUrl = "http://localhost:8080" ; Таймаут обращения к серверу в секундах. По умолчанию 30 ; timeout = 30 ; Количество экземпляров передаточного документа, которое нужно распечатать при закрытии чека (если печать была подтверждена) ; По умочанию 2 ; numberToPrint = 2 |
При добавлении карты клиента в чек проверяется наличие кода организации, который свидетельствует о том, что карта выдана на юридическое лицо. Если поле заполнено, то при добавлении карты на экран выводится диалоговое окно с сообщением "Выполнить печать счета-фактуры при закрытии чека?".
Documents
в таблицу Document
в поле waybillprinted
будет установлено значение 1 (УПД напечатан), а в поле waybillnumber
полученный номер УПД.waybillprinted
и waybillnumber
не заполняются.Обновление статуса УПД при закрытии чека осуществляется через очередь сообщений Artix-Queue. |
Задать количество распечатанных экземпляров УПД можно при помощи параметра numberToPrint
в секции [Waybill]
в конфигурационном файле /linuxcash/cash/conf/ncash.ini
. По умолчанию печатается 2 экземпляра УПД.
При замене карты в чеке требуется повторно подтвердить необходимость печати УПД. Если в чек была добавлена еще одна карта с привязкой к юр.лицу, то подтверждение не требуется, УПД будет напечатан на юр.лицо из последней добавленной карты.
Запрещена продажа акцизной и неакцизной алкогольной продукции в чеке, по которому требуется печать счета-фактуры:
При печати по кнопке в документ в поле waybillprinted не устанавливается признак того, что УПД был напечатан. |
Для настройки печати универсального передаточного документа необходимо в утилите администрирования Yuki задать клавишу с действием "Печать УПД" и назначить этому действию команду COMMAND_OPERATION
. В параметрах действия необходимо указать:
Порядок | Название | Значение | Примечания |
---|---|---|---|
1 | url | shell:///mkdir%20-p%20/linuxcash/cash/data/tmp/print | Создается директория для размещения отчета (УПД) |
2 | url | report://waybill?out=file&shift=selected&document=selected&name=/linuxcash/cash/data/tmp/print/waybill | Формируется отчет (УПД). О задании выбора смены и документа в команде для выполнения внешних программ можно прочитать здесь. |
3 | url | shell:////linuxcash/cash/bin/print.sh%20/linuxcash/cash/data/tmp/print/waybill%20Landscape%201 | Созданный документ удаляется после печати |
Печать универсального передаточного документа выполняется по нажатию клавиши "Печать УПД". Печать документа производится в соответствии с настроенными правилами печати отчета.
Для печати копии УПД (счета-фактуры) по кнопке в утилите администрирования Yuki необходимо настроить пункт меню "Печать УПД" с командой COMMAND_PRINTWAYBILL
с параметром useLastDocument
, который определяет какой документ необходимо распечатать:
true
будет напечатан УПД для последнего закрытого чека;false
/ отсутствии параметра будет предложено выбрать смену и документ.О настройке пунктов меню подробнее можно прочитать в разделе "Настройка действий".
При печати УПД из главного меню осуществляется выбор смены и документа. Поиск возможен как в текущей смене, так и в любой из закрытых смен на кассе.
Начиная с версии 4.6.140 реализован функционал работы с универсальным передаточным документом в режиме подключения к кластеру. |
При использовании кластерного режима возникает необходимость вести УПД отдельно для каждого из клиентов, подключенных к кассовому серверу. В этом случае при получении номера УПД касса отправляет на кассовый сервер запрос, включающий идентификатор кластера. При подключении к кассовому серверу в файле настроек sync-агента /linuxcash/cash/sync/properties/cash.ini
устанавливается ID кластера.