Интеграция 1С с Kaspi Магазином
Расширение для 1С:Управление торговлей для Казахстана. Заказы с Kaspi.kz сами появляются в 1С и становятся заказами клиентов, а цены и остатки уходят в Kaspi по ссылке прямо из 1С.
- Назначение
- Обмен заказами, ценами и остатками между 1С и Магазином на Kaspi.kz
- Формат решения
- Расширение 1С, типовая конфигурация не меняется
- Режим работы
- Автоматически по расписанию или вручную
- Способ обмена
- API продавца Kaspi; прайс-лист — HTTP-сервис 1С, каталог сайта или FTP
Расширение связывает 1С:Управление торговлей для Казахстана с вашим магазином на Kaspi.kz через API продавца. Заказы загружаются каждые несколько минут, и по каждому создаётся обычный заказ клиента в 1С — с соглашением, НДС, обеспечением и номером Kaspi. Принять заказ, собрать его, распечатать накладную Kaspi Доставки, выдать покупателю по коду или отменить можно прямо из 1С, в том числе сразу по нескольким заказам. Цены и остатки 1С уходят в Kaspi прайс-листом, который Kaspi сам забирает по ссылке.
Кому подходит
Продавцам на Kaspi.kz, которые ведут товарный учёт в 1С:Управление торговлей для Казахстана: магазинам электроники, бытовой техники, товаров для дома, автозапчастей и другим, у кого заказов достаточно, чтобы ручной перенос из кабинета в 1С отнимал время и давал ошибки.
Преимущества
заказы Kaspi не нужно переносить в 1С вручную — заказ клиента создаётся сам, без дублей;
остатки и цены на Kaspi совпадают с 1С: прайс-лист обновляется автоматически;
все действия с заказами Kaspi — в одном рабочем месте 1С, с подсказкой, что делать дальше;
отмена в Kaspi сама закрывает заказ клиента в 1С;
накладные Kaspi Доставки печатаются пачкой по выделенным заказам;
типовая конфигурация не меняется — обновлять УТ так же просто, как без расширения.
Частые вопросы
Нужен ли хостинг или FTP для прайс-листа?
Нет, если база 1С опубликована на веб-сервере. Kaspi забирает прайс-лист по ссылке прямо из 1С, ссылка защищена секретным ключом. Если публиковать базу не хотите, прайс-лист можно выкладывать файлом в каталог сайта или на FTP.
Что будет, если в заказе товар, которого нет в 1С?
Заказ загрузится и попадёт в плитку «требуют внимания». Заказ клиента появится сразу после того, как вы укажете номенклатуру прямо в карточке заказа. Следующие заказы с этим товаром сопоставятся сами.
Меняет ли расширение типовую конфигурацию?
Нет. Расширение не заимствует формы документов и справочников УТ, а добавляет свои команды через общие команды. Поэтому обновления УТ ставятся как обычно.
Можно ли подключить несколько магазинов Kaspi?
Да. У каждого магазина свои настройки: организация, склады, вид цены, интервалы обмена.
Где взять токен API и безопасно ли его хранить в 1С?
Токен формирует руководитель в кабинете продавца Kaspi: Настройки → Токен API. В 1С он хранится в защищённом хранилище, а не в реквизите справочника.
Что происходит в 1С, когда Kaspi отменяет заказ?
Строки заказа клиента отменяются, и заказ закрывается. Если по заказу уже была отгрузка, документы не меняются: заказ попадает в «требуют внимания» с подсказкой оформить возврат вручную.
Какие версии 1С поддерживаются?
1С:Управление торговлей для Казахстана 3.4 на платформе 8.3.21 и выше. Проверено на релизе 3.4.5.21.
Что происходит с заказом
| В Kaspi | В 1С |
|---|---|
| Пришёл новый заказ | Заказ появляется в рабочем месте в плитке «ждут принятия», создаётся заказ клиента (если все товары сопоставлены) |
| Принят продавцом | Кнопка «Принять» в 1С, можно сразу по нескольким заказам; по флажку — автопринятие, если товар есть в наличии |
| Kaspi Доставка: собран | «Собрать и накладная» → указываете количество мест, Kaspi формирует накладную; печать пачкой |
| Самовывоз: выдан | «Выдать» → код покупателю в приложение Kaspi.kz → «Подтвердить выдачу»; по флажку создаётся реализация |
| Отменён | Строки заказа клиента отменяются, заказ закрывается |
| Изменился состав | Строки заказа клиента обновляются, если отгрузки ещё не было |
Как считаются цены и остатки
цена — вид цены магазина (или своя для города) × коэффициент × наценка, с округлением до 1, 10 или 100 ₸; для отдельного товара можно задать свою цену;
остаток — свободный остаток складов, привязанных к точке Kaspi, за вычетом резервов и страхового остатка;
если остаток меньше минимального, товар уходит в Kaspi как «нет в наличии»;
предзаказ задаётся для точки или для конкретного товара.
Ещё
карточки новых товаров для Kaspi: категория, характеристики, фото, проверка обязательных полей и отправка на модерацию;
передача штрихкодов в Kaspi;
помощник подключения в 5 шагов с проверкой токена;
журнал обмена: каждый заказ, ошибка связи и действие видны пользователю, а не только администратору;
в заказе клиента — кнопки «Kaspi» и «Накладная Kaspi», в номенклатуре — ссылка на сопоставление.
Чем отличается от других интеграций
Работа с заказом целиком из 1С. Принять, собрать, распечатать накладные, выдать по коду, отменить, указать IMEI — без переключения в кабинет Kaspi. Действия доступны сразу по нескольким заказам.
Заказ клиента без «пустых» строк. Он создаётся, только когда все товары сопоставлены, и создаётся сам, как только вы укажете номенклатуру.
Прайс-лист без хостинга. Ссылку на прайс-лист отдаёт сама 1С через HTTP-сервис. Посторонние по ней ничего не получат: без секретного ключа сервис отвечает «не найдено».
Типовые формы не тронуты. Расширение не заимствует формы заказа и номенклатуры, поэтому обновление УТ не ломает интеграцию.
Видно, что происходит. Плитки, подсказка «что делать дальше» в карточке заказа и журнал обмена для пользователя.
Основное
- Назначение
- Обмен заказами, ценами и остатками между 1С и Магазином на Kaspi.kz
- Формат решения
- Расширение 1С, типовая конфигурация не меняется
- Режим работы
- Автоматически по расписанию или вручную
- Способ обмена
- API продавца Kaspi; прайс-лист — HTTP-сервис 1С, каталог сайта или FTP
Обмен данными
- Из Kaspi в 1С
- Заказы и статусы, состав, покупатель, доставка, накладные
- Из 1С в Kaspi
- Принятие, сборка, выдача, отмена заказов; цены и остатки; штрихкоды; карточки новых товаров
- Несколько магазинов
- Да
Технические данные
- Конфигурация
- 1С:Управление торговлей для Казахстана, ред. 3.4
- Проверено на релизе
- 3.4.5.21
- Платформа
- 1С:Предприятие 8.3.21 и выше
- Обновления решения
- Устанавливаются автоматически с сервера Авиорд
Совместимость и покупка
- Конфигурации 1С
- УТ
- Лицензия
- Привязывается к БИН организации
Что входит
- ✓Расширение 1С «Авиорд: Kaspi Магазин»
- ✓Инструкция по установке и настройке
- ✓Руководство пользователя
- ✓Роли «Kaspi: администратор» и «Kaspi: менеджер»
Требования
- •1С:Управление торговлей для Казахстана 3.4, платформа 8.3.21 и выше
- •Включённые заказы клиентов в УТ (НСИ и администрирование → Продажи)
- •Токен API из кабинета продавца Kaspi (формирует руководитель)
- •Заполненный БИН/ИИН организации магазина — на него выдаётся лицензия
- •Исходящий доступ по HTTPS к license.aviord.kz — проверка лицензии и обновления
- •Для прайс-листа по ссылке — публикация базы на веб-сервере; иначе FTP или каталог сайта
Отзывы и вопросы появляются на сайте после проверки модератором.
Как проходит подключение
- 1УстановкаПодключаем расширение к вашей базе, снимаем у него безопасный режим (нужен доступ в интернет), включаем заказы клиентов в УТ.
- 2Подключение магазинаВ помощнике указываем ID магазина и токен API — 1С сразу проверяет подключение и загружает заказы за 14 дней.
- 3Настройка заказов и складовОрганизация, клиент «Покупатели Kaspi», статус заказа клиента, склад 1С для каждой точки Kaspi.
- 4ТоварыЗагружаем список товаров из кабинета Kaspi и сопоставляем с номенклатурой: по артикулу, штрихкоду, коду и наименованию, остальное — вручную.
- 5Цены и остаткиВыбираем вид цены, наценку и округление, публикуем базу на веб-сервере и вставляем ссылку на прайс-лист в кабинет Kaspi.
- 6ЗапускВключаем автообмен, проверяем первые заказы вместе с менеджерами и показываем рабочее место.
Услуги Авиорд
Дополнительно можем выполнить:
публикацию базы на веб-сервере для прайс-листа;
первоначальное сопоставление товаров;
обучение менеджеров работе с заказами Kaspi в 1С;
доработку под особенности вашего учёта;
сопровождение.
Стоимость этих работ рассчитывается отдельно для каждого клиента.