# Подключение МойСклада: данные, остатки и обмен

> Подключение МойСклада к CRM BLANK KIT: внешний учёт своего склада, направления обмена, сопоставление объектов, проверка оплат и отгрузок, себестоимость и ограничения.

**Раздел:** CRM: Настройки
**Обновлено:** 2026-10-21
**Официальный URL:** https://blank-kit.ru/docs/crm-settings/moysklad
**Язык:** ru-RU

## Доступность и границы подключения

> Инструкция подготовлена к обновлению CRM. Описанные действия доступны в версии приложения с разделом интеграций; до обновления рабочего сервера они могут быть недоступны. Статья не является подтверждением уже выполненного обмена на аккаунте клиента.

Подключение предназначено для работы, в которой складской учёт ведёт МойСклад, а BLANK KIT использует проверенные данные о товарах, наличии, заказах, оплатах и исполнении. Полный цикл конкретного аккаунта требует отдельного пилота с разрешённым доступом.

CRM и доступные возможности подключения входят в текущие бесплатные условия BLANK KIT. Условия МойСклада и доступ к его API определяются самим провайдером. Будущие тарифы BLANK KIT публикуются на [странице тарифов](/pricing); бессрочная бесплатность CRM и API здесь не обещается.

## Чей товар и где ведётся учёт

Собственный товар может находиться на нашем складе, учёт которого ведётся во внешней системе. В BLANK KIT это собственный склад с режимом **«Внешнее наличие»**. Собственность и источник остатков — разные настройки.

Чтение такого склада не создаёт вторую приёмку или второй FIFO в BLANK KIT. Для дропшиппинга и бизнеса без своего запаса можно использовать склад поставщика или номинальную точку отгрузки. Включать внутренний учёт своего запаса только ради просмотра внешнего наличия не требуется.

Настройки склада доступны в [CRM → Склад → Настройки](/crm/warehouse/settings). Переход от внешнего источника к внутреннему учёту требует сверки и согласованного открытия остатков; смена названия склада этого не делает.

## Подключить аккаунт

1. Откройте [Настройки → Интеграции](/crm/settings/integrations). Нужны права управления настройками; работа со стоимостью, оплатами и исполнением требует соответствующих дополнительных прав.
2. В каталоге откройте карточку **«МойСклад»**, выберите вкладку **«Подключения»** и нажмите **«Добавить подключение»**. Задайте название подключения и адрес `https://api.moysklad.ru`.
3. Введите Bearer-токен своего разрешённого аккаунта. Секрет шифруется и повторно не показывается.
4. Включите чтение и сохраните подключение. Проверьте доступ отдельной кнопкой.
5. Загрузите каталог и наличие. Для периодического обновления задайте интервал: по умолчанию 15 минут, минимум 5 минут. Автоматический обмен требует работающего серверного worker.

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

## Направления и результат

| Данные | Направление и действие |
| --- | --- |
| Товары, модификации, услуги | МойСклад → каталог BLANK KIT, по внешним идентификаторам |
| Цены | МойСклад → каталог; в этом контуре подтверждается RUB и используется первый вид продажной цены |
| Склады и наличие | МойСклад → отдельная внешняя проекция с источником и временем обновления |
| Выбранный заказ или оплата CRM | BLANK KIT → МойСклад после сопоставления и предпросмотра; исходящие записи разрешаются отдельно |
| Оплаты и отгрузки источника | МойСклад → проверяемый пакет; применение создаёт учётные факты после проверки связей |
| Отмена учётного факта | Отдельное подтверждаемое событие, сохраняющее прежнюю историю; не выдуманный возврат товара или денег |

Отрицательное либо неполученное доступное количество не превращается в подтверждённый ноль. Неудачная загрузка сохраняет прежний снимок с ошибкой/признаком неактуальности. Отсутствующая строка нового полного снимка может стать неизвестным наличием; не считайте её обещанием прежнего положительного остатка.

## Сопоставить объекты и дату начала

В карточке **«МойСклад»** выберите **«Обмен и соответствия»** или нажмите **«Соответствия и документы»** у нужного подключения. На внутренней вкладке **«Соответствия»** загрузите справочники. Слева показан объект МойСклада, справа выбирается объект BLANK KIT по названию. Свяжите организации, контрагентов или клиентов, товары, внешние склады и заказы, затем сохраните соответствия. Если оплата уже перенесена из другой системы, сначала сопоставьте существующую запись.

