МойСклад → AgentPay · инструкция для магазина

Вариант A — решение из каталога МойСклад

После публикации нашего решения администратор аккаунта МС:

МойСклад → раздел решений / приложений → найти AgentPay → Установить.
Подтвердить доступ к товарам и заказам покупателя.
Откроется кабинет /business (iframe или редирект). Нажмите «Синхронизировать».

Вариант B — пилот по токену JSON API

МойСклад → Настройки → Токены (или пользователь для API). Создайте токен с правами на товары и customerorder.
/business → создать магазин, коннектор МойСклад.
Передайте токен в карточку магазина (поле API-ключа коннектора) или в тикете пилота на help@agentpay.shop — токен хранится только на стороне AgentPay.
«Синхронизировать». Коды товаров МС (code) станут SKU в AgentPay; цена берётся из salePrices (копейки → рубли). Фид Яндекс.Маркета и JSON-выгрузку с сайта не отдавайте: каталог забираем из МойСклад.

Каталог и отзывы

Нажмите «Синхронизировать». Каталог забираем из МойСклад, отдельный фид не отдавайте. После синка в кабинете укажите роль доп. атрибутов номенклатуры: описание, анализ, отзывы. В учёте отзывов обычно нет. Оставьте поля пустыми или замапьте свой атрибут. Виджеты на витрине не разбираем.

Как выглядит заказ

В МойСклад создаётся заказ покупателя. Имя документа = purchaseId AgentPay, в описании строка AgentPay purchaseId=…. Контрагент служебный «AgentPay», если не задан свой. Позиции привязаны к assortment (товар по коду/UUID).

Повтор того же purchaseId не создаёт второй заказ.

Адрес доставки кладётся в shipmentAddress / shipmentAddressFull: улица, дом, квартира, подъезд, домофон. Отправление в СДЭК создаёт ваш сценарий МойСклад, не AgentPay. Когда появится трек, верните trackingNumber в статус заказа AgentPay.

Когда МойСклад не тот путь

Заказы уже принимает сайт (Woo / InSales / 1С-Битрикс) — подключайте сайт, МС оставьте складом за CMS.
Нужен только webhook на вашу CRM — см. Merchant API.

Служебные URL (IT)

POST {API}/integrations/moysklad/vendor/1.0/apps/{appId}/{accountId}
GET  {API}/integrations/moysklad/vendor/1.0/apps/{appId}/{accountId}
DELETE {API}/integrations/moysklad/vendor/1.0/apps/{appId}/{accountId}

Локально {API} = http://localhost:3100.