> 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/ozon/api-1/api-2/api.md).

# АПИ

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

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
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/ozon/api-1/api-2/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.