WB API Продавца SDK Python Library

Клиент для работы по WB API Продавца

Требования

Установка

Начало работы

Примеры использования SDK

• API статистики
  • Поставки
  • Остатки
  • Заказы
  • Продажи
  • Отчет о продажах по реализации
• API Контента
  • Категории
  • Предметы
  • Характеристики предмета
  • Цвет
  • Пол
  • Сезон
  • ТВЭД
  • Ставка НДС
• API Общее (тарифы)
  • Комиссия по категориям товаров
  • Тарифы для коробов
  • Тарифы для монопаллет
  • Тарифы на возврат

Требования

1. Python >= 3.8
2. pip

Установка

1. Установите pip.
2. В консоли выполните команду

pip install --upgrade wb-api-sdk

Начало работы

1. Импортируйте класс WBApi из модуля wb_api

from wb_api import WBApi

2. Установите API_TOKEN для авторизации

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

3. Вызовите нужный метод API. Подробнее в документации к WB API Продавца

Примеры использования SDK

API статистики

1. Получить статистику по Поставкам, Остаткам, Заказам, Продажам и Отчет о продажах по реализации можно вызвав методы свойства statistics

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

stats = api.statistics

Поставки

1. Для получения статистики по поставкам за период, воспользуйтесь методом get_incomes

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

stats = api.statistics
incomes = stats.get_incomes(date_from="2024-07-31")

2. Метод возвращает список объектов Income

3. Подробнее в документации к WB API Продавца

Остатки

1. Для получения статистики по остаткам товаров на складах WB, воспользуйтесь методом get_stocks

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

stats = api.statistics
stocks = stats.get_stocks(date_from="2024-07-31")

2. Метод возвращает список объектов Stock

3. Подробнее в документации к WB API Продавца

Заказы

1. Для получения статистики по заказам, воспользуйтесь методом get_orders

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

stats = api.statistics
orders = stats.get_orders(date_from="2024-07-31")

2. Метод возвращает список объектов Order

3. Подробнее в документации к WB API Продавца

Продажи

1. Для получения статистики по продажам, воспользуйтесь методом get_sales

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

stats = api.statistics
sales = stats.get_sales(date_from="2024-07-31")

2. Метод возвращает список объектов Sale

3. Подробнее в документации к WB API Продавца

Отчет о продажах по реализации

1. Для получения отчета о продажах по реализации, воспользуйтесь методом get_realization_reports

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

stats = api.statistics
realization_reports = stats.get_realization_reports(date_from="2024-08-05", date_to="2024-08-06")

2. Метод возвращает список объектов Sale

3. Подробнее в документации к WB API Продавца

API Контента [в разработке]

1. Начать работу с API контента можно вызвав методы свойства content

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content

Категории

1. Для получения списка всех родительских категорий товаров, воспользуйтесь методом get_all_parents

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content
parents = content.get_all_parents()

2. Метод возвращает список объектов Parent

3. Подробнее в документации к WB API Продавца

Предметы

1. Для получения списка всех всех доступных предметов, родительских категорий предметов, и их идентификаторов, воспользуйтесь методом get_all_subjects

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content
subjects = content.get_all_subjects()

2. Метод возвращает список объектов Subject

3. Подробнее в документации к WB API Продавца

Характеристики предмета

1. Для получения списка характеристик предмета, воспользуйтесь методом get_charcs

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content
charcs = content.get_charcs(subject_id=1)

2. Метод возвращает список объектов Charc

3. Подробнее в документации к WB API Продавца

Цвет

1. Для получения списка значений характеристики Цвет, воспользуйтесь методом get_colors

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content
colors = content.get_colors()

2. Метод возвращает список объектов Color

3. Подробнее в документации к WB API Продавца

Пол

1. Для получения списка значений характеристики Пол, воспользуйтесь методом get_kinds

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content
kinds = content.get_kinds()

2. Метод возвращает список строк

3. Подробнее в документации к WB API Продавца

Страна Производства

1. Для получения списка значений характеристики Страна Производства, воспользуйтесь методом get_countries

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content
countries = content.get_countries()

2. Метод возвращает список объектов Country

3. Подробнее в документации к WB API Продавца

Сезон

1. Для получения списка значений характеристики Сезон, воспользуйтесь методом get_seasons

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content
seasons = content.get_seasons()

2. Метод возвращает список строк

3. Подробнее в документации к WB API Продавца

ТНВЭД

1. Для получения списка ТНВЭД кодов, воспользуйтесь методом get_tnved

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content
tnved_list = content.get_tnved()

2. Метод возвращает список объектов TNVED

3. Подробнее в документации к WB API Продавца

Ставка НДС

1. Для получения списка значений характеристики Ставка НДС, воспользуйтесь методом get_vat или get_nds

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

content = api.content
vat_list = content.get_vat()
nds_list = content.get_nds()

2. Метод возвращает список строк

3. Подробнее в документации к WB API Продавца

API Общее (тарифы)

1. Получить данные по комиссиям и тарифам можно вызвав методы свойства common

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

common = api.common

Комиссия по категориям товаров

1. Для получения данных о комиссии по категориям товаров, воспользуйтесь методом get_commissions

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

common = api.common
commissions = common.get_commissions()

2. Метод возвращает список объектов Commission

3. Подробнее в документации к WB API Общее

Тарифы для коробов

1. Для получения статистики данных о тарифах для коробов, воспользуйтесь методом get_box

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

common = api.common
box = common.get_box()

2. Метод возвращает объект Box

3. Подробнее в документации к WB API Общее

Тарифы для монопаллет

1. Для получения статистики данных о тарифах для монопаллет, воспользуйтесь методом pallet

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

common = api.common
pallet = common.pallet(date="2024-09-08")

2. Метод возвращает объект Pallet

3. Подробнее в документации к WB API Общее

Тарифы на возврат

1. Для получения статистики данных о тарифах на возврат, воспользуйтесь методом get_return

from wb_api import WBApi

api = WBApi(api_key="<API_TOKEN>")

common = api.common
return_ = common.get_return(date="2024-09-08")

2. Метод возвращает объект Return

3. Подробнее в документации к WB API Общее