Сайт → МойСклад → MAXMA




1. Общие положения

Цель: Синхронизация данных о заказах между сайтом, МойСклад и платформой лояльности MAXMA.Участники системы:
  • Сайт: Интернет-магазин клиента
  • МойСклад: Платформа для управления заказами
  • MAXMA: SaaS-платформа для управления программой лояльности


2. Процесс оформления заказа

2.1. Создание заказа в МойСклад

    Клиент оформляет заказ на сайте
    Сайт отправляет заказ в МойСклад через API
    МойСклад создает заказ и возвращает уникальный orderUuid

2.2. Отправка данных в MAXMA

Сайт выполняет 2 запроса в разные сервисы MAXMA:
Запрос 1 - Непубличный API MAXMA для интеграции с МС:
POST https://moysklad.maxma.com/ext-api/set-order?key=<requestKey>&version=<version>
Тело запроса:
{
  "orderUuid": "полученный_id_из_мс",
  "firstLoad": false,
  "shopCode": "yourwebsite.com",
  "shopName": "yourwebsite.com",
  "applyBonuses": 100,
  "promocode": "SUMMER2025"
}
requestKey, version - выдает менеджер

Запрос 2 - Официальный API MAXMA:
Для сайта на Bitrix этот запрос обычно делает модуль MAXMA для Bitrix, однако номер заказа должен совпадать с тем, который был присвоен заказу системой МойСклад.
POST /v2/set-order
Тело запроса:
{
  "calculationQuery": {
    "applyBonuses": 100,
    "client": {
      "phoneNumber": "+79000000000"
    },
    "collectBonuses": "auto",
    "discountRoundStep": 0,
    "executedAt": "2025-01-14T16:36:04+03:00",
    "rows": [
      {
        "autoDiscount": 0,
        "id": "266233",
        "manualDiscount": 0,
        "noApplyBonuses": false,
        "noCollectBonuses": false,
        "noOffer": false,
        "noPromocode": false,
        "product": {
          "blackPrice": 2790,
          "externalId": "131135",
          "minPrice": 0,
          "redPrice": 3290,
          "sku": "3bb4fce9-18bc-11ed-9ec2-000c292cefe1",
          "title": "Название товара"
        },
        "qty": 1
      }
    ],
    "shop": {
      "code": "site",
      "name": "site"
    }
  },
  "orderId": "полученный_orderUuid_из_МойСклад"
}


3. Действия менеджера в интерфейсе МойСклад

Менеджер работает в интерфейсе с помощью плагина для Chrome. Дополнительных действий по интеграции здесь не требуется.


4. Требования к данным

4.1. Критически важные данные "Заказ"

  • orderUuid: Уникальный ID из МойСклад, используется как orderId в MAXMA
  • externalId: ID товара в MAXMA, должен совпадать с ID в МойСклад
  • sku: Артикул товара (обязателен для возвратов) должен совпадать с ID в МойСклад

4.2. Критически важные данные "Клиент"

  • Примененный промокод (promocode)
  • Индификация клиента (phoneNumber)
  • Количество списанных бонусов (applyBonuses)


5. Дополнительные указания

5.1. Согласование статусов

  • Определить конкретные статусы в МойСклад для отмены и подтверждения

5.2. Тестирование

  • Протестировать все сценарии в тестовом окружении MAXMA
  • Проверить корректность передачи orderUuid между системами
Примечание: Все даты должны передаваться в формате ISO 8601 с указанием часового пояса.