# АПИ

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

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

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

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

#### Схема работы магазина на Озон:

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

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

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

### Настройка связи с Озоном

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

* **OZON Client Id** — **п**рисваивается кабинету при регистрации на Озон
* **OZON API key** — формируется в вашем личном кабинете Озон в разделе

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

{% hint style="danger" %}
**Важно!**\
Для корректной работы интеграции необходимы права **"Admin"** у API токена. Если указать другие права, интеграция не сможет работать полноценно и могут возникать ошибки в работе интеграции.
{% endhint %}

### Настройка URL для push-уведомлений

Для ускорения и оптимизации синхронизации статусов и импорта заказов настройте push-уведомления:

1. **Скопируйте** URL из раздела АПИ в TS Connect
2. **Вставьте** ссылку в личном кабинете Озона:
   * Перейдите в **Настройки → Интеграции**
   * Вставьте скопированный URL в соответствующее поле.
3. **Выберите необходимые типы уведомлений**:

* TYPE\_NEW\_POSTING
* TYPE\_POSTING\_SHIPPED
* TYPE\_POSTING\_CHANGED
* TYPE\_STATE\_CHANGED
* TYPE\_DELIVERY\_DATE\_CHANGED
* TYPE\_STOCKS\_CHANGED

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


---

# Agent Instructions: 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:

```
GET https://help.topseller.ru/instruction/ts-connect/settings/ozon/api/api-2/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
