API для торговли и производства: интеграция с системой МойСклад

У бизнеса редко бывает так, чтобы одной программы хватало на все задачи. МойСклад можно использовать не только «как есть». Если бизнесу нужен свой сценарий работы, это можно настроить через API.

В статье покажем, как это работает, какие задачи можно решить с помощью API, с чего начать, если хотите разрабатывать сами, и куда обратиться, если нужна доработка под ваш бизнес.

Эксперт статьи

Что такое API и зачем он нужен

Современные компании выстраивают свои процессы как единую экосистему: интернет-магазин, CRM, бухгалтерия, склад и касса работают вместе. Чтобы все эти системы обменивались данными, нужен API (Application Programming Interface) — интерфейс для связи между программами.

Простыми словами, API — это набор правил, по которым одна программа может попросить другую что-то сделать: передать заказ, вернуть остатки, создать документ, обновить статус или показать нужные данные. Пользователь этих правил не видит — с ними работает разработчик.

Для бизнеса API нужен там, где ручная работа уже мешает расти. Вместо того чтобы переносить заказы с сайта в учетную систему, копировать остатки в интернет-магазин или вручную обновлять статусы, можно настроить автоматический обмен данными. Это быстрее, точнее и проще контролировать.

API — это инструмент, с помощью которого разработчик может делать разные улучшения:

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

API экономит время, снижает количество ошибок и делает работу компании более прозрачной. В большинстве случаев использование API заменяет работу одного или нескольких сотрудников, что позволяет компаниям существенно экономить на зарплатах.

Какие есть API

У МоегоСклада их несколько. Разные API решают разные задачи: одни помогают работать с данными и документами, другие — подключать кассу, телефонию, программы лояльности, оплату по QR или сервисы фискализации. Ниже — краткая «карта», чтобы было понятно, что выбирать в вашем случае.

JSON API

Это основной API, который позволяет работать практически со всеми сущностями МоегоСклада: читать, изменять и создавать их.

Это может быть интеграция с внешним сервисом: загружать в МойСклад заказы с самописного сайта, менять статусы или выгружать во внешний сервис аналитики данные по продажам. Или можно автоматизировать работу пользователей в аккаунте: например, менять статусы в документах, ставить в резерв, править названия товаров и многое другое.

Loyalty API

Этот API позволяет интегрировать кассу МойСклад с внешними программами лояльности (бонусными программами). С его помощью вы можете подключить сторонний сервис, если его на данный момент нет в каталоге решений, или разработать индивидуальную бонусную систему, которая будет работать в связке с вашим аккаунтом в МоемСкладе.

POS API

Это API для подключения сторонних кассовых программ. В такой интеграции МойСклад будет выступать в роли бэк-офиса (товаро-учетной системы). К ней можно будет подключить стороннюю кассу — программное обеспечение, в котором будет работать кассир, куда из МоегоСклада будут передаваться данные по товарам: описание, цена и остатки, а в обратную сторону — розничные продажи, смены и прочее.

API телефонии

API для подключения сервисов телефонии. Позволяет звонить из карточки контрагента, сохранять историю и записи разговоров в МоемСкладе, а также показывать сотруднику карточку звонка во время входящего или исходящего вызова. Через это API можно связать звонок с контрагентом, сотрудником и добавочным номером, а после завершения — передать запись разговора, длительность и комментарий.

Fiscal API

API для вендоров и партнеров из стран СНГ, где существуют свои региональные особенности по фискализации продаж. С помощью API можно подключить к Кассе МоегоСклада сторонний сервис фискализации, в который будет отправляться информацию о продаже: товар, способ оплаты и другие необходимые данные. Сервис фискализации в ответ пришлет чек, который можно будет распечатать на кассе, подключив к ней принтер чеков. Пример — решение для Казахстана.

QRPay API

Еще один API для расширения возможностей кассы. Позволяет подключать сервисы для оплаты по QR. Касса МойСклад также отправляет данные о продаже, в ответ сервис формирует QR-код, который отображается на кассе или терминале для оплаты. Покупатель сканирует, оплачивает — в Кассу МойСклад приходит статус об успешной оплате, можно печатать чек. Примеры интеграций.

Vendor API

Это API для работы с магазином приложений МоегоСклада. Он нужен тем, кто хочет публиковать свои решения: через него можно управлять установкой и удалением приложения, настраивать пробный период и тарифы. Обычно Vendor API используют вместе с JSON API: первый отвечает за публикацию и жизненный цикл решения, второй — за сам функционал.

Как работать с API МойСклад

