ПКБ:Мобильная касса: различия между версиями

Материал из Документация ПКБ «Витебск»
Перейти к навигации Перейти к поиску
 
(не показано 17 промежуточных версий этого же участника)
Строка 1: Строка 1:
Так как «ПКБ:Мобильная касса» создана на базе приложения «1С:Мобильная касса», то для изучения возможностей нашего решения следует использовать документацию от «1С:Мобильная касса», ссылки на которую можно найти на страницах https://1c-prosto.ru/text/spisok-rolikov-1c-prosto#opportunities-17 и  https://v8.1c.ru/1s-kassa/mobilnoe-prilozhenie-1s-mobilnaya-kassa/
Так как «ПКБ:Мобильная касса» создана на базе приложения «1С:Мобильная касса», то для изучения возможностей нашего решения следует использовать документацию от «1С:Мобильная касса», ссылки на которую можно найти на страницах https://1c-prosto.ru/text/spisok-rolikov-1c-prosto#opportunities-17 и  https://v8.1c.ru/1s-kassa/mobilnoe-prilozhenie-1s-mobilnaya-kassa/


На этой странице описываются все дополнения и исключения из документации родительского решения, связанные с нашей локализацией. Актуальная информация относится к версии приложения 3.25.15.
На этой странице описываются все дополнения и исключения из документации родительского решения, связанные с нашей локализацией. Актуальная информация относится к версии приложения 3.28.23.


== Особенности распространения и подключения ==
== Особенности распространения и подключения ==
Строка 7: Строка 7:


Стоимость лицензии на приложение «ПКБ:Мобильная касса» (включает лицензию на родительское решение «1С:Мобильная касса» и подписку на обновления нашего приложения в течение 365 суток с момента приобретения) составляет 99,00 белорусских рублей на каждое устройство. Стоимость права на получение дальнейших обновлений за каждые последующие 12 месяцев равна стоимости лицензии на приложение.
Стоимость лицензии на приложение «ПКБ:Мобильная касса» (включает лицензию на родительское решение «1С:Мобильная касса» и подписку на обновления нашего приложения в течение 365 суток с момента приобретения) составляет 99,00 белорусских рублей на каждое устройство. Стоимость права на получение дальнейших обновлений за каждые последующие 12 месяцев равна стоимости лицензии на приложение.
При этом пользователь обязан соблюдать условия использования и сопровождения, установленные фирмой 1С для родительского решения.


== Особенности работы с оборудованием ==
== Особенности работы с оборудованием ==
Из приложения исключены драйверы кассового оборудования, которое не сертифицировано и не применяется для работы в Республике Беларусь.
 
# Из приложения исключены драйверы кассового оборудования, которое не сертифицировано и не применяется для работы в Республике Беларусь.
# При настройке работы с программной кассой, поддерживающей оплату картой, требуется обязательно выставлять в стандартных настройках эквайринга (раздел ''Настройки'' → ''Оборудование'' → ''Эквайринг'') вид терминала: ''Внешний автономный терминал.''


