> For the complete documentation index, see [llms.txt](https://topseller.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://topseller.gitbook.io/help/instruction/ts-connect/settings/wildberries/api-1/api/orders/tuning.md).

# Новый заказ

### Обзор раздела

Перед настройкой данного раздела рекомендуем подготовить учетную систему МойСклад, Подробная инструкция [здесь](https://help.topseller.ru/~/revisions/ZPRFvx36f8oI5cBr71SG/instruction/ts-connect/prepare-accounting-system/moysklad)

Раздел "Новый заказ" определяет, как заказы будут отображаться и обрабатываться в системе МойСклад. Настройка этого раздела является обязательной перед запуском импорта заказов.&#x20;

### Обязательные поля

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

* [**Организация**](https://support.moysklad.ru/hc/ru/articles/360010899237-Юрлица) - ваше юридическое лицо, заведенное в МоемСкладе. Без указания организации не создастся ни один документ в системе.
* [**Контрагент**](https://support.moysklad.ru/hc/ru/articles/236087988-Создание-контрагента) - юридическое лицо маркетплейса (например, ООО ВАЙЛДБЕРРИЗ). Также обязательно для создания документов МоемСкладе.
* [**Склад отгрузки по дефолту**](https://support.moysklad.ru/hc/ru/articles/360016263153-Создание-и-редактирование-склада) - склад, который будет автоматически указываться в заказах покупателей и документах отгрузки. С этого склада будут резервироваться остатки заказами и списываться отгрузками.

### Точное соответствие складов Вайлдберриз складам МоегоСклада

Если вы хотите работать с региональными складами Вайлдберриз и стандартное назначение одного виртуального склада для всех заказов не подходит, настройте соответствие складов. Так у вас заказы будут разбиты по региональным складам маркетплейса.

#### Процесс настройки:

* **Сопоставление:** В левой части выберите склад Вайлдберриз, в правой - соответствующий склад из системы МойСклад
* **Удаление связок:** Для удаления неактуальных связок используйте кнопку удаления <img src="/files/jfNIarW0bhm3YNsds4oX" alt="" data-size="line">
* **Сохранение:** Обязательно сохраните внесенные изменения

{% hint style="info" %}
**Примечание:**

Настройка соответствия складов с региональными складами маркетплейса, в разы увеличит ручную работу. Так как Вайлдберриз в АПИ не дает возможности отследить на какой склад направился товар после возврата, поэтому их нужно будет обрабатывать вручную.&#x20;
{% endhint %}

#### Необязательные поля

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

* [**Проект**](https://support.moysklad.ru/hc/ru/articles/205529477-Проекты) - заполняет поле проекта в документах МоегоСклада
* [**Канал продаж**](https://support.moysklad.ru/hc/ru/articles/4403265549585-Каналы-продаж) - заполняет канал продаж в документах МоегоСклада
* [**Договор**](https://support.moysklad.ru/hc/ru/articles/218121398-Договоры) - заполняет договор в документах МоегоСклада&#x20;
* [**Счет организации**](https://support.moysklad.ru/hc/ru/articles/203325593-Расчетный-счет) - расчетный счет вашего юридического лица. Выбирается из списка. **Требование**: предварительно должна быть настроена организация.
* [**Счет контрагента**](https://support.moysklad.ru/hc/ru/articles/203325593-Расчетный-счет) - расчетный счет юридического лица маркетплейса. Выбирается из списка. **Требование**: предварительно должен быть выбран контрагент.
* [**Сотрудник**](https://support.moysklad.ru/hc/ru/articles/204019656-Сотрудники) - ответственный сотрудник за документ
* [**Отдел сотрудника**](https://support.moysklad.ru/hc/ru/articles/204364908-Отделы) - отдел для сотрудника

{% hint style="danger" %}
**Важно!**

При финансовой схеме работы интеграции **Заказы + отгрузки + комиссия** указанный вами договор должен иметь тип **Купли-продажи.** Если выбрать договор типа **Комиссия**, отгрузки и возвраты не будут учитываться в отчётах МоегоСклада.
{% endhint %}

**Серийные номера** - для продавцов, работающих с серийными номерами. Интеграция записывает номера заказов в поле серийных номеров в документах отгрузки.

**Отфильтровать** - позволяет исключать определенные склады Вайлдберриз из работы интеграции.\
\&#xNAN;*Пример: Вы не хотите добавлять заказы со складов:* Белая дача СЦ&#x31;*,* Белые Столбы 1 *- включаете у всех остальных складов чекбоксы. При таких настройках интеграция начнет игнорировать два выше указанных склада и не будет подгружать с них заказы.*

<figure><img src="/files/lEeTx6enY3mjC60YKmRC" alt=""><figcaption></figcaption></figure>

### Параметры заказов

**Как поступать с копейками** - влияет на заказы и связанные документы:

* Округлять копейки - копейки в документах округляются
* Пусть копейки останутся - копейки сохраняются как получены от маркетплейса

**Валюта заказов и документов** - по умолчанию российские рубли. Для использования другой валюты:

* Кликните на "Обновить список валют"
* Выберите нужную валюту для заказов и документов

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

**Нумерация заказов и документов**:

* Номер отправления из маркетплейса - заказам и документам присваиваются номера, установленные Вайлдберриз.\
  \&#xNAN;*Пример:* 4688678733
* Сквозная нумерация Моего склада - используется внутренняя нумерация МоегоСклада. Принцип работы: номер последнего документа + 1.\
  \&#xNAN;*Пример: если у последней отгрузки номер 458494, следующая получит номер 458495.*

**Настройка цен товаров в заказах:**

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

* Цена товара из МоегоСклада "Минимальная цена"
* Цена товара из МоегоСклада "Закупочная цена"
* Цена товара, указанная в разделе [Товары → Поля карточки](https://help.topseller.ru/~/revisions/QrPm0EhAJiOwBd1ISyNk/instruction/ts-connect/settings/ozon/api/api/products/card-fields)

<figure><img src="/files/iHRpNb6WzLNNU3E9p2rw" alt=""><figcaption></figcaption></figure>

### Новый заказ

Для корректной работы слежки за статусами заказов необходимо сопоставить статусы Вайлдберриз со статусами в системе "МойСклад".

**Быстрое создание статуса:** создать и сопоставить новый статус в системе "МойСклад" можно с помощью папки с символом `+`, после чего выберите статус из списка и сохраните внесенные изменения.\
Подробное описание каждого статуса доступно в разделе документации:&#x20;

<figure><img src="/files/7NuHAjofPfLjAXQD18Fz" alt=""><figcaption></figcaption></figure>

Интеграция автоматически присваивает статусам стандартные названия. Но вы можете **вручную изменить** их в МоемСкладе под свои процессы и привычки.

Как это сделать - описано в нашей [статье](https://help.topseller.ru/~/revisions/a9cj9Na7ppBsFnvPcZIJ/instruction/ts-connect/prepare-accounting-system/moysklad/to-orders)

{% hint style="danger" %}
**Важно!**

* Для корректной работы слежки за статусами заказов, важно, чтобы были настроены и сопоставлены **все** статусы.
* Статусы не должны дублироваться, каждому статусу из Вайлдберриз должен соответствовать свой статус в МоемСкладе.
  {% endhint %}

#### Уведомления о новых заказах

**Получать уведомления о добавлении в МойСклад всех новых заказов**\
При помощи данной настройки вам будут поступать оповещения в Телеграмм-бот о поступлении новых заказов в МойСклад, что позволит контролировать работу интеграции, не заходя в неё.

#### Резервирование товаров

**Резерв** - при поступлении заказов автоматически устанавливается резерв на товар и проводится заказ и документы к заказу. (Непроведенный документ будет считаться черновиком в МоемСкладе и не попадет во внутренние отчеты МоегоСклада.)

#### Проставление НДС

**НДС** - при активации учитывается НДС в заказах и документах. Доступен подвариант для получения НДС из карточки товара в системе "Мой склад" вместо заказа маркетплейса.

### Комментарий для заказа

Чтобы интеграция прописывала комментарий к заказу, выполните следующие действия:

* Включите чекбокс **Добавлять комментарии в заказ**
* Выберите подходящие под ваши цели теги комментария (Пример тега: \[\[offer\_id]])
* Подпишите теги, чтобы в дальнейшем было понятно, что за информацию интеграция прописала в комментарий

<figure><img src="/files/mzJdLE5uopuImesdgrAM" alt=""><figcaption></figcaption></figure>

### Работа с отгрузками и платежами

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

<figure><img src="/files/DTOaoKLadPUzUqVPCDZw" alt=""><figcaption></figcaption></figure>

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

### Неудачный заказ

Неудачным заказом считаются отмены покупателей. У них так же, как и у новых заказов, следует настроить соответствие статусов. После чего вы можете включить ползунок удаления документов у заказов в статусе Отменен в процессе либо настроить формирование документов **Возврата** и **Исходящего платежа.**

<figure><img src="/files/0PcvtnFkGjR9xQ4VUJO7" alt=""><figcaption></figcaption></figure>

Заказы, которые отменят покупатели, перейдут в статус Отменен в процессе, после чего получат статус Возврат и к ним создадутся документы Возврата и Исходящего платежа.

### Возвращенный заказ

Для обработки возвратов следует включить ползунок **Автоматически создавать возврат покупателя,** по умолчанию документы возврата будут создаваться и у заказов в статус **Отменен в процессе,** вы можете отключить это при помощи чекбокса **Не создавать возврат в статусе Вайлдберриз.Отменен в процессе.** \
После чего указываете на какой склад будет поступать возвращенный товар.

При необходимости вы можете получать уведомления о создании Возврата покупателю в МоемСкладе. А так же включить **Тонкую настройку дополнительных полей,** работает она следующим образом:

* Обновляете список доступных атрибутов
* Кликаете на кнопку <img src="/files/OSp3MM2ZqbvDgDnA1w2x" alt="" data-size="line">
* Выбираете при каком действии нужно отредактировать поля в документе:
  * При создании документа
  * Если в заказе выбран склад
  * Если в заказе маркированный товар
* Выбираете какие поля редактировать в документе возврата
* Указываете значение, которое интеграция будет прописывать в эти поля

<figure><img src="/files/RpduPBMPZEH2F9VWEORi" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://topseller.gitbook.io/help/instruction/ts-connect/settings/wildberries/api-1/api/orders/tuning.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