Есть несколько вариантов работы.

Доступно малому бизнесу

API в МоемСкладе доступен не только крупным компаниям. JSON API бесплатный, не требует отдельной регистрации и работает на всех тарифах. На Бесплатном и Старте есть ограничения, но для первых сценариев этого часто достаточно. Если нужен полный набор возможностей, можно зарегистрировать тестовый аккаунт и проверить идею на практике.

Для малого бизнеса это означает, что не нужно сразу нанимать команду разработчиков или запускать большой проект. Часто путь проще: поставить готовое решение из каталога, заказать точечную доработку у партнера или написать небольшой скрипт под свой процесс.

Для несложных задач в этом уже помогает ИИ: с его помощью можно быстрее подготовить скрипт, шаблон обмена данными или черновик интеграции.Главное, подходить с умом: понимать задачу, проверять результат и не запускать в работу непроверенные решения.

API полезен не только тем, кто строит сложную ИТ-систему, но и тем, кто хочет убрать ручной перенос заказов, остатков, платежей и статусов.

Безопасность API-интеграций

У МоегоСклада доступ к API не открыт для всех: для подключения нужна авторизация, права зависят от учетной записи, а обращения к API можно отслеживать в статистике использования.

На практике безопасность начинается с организации работы. Если интеграция работает от учетной записи сотрудника, ее можно случайно остановить, если деактивировать сотрудника или сбросить пароль. Перед такими действиями стоит проверять отчет Статистика использования API: он показывает, какие учетные записи обращаются к API и в какое время.

Этот же отчет помогает увидеть пиковую нагрузку. У МоегоСклада есть лимиты на количество запросов, поэтому тяжелые синхронизации лучше разводить по времени. Если несколько интеграций запускаются одновременно, они могут мешать друг другу.

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

Каталог решений МоегоСклада

Прежде чем задумываться о разработке «кастомной» интеграции, поищите уже готовые.
У нас есть каталог решений — это витрина готовых приложений и интеграций, созданных партнерами и профессиональными разработчиками для пользователей МоегоСклада.

Изучить доступные варианты можете на сайте в разделе интеграций или прямо внутри вашего аккаунта в «Каталоге решений».

В каталоге можно найти:

• интеграции с ЭДО, маркетплейсами, банками, бухгалтерией;
• инструменты аналитики, доставки и документооборота;
• специализированные решения для отраслей.

В карточке решения есть подробное описание, инструкции, картинки, а также указана стоимость и контакты разработчика.

Большинство решений имеют пробный период до 14 дней, то есть можно установить и проверить функционал до его покупки.

10 незаменимых решений для бизнеса

В нашем каталоге среди самых востребованных решений — интеграции с банками, 1С, программы лояльности и инструменты для автоматизации. Собрали на основе предпочтений клиентов топ лучших решений 2025 года.

Онлайн-заказ. Самое популярное решение в каталоге — позволяет быстро запустить онлайн-продажи без сайта. Подходит для оптовых и розничных продаж.

Интеграция с 1C. Поддерживает загрузку всех документов, прослеживаемые (РНПТ) и маркированные товары, QR-оплаты.

Управление ценами. Можно работать с курсами валют, автоматически рассчитывать цены комплектов, использовать гибкие сценарии и др.

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

BonusMoney. Если нужно создать свою систему лояльности, включает не только операции с бонусами клиентов, но и возможность делать заказы прямо в электронной карте.

Интеграция с Авито | UnitXML. Чтобы быстро подключить продажи на маркетплейсе Авито и общаться с клиентом прямо из Заказа покупателя через встроенный мессенджер.

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

Роботы 365. Автоматизация действий. Решение для быстрого выполнения рутинных задач внутри МоегоСклада.

BankSklad — экспорт платежей и автоматический импорт выписки из банков. Интеграция работает с 13 банками: можно загружать в МойСклад входящие платежи, и выгружать в банк платежки.

Интеграция с inSales. Автоматически синхронизирует все данные между МоимСкладом и inSales, цены, остатки и статусы заказов в режиме реального времени.

Как начать разрабатывать интеграции самому

Если вы хотите самостоятельно создать интеграцию или приложение, начать можно так.