Совпадение артикула или телефона не разрешает автоматически объединить разные объекты. Если один товар встречается в нескольких строках заказа, отгрузке может потребоваться отдельное соответствие строки.

На вкладке **«Правила»** укажите **начало нового обмена** в МСК. По умолчанию это создание подключения. Здесь же настраиваются подтверждённый формат себестоимости и автоматическое применение проверенных документов. Более ранние отгрузки и оплаты требуют исторического переноса: их нельзя провести текущим каналом с повторным исполнением или сегодняшними комиссиями. [Перенос истории и открытых заказов](/docs/crm-settings/retailcrm-migration) рассматривается отдельно.

## Отправить заказ или оплату

На вкладке **«Отправка»** выберите заказ CRM и, при необходимости, его оплату. Если отправка выключена, перейдите в настройки подключения и включите **«Разрешить отправку документов»**. Нажмите **«Проверить отправку»**: проверьте компанию, покупателя, товары, количества и сумму. При несопоставленной связи отправка блокируется с объяснением. Для чтения и проверки входящих документов используется отдельная вкладка **«Получение»**.

После подтверждения используйте команду отправки. Повтор проверяет прежний документ и не создаёт второй. Уже связанный документ не перезаписывается автоматически при изменении CRM: изменения требуют отдельного согласования. Отдельная платная доставка без согласованной услуги и суммы даёт конфликт вместо тихого изменения итогов.

Неизвестный ответ источника после обрыва соединения не означает отказ. Система ищет результат по прежнему идентификатору. Не создавайте новую оплату или заказ только ради повторной отправки.

Запись оплаты в МойСкладе фиксирует факт в учётной системе и не переводит деньги через банк.

## Применить входящие данные и проверить прибыль

Прочитайте заказы, оплаты и отгрузки в проверяемый пакет. В предпросмотре видны отсутствующие связи, суммы, количества, неизвестная стоимость и предлагаемые отмены. После исправления соответствий нажмите повторную проверку, затем примените проверенные факты.

Текущая подтверждённая оплата проходит общий финансовый сервис CRM один раз. Отгрузка со склада с внешним учётом создаёт факт исполнения без второго списания внутреннего склада. Чужой резерв, уже исполненное количество и права участника продолжают проверяться.

Фактическую себестоимость нельзя брать из сегодняшней закупочной цены карточки. Используется подтверждённый исторический факт источника. Если поле стоимости недоступно либо его единицы не сверены в пилоте аккаунта, себестоимость остаётся неизвестной, а прибыль — неполной. Подтверждение формата стоимости в настройках не следует включать без такой сверки.

Проведённые количества и стоимость не переписываются молча. При подтверждённом изменении оператор указывает основание отмены прежнего учётного факта, получает новый пакет и проверяет его отдельно. Связанные корректировки могут запретить отмену.

Физический возврат, изменение суммы продажи и возврат денег — отдельные связанные события. Возврат источника нельзя автоматически объявить отменой всей отгрузки. Неразрешённые случаи остаются конфликтом с исходным протоколом.

## Автоматическое применение и ограничения

Автоматическое применение проверенных сопоставленных фактов включается отдельно. Оно влияет на реальные учётные оплаты и исполнение после даты начала обмена. Неизвестные связи и изменённые проведённые документы остаются в протоколе. Включение чтения не разрешает исходящие записи само по себе.

Сейчас в этом контуре поддерживается RUB. Несколько заказов в одном платеже требуют явной разбивки. Недоступная история, неоднозначные строки, неподтверждённая стоимость, иная валюта или несовпадение коммерческих условий дают ограничение/конфликт, а не сообщение о полном успехе.

Для решения о переходе проверьте на разрешённом аккаунте два прихода по разным ценам, частичное исполнение, оплату, отмену/возврат, остатки и прибыль. Проверки адаптера на стенде не являются проверкой конкретного аккаунта. Если нужна помощь со сверкой, приложите к [обращению в поддержку](/support) безопасный протокол без токенов.