Модуль Izibiz для 1С — установка и работа
Izibiz — расширение для 1С: выставляйте клиентам счета на оплату через Kaspi прямо из Бухгалтерии, а оплаты возвращаются в 1С автоматически. Все разделы открыты — листайте подряд или переходите по оглавлению слева.
- Файл расширения Izibiz.cfe — его присылает поставщик (мы).
- Лицензионный ключ вида IZB-XXXXX-XXXXX-XXXXX-XXXXX-X — тоже от поставщика.
- Номер телефона кассира Kaspi Business — см. раздел про кассира.
Ключ Kaspi/ApiPay вводить не нужно — подключение к Kaspi настраивается автоматически. В 1С вы вводите только лицензионный ключ модуля.
Расширение ставится одним файлом, без изменения вашей конфигурации 1С. Порядок такой:
Сохраните файл Izibiz.cfe
Положите присланный файл Izibiz.cfe в удобную папку на компьютере.
Откройте управление расширениями
В 1С:Предприятие: раздел «Администрирование» → «Печатные формы, отчёты и обработки» → «Расширения».
Добавьте файл
Нажмите «Добавить из файла…» и выберите Izibiz.cfe. В списке появится расширение Izibiz.
Снимите «Безопасный режим»
У строки расширения Izibiz снимите галочку «Безопасный режим». Это обязательно — в безопасном режиме модуль не сможет связаться с Kaspi.
Перезапустите 1С
Закройте и снова откройте программу. При запросе разрешите изменение — расширение применится. В панели разделов появится раздел «Izibiz (Apipay)» с логотипом.
Важно. Шаг со снятием «Безопасного режима» пропускать нельзя — без него кнопки будут выдавать ошибку связи.
Обновление версии. Когда придёт новый файл, там же (Администрирование → Печатные формы, отчёты и обработки → Расширения) выделите строку Izibiz и нажмите «Обновить из файла…», выберите новый файл. Не удаляйте расширение — вместе с ним удалятся ваши данные (журнал выставленных счетов). Обновление поверх все данные сохраняет.
Если ваша 1С работает в облаке (1С:Fresh), установку расширений может контролировать провайдер — тогда пришлите файл в вашу техподдержку 1С или напишите нам, поможем.
После установки в панели разделов 1С появляется раздел «Izibiz (Apipay)». В нём шесть пунктов:
| Пункт меню | Для чего |
|---|---|
| Добавление товаров 1С → Kaspi | Завести ваши товары в каталог Kaspi (с кодом НТИН). |
| Выставление счетов по задолженности | Выставить счета Kaspi должникам по счёту 1210. |
| Выставленные счета Kaspi | Журнал всех выставленных счетов и их оплат. |
| Выставить счёт клиенту | Выставить произвольный счёт вручную (телефон, сумма, описание). |
| Подключение Kaspi (ApiPay) | Мастер первого подключения: ключ, кассир, тариф. |
| Настройки справочников | Счёт дебиторки, вид телефона, договор эквайринга и т.д. |
Начать нужно с «Подключение Kaspi», затем один раз заполнить «Настройки справочников», после чего можно выставлять счета.
Откройте пункт «Подключение Kaspi (ApiPay)». Сверху всегда выбирается Организация (если у вас несколько юрлиц — для каждого своё подключение и свой ключ). Дальше мастер ведёт по шагам.
Шаг 1. Лицензия
Вставьте выданный ключ в поле «Лицензионный ключ модуля» (формат IZB-XXXXX-XXXXX-XXXXX-XXXXX-X) и нажмите «Подключить». Ключ Kaspi вводить не нужно.
Шаг 2. Готовность (три галочки)
Отметьте все три пункта — кнопка «Продолжить» станет активной только когда отмечены все:
- На телефоне кассира в Kaspi включена только роль «Кассир» (без других ролей).
- Это обычная SIM-карта (не виртуальный номер), и телефон сейчас под рукой.
- Код из SMS введу сразу — он действует около минуты.
Шаг 3. Телефон кассира
Введите «Телефон кассира Kaspi» в формате 8XXXXXXXXXX (например 87011234567) и нажмите «Отправить SMS». На этот номер придёт код.
Шаг 4. Код из SMS
Введите пришедший код в поле «Код из SMS» и нажмите «Подтвердить». Ошиблись номером — кнопка «Изменить номер» вернёт назад. После подтверждения включается пробный период 3 дня.
Шаг 5. Тариф
Выберите тариф и срок. Три варианта действий:
- «Оплатить» — счёт на тариф придёт пушем Kaspi на указанный телефон; после оплаты тариф активируется автоматически.
- «Запросить счёт на компанию» — если удобнее оплатить по счёту на расчётный счёт: оставьте контакт, мы вышлем счёт.
- «Позже (пробный период)» — отложить оплату, продолжить на пробном периоде (3 дня).
Шаг 6. Статус
Финальный экран показывает состояние: подключение, кассир, тариф. Кнопка «Обновить» перечитывает статус, «Оплатить/сменить тариф» возвращает к выбору тарифа. Всё — можно выставлять счета.
Кассир — это отдельный номер телефона, через который вы принимаете оплаты Kaspi. Это не тот номер, которым вы входите в приложение Kaspi. Требования:
- Роль «Кассир» в Kaspi Business — на этом номере должна быть включена только роль «Кассир».
- Обычная SIM-карта — не виртуальный номер; телефон должен быть под рукой.
- Приём SMS — на номер придёт код подтверждения. Он живёт около минуты, поэтому вводите сразу.
- Формат номера — 8XXXXXXXXXX (11 цифр, например 87011234567).
Кассир не видит баланс и не выводит деньги — он только принимает оплаты. Сами деньги приходят на ваш обычный счёт Kaspi. Скачивать приложение кассиру не нужно — телефон нужен только чтобы принять SMS-код.
Как выдать роль «Кассир» в Kaspi Business
В приложении Kaspi Business: раздел сотрудников/настроек → добавить сотрудника по номеру телефона → выдать роль «Кассир». Kaspi пришлёт на номер ссылку на приложение — это просто уведомление, устанавливать ничего не надо. После этого номер готов к подключению в мастере.
Пункт «Настройки справочников» заполняется один раз на каждую организацию — это подсказывает модулю, какие счета и реквизиты подставлять. Поля:
| Поле | Что указать |
|---|---|
| Счёт дебиторки | Счёт учёта долга покупателя (обычно 1210). |
| Вид телефона | Какой контакт клиента брать как телефон для счёта. |
| Договор эквайринга | Договор эквайринга для документов оплаты. |
| Вид оплаты | Вид оплаты эквайринга. |
| Статья ДДС | Статья движения денежных средств для платежа. |
| Процент уступки | Процент комиссии эквайринга (если есть). |
| Тип цен / Цена по умолчанию | Используются при выгрузке товаров в Kaspi. |
Выставление счетов по задолженности (счёт 1210)
Массовое выставление счетов должникам.
- «Загрузить должников» — заполняет таблицу должников по счёту 1210. Колонки: галочка «Выставить», Контрагент, Договор, Долг ₸, Телефон (можно поправить вручную).
- «Отметить всех» / «Снять отметки» — быстрый выбор строк.
- «Выставить выбранные» — выставляет счета по отмеченным. В конце покажет «Выставлено счетов: N из M на сумму X ₸» и откроет журнал. Ошибки видны в журнале, в колонке «Сообщение об ошибке».
Выставить счёт из накладной (Реализация)
В документе «Реализация товаров и услуг» есть кнопка «Выставить счёт клиенту (Kaspi)»:
- Сначала запишите документ. Модуль проверит, какие товары есть в каталоге Kaspi.
- Если часть товаров не в каталоге или без НТИН — покажет предупреждение (такие позиции в счёт не войдут либо не попадут в фискальный чек) и спросит подтверждение.
- Введите телефон покупателя (8XXXXXXXXXX) — счёт уйдёт в Kaspi.
- Результат: «✅ Счёт отправлен покупателю в Kaspi». Счёт записывается в журнал «Выставленные счета Kaspi».
Если счёт получился меньше суммы накладной — значит часть товаров ещё не в каталоге Kaspi. Заведите их (см. ниже) и выставьте счёт заново.
Добавление товаров 1С → Kaspi
Чтобы товар попал в счёт и в фискальный чек, он должен быть в каталоге Kaspi с кодом НТИН. Здесь это делается массово.
- «Обновить список» — показывает номенклатуру с заполненным «Код НКТ (НТИН)». Колонки: значок, галочка, Наименование, Код НКТ (НТИН), Цена ₸ (можно править), Статус Kaspi.
- «Проверить в каталоге» — сверяет товары с Kaspi и раскрашивает статусы.
- «Загрузить в Kaspi» — отправляет отмеченные товары в каталог (в фоне, окно можно закрыть).
Цвета статусов:
- Есть в Kaspi — товар уже в каталоге, всё хорошо.
- Есть, но без НТИН — оплатится, но не попадёт в фискальный чек; отметьте и нажмите «Загрузить в Kaspi», чтобы дозаполнить НТИН.
- Нет в Kaspi — товара нет в каталоге, нужно загрузить.
Если товаров не видно — заполните поле «Код НКТ» (НТИН) в карточках номенклатуры 1С: без него товар в Kaspi не выгрузить. Kaspi не принимает нулевую цену — заполните колонку «Цена, ₸».
Выставленные счета Kaspi (журнал)
Здесь видны все выставленные счета и их оплаты. Внутри документа по каждому счёту: Контрагент, Сумма, Телефон, Статус, Дата оплаты, Документ оплаты, Сообщение об ошибке.
- «Опросить оплаты» — проверяет, какие счета уже оплачены, и создаёт документы оплаты. Покажет «Статусов обновлено: N. Документов оплаты создано: M».
При оплате модуль создаёт документ «Оплата от покупателя платёжной картой» как черновик — бухгалтер проверяет и проводит его сам.
Выставить счёт клиенту (вручную)
Простое окно для разового счёта: укажите Телефон, Сумму и Описание, нажмите «Выставить счёт» — счёт уйдёт в Kaspi и попадёт в журнал.
| Статус | Что означает |
|---|---|
| Выставлен | Счёт отправлен покупателю, ожидает оплаты. |
| Оплачен | Покупатель оплатил; создаётся документ оплаты. |
| Отменён | Счёт отменён. |
| Истёк | Срок оплаты истёк, счёт не оплачен. |
| Ошибка | Счёт не удалось отправить — причина в колонке «Сообщение об ошибке». |
В шапке форм модуля бывает строка о версии:
- «✓ …у вас актуальная версия» — всё хорошо, ничего делать не нужно.
- «⚠ Вышло обновление Izibiz …» — доступна новая версия. Свяжитесь с поставщиком по контакту, указанному в этой же строке, получите новый файл и установите его поверх текущего расширения.
Куда вставлять ключ и какой именно?
Только лицензионный ключ модуля вида IZB-… — в мастере «Подключение Kaspi», поле «Лицензионный ключ модуля». Ключ Kaspi/ApiPay вводить не нужно.
Где взять кассира? Нужно ли ему приложение?
Это отдельный номер телефона Kaspi Business с ролью «Кассир» (обычная SIM, принимает SMS). Роль выдаётся в приложении Kaspi Business в разделе сотрудников. Скачивать приложение кассиру не нужно — номер нужен только чтобы принять SMS-код.
Почему счёт меньше суммы накладной?
В счёт попадают только товары, заведённые в каталог Kaspi. Позиции не из каталога не входят — заведите их через «Добавление товаров 1С → Kaspi» и выставьте счёт заново.
Оплата пришла, но в 1С её не видно
Откройте «Выставленные счета Kaspi» и нажмите «Опросить оплаты» — статусы обновятся и создадутся документы оплаты.
Товар не выгружается в Kaspi
Проверьте, что в карточке номенклатуры заполнен «Код НКТ» (НТИН) и указана ненулевая цена — Kaspi не принимает товары без НТИН и с нулевой ценой.
Нужна помощь с подключением?
Напишите нам — вышлем файл модуля, ключ и поможем пройти подключение.