Продажи

Общее

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
}
PreviousШаблоныNextWebHooks

Last updated