Интеграция 1С с Kaspi Shop — задача нетривиальная. Не потому что сложная технически (API Kaspi достаточно простой), а потому что важна правильная последовательность шагов. Если поспешить и сразу включить обмен заказами, не подготовив справочники — получите свалку дублей и сломанный учёт.
Ниже — порядок, по которому мы делаем интеграцию у клиентов в Шымкенте, Алматы и Астане. С пояснениями: почему именно так, а не иначе.
Что должно быть до начала
До того как трогать обмен, проверьте:
- В 1С наведён порядок в номенклатуре. Каждый товар имеет уникальный артикул. Без артикула обмен невозможен — Kaspi не поймёт, какой товар что обновляет.
- У вас есть аккаунт продавца в Kaspi с доступом к API. Токен API получают в личном кабинете Kaspi Pay.
- Решено, кто хозяин данных. Это ключевой вопрос — обсудим ниже отдельно.
- Версия 1С актуальная. Старые типовые конфигурации могут требовать обновления для работы с современным HTTPS API.
Шаг 0. Решите: кто хозяин данных
Это самый важный этап, который пропускают 90% компаний — и потом мучаются.
Когда товар появляется одновременно в 1С и в Kaspi, должен быть один источник истины. Иначе при следующем обмене у вас будут конфликты: «остаток в 1С — 5, в Kaspi — 3, что считать правильным?»
Правильное решение: 1С — хозяин для остатков, цен и описаний товаров. Kaspi — хозяин для заказов и статусов заказов. Никаких компромиссов.
На практике это значит:
- Меняем остатки только в 1С — Kaspi их подтянет.
- Меняем цены только в 1С — Kaspi их обновит.
- Заказы создаются на Kaspi и приходят в 1С — но статусы потом ведём в 1С (или в Kaspi, но строго в одной системе).
Шаг 1. Подключаем выгрузку номенклатуры (1С → Kaspi)
Первая задача — научить 1С отправлять товары на Kaspi. Это безопасный шаг: ничего критичного не сломается, а вы сразу увидите, насколько данные готовы.
Что выгружаем:
- Артикул (главное поле для сопоставления)
- Наименование
- Описание
- Бренд, категория, характеристики
- Изображения (если хранятся в 1С)
На этом шаге часто всплывает, что часть товаров в 1С заведена «как попало»: без бренда, с одинаковыми артикулами, без характеристик. Это нужно почистить до запуска обмена.
Шаг 2. Включаем синхронизацию остатков
После того как номенклатура загружена и проверена, включаем обмен остатками. Обычно мы делаем это с интервалом 5–15 минут.
Важные моменты:
- Учитывайте резервы. Если у вас есть резервы под другие маркетплейсы или розничный магазин — отправляйте на Kaspi только свободный остаток.
- Минимальный порог. Часто настраивают так: если остаток меньше 2 штук — на Kaspi отправляем 0. Это страховка от oversale.
- Объединение складов. Если у вас несколько складов, нужно решить, объединять ли остатки или подключать только основной склад.
Шаг 3. Подключаем обмен ценами
Цены отправляются отдельным заданием, обычно реже остатков — 1–2 раза в день достаточно. На этом этапе:
- Решите, какой тип цены 1С отдаёт на Kaspi («Розничная», «Цена Kaspi» или отдельная).
- Добавьте логику автоматической наценки/скидки, если она зависит от категории.
- Подключите репрайсинг (по желанию) — он работает на стороне бота, не 1С.
Шаг 4. Принимаем заказы из Kaspi в 1С
Самый сложный этап. Когда заказ создаётся на Kaspi, бот должен:
- Получить его через API.
- Найти или создать контрагента в 1С (по телефону).
- Создать документ заказа покупателя.
- Зарезервировать товар на складе.
- Передать заказ в работу менеджеру или сборщику.
Здесь возникает 80% всех ошибок интеграции. Типичные проблемы:
- Дубли контрагентов (один и тот же клиент создаётся каждый раз заново).
- Заказы зависают в статусе «новый», потому что менеджер их не видит.
- Резерв не снимается при отмене заказа на Kaspi.
Шаг 5. Обмен статусами заказов
Когда менеджер в 1С меняет статус заказа («собран», «отгружен», «доставлен») — это нужно передавать обратно на Kaspi. Чтобы у клиента не было разрыва: на Kaspi висит «в обработке», а у вас уже отправлено.
Здесь важно сопоставить статусы 1С и Kaspi. У Kaspi свой набор статусов (KASPI_DELIVERY, COMPLETED и т.п.), и не каждый статус 1С имеет аналог. Часто настраивают так:
| Статус в 1С | Статус в Kaspi |
|---|---|
| Новый | NEW |
| В работе | ON_DELIVERY |
| Собран | KASPI_DELIVERY_READY |
| Доставлен | COMPLETED |
| Отменён | CANCELLED |
Шаг 6. Тестирование и переход в продакшен
Перед запуском обязательно прогоните 5–10 тестовых заказов в полном цикле: создание → 1С → сборка → статус → доставка → закрытие. Только после этого подключайте всех остальных операторов.
Сколько времени это занимает
- Базовая интеграция (только обмен товарами и остатками): 5–7 рабочих дней.
- Полный цикл с заказами и статусами: 10–15 дней.
- Сложная интеграция с несколькими складами и кастомной логикой: 3–5 недель.
Большая часть времени уходит на наведение порядка в 1С — а не на программирование. Это нормально и неизбежно.
Итог
Интеграция 1С с Kaspi — пошаговый процесс, где спешка означает поломанный учёт. Идеальный порядок: номенклатура → остатки → цены → заказы → статусы. На каждом шаге проверяем, что данные летят корректно, и только потом идём дальше.
Хотите интеграцию под ключ — мы делаем её за 10–15 дней. Подробнее про услугу внедрения 1С или про автоматизацию маркетплейсов. Или сразу оставьте заявку.