# МойСклад

{% hint style="danger" %}
Для успешной интеграции у вас должен быть оплаченный тариф с опцией работы интеграции по вебхукам в МойСклад
{% endhint %}

### Возможности интеграции

1. Импорт товаров и категорий 
2. Синхронизация цен и остатков: автоматическое обновление цен и остатков товаров из МойСклад
3. Передача заказов в МойСклад: автоматическое создание заказов из TGShop в МойСклад

\
**Настройка интеграции с МойСклад по шагам:**

1\. Перейдите на вкладку “Интеграции” и нажмите кнопку “Добавить интеграцию”.

<div align="left"><figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FUqg3o02EpyoJYCwCLD4P%2F1_2.png?alt=media&#x26;token=a6024025-d002-414a-a1f2-b497aed6a397" alt="" width="563"><figcaption><p>Начало интеграции с МойСклад</p></figcaption></figure></div>

2. Введите ваш токен из МойСклад (Настройки → Токены) и добавьте интеграцию. Как найти токен в МойСклад ↓

{% hint style="danger" %}
Для корректной работы МойСклад с другими сервисами необходимо использовать всегда один и тот же токен. Если у вас уже подключена интеграция с МойСклад к сайту или другому сервису необходимо использовать токен, который был использован для этой интеграции. При создании нового токена - все текущие интеграции с МС перестанут работать.&#x20;
{% endhint %}

<div align="left"><figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2F8hsBckE8XBOyCn3s2hW1%2F2_6_1.png?alt=media&#x26;token=a58b0864-722e-4cd0-90aa-667a16dff075" alt="" width="563"><figcaption><p>Токен в МойСклад</p></figcaption></figure></div>

3. Нажмите на иконку “Три точки” и перейдите в “Настройки”.

<div align="left"><figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FFBXRcWKhB80W4bQwyQXc%2F3_5.png?alt=media&#x26;token=de6851d3-f591-4d64-88dc-8f1dfd85c499" alt="" width="563"><figcaption><p>Настройки интеграции</p></figcaption></figure></div>

4. Настройте “Тип склада”. В данный момент можно настроить синхронизацию остатков только одного склада или со всех складов сразу.&#x20;
5. Выберите организацию.&#x20;
6. Выберите тип привязки товаров: по артикулу или внешнему идентификатору.&#x20;

{% hint style="danger" %}
**Важно:** для синхронизации товаров по внешнему идентификатору, товары должны быть импортированы из МойСклад. Либо импортированы из xls/xml-файла. В ID продукта (при импорте из xls) или offerID (при импорте через xml-файл ) необходимо указать внешний код товаров из МС или их внешний идентификатор, который используется вами для учета товаров.
{% endhint %}

<div align="left"><figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FaPYlhzMDUHL1lHpkmuUM%2FConfig.png?alt=media&#x26;token=eca0ac2c-212b-499f-b88b-cf19dd6e143c" alt="" width="274"><figcaption></figcaption></figure></div>

5. Укажите, что делать, если SKU (модификации товара) нет в МойСклад&#x20;
6. Укажите, что делать, если товара нет в МойСклад.&#x20;

{% hint style="danger" %}
Если вы укажите вариант "Удалить", то система будет удалять из TGShop SKU (модификацию товара) / Товар целиком.
{% endhint %}

7. Если вы хотите, чтобы заказы из TGShop в автоматически передавались в МойСклад, включите эту опцию.&#x20;
8. Если вы хотите подключить синхронизацию цен из МойСклад, нужно включить эту опцию и настроить тип “Цены продажи” (обязательное поле) и тип “Старой цены” (необязательное поле).

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2F2RBBnSAphaNNjdV5GhHk%2F5_4.png?alt=media&#x26;token=ecf45f76-c773-4094-987b-89c554d6fa4c" alt=""><figcaption><p>Настройка типов цен и выбор склада</p></figcaption></figure>

6. Если вы хотите включить импорт товаров из МойСклад, включите опцию "Добавлять новые товары из файла". Для того, чтобы эта опция была доступна - включите синхронизацию цен.&#x20;
7. Если вы хотите выгрузить не все товары из МойСклад, а только определенные категории или хотите исключить какие-то категории выберите необходимые опции. Если на предыдущем шаге вы выбрали определенный склад, то товары будут импортироваться только с этого склада.&#x20;

После этого укажите в какую категорию в TGShop вы хотите импортировать выбранную вами категорию. По умолчанию стоит "все категории", при выборе этой опции товары будут импортированы в дефолтную категорию внутри TGShop.&#x20;

<div align="left"><figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FzdJuuxqtKWDnF4dK5O1r%2FConfig%20(1).png?alt=media&#x26;token=36e64ca4-7bfe-4c8c-8722-1a35a301be8c" alt="" width="274"><figcaption></figcaption></figure></div>

8. Если вы хотите защитить от изменений определенные характеристики товара, выберите необходимые опции. Например, если вы не хотите, чтобы при импорте у товаров обновлялось фото, отметьте "галочкой" эту характеристику.&#x20;
9. Укажите значения параметров товара, если вы хотите для своего свойства из МойСклад добавить свойство к товару при импорте в TGShop. Вариант товара - будет отображаться в карточке товара как отдельный его вариант, характеристика - будет отображаться только в описании карточки товара.&#x20;

<div align="left"><figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2Fe71gIaBaW3ZsqYGvKwdA%2FConfig%20(2).png?alt=media&#x26;token=4df56a02-3639-4dd4-9e37-9a1f6741d68f" alt="" width="274"><figcaption></figcaption></figure> <figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FH3Klti1npdHH6SFkDXtH%2FConfig%20(3).png?alt=media&#x26;token=fef1b7a1-93ea-477f-9bd0-48d03d48428c" alt="" width="274"><figcaption></figcaption></figure></div>

6. После настройки остатков и цен необходимо нажать на кнопку “Активировать” для активации интеграции и ее настроек.

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FDU68OwInBjaL1DAPpL8B%2F6_2.png?alt=media&#x26;token=e9c9725d-80c5-46d4-a1a8-874544e850f3" alt=""><figcaption><p>Активация настроек интеграции</p></figcaption></figure>

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

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FOQRqBt5O7dTW1B6SBQfI%2FMC.png?alt=media&#x26;token=d1abb003-7e8b-4110-9329-28eb804e7538" alt=""><figcaption><p>Связать товары</p></figcaption></figure>

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

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FbH4ZlDIkxPq4PXEh59L8%2FMC2.png?alt=media&#x26;token=7176e19b-8d56-46b6-b65e-34f483df67f0" alt=""><figcaption><p>Синхронизация товаров</p></figcaption></figure>

{% hint style="info" %}
**Важно!** После связки товаров система начнет автоматически обновлять цены / остатки при следующем изменении в МойСклад, а также импортировать новые товары со склада. После ручного нажатия на кнопку "синхронизировать" система обновит по всем товарам цены/остатки, а также импортирует товары если ваши настройки интеграции МойСклад с TGShop позволяют это сделать.&#x20;
{% endhint %}

**Что происходит, если у вас товары в МойСклад добавлены в архив?**

После изменения статуса Активный/Архивный в МойСклад, чтобы количество обнулилось или, наоборот, восстановилось, нужно нажать кнопку “синхронизация”.

**Как работать с комплектами?**\
В данный момент интеграция не поддерживает синхронизацию цен и остатков для комплектов. При связывании Telegram-каталога с МойСклад данные товары не будут связаны. Для обновления цен и остатков таких товаров необходимо использовать импорт в TGShop.