> 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/products/card-fields.md).

# Импорт товаров

### **Поля карточки**

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

Или же создать поля более быстрым способом при помощи данного символа <img src="/files/40P4MVV5I7cMXbWbfaIs" alt="" data-size="original"> так интеграция автоматически создаст поле в МоемСкладе и предоставит вам в выпадающем списке. Вам останется только выбрать полей из выпадающего списка и сохранить изменения.

<figure><img src="/files/3ynbqtnoiayWE2QNBfVa" alt=""><figcaption></figcaption></figure>

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

Поля необязательны для заполнения и используются только для выведения дополнительной информации в карточку товаров в МоемСкладе. Кроме поля **"Срок годности товара"**, данное поле используется для передачи данных о сроке годности в заказ (будет передавать только в заказы, где это необходимо). Поэтому необходимо актуализировать информацию в этом поле. После обновления информации в этом поле пересоздайте таблицу связи, чтобы интеграция "увидела" новую дату.

### Настройки импорта товаров

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

1. При импорте новых товаров автоматически связывать их в таблице связей - эта функция позволит интеграции автоматически пересоздавать таблицу связей после импорта новых товаров, чтобы вам не приходилось запускать процесс вручную каждый раз.
2. Указываете в каких величинах вы храните длины и в каких вы хотите указывать длины в грузовом месте (Метры или Сантиметры).
3. Уменьшать размер изображений при скачивании - иногда картинки на ВБ имеют очень большой размер. Для экономии места в МоемСкладе интеграция будет сжимать изображения.
4. Количество картинок для загрузки в МойСклад
   * Закачать только одну картинку
   * Закачать до десяти штук
   * Не закачивать картинки

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

* При включении настройки **Уменьшать размер изображений при скачивании** возможна небольшая потеря качества фото.
* Рекомендуем указать первый вариант в настройке количества картинок. Данный вариант самый оптимальный, так как картинки товаров не занимают много памяти в подписке МоегоСклада, а навигация среди товаров в учетной системе остается удобной.
  {% endhint %}

#### Как именно поступить с товарами и вариациями

**Товары с нулевым размером и одним цветом (потенциально отдельный товар)**

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

**Товары с вариантами размера или цвета (потенциально модификации)**

* **Создавать варианты размеров и цветов и добавлять их в главную карточку** - если вы хотите, чтобы варианты товара в учетной системе складывались в одну карточку товара
* **Все варианты размеров и цветов добавлять как отдельные карточки** - если вы хотите, чтобы все товары создавались как отдельные карточки товаров

#### Настройки полей для отдельных карточек товаров в МоемСкладе

Здесь вы выбираете, какие значения будет прописываться интеграция при импорте в поля **КОД** и **АРТИКУЛ**. В случае с Вайлдберриз есть четыре значения, которые интеграция может подгрузить в поля в МоемСкладе:

* **Артикул chrtId** - внутренний артикул Вайлдберриз (артикул модификаций), который можно встретить только во внутренних отчетах ВБ.
* **Артикул nmId** - артикул товара, который присваивает сам Вайлдберриз, он отображается у вас в личном кабинете ВБ и на витрине.
* **Артикул Поставщика** - артикул, который присваиваете товарам вы.
* **Полный артикул (АртикулПоставщика/Размер)** - ваш артикул товара, но так же интеграция будет прописывать размер через `/` .

#### Настройки полей для модификаций в МоемСкладе

**Запишем в КОД для модификаций** Если вы решили работать с вариантами товаров (модификациями), нужно выбрать какое значение интеграция будет прописывать в поле КОД в МоемСкладе. Так как значение в поле код должно быть уникальным интеграция позволит выбрать только из следующих значений:

* **Артикул chrtId**
* **Полный артикул (АртикулПоставщика/Размер)**
* **Баркод**

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

Для того чтобы интеграция могла создать модификации товаров, необходимо создать характеристики в МоемСкладе, сделать это можно при помощи данного символа <img src="/files/qbCzCC0GyKll2UZ4EL1G" alt="" data-size="original">после чего выбрать характеристику из выпадающего списка.

### Импорт товаров

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

1. **Добавить новые товары в МойСклад** - создаст новые карточки товаров в МоемСкладе по всем несвязанным товарам в таблице связи. Вы можете указать какие параметры загружать в карточки товаров в МоемСкладе, а какие проигнорировать и не добавлять.
2. **Обновить существующие товары в МоемСкладе** - обновляет параметры уже связанных товаров, не создавая новых карточек. У этого импорта так же можно выбрать, какие параметры обновлять, а какие оставить без изменений.

### Импорт/обновление только конкретных товаров

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

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

{% hint style="info" %}
**Примечание:**\
При использовании чекбокса **"Добавить/обновить только конкретные товары"** всё равно требуется выбрать, что делать с товарами: добавить или обновить.
{% endhint %}

### Автоматический импорт товаров

Помимо ручного импорта, в интеграции представлен автоматический импорт товаров. Работает он следующим образом:

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

Автоматический импорт товаров позволит вам не следить за созданием карточек новых товаров в МоемСкладе.&#x20;

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


---

# 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/products/card-fields.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.