== Подключение и использование программных касс ==
== Подключение и использование программных касс ==
Для подключения приложения к программной кассе необходимо зайти в раздел ''Настройки'' — ''Оборудование'' — ''Устройство печати''.
Далее в поле ''Устройство печати'' выбираем значение ''Программная касса''.
[[Файл:Окно настроек устройства печати.png|без|мини|250x250пкс]]
Далее по кнопке ''Настроить'' открываем окно настроек:
[[Файл:Окно настроек программной кассы, часть 1.png|слева|мини|250x250пкс]]
[[Файл:Окно настроек программной кассы, часть 2.png|без|мини|250x250пкс]]
Значения реквизитов здесь следующие:
* Вид кассы — выбираем ту кассу, которую мы подключили на этом устройстве.
* Версия — для касс от iKassa после 01.07.2025 всегда ставим 2.
* Прямое подключение к мобильному приложению — функция предназначена для отладки со стороны разработчиков приложения. В общем случае должна быть снята.
* Сервер кассы — если касса находится на этом же устройстве — 127.0.0.1 или localhost. Иначе — фиксированный IP-адрес или видимое отсюда имя устройства, по которому доступна программная касса.
* Порт — зависит от конкретной программной кассы и её настроек, если оставить 0, заполнится по умолчанию.
* Токен — номер токена, который используется в подключаемой кассе.
* Пин — пин-код токена.
* Способ совершения безналичных операций — встроенный терминал, если касса находится на эквайринговом терминале 3-в-1, либо одно из предусмотренных внешних приложений.
* Не закрывать смену банка — для отладки разработчиками, в общем случае должна быть снята.
* Вести лог — для отладки. В этом случае весь обмен между мобильной и программной кассой сохраняется в базе данных для исследования.
* Касса на сервере 1С — для отладки разработчиками, в общем случае должна быть снята.
== Дополнительные возможности настройки синхронизации ==
В раздел ''Опции'' программы добавлена новая настройка: ''Очищать старые остатки при загрузке новых'':
[[Файл:Настройка очистки остатков при загрузке.png|альт=Настройка очистки остатков при загрузке|без|мини|250x250пкс|Настройка очистки остатков при загрузке]]
Она нужна для синхронизации со «старшими» программами, которые умеют выгружать только ненулевые остатки. Такая программа, если в ней какой-то остаток обнулился, не отправит информацию об этом в наше приложение и, соответственно, он не обнулится. Если эту настройку включить, перед началом загрузки остатков «ПКБ:Мобильная касса» будет обнулять все остатки в своей базе.


== Синхронизация со старшими программами 1С для Беларуси ==
== Синхронизация со старшими программами 1С для Беларуси ==
Так как версия формата обмена EnterpriseData в белорусских конфигурациях существенно ниже, чем в российских, он принудительно понижен и в нашей версии приложения. Версия по умолчанию в исходном приложении — 1.16, версия в нашей версии — 1.8.
Для нас основным продуктом, внедряемым и продвигаемым среди клиентов, является «1С:Комплексная автоматизация для Беларуси», то наиболее полно особенности синхронизации описаны в разделе, посвящённом этой программе. Описания интеграцию с другими программами будут содержать в основном дополнения и отличия от интеграции с ней.


=== 1С:Комплексная автоматизация для Беларуси ===
=== 1С:Комплексная автоматизация для Беларуси ===
Для корректной интеграции необходимо скачать и установить расширение «пкбМобильнаяКасса». Оно исправляет некоторые мелкие ошибки основной конфигурации, мешающие получению отчёта о розничных продажах, а также добавляет реквизиты для организации упрощённой работы с маркировкой.


=== 1С:Управление торговлей 8 для Беларуси ===
Синхронизация организации осуществляется по строгому соответствию наименования в мобильной кассе и реквизита «Рабочее наименование» в старшей программе. Если наименования не совпадают, в старшей программе будет создана новая организация в справочнике. На это надо обращать особое внимание.


=== 1С:ERP. Управление предприятием 2 для Беларуси ===
При просмотре регистрации изменений для обмена мы можем увидеть много лишних документов и справочников, явно для мобильной кассы не нужных. На это не стоит обращать особого внимания: при формировании сообщения обмена в него попадут только те объекты, которые мобильная касса реально готова принять (уведомление о возможности или невозможности приёма тех или иных документов и справочников — часть стандартного механизма обмена).
 
=== 1С:Управление торговлей 8 для Беларуси и 1С:ERP. Управление предприятием 2 для Беларуси ===
На настоящий момент синхронизация не тестировалась. Ввиду технологической близости с конфигураций «1С:Комплексная автоматизация для Беларуси» предполагаем, что Вы можете использовать расширение, предназначенное для этой конфигурации с минимальными изменениями.


=== 1С:Розница 8 для Беларуси и 1С:Управление компанией 8 для Беларуси ===
=== 1С:Розница 8 для Беларуси и 1С:Управление компанией 8 для Беларуси ===
Стандартная синхронизация через универсальный формат обмена в этих программах изначально работает корректно и не требует дополнительных расширений.


