Platitun · API · Карточки товара · Завести карточку

Завести карточку

POST /api/v1/listings

Область ключа: listings · изменяет данные, нужен заголовок Idempotency-Key

Новая карточка товара. Рождается ВЫКЛЮЧЕННОЙ — включение остаётся отдельным действием, потому что именно оно делает вашу цену публичной офертой: по ней вы обязаны продать. Допустимые значения полей отдаёт путь позиции справочника.

Самозанятый вправе продавать только подписку, оформляемую НА ПОЧТУ ПОКУПАТЕЛЯ: готовые аккаунты и токены — перепродажа, а она самозанятому запрещена законом. Отказ придёт кодом self_employed_forbidden.

Контакты в описании не проходят: увод сделки за пределы площадки лишает покупателя защиты, а продавца — гарантии.

Поля запроса

Поле	Тип	Что это
`service` обязательно	`string`	Короткое имя сервиса из справочника.
`tariff`	`string`	Короткое имя плана вендора. Обязателен у подписки и аккаунта с подпиской.
`productType` обязательно	`string`	subscription, account, account_with_subscription или credits.
`deliveryMethod` обязательно	`string`	Способ выдачи. Что чему подходит — в ответе позиции справочника.
`priceRub` обязательно	`integer`	Цена в рублях целым числом.
`slaMinutes` обязательно	`integer`	За сколько минут обещаете выдать. Только из allowed списка.
`guaranteeDays` обязательно	`integer`	Срок гарантии в днях. Только из allowed списка.
`stock`	`integer`	Ограничение остатка. Пусто — без ограничения.
`description`	`string`	Своё описание товара. Оно же выводит карточку в карту сайта: продавец получает выгоду от того, что описал товар.
`confirmRequired`	`boolean`	Нужно ли ваше подтверждение перед оплатой.
`ratePer1000Rub`	`integer`	Для токенов: курс за тысячу.
`amountMin`	`integer`	Для токенов: наименьший объём.
`amountMax`	`integer`	Для токенов: наибольший объём.

Поля ответа

Поле	Тип	Что это
`number`	`integer`	Публичный номер новой карточки.
`isActive`	`boolean`	Всегда false: карточка рождается выключенной.
`isTest`	`boolean`	Карточка тестового продавца рождается тестовой.

Поводы отказа

Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.

Код	Что случилось и что делать
`complaint`	Правила карточки не сошлись: например, способ выдачи не подходит виду товара или срок вне допустимого списка. Допустимые значения отдаёт путь позиции справочника.
`contacts`	В тексте найдены контакты — почта, телефон, ссылка на мессенджер. Увод сделки за пределы площадки лишает покупателя защиты, а продавца гарантии. Уберите контакты и отправьте снова.
`no_service`	Такой позиции в справочнике нет. Найдите её поиском по справочнику или заведите заявку.
`type_not_available`	У этой позиции такого вида товара не бывает. Возможные виды — в ответе позиции справочника.
`no_tariff`	Для подписки и аккаунта с подпиской нужен план вендора. Список планов — в ответе позиции справочника.
`self_employed_forbidden`	Самозанятый вправе продавать только подписку, оформляемую на почту покупателя: готовые аккаунты и токены — перепродажа, а она самозанятому запрещена законом.

Рядом в этом разделе

GET /api/v1/listings — Свои карточки
GET /api/v1/listings/{number} — Одна своя карточка
PATCH /api/v1/listings/{number} — Правка карточки
DELETE /api/v1/listings/{number} — Убрать карточку
POST /api/v1/listings/{number}/state — Включить, выключить, автовыдача
POST /api/v1/listings/{number}/copy — Копия карточки
POST /api/v1/listings/{number}/test — Пометить карточку тестовой
PUT /api/v1/listings/{number}/image — Картинка карточки
DELETE /api/v1/listings/{number}/image — Убрать картинку
GET /api/v1/questions — Вопросы по своим карточкам
POST /api/v1/questions/{id}/answer — Ответить на вопрос