Интеграция с Kit Vending/Kit Shop (БП 3.0, Розница 2.3/3.0, УТ 11/КА 2, УНФ)

 Установка выполняется пользователем 1С с полными правами. Для установки необходимо зайти в раздел «НСИ и администрирование»-«Печатные формы, отчеты и обработки»

                Далее открыть форму для управления расширениями конфигурации:

Далее нажать кнопку «Добавить из файла», на форме предупреждения безопасности нажать «Продолжить» и указать файл «KitVending.cfe»:

                После загрузки необходимо снять галку «Безопасный режим»:

                Для того, чтобы расширение заработало необходимо перезайти в 1С.

Для возможности загружать данные из сервиса KitVending необходимо провести первоначальную настройку. Для этого в разделе «KitVending» необходимо нажать надпись «Настройки интеграции»:

        Для каждой организации можно определить свои настройки подключения к сервису:

Описание настроек

• ID организации – идентификатор организации в сервисе Kit Vending 
• Адрес сервера  - api2.kit-invest.ru/APIService.svc/
• Логин – имя пользователя сервиса KitVending с правами API
• Пароль – пароль пользователя сервиса KitVending

Для проверки корректности данных используйте кнопку «Проверить».

После заполнения всех обязательных необходимо нажать кнопку «Записать настройки».

Список торговых автоматов хранится в одноименном справочнике в разделе «Kit Vending»:

Для загрузки и обновления информации о торговых автоматах можно воспользоваться кнопкой «Загрузить список автоматов»:

В карточке автомата можно посмотреть его состояние и описание статусов основных узлов: питания, купюро-/монетоприемника, модуля безналичной оплаты и онлайн-ККТ, а также денежные средства в автомате.

При наведении курсора на пиктограмму статуса появится подсказка с описанием статуса.

Для торгового автомата можно назначить склад, кассу ККМ и эквайринговый терминал 1С в одноименных полях. Эти значения будут подставляться в документы. Если эти значения не назначены, то будут подставляться значения по умолчанию (см. раздел «Загрузка данных из сервиса Kit Vending»).

Товары в торговых автоматах хранятся в отдельном справочнике. Этот справочник автоматически заполняется при загрузке данных продаж из сервиса Kit Vending. Для заполнения документов необходимо предварительно сопоставить товары в автоматах с номенклатурой в 1С. Ниже представлена форма для сопоставления:

                Фиолетовым цветом выделены строки, для которых уже настроено сопоставление. Несколько товаров в автомате можно сопоставить с одной номенклатурой. Для удобства просмотра для каждой таблицы добавлены отборы: можно посмотреть либо полные списки, либо отобрать только те товары, которые уже сопоставлены/не сопоставлены.

                Для записи соответствия необходимо выделить товар в левой таблице и номенклатуру в правой таблице, а затем нажать «Сопоставить».

                Для создания новой номенклатуры по выделенным строкам необходимо нажать кнопку «Создать номенклатуру». Следует учесть, что новая номенклатура в этом случае не будет создана, если товар в автомате уже был сопоставлен с номенклатурой 1С!

                После нажатия кнопки «Создать номенклатуру» будет выведено отдельное окно, где необходимо подтвердить намерение создать номенклатуру:

По нажатию на кнопку «Создать номенклатуру» в базу 1С будет добавлена новая номенклатура и сопоставлена с товарами в торговых автоматах.

Если ведется учет по характеристикам, то после создания номенклатуры откроется форма заполнения характеристик в сопоставлениях:

Проверить заполнение характеристик можно также по одноименной кнопке в форме сопоставления.

Обработку загрузки данных можно открыть в разделе Kit Vending по одноименной кнопке:

Загрузка продаж

                Загрузка данных продаж выполняется на вкладке «Продажи»:

• Организация – организация, для которой настроена интеграция с KitVending
• Период загрузки – период, за который необходимо загрузить данные
• Отобрать по торговым автоматам – список автоматов, по которым необходимо загрузить данные
• Склад по умолчанию – склад для подстановки в документы, если у торгового автомата не заполнен склад
• Касса ККМ по умолчанию – касса ККМ для подстановки в документы, если у торгового автомата не заполнена касса ККМ
• Эквайринг по умолчанию – эквайринговый терминал для подстановки в отчет о розничных продажах, если он не назначен у торгового автомата.
• Разделять по торговым автоматам – для каждого автомата будет создан отдельный документ продажи; если галка не стоит, то будет создан один документ.
• Создавать приходный кассовый ордер автоматически – для касс ККМ с типом «Фискальный регистратор» помимо выемки ДС будет автоматически создан ПКО с операцией «Поступление из другой кассы»