=== 1С:Бухгалтерия 8 для Беларуси ===
=== 1С:Бухгалтерия 8 для Беларуси ===
На настоящий момент синхронизация не тестировалась.


== Работа с сериями и ценообразование по сериям ==
== Работа с сериями и ценообразование по сериям ==
Серийный учёт реализован только с использованием штрихкодов в формате GS1. Серия (партия) считывается из поля с идентификатором применения 10 (номер партии).
Серийный учёт реализован только с использованием штрихкодов в формате GS1. Серия (партия) считывается из поля с идентификатором применения 10 (номер партии).


Ценообразование по сериям реализовано путём либо ручного ввода цены после считывания штрихкода в формате GS1, содержащего партию, либо считывается из поля с идентификатором применения 8005 (цена за единицу).
Ценообразование по сериям реализовано путём либо ручного ввода цены после считывания штрихкода в формате GS1, содержащего партию, либо цена считывается из поля с идентификатором применения 8005 (цена за единицу).


Таким образом, если штрихкод в формате GS1 на ценнике товара сформирован следующим образом: (01)04810410012205(10)055444(8005)001256 -- то при его считывании будет определён сам товар по GTIN 4810410012205, номер партии (серии) 055444 и цена 12,56 белорусских рублей.
Таким образом, если штрихкод в формате GS1 на ценнике товара сформирован следующим образом: (01)04810410012205(10)055444(8005)001256 -- то при его считывании будет определён сам товар по GTIN 4810410012205, номер партии (серии) 055444 и цена 12,56 белорусских рублей.
Строка 35: Строка 73:


== Особенности маркировки товаров в Республике Беларусь ==
== Особенности маркировки товаров в Республике Беларусь ==
На настоящий момент маркировка товаров в Республике Беларусь поддерживается в полном объёме, в том числе и двойная маркировка СИ+КИЗ (импортные товары из РФ, маркируемые там СИ, а у нас КИЗ). При этом напоминаем, что вывод из оборота КИЗ на кассе при розничной продаже, начиная с 02.07.2025, не является обязательным.
Маркировка настраивается в карточке товара в разделе ''Тип маркировки'':
[[Файл:Настройка маркировки товара в ПКБ-Мобильная касса.png|альт=Настройка маркировки товара в ПКБ:Мобильная касса|без|мини|250x250пкс|Настройка маркировки товара в ПКБ:Мобильная касса]]
Верхняя настройка (выбор из списка) — это выбор варианта маркировки СИ. Нижний переключатель определяет, маркируется ли товар белорусским УКЗ. Сейчас его использовать не обязательно.
== Пример развёртывания приложения с нуля и настройки синхронизации со старшей программой ==
''Раздел не завершён.''
=== Сокращения ===
* '''КА''' — развёрнутая база конфигурации «1С:Комплексная автоматизация для Беларуси».
* '''МК''' — установленное приложение «ПКБ:Мобильная касса».
* '''ПКС''' — программная кассовая система: программное обеспечение, сертифицированное в РУП ИИЦ Минфина и непосредственно выполняющее фискализацию информации и обмен с системами Минфина. Например, Smart X от iKassa.
* '''СКО''' — средство контроля оператора Avest, которое используется для работы ПКС, кроме облачной. Выполнено в виде токена, похожего на флешку, вставляющегося в порт USB.
* '''Терминал''' — кассовое устройство 3-в-1, например, Feitian F20 или Pax A930 RTX, на котором установлена ПКС и подключено СКО.
* '''ТСД''' — терминал сбора данных, специализированное устройство для складской обработки информации, например, серии Atol SMART.
* '''Мобильное устройство''' — устройство с ОС Android, на которое установлена МК. Чаще всего это сам терминал, реже — ТСД, отдельный телефон или отдельная POS-система.
=== Начальные условия ===
# Развёрнута и настроена для работы КА, на неё установлено расширение «пкбМобильнаяКасса», в ней созданы необходимые склады, магазины и подразделения.
# На мобильное устройство установлена МК.
# Имеется настроенный терминал с установленной ПКС.
=== Начальная настройка МК ===
=== Настройка синхронизации ===
==== Предварительная настройка КА ====
==== Создание синхронизации в МК ====
==== Настройка синхронизации в КА ====
==== Выполнение синхронизации в МК ====
=== Последующая настройка МК ===


