Продажи

Общее

Swagger: https://api.radist.online/v2/docs#/Sales

Необходимые права доступа (scopes) для работы с API: sales

Продукт (product) - то, что продаём: товар, услуга, что-то ещё. Имеет цены в разных валютах, описание, картинки, артикул (sku), свойства для приёма оплаты (НДС, тип).

Каталог (catalog) - набор продуктов. Имеет название, валюту.

Магазин (shop) - сущность, соединяющая бота в Telegram с каталогом (телегомагазин).

Продукты

Типы продуктов (payment_object_type)

• commodity - Товар

• excise - Акциз

• job - Работа

• service - Услуга

• gambling_bet - Ставка азартной игры

• gambling_prize - Выигрыш азартной игры

• lottery - Лотерейный билет

• lottery_prize - Выигрыш лотереи

• intellectual_activity - Предоставление результатов интеллектуальной деятельности

• payment - Платеж

• agent_commission - Агентское вознаграждение

• composite - Составной предмет расчета

• another - Иной предмет расчета

Типы НДС (vat):

• none - Без НДС

• vat0 - НДС 0%

• vat5 - НДС 5%

• vat7 - НДС 7%

• vat10 - НДС 10%

• vat20 - НДС 20%

• vat25 - НДС 25%

• vat105 - НДС 5/105

• vat107 - НДС 7/107

• vat110 - НДС 10/110

• vat120 - НДС 20.120

Примеры

Создать продукт с картинками

1. Сначала нужно загрузить картинки к нам: https://api.radist.online/v2/docs#/Files/FilesUploadProductImage

{"url":"https://radist2.cdn.radist.online/products/images/8521fa96b73649469cb664e77adb71ae.jpg"}

1. Потом создать продукт: https://api.radist.online/v2/docs#/Sales/SalesCreateProduct

POST /companies/{company_id}/sales/products/
{
  "name": "Radist.Online",
  "description": "Radist.Online: https://radist.online/",
  "payment_object_type": "service",
  "vat": "vat20",
  "images": [
    "https://radist2.cdn.radist.online/products/images/8521fa96b73649469cb664e77adb71ae.jpg"
  ],
  "prices": [
    {
      "price": 100,
      "currency": "RUB"
    }
  ]
}


Response
{
  "id": 1186,
  "name": "Radist.Online",
  "description": "Radist.Online: https://radist.online/",
  "payment_object_type": "service",
  "category": null,
  "vat": "vat20",
  "sku": null,
  "images": [
    "https://radist2.cdn.radist.online/products/images/8521fa96b73649469cb664e77adb71ae.jpg"
  ],
  "prices": [
    {
      "currency": "RUB",
      "price": 100
    }
  ],
  "catalog_ids": [],
  "created_at": "2024-07-05T15:29:31.485300Z",
  "updated_at": "2024-07-05T15:29:31.485300Z"
}

Каталоги

У каталога есть название и валюта.

Примеры

Создать каталог

POST /companies/{company_id}/sales/catalogs/
{"name":"Demo", "currency":"RUB"}


Response
{
  "id": 554,
  "name": "Demo",
  "currency": "RUB",
  "products_count": 0
}

Добавить продукты в каталог

POST /companies/{company_id}/sales/catalogs/{catalog_id}/add_products

{"product_ids":[1,9,175,177,178,183,184,185]}


Response
{
  "id": 554,
  "name": "Demo",
  "currency": "RUB",
  "products_count": 8
}

Удалить продукты из каталога

POST /companies/{company_id}/sales/catalogs/{catalog_id}/delete_products

{"product_ids":[9,177,183,184]}


Response
{
  "id": 554,
  "name": "Demo",
  "currency": "RUB",
  "products_count": 4
}

Магазины

Ссылку, полученную при создании магазина (в поле link), можно использовать:

1. В кнопке Меню бота (в BotFather выбрать бота -> Bot Settings -> Menu Button)

2. В веб-приложении бота (в BotFather /newapp и следовать инструкциям)

Ссылка работает только с тем подключением (connection_id), с которым связан магазин.

Примеры

Создать магазин

POST /companies/{company_id}/sales/shops/
{
  "name": "Demo shop",
  "catalog_id": 554,
  "connection_id": 29228,
  "use_device_color_scheme": true
}


Response
{
  "id": 363,
  "name": "Demo shop",
  "link": "https://tgbot.radist.me/5ab70f57-b244-45c1-8b2c-a4d26215796a",
  "use_device_color_scheme": true,
  "company_id": 5,
  "catalog_id": 554,
  "connection_id": 29228
}