1. Определите конкретную задачу. Не «интегрировать все со всем», а один понятный сценарий: выгружать заказы с сайта, обновлять остатки, менять статус документа, отправлять уведомление в мессенджер.
2. Выберите тип интеграции.Если нужно работать только с данными, чаще всего хватит JSON API. Если нужны кнопки, виджеты и доработка интерфейса, смотрите в сторону приватного или публичного решения и регистрации кабинета разработчика.
3. Зарегистрируйте отдельный тестовый аккаунт. Первые шаги лучше делать не в боевом аккаунте с живыми данными, а в отдельном тестовом контуре. Так вы не рискуете случайно испортить рабочие данные или сломать процессы. Если что-то пойдет не так, не придется ничего восстанавливать. Если нужен полный набор возможностей, можно использовать пробный тариф.
4. Сделайте несколько простых запросов. Обычно начинают с чтения данных: например, получить список товаров, контрагентов или заказов. Когда ответ стал понятен, переходят к созданию и обновлению сущностей.
5. Соберите минимальный рабочий сценарий. Для первого шага не нужно писать большое приложение. Часто достаточно небольшого скрипта, который забирает данные из одной системы и отправляет их в другую.
6. После запуска следите за отчетом Статистика использования API. Он поможет понять, кто ходит в API, в какое время идет пик запросов и нет ли ошибок в интеграции.

Для старта достаточно базовых знаний HTTP-запросов и работы с JSON. Если вы знакомы с Python, JavaScript или PHP, начать будет проще. Если нет — можно сначала обратиться к AI, например Chat GPT, или подключить разработчика на первый этап.

Где найти разработчика

Если разработать самостоятельно — не ваш случай, можно найти стороннего разработчика. Вариантов несколько.

Взять программиста в штат (инхаус-разработчик)

Имеет смысл, если вы понимаете, что сможете полноценно загрузить его работой: у вас много систем, которые нужно синхронизировать между собой и поддерживать их работоспособность, есть задачи по разработке индивидуальных решений под ваш бизнес (своя система аналитики, разработка самописного сайта, свое кассовое ПО и другое).

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

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

Заказать разработку у партнеров МоегоСклада

У МоегоСклада более 600 партнеров, которые профессионально занимаются внедрением и интеграцией сервиса. Это может быть как разовая доработка, так и постоянное сотрудничество: поддержка, развитие, новые автоматизации.

Плюсы: партнер хорошо знает, как работает МойСклад, что такое API и как с ним работать. Часто у него уже есть похожий опыт, поэтому он может предложить более быстрый и практичный способ решить задачу.

Недостатки: стоимость работ обычно выше, чем у фрилансера, но за это вы покупаете опыт именно в МоемСкладе и меньше рискуете ошибиться на старте.

Самому найти разработчика

Например, на Авито, Профи.ру, FL.ru и похожих площадках. Для работы с API МоегоСклада важнее не конкретный язык программирования, а опыт интеграций и понимание логики учета. В другом случае стоимость таких услуг может быть ниже, чем у сертифицированных партнеров МоегоСклада, но разработчик будет учиться на вас, что может приводить к ошибкам в работе интеграции в дальнейшем.

Плюсы

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

Недостатки

• Разработчик может не знать МойСклад и будет разбираться на вашем проекте.
• Без четкого ТЗ и документации выше риск ошибок и переделок.
• После сдачи проекта поддержка может оказаться сложнее, чем у партнера или штатного сотрудника.

Как опубликовать свое приложение

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

1. Заполните анкету разработчика на сайте для разработчиков.
2. Получите доступ в кабинет разработчика. Для публикации публичного решения нужен ИП или юрлицо из России или СНГ, расчетный счет в рублях и профильная деятельность — разработка ПО.
3. Разработайте решение с помощью подходящего API. Обычно это JSON API для бизнес-логики и Vendor API для работы с приложением. Для отдельных сценариев могут понадобиться LoyaltyAPI, Phone API, Fiscal API или QRPay API.
4. Протестируйте решение и отправьте его на модерацию.
5. После публикации управляйте версиями, установками и статистикой уже из кабинета разработчика.

Если не хотите публиковать решение на всех пользователей, но вам нужны кнопки, виджеты и работа с интерфейсом МоегоСклада, можно выбрать формат приватного решения. Это хороший вариант для внедренцев, франчайзинговых сетей и компаний с несколькими связанными аккаунтами. Для приватного решения требование о профильной деятельности — разработке ПО — не требуется.

Резюме

API МоегоСклада — это не просто инструмент для разработчиков. Это основа, на которой строятся интеграции, автоматизация и развитие бизнеса. Он помогает компаниям работать быстрее, точнее и без ручных ошибок, а партнерам и разработчикам создавать востребованные решения и зарабатывать на них.

Используйте API, чтобы раскрыть весь потенциал МоегоСклада и построить систему, которая работает именно под ваш бизнес.