== История изменений ==
== История изменений ==
=== Версия 3.28.23.59 (29.10.2025) ===
Обновлена исходная версия приложения до российской версии 3.28.23.
=== Версия 3.25.15.47 (18.08.2025) ===
Доработана загрузка справочных остатков для сценария, когда «старшая» программа не передаёт нулевые остатки: добавлена настройка, позволяющая обнулять все остатки в начале импорта.
=== Версия 3.25.15.43 (12.08.2025) ===
Содержит только исправления ошибок.
=== Версия 3.25.15.39 (11.07.2025) ===
Исправлены некоторые ошибки при работе с маркированным товаром.
=== Версия 3.25.15.35 (30.06.2025) ===
Исправлены ошибки загрузки цен номенклатуры при отдельных сценариях работы с некоторыми типовыми конфигурациями для Беларуси.
=== Версия 3.25.15.31 (27.06.2025) ===
Изменена маркетинговая информация о приложении, добавлены ссылки на эту документацию.

Текущая версия от 12:43, 21 ноября 2025

Так как «ПКБ:Мобильная касса» создана на базе приложения «1С:Мобильная касса», то для изучения возможностей нашего решения следует использовать документацию от «1С:Мобильная касса», ссылки на которую можно найти на страницах https://1c-prosto.ru/text/spisok-rolikov-1c-prosto#opportunities-17 и https://v8.1c.ru/1s-kassa/mobilnoe-prilozhenie-1s-mobilnaya-kassa/

На этой странице описываются все дополнения и исключения из документации родительского решения, связанные с нашей локализацией. Актуальная информация относится к версии приложения 3.28.23.

Особенности распространения и подключения

Программа не бесплатна. Для её использования необходима платная лицензия на родительское решение «1С:Мобильная касса» на каждое устройство.

Стоимость лицензии на приложение «ПКБ:Мобильная касса» (включает лицензию на родительское решение «1С:Мобильная касса» и подписку на обновления нашего приложения в течение 365 суток с момента приобретения) составляет 99,00 белорусских рублей на каждое устройство. Стоимость права на получение дальнейших обновлений за каждые последующие 12 месяцев равна стоимости лицензии на приложение.

При этом пользователь обязан соблюдать условия использования и сопровождения, установленные фирмой 1С для родительского решения.

Особенности работы с оборудованием

  1. Из приложения исключены драйверы кассового оборудования, которое не сертифицировано и не применяется для работы в Республике Беларусь.
  2. При настройке работы с программной кассой, поддерживающей оплату картой, требуется обязательно выставлять в стандартных настройках эквайринга (раздел НастройкиОборудованиеЭквайринг) вид терминала: Внешний автономный терминал.

Подключение и использование программных касс

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

Далее в поле Устройство печати выбираем значение Программная касса.

Далее по кнопке Настроить открываем окно настроек:

Значения реквизитов здесь следующие:

  • Вид кассы — выбираем ту кассу, которую мы подключили на этом устройстве.
  • Версия — для касс от iKassa после 01.07.2025 всегда ставим 2.
  • Прямое подключение к мобильному приложению — функция предназначена для отладки со стороны разработчиков приложения. В общем случае должна быть снята.
  • Сервер кассы — если касса находится на этом же устройстве — 127.0.0.1 или localhost. Иначе — фиксированный IP-адрес или видимое отсюда имя устройства, по которому доступна программная касса.
  • Порт — зависит от конкретной программной кассы и её настроек, если оставить 0, заполнится по умолчанию.
  • Токен — номер токена, который используется в подключаемой кассе.
  • Пин — пин-код токена.
  • Способ совершения безналичных операций — встроенный терминал, если касса находится на эквайринговом терминале 3-в-1, либо одно из предусмотренных внешних приложений.
  • Не закрывать смену банка — для отладки разработчиками, в общем случае должна быть снята.
  • Вести лог — для отладки. В этом случае весь обмен между мобильной и программной кассой сохраняется в базе данных для исследования.
  • Касса на сервере 1С — для отладки разработчиками, в общем случае должна быть снята.

