---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.1
alternate:
  - https://yandex.com/support/market-distr/ru/api/reference/get-partner-article.md
  - href: https://yandex.com/support/market-distr/ru/api/reference/get-partner-article.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/support/market-distr/ru/llms.txt?revision=r22075821
    rel: describedby
keywords: POST /partner/article/create
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/market-distr/ru/llms.txt?revision=r22075821


# Создание реферальных артикулов

## Описание {#description}

```
POST /partner/article/create
```

Создает реферальный артикул для переданных параметров. В том случае, если такой артикул [уже существует](*comb), возвращает его.
Для генерации реферального артикула вы можете передать либо маркетный артикул товара, либо ссылку на товар.

URL ресурса:

```
https://api.content.market.yandex.ru/v3/affiliate/partner/article/create
```


## Входные данные {#input}

#|
||
**Параметр**
|
**Тип**
|
**Значение**
|
**Обязательный**
||
|| `place_id` | Int64 | Идентификатор площадки, для которой создаётся реферальный артикул. Его можно найти в личном кабинете Реферальной программы на Яндекс Маркете в разделе «Блоги». | да ||
||
`clid`
|
Int64
|
Ваш идентификатор в реферальной программе.

Передайте идентификатор CLID типа «Артикулы Маркета» для площадки, для которой хотите создать реферальный артикул. 

Может быть указан вместо `place_id`.
|
нет
||
|| `isUseDiscount` | Enum | Добавляет скидку на товар за счёт вашего вознаграждения. Скидку можно добавить только на товары, для которых она доступна. Формат ввода данных: 
- `1` — скидка добавляется
- `0` или параметр не указан в запросе — скидка не добавляется. | нет ||
||
`vid`
|
String
|
Дополнительный идентификатор реферальной ссылки.

С помощью идентификатора `vid` можно отслеживать данные отдельно по каждой реферальной ссылке Яндекс Маркета или сравнивать статистику по всем ссылкам на разных страницах.

Если идентификатор указан в запросе, реферальная ссылка будет содержать этот `vid`. По умолчанию возвращаются ссылки без дополнительных идентификаторов.

В запросе можно передать только один дополнительный идентификатор `vid`.
|
нет, по умолчанию пустой
||
||
`format`
|
Enum
|
Формат выходных данных:

- `json`
- `xml`
|
нет, по умолчанию `json`
||
|#

## Тело запроса {#body}

#|
||
**Параметр**
|
**Тип**
|
**Значение**
|
**Обязательный**
||
||
`marketArticle`
|
String
|
Маркетный артикул товара
|
обязательный, если не задан `marketUrl`
||
||
`marketUrl`
|
String
|
Ссылка на товар вида https://market.yandex.ru/card/...

|
обязательный, если не задан `marketArticle`
||
|#

## Выходные данные {#output}

  
  ```json
  {
    "status": "{enum}",
     "partnerArticle":
        {
          "partnerArticle": "{string}",
          "marketArticle": "{string}",
          "clid": "{int64}",
          "vid": "{string}",
          "productPhoto": "{string}",
          "title": "{string}"
        },
    "link": "{string}",
    "promise": "{int64}",
    "potential_discount": "{int64}",
    "discount": "{int64}",
    "price": "{int64}",
    "rewardInUrl": "{int64}",
    "stockAmount": "{int64}"
   
  }
  ```

Описание параметров: 

#|
||
**Параметр**
|
**Тип**
|
**Описание**

||
||
`status`
|
Enum
|
Статус выполнения запроса:

- `OK` — запрос выполнен успешно.
- `ERROR` — произошла ошибка.
||
|| `link` | String | Ссылка. При создании реферального артикула возвращает NULL. ||
|| `promise` | Int64 | Вознаграждение, закрепленное за ссылкой. ||
||
`potential_discount`
|
Int64
|
Размер скидки, доступной для этого товара. Отдаёт `0` если скидка для товара не доступна. 
||
||
`discount`
|
Int64
|
Размер скидки, применённой к реферальной ссылке. Отдаёт `0` если скидка для товара не доступна или не была применена при создании реферальной ссылки. 
||

|| `price` | Int64 | Цена товара. ||

|| `rewardInUrl` | Int64 | Вознаграждение, закреплённое за ссылкой в момент её создания. ||
|| `stockAmount` | Int64 | Остаток товара, доступный для заказа. ||
||
**Параметры, вложенные в `partnerArticle`**  | > | > 
||
||
`partnerArticle`
|
String
|
Сгенерированный реферальный артикул.

Пример: `"YM10001000"`
||
||
`marketArticle`
|
String
|
Маркетный артикул товара, для которого сгенерирован реферальный артикул.

||
||
`clid`
|
Int64
|
Параметр `clid`, для которого сгенерирован реферальный артикул.
||
||
`vid`
|
String
|
Параметр `vid`, для которого сгенерирован реферальный артикул.
||
|| `productPhoto` | String | Ссылка на изображение товара. ||
||`title`|String|Название товара.||
|#

## Ошибки {#errors}

В случае ошибки сервер возвращает HTTP‑код ответа и [краткое описание ошибки](https://yandex.com/support/market-distr/ru/api/concepts/error-codes.md).

Возможные ошибки:

#|
|| **Текст ошибки** | **Пояснение** ||
|| Client clid does not match | Передан несуществующий или [чужой](*alien) параметр `clid` ||
|| Parameter 'vid' format is incorrect. Incorrect value '`***`'. VID must be up to 150 characters long and contain only latin letters and numbers | Передан недопустимый параметр `vid` ||
|| Invalid market article '`***`' | Переданный маркетный артикул не найден на Яндекс Маркете ||
|| Input URL '`*`' doesn't lead to market | На вход передана ссылка с URL, отличным от `market.yandex.ru` ||
|| Unsupported input URL format: *** | На вход передана ссылка на Яндекс Маркет, но формат этой ссылки не поддерживается ||
|| Can't find market article for productId = '`***`' and skuId = '`***`' and offerId = '`***`' | Ссылка нужного формата, но соответствующий маркетный артикул не найден на Яндекс Маркете ||
|#

## Примеры {#examples}

  
  Запрос:
  
  ```
  curl -X POST -i \
  -H 'Authorization: OAuth <token>' \
  -H 'Content-Type: application/json' \
  -d '{"marketArticle":"5828126315"}' \
  'https://api.content.market.yandex.ru/v3/affiliate'\
  '/partner/article/create'\
  '?clid=15085330'\
  '&isUseDiscount=1'\
  '&format=json'
  ```
  
  
  Ответ:
  
  
  ```json
{
    "status": "OK",
    "partnerArticle": {
        "partnerArticle": "YM10469939",
        "marketArticle": "5828126315",
        "clid": 15085330,
        "vid": "",
        "productPhoto": "https://avatars.mds.yandex.net/get-mpic/17406069/2a0000019eb8ed516c48c5be4433698a798f/300x300",
        "title": "Беспроводные наушники COMMO Etude с функцией адаптивного шумоподавления ANC, лавандовый"
    },
    "link": null,
    "promise": 658,
    "potential_discount": 250,
    "discount": 250,
    "price": 8072,
    "rewardInUrl": null,
    "stockAmount": 186
}
  ```




[*comb]: для переданной комбинации маркетного артикула, `clid` и `vid`

[*alien]: для авторизованного партнера