Для просмотра списка продаж необходимо нажать кнопку «Загрузить продажи».

После загрузки данных необходимо выполнить сопоставление товаров при необходимости. В этом случае следует воспользоваться меню «Сопоставление»:

• Автоматически по наименованию – обработка попытается в автоматическом режиме сопоставить товары автомата с номенклатурой 1С по точному совпадению наименований.
• Сопоставить вручную – откроется окно сопоставления товаров с отбором только по несопоставленным товарам из таблицы (см.раздел «Список товаров в торговых автоматах»

После сопоставления всех товаров можно создать документы в 1С: для этого предназначена кнопка «Записать в 1С». После создания документов будет открыт список новых отчетов о розничных продажах.

Загрузка информации об инкассациях

                Данные об инкассациях можно загрузить на вкладке «Выемки денежных средств».

                Для загрузки данных используются те же самые фильтры, что и для загрузки продаж. Галка «Разделять по торговым автоматам» для инкассаций не работает: для каждой строки создается всегда отдельный пакет документов «Выемка+ПКО».

                Порядок создания документов для отражения выемки:

1. Для касс ККМ с типом «Фискальный регистратор» - как минимум документ «Выемка ДС из кассы ККМ»; если стоит галка «Создавать приходный кассовый ордер автоматически» - на основании выемки будет автоматически создан документ «Приходный кассовый ордер» с операцией «Поступление из другой кассы»
2. Во всех остальных случаях создается один документ «Приходный кассовый ордер» с операцией «Поступление из кассы ККМ»

                Для создания документов в 1С следует воспользоваться кнопкой «Записать в 1С»: после создания отобразится список новых документов.

В расширении также добавлены роли для работы с KitVending. Пользователям с полными правами по умолчанию доступен весь функционал интеграции.

Для остальных пользователей можно назначить следующие роли:

 Установка выполняется пользователем 1С с полными правами. Для установки необходимо зайти в раздел «Настройки»-«Печатные формы, отчеты и обработки»

                Далее открыть форму для управления расширениями конфигурации:

                Далее нажать кнопку «Добавить из файла», на форме предупреждения безопасности нажать «Продолжить» и указать файл «KitVending.cfe»:

                После загрузки необходимо снять галку «Безопасный режим»:

                Для того, чтобы расширение заработало необходимо перезайти в 1С.

Для возможности загружать данные из сервиса KitVending необходимо провести первоначальную настройку. Для этого в разделе «KitVending» необходимо нажать надпись «Настройки интеграции»:

        Для каждой организации можно определить свои настройки подключения к сервису. Настройки разбиты на 2 блока: настройки подключения и настройки создания документов

Блок «Настройки подключения»

• ID организации – идентификатор организации в сервисе Kit Vending

• Адрес сервера  - api2.kit-invest.ru/APIService.svc/
• Логин – имя пользователя сервиса KitVending с правами API
• Пароль – пароль пользователя сервиса KitVending

Для проверки корректности данных используйте кнопку «Проверить».

Блок «Настройка создания документов»

• Безналичная оплата – вид оплаты организации, соответствующий безналичной оплате.

Виды оплат по умолчанию

Позволяет выполнить сопоставление типов оплат торговых автоматов с видами оплат 1С:

• Тип оплаты автомата - число, тип оплаты, заданный в автомате
• Вид оплаты - соответствующий вид безналичной оплаты 1С; для наличной оплаты и реализации без оплаты не заполняется
• Это реализация без оплаты - для типа оплаты со 100% скидкой; в отчеты о розничных продажах для таких оплат будет установлена ручная скидка 100 % (нужно включить функционал ручных скидок)
• Это наличная оплата - включается для типа оплаты, соответствующей наличной оплате

Данное сопоставление используется для всех автоматов. Такая же настройка есть для каждого торгового автомата. Сопоставление оплат по умолчанию более низкий приоритет перед настройкой сопоставления, указанной в карточке конкретного торгового автомата.

После заполнения всех обязательных необходимо нажать кнопку «Записать настройки».

Список торговых автоматов хранится в одноименном справочнике в разделе «Kit Vending»:

Для загрузки и обновления информации о торговых автоматах можно воспользоваться кнопкой «Загрузить список автоматов»:

В карточке автомата можно посмотреть его состояние и описание статусов основных узлов: питания, купюро-/монетоприемника, модуля безналичной оплаты и онлайн-ККТ, а также денежные средства в автомате.

При наведении курсора на пиктограмму статуса появится подсказка с описанием статуса.

Для торгового автомата можно назначить кассу ККМ и эквайринговый терминал в одноименных полях. Эти данные будут подставляться в документы. Если касса и терминал не назначены, то будет подставляться значения по умолчанию (см. раздел «Загрузка данных из сервиса Kit Vending»).

    Товары в торговых автоматах хранятся в отдельном справочнике. Этот справочник автоматически заполняется при загрузке данных продаж из сервиса Kit Vending. Для заполнения документов необходимо предварительно сопоставить товары в автоматах с номенклатурой в 1С. Ниже представлена форма для сопоставления:

                Фиолетовым цветом выделены строки, для которых уже настроено сопоставление. Несколько товаров в автомате можно сопоставить с одной номенклатурой. Для удобства просмотра для каждой таблицы добавлены отборы: можно посмотреть либо полные списки, либо отобрать только те товары, которые уже сопоставлены/не сопоставлены.

                Для записи соответствия необходимо выделить товар в левой таблице и номенклатуру в правой таблице, а затем нажать «Сопоставить».

                Для создания новой номенклатуры по выделенным строкам необходимо нажать кнопку «Создать номенклатуру». Следует учесть, что новая номенклатура в этом случае не будет создана, если товар в автомате уже был сопоставлен с номенклатурой 1С!

                После нажатия кнопки «Создать номенклатуру» будет выведено отдельное окно, где необходимо подтвердить намерение создать номенклатуру:

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

По нажатию на кнопку «Создать номенклатуру» в базу 1С будет добавлена новая номенклатура и сопоставлена с товарами в торговых автоматах.

Если ведется учет по характеристикам, то после создания номенклатуры откроется форма заполнения характеристик в сопоставлениях:

Проверить заполнение характеристик можно также по одноименной кнопке в форме сопоставления.

Обработку загрузки данных можно открыть в разделе Kit Vending по одноименной кнопке:

Загрузка продаж

                Загрузка данных продаж выполняется на вкладке «Продажи»:

• Организация – организация, для которой настроена интеграция с KitVending
• Период загрузки – период, за который необходимо загрузить данные
• Отобрать по торговым автоматам – список автоматов, по которым необходимо загрузить данные
• Касса ККМ по умолчанию – касса ККМ для подстановки в документы, если у торгового автомата не заполнена касса ККМ
• Экв.терминал по умолчанию – эквайринговый терминал для подстановки в документы, если у торгового автомата не заполнен эквайринговый терминал
• Разделять по торговым автоматам – для каждого автомата будет создан отдельный документ продажи; если галка не стоит, то будет создан один документ с кассой ККМ и эквайринговым терминалом по умолчанию.
• Загружать нефискальные данные - если настройка включена, то будут также загружаться данные с признаком IsFiscal=false

Для просмотра списка продаж необходимо нажать кнопку «Загрузить продажи».

После загрузки данных необходимо выполнить сопоставление товаров при необходимости. В этом случае следует воспользоваться меню «Сопоставление»:

• Автоматически по наименованию – обработка попытается в автоматическом режиме сопоставить товары автомата с номенклатурой 1С по точному совпадению наименований.
• Сопоставить вручную – откроется окно сопоставления товаров с отбором только по несопоставленным товарам из таблицы (см.раздел «Список товаров в торговых автоматах»

После сопоставления всех товаров можно создать документы в 1С: для этого предназначена кнопка «Записать в 1С». После создания документов будет открыт список новых отчетов о розничных продажах.

Загрузка информации об инкассациях

                Данные об инкассациях можно загрузить на вкладке «Выемки денежных средств».

                Для загрузки данных используются те же самые фильтры, что и для загрузки продаж. Галка «Разделять по торговым автоматам» для инкассаций не работает: для каждой строки создается всегда отдельный пакет документов «Выемка наличных+Поступление в кассу».

                Для создания документов в 1С следует воспользоваться кнопкой «Записать в 1С»: после создания откроется список новых документов.

                На основании каждой выемки автоматически создается также документ поступления в кассу:

В расширении также добавлены роли для работы с KitVending. Пользователям с полными правами по умолчанию доступен весь функционал интеграции.

Для остальных пользователей можно назначить следующие роли:

 При отправке на аудит требуется указать следующие разрешения:

• Установка привилегированного режима - для работы с безопасным хранилищем данных (хранение пароля для авторизации в сервисе Kit Vending)
• Обращение к внешнему ресурсу api2.kit-invest.ru/APIService.svc - собственно, для работы с API Kit Vending