Дополнительные возможности настройки синхронизации

В раздел Опции программы добавлена новая настройка: Очищать старые остатки при загрузке новых:

Настройка очистки остатков при загрузке
Настройка очистки остатков при загрузке

Она нужна для синхронизации со «старшими» программами, которые умеют выгружать только ненулевые остатки. Такая программа, если в ней какой-то остаток обнулился, не отправит информацию об этом в наше приложение и, соответственно, он не обнулится. Если эту настройку включить, перед началом загрузки остатков «ПКБ:Мобильная касса» будет обнулять все остатки в своей базе.

Синхронизация со старшими программами 1С для Беларуси

Так как версия формата обмена EnterpriseData в белорусских конфигурациях существенно ниже, чем в российских, он принудительно понижен и в нашей версии приложения. Версия по умолчанию в исходном приложении — 1.16, версия в нашей версии — 1.8.

Для нас основным продуктом, внедряемым и продвигаемым среди клиентов, является «1С:Комплексная автоматизация для Беларуси», то наиболее полно особенности синхронизации описаны в разделе, посвящённом этой программе. Описания интеграцию с другими программами будут содержать в основном дополнения и отличия от интеграции с ней.

1С:Комплексная автоматизация для Беларуси

Для корректной интеграции необходимо скачать и установить расширение «пкбМобильнаяКасса». Оно исправляет некоторые мелкие ошибки основной конфигурации, мешающие получению отчёта о розничных продажах, а также добавляет реквизиты для организации упрощённой работы с маркировкой.

Синхронизация организации осуществляется по строгому соответствию наименования в мобильной кассе и реквизита «Рабочее наименование» в старшей программе. Если наименования не совпадают, в старшей программе будет создана новая организация в справочнике. На это надо обращать особое внимание.

При просмотре регистрации изменений для обмена мы можем увидеть много лишних документов и справочников, явно для мобильной кассы не нужных. На это не стоит обращать особого внимания: при формировании сообщения обмена в него попадут только те объекты, которые мобильная касса реально готова принять (уведомление о возможности или невозможности приёма тех или иных документов и справочников — часть стандартного механизма обмена).

1С:Управление торговлей 8 для Беларуси и 1С:ERP. Управление предприятием 2 для Беларуси

На настоящий момент синхронизация не тестировалась. Ввиду технологической близости с конфигураций «1С:Комплексная автоматизация для Беларуси» предполагаем, что Вы можете использовать расширение, предназначенное для этой конфигурации с минимальными изменениями.

1С:Розница 8 для Беларуси и 1С:Управление компанией 8 для Беларуси

Стандартная синхронизация через универсальный формат обмена в этих программах изначально работает корректно и не требует дополнительных расширений.

1С:Бухгалтерия 8 для Беларуси

На настоящий момент синхронизация не тестировалась.

Работа с сериями и ценообразование по сериям

Серийный учёт реализован только с использованием штрихкодов в формате GS1. Серия (партия) считывается из поля с идентификатором применения 10 (номер партии).

Ценообразование по сериям реализовано путём либо ручного ввода цены после считывания штрихкода в формате GS1, содержащего партию, либо цена считывается из поля с идентификатором применения 8005 (цена за единицу).

Таким образом, если штрихкод в формате GS1 на ценнике товара сформирован следующим образом: (01)04810410012205(10)055444(8005)001256 -- то при его считывании будет определён сам товар по GTIN 4810410012205, номер партии (серии) 055444 и цена 12,56 белорусских рублей.

