#на #в #для #yandex #market #с #api-client

rust-yandexmarket

Библиотека для работы с API Yandex.Market на языке программирования Rust

3 releases

0.1.2 Jul 23, 2024
0.1.1 May 3, 2024
0.1.0 May 3, 2024

#310 in Web programming

Download history 12/week @ 2024-09-11 13/week @ 2024-09-18 22/week @ 2024-09-25 16/week @ 2024-10-02 2/week @ 2024-10-09

222 downloads per month

MIT license

1.5MB
15K SLoC

rust-yandexmarket

Библиотека для работы с API Yandex.Market на языке программирования Rust

Использование

Клиент для доступа к Yandex Market API.

Пример

use anyhow::Result;
use rust_yandexmarket::MarketClient;

#[tokio::main]
async fn main() -> Result<()> {
    let subscriber = tracing_subscriber::fmt()
        .with_max_level(tracing::Level::DEBUG)
        .finish();
    tracing::subscriber::set_global_default(subscriber).expect("setting default subscriber failed");
    let token = std::env::var("MARKET_TOKEN").expect("MARKET_TOKEN must be set");
    let client = MarketClient::new(token).await?;
    // do something with the client
    Ok(())
}

Как добавить новые товары в каталог

  1. Получите список категорий Маркета, выполнив запрос get_categories_tree.
  2. Для каждой категории запросите список необходимых характеристик с помощью get_category_content_parameters.
  3. Передайте информацию о товарах (названия, описания, фотографии и так далее), цены, категории на Маркете и характеристики с помощью запроса update_offer_mappings.
  4. Чтобы узнать стоимость услуг Маркета для конкретных товаров, передайте их параметры в запросе tariffs_calculate.
  5. Получите у Маркета список моделей, по которым можно продавать каждый из добавленных товаров с помощью запроса offer_mappings. Что такое модель работы и какие модели есть.
  6. Задайте условия размещения товаров с помощью запроса offers_update. Условия размещения — это минимальный объем заказа, квант продаж и ставка НДС. Если вы работаете по модели DBS, этим же запросом задаются параметры доставки.
  7. Убедитесь, что товары появились на витрине, с помощью запроса get_campaign_offers. Подробные пояснения к статусам товаров вы найдете в Справке Маркета для продавцов.

Как изменить цены на товары

  1. Чтобы узнать стоимость услуг Маркета для конкретных товаров, передайте их параметры в запросе tariffs_calculate.
  2. Передайте новые цены для всех магазинов с помощью запроса offer_prices_updates.
  3. Убедитесь, что ни один из товаров не попал в карантин с помощью запроса price_quarantine.
  4. Если карантин не пустой, проверьте цены на товары. Ошибочно установленные цены для всех магазинов можно исправить запросом offer_prices_updates.
  5. После того как в карантине останутся только правильные цены, подтвердите их запросом price_quarantine_confirm. Если ложные срабатывания карантина случаются часто, подумайте о том, чтобы изменить его порог по инструкции.

Как управлять товарами в архиве

  1. Для архивации товаров используйте запрос offer_mappings_archive. Если товары не удалось архивировать, они вернутся в ответе запроса.
  2. Для просмотра товаров в архиве используйте фильтр archived в запросе offer_mappings
  3. Чтобы восстановить товар из архива, используйте запрос offer_mappings_unarchive

Передача остатков по API

С помощью запроса update_stock

Dependencies

~7–19MB
~253K SLoC