> 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/yandex/api-1/api-3/api.md).

# АПИ

### Создание аккаунта

1. Перейдите во вкладку интеграции
2. Кликните на логотип маркетплейса <img src="/files/r6MvIm9J6yTOQn6NX8k6" alt="" data-size="line">
3. Выберите существующий или создайте новый аккаунт для начала настройки

### Настройка раздела АПИ

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

#### Схема работы магазина на Яндексе:

* **FBY (Fulfillment by Yandex)** — маркетплейс выступает витриной и хранилищем вашего товара. Маркетплейс обрабатывает заказы: собирает, маркирует и доставляет их до клиента.
* **FBS (Fulfillment by Seller)** — маркетплейс также выступает витриной, однако сборка и маркировка товара лежат на плечах продавца. После этого продавец передает заказ в доставку, которая осуществляется силами самого маркетплейса.
* **DBS** **(Delivery by Seller)** — маркетплейс по-прежнему является витриной, но теперь помимо сборки и маркировки товара доставка также ложится на плечи продавца или сторонних курьерских служб, таких как СДЭК или Почта России.
* **Express** — схема, аналогичная DBS, но доставка должна быть выполнена в кратчайшие сроки — от 1 до 4 часов.

#### Финансовая схема работы интеграции:

* **Заказы + Отгрузки + Отчет комиссионера** — работа ведется по договору комиссии, а не по договору купли-продажи. У вас будут создаваться Отчеты комиссионера. В документы прикрепленные к заказам комиссия не проставляется.&#x20;
* **Заказы + Отгрузки + Комиссия** — в этой схеме используется договор купли-продажи или договор не используется вовсе. Отчеты комиссионера в МоемСкладе не создаются: документ отгрузки является документом реализации, а не передачи на комиссию. Комиссия и прочие сборы маркетплейса проставляются в отгрузки для корректного формирования отчетов МоегоСклада.

### Настройка связи с Яндексом

Для подключения понадобятся:

1. Авторизационный токен для запросов к маркетплейсу.
2. Business ID (идентификатор бизнеса/кабинета).
3. ID кампании (идентификатор магазина).

#### Авторизационный токен

Создайте токен в личном кабинете Яндекса:

* Настройки → Модули и АПИ → Отправка запросов Маркету → Авторизационный токен.\
  Токен создается с полным доступом.

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

#### Бизнес ID и Номер кампании

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

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

Требуется авторизационный токен с полным доступом. Токены с ограниченными правами могут вызвать некорректную работу или отказ части функций интеграции.
{% endhint %}


---

# 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/yandex/api-1/api-3/api.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.