При синхронизации со «старшей программой» 1С в каждой позиции отчёта о розничных продажах передаются данные о считанной серии стандартным для 1С способом через формат Enterprise Data. Таким образом, в случае, если в «старшей программе» ведётся серийный учёт, из неё распечатаны ценники или этикетки со штрихкодом, содержащим серию под идентификатором применения 10, то при продаже товара со сканированием таких штрихкодов в «старшую программу» будут передаваться сведения с привязкой к существующей серии (не актуально для «1С:Бухгалтерия 8 для Беларуси», поскольку она не предусматривает серийного учёта).

Особенности маркировки товаров в Республике Беларусь

На настоящий момент маркировка товаров в Республике Беларусь поддерживается в полном объёме, в том числе и двойная маркировка СИ+КИЗ (импортные товары из РФ, маркируемые там СИ, а у нас КИЗ). При этом напоминаем, что вывод из оборота КИЗ на кассе при розничной продаже, начиная с 02.07.2025, не является обязательным.

Маркировка настраивается в карточке товара в разделе Тип маркировки:

Настройка маркировки товара в ПКБ:Мобильная касса
Настройка маркировки товара в ПКБ:Мобильная касса

Верхняя настройка (выбор из списка) — это выбор варианта маркировки СИ. Нижний переключатель определяет, маркируется ли товар белорусским УКЗ. Сейчас его использовать не обязательно.

Пример развёртывания приложения с нуля и настройки синхронизации со старшей программой

Раздел не завершён.

Сокращения

  • КА — развёрнутая база конфигурации «1С:Комплексная автоматизация для Беларуси».
  • МК — установленное приложение «ПКБ:Мобильная касса».
  • ПКС — программная кассовая система: программное обеспечение, сертифицированное в РУП ИИЦ Минфина и непосредственно выполняющее фискализацию информации и обмен с системами Минфина. Например, Smart X от iKassa.
  • СКО — средство контроля оператора Avest, которое используется для работы ПКС, кроме облачной. Выполнено в виде токена, похожего на флешку, вставляющегося в порт USB.
  • Терминал — кассовое устройство 3-в-1, например, Feitian F20 или Pax A930 RTX, на котором установлена ПКС и подключено СКО.
  • ТСД — терминал сбора данных, специализированное устройство для складской обработки информации, например, серии Atol SMART.
  • Мобильное устройство — устройство с ОС Android, на которое установлена МК. Чаще всего это сам терминал, реже — ТСД, отдельный телефон или отдельная POS-система.

Начальные условия

  1. Развёрнута и настроена для работы КА, на неё установлено расширение «пкбМобильнаяКасса», в ней созданы необходимые склады, магазины и подразделения.
  2. На мобильное устройство установлена МК.
  3. Имеется настроенный терминал с установленной ПКС.

Начальная настройка МК

Настройка синхронизации

Предварительная настройка КА

Создание синхронизации в МК

Настройка синхронизации в КА

Выполнение синхронизации в МК

Последующая настройка МК

История изменений

Версия 3.28.23.59 (29.10.2025)

Обновлена исходная версия приложения до российской версии 3.28.23.

Версия 3.25.15.47 (18.08.2025)

Доработана загрузка справочных остатков для сценария, когда «старшая» программа не передаёт нулевые остатки: добавлена настройка, позволяющая обнулять все остатки в начале импорта.

Версия 3.25.15.43 (12.08.2025)

Содержит только исправления ошибок.

Версия 3.25.15.39 (11.07.2025)

Исправлены некоторые ошибки при работе с маркированным товаром.

Версия 3.25.15.35 (30.06.2025)

Исправлены ошибки загрузки цен номенклатуры при отдельных сценариях работы с некоторыми типовыми конфигурациями для Беларуси.

Версия 3.25.15.31 (27.06.2025)

Изменена маркетинговая информация о приложении, добавлены ссылки на эту документацию.