Интеграция Kaspi с 1С и МойСклад: остатки и себестоимость
Мост остатков решает одну задачу: склад ведётся там, где вы его уже ведёте, а Kaspi получает актуальные числа без ручного переноса. Ниже — что требуется для подключения каждой системы, как сопоставляются товары, что происходит с себестоимостью и какие ограничения у моста есть на самом деле.
Что делает мост и чего он не делает
Мост забирает остатки из вашей учётной системы и отдаёт их в Satushy, а оттуда они уходят в Kaspi вместе с обычной синхронизацией. Направление одно: из учётной системы к нам. Обратно в 1С или МойСклад сервис ничего не пишет — ни заказы, ни списания, ни документы.
Из этого следует главное правило работы: пока мост включён, хозяин остатков — ваша учётная система. Ручные правки склада в Satushy, приёмка по штрихкодам, списания и инвентаризация перезапишутся ближайшей выгрузкой, поэтому проводить их нужно там же, в 1С или МойСкладе.
1С: два способа подключения
Способ выбирается по одному признаку — видна ли ваша база из интернета. Если в 1С заходят по ссылке в браузере (1С:Фреш или своя база с веб-публикацией) — подходит первый способ. Если через ярлык на рабочем столе — второй; так работает у большинства.
| Способ | Кто к кому ходит | Что нужно сделать |
|---|---|---|
| База доступна по интернету | Satushy сам заходит в 1С раз в 30 минут | Включить стандартный интерфейс OData и завести отдельного пользователя для обмена |
| База в локальной сети | 1С сама отправляет выгрузку по ключу | Добавить обработку выгрузки на стороне 1С — ключ выдаётся при подключении |
Что настраивается в самой 1С для первого способа
- Настройки → Синхронизация данных → «Настройки стандартного интерфейса OData». В 1С:Фреш другого пути нет: «Все функции» подписчику недоступны.
- Отдельный пользователь для обмена на вкладке «Авторизация» — он не сможет заходить в программу, логин и пароль вы придумываете сами.
- На вкладке «Состав» отмечаются справочник «Номенклатура» и регистр остатков — без них читать будет нечего.
- Ничего программировать не нужно: это штатный механизм 1С.
Что нужно для второго способа
- Выгрузку отправляет сама 1С, поэтому обработку ставит тот, кто её обслуживает — со стороны Satushy выдаются ключ и адрес.
- В каждой позиции нужен хотя бы артикул, штрихкод или идентификатор — иначе позицию не с чем сопоставить.
- Количество передаётся целиком, а не изменением: «на складе 7», а не «минус 2».
МойСклад: токен и десять минут
Подключение занимает одно поле: API-токен, выпущенный в кабинете МойСклада. Выдать его может только владелец аккаунта — у сотрудника с ограниченными правами раздела «Обмен данными» может не быть. Токен хранится зашифрованным и обратно в приложении не показывается.
Сразу после подключения товары сопоставляются автоматически, дальше остатки подтягиваются каждые десять минут. Для МойСклада стоит завести отдельный токен: если вы его отзовёте, ваши остальные интеграции не пострадают.
Себестоимость из МойСклада и защиты вокруг неё
Кроме остатков, МойСклад умеет отдавать закупочные цены — из них получается себестоимость, без которой приложение показывает оборот, а не прибыль. Перенос включается отдельно и работает в одном из двух режимов: заполнять только пустые или перезаписывать всё.
Закупочные цены снимаются в момент сопоставления товаров, а не при каждой синхронизации. Поменяли закупку в МойСкладе — нажмите «Сопоставить заново», иначе в Satushy останется прежняя.
Как сопоставляются товары
Позиции связываются по артикулу и по штрихкоду. Результат сопоставления виден числом: столько-то по артикулу, столько-то по штрихкоду, столько-то конфликтов.
Конфликт — это когда в учётной системе один артикул или штрихкод стоит у нескольких позиций. Остатки таких товаров замораживаются: сервис не угадывает наугад и не обнуляет их. Они не синхронизируются, пока неоднозначность не убрана на вашей стороне, после чего помогает кнопка «Сопоставить заново».
Дальше: как остаток попадает на Kaspi
Остаток и цена уходят на площадку двумя каналами. Через кабинет магазина — точечно, минутами. Через XML-фид — площадка забирает прайс-лист сама раз в 60 минут, и этот интервал задан на её стороне, ускорить его нельзя.
Поэтому цепочка «1С → Satushy → Kaspi» быстрее всего работает, когда подключён кабинет: десять минут на мост и минуты на доставку. На одном XML-фиде к этому добавляется до часа ожидания площадки.
Ключи и доступы
Ни один ключ сервис за вас не выпускает: ни токен Kaspi, ни токен МойСклада, ни ключ Нацкаталога, ни пользователя OData в 1С. Это ваши ключи от ваших систем — вы их создаёте и в любой момент отзываете, не спрашивая нас.
Всё, что вы выдали, хранится зашифрованным, используется только для работы функций сервиса и стирается при отключении интеграции.
На каких тарифах доступны мосты
При оплате за год дополнение, как и тариф, дешевле примерно на 20 %. Отключение моста не стирает остатки: последние переданные числа остаются в Satushy, и дальше складом снова можно управлять внутри приложения.
| Тариф | Интеграции 1С и МойСклад |
|---|---|
| Старт · 9 990 ₸ | Дополнением — 14 990 ₸ в месяц |
| Про · 29 990 ₸ | Дополнением — 14 990 ₸ в месяц |
| Бизнес · 69 990 ₸ | Входит в тариф |
| Пробный период · 3 дня | Доступны |
Частые вопросы
Что будет с остатками, если я отключу 1С?
Последние переданные числа останутся, и склад снова станет вести Satushy: ручные правки, приёмка и инвентаризация перестанут перезаписываться. Товары, замороженные из-за конфликтов сопоставления, разморозятся.
Нужен ли программист 1С?
Для базы, доступной по интернету, — нет: всё делается штатными настройками OData. Для базы в локальной сети выгрузку отправляет сама 1С, и обработку ставит тот, кто её обслуживает — со стороны сервиса выдаются ключ и адрес.
Почему остатки некоторых товаров не обновляются?
Чаще всего это конфликт сопоставления: в учётной системе один артикул или штрихкод стоит у нескольких позиций. Такие товары показаны отдельно с причиной; их остатки заморожены, чтобы не уехало наугад. После правки в 1С или МойСкладе помогает «Сопоставить заново».
Можно ли подключить и 1С, и МойСклад одновременно?
Мост остатков в магазине один — у остатка должен быть ровно один хозяин. Выбирается та система, в которой склад ведётся на самом деле.
Перенесётся ли себестоимость из 1С?
Из 1С мост берёт остатки. Закупочные цены переносит МойСклад — при сопоставлении товаров и с ограничениями: без понижения себестоимости товара под ботом, без расхождений больше чем втрое, без валютных закупок. Если моста нет, себестоимость заводится приёмкой или файлом.
Как быстро изменение остатка доходит до Kaspi?
МойСклад — до десяти минут до Satushy, 1С по OData — до тридцати. Дальше зависит от канала: через кабинет магазина минуты, через XML-фид — до часа, потому что прайс-лист площадка забирает сама раз в 60 минут.
Другие возможности
Посмотрите на своём магазине
Три дня бесплатно, карта не нужна. Подключение занимает около десяти минут и не требует программиста.
Создать аккаунт