ВБ Интеграция | WB API

#promotion Изменения в сервисе Продвижения В ответ метода GET /api/advert/v1/config добавили информацию о минимальной сумме пополнения бюджета кампании — поле minTopUp. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Changes in Promotion service In the response of the GET /api/advert/v1/config added the minTopUp field — information about the minimum campaign budget top-up amount. 📖 WB API Release Notes

#analytics Новая версия Оценки товара и отключение метода Скрытые из каталога Добавили новую версию метода получения отчёта Оценка товара — POST /api/analytics/v2/item-rating. C её помощью вы можете получать данные отдельно по скрытым из каталога товарам. В новом методе: • добавили параметр onlyShadowedNms: • укажите true, чтобы получить в отчёте только скрытые из каталога товары • укажите false, чтобы получить в отчёте все товары, если не указаны другие параметры • добавили поле isShadowed — является ли товар скрытым из каталога • изменили наименование массива ответа cards на items • изменили наименование параметра isNotIncludeNMsWithoutSales на isNotIncludeNmsWithoutSales Метод доступен по Персональному или Сервисному токену для категории Аналитика. Текущие методы POST /api/analytics/v1/item-rating и GET /api/v1/analytics/banned-products/shadowed будут отключены 30 июля. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС New Version of Item Rating and Disabling the Hidden from Catalog Method Added new version of the method for getting the Item Rating report — POST /api/analytics/v2/item-rating. Using one, you can get data separately for items hidden from catalog. In the new method we: • added the onlyShadowedNms parameter: • specify true to get only items hidden from catalog in the report • specify false to get all items unless other parameters are specified • added the isShadowed field — is the item hidden from catalog • changed the name of the cards response array to items • changed the name of the isNotIncludeNMsWithoutSales parameter to isNotIncludeNmsWithoutSales The method is available by Personal or Service token for the Analytics category. The POST /api/analytics/v1/item-rating and GET /api/v1/analytics/banned-products/shadowed current methods will be disabled on July 30. 📖 WB API Release Notes

#dbs #in_store_pickup Изменения в заказах DBS и Самовывоз Обновили методы WB API согласно анонсу от 2 июля. Теперь, при закреплении за сборочными заданиями номеров деклараций на товары (ДТ), обязательно указывать код страны происхождения товара по Общероссийскому классификатору стран мира для B2B-заказов DBS и Самовывоз. Без корректного кода страны закрепить за сборочным заданием номер ДТ невозможно. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Changes for DBS and In-Store Pickup Orders Updated WB API methods according to the announcement dated July 2. Now, when linking customs declarations number to assembly orders, it is required to specify the country of origin code according to the Russian classification of countries of the world for DBS and In-store Pickup B2B orders. Without a correct country code, it is not possible to link a customs declaration number to assembly orders. 📖 WB API Release Notes Best regards, WB API team

#promotion Изменения в сервисе Продвижения В ответ метода GET /api/advert/v2/adverts добавили признак возможности изменения списка товаров в кампании поле — can_change_nms в объекте restrictions. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API Changes in Promotion service Added the can_change_nms field to the restrictions object in the response of the GET /api/advert/v2/adverts method. This flag indicates whether it is possible to change the list of items in the campaign. 📖 WB API Release Notes

#communication Новые методы в Песочнице Вопросов и отзывов Расширили песочницу вопросов и отзывов. Теперь вы можете: • создавать несколько тестовых отзывов одним запросом — POST /api/v1/test/make/feedbacks/batch • удалять тестовые отзывы — POST /api/v1/test/delete/feedbacks • создавать несколько тестовых вопросов одним запросом — POST /api/v1/test/make/questions/batch • удалять тестовые вопросы — POST /api/v1/test/delete/questions 27 июля отключим неактуальные методы: • POST /api/v1/test/make/feedbacks • POST /api/v1/test/make/questions 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС New Methods in the Questions and Feedbacks Sandbox We have expanded the sandbox for feedbacks and questions. Now you can: • create multiple test feedbacks with a single request — POST /api/v1/test/make/feedbacks/batch • delete test feedbacks — POST /api/v1/test/delete/feedbacks • create multiple test questions with a single request — POST /api/v1/test/make/questions/batch • delete test questions — POST /api/v1/test/delete/questions On July 27 we will disable the deprecated methods: • POST /api/v1/test/make/feedbacks • POST /api/v1/test/make/questions 📖 WB API Release Notes

Видим обращения пользователей по поводу ошибок токена API в интеграции 1С. Чтобы исправить проблему, сервис 1С рекомендует установить патч EF_60033229. Если это не исправит проблему, обратитесь напрямую в поддержку 1С. WB API не имеет отношения к ошибкам интеграций сторонних сервисов. С уважением, команда WB API

#general Продолжаем обновлять лимиты для Базовых токенов. 9 июля обновятся лимиты методов Работа с товарами, доступных по категории Контент. Новые лимиты запросов будут учитывать особенности разных типов токенов: • Для Персональных и Сервисных токенов лимиты запросов не изменятся. • Для Базовых и Тестовых токенов лимиты запросов будут ниже, так как эти токены должны использоваться как вспомогательные. Рекомендуем перевести интеграцию на Персональные и Сервисные токены. Управлять токенами можно в личном кабинете. Обсудить или задать вопрос в Сообществе WB API С уважением, команда WB API Request Limits by Token Types We continue to update the limits for Basic Tokens. On July 9, we will update the limits in the Item Management methods available under the Content category. The new request limits will consider the specifics of different token types: • For Personal and Service tokens, the request limits will not change. • For Basic and Test tokens, the request limits will be lower, as these tokens are intended for auxiliary use. We recommend migrating your integration to Personal and Service tokens. You can manage tokens in your personal account. Best regards, WB API team

15 июля начнём отключать метод GET /api/v5/supplier/reportDetailByPeriod. Используйте метод POST /api/finance/v1/sales-reports/detailed, чтобы получить детализации к отчётам реализации за период. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС On July 15, we will start disabling the GET /api/v5/supplier/reportDetailByPeriod method. Use the POST /api/finance/v1/sales-reports/detailed method to get details for the sales reports by period. 📖 WB API Release Notes

#promotion Изменения в сервисе Продвижения API Продвижения уже работает в валюте аккаунта продавца. Добавили информацию о валюте аккаунта продавца — поле currency— в ответы методов: • GET /api/advert/v2/adverts • POST /api/advert/v1/bids/min • PATCH /api/advert/v1/bids • GET /adv/v1/balance • GET /adv/v1/budget • POST /adv/v1/budget/deposit • GET /adv/v1/payments • POST /adv/v0/normquery/stats • GET /adv/v3/fullstats В ответ метода получения списка ставок поисковых кластеров POST /adv/v0/normquery/get-bids добавили поля: • id_kopecks — текущая ставка в разменных денежных единицах — 0,01 от базовой единицы валюты аккаунта продавца за тысячу показов. • currency — валюта аккаунта продавца. Добавили метод GET /api/advert/v1/config. С его помощью вы можете получить валюту вашего аккаунта и допустимые шаги ставок. Чтобы установить ставки для поисковых кластеров в валюте вашего аккаунта используйте новый метод POST /api/advert/v1/normquery/bids. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Promotion API now works in the seller account currency. We added information about the seller account currency — the currency field — to the responses of the methods: • GET /api/advert/v2/adverts • POST /api/advert/v1/bids/min • PATCH /api/advert/v1/bids • GET /adv/v1/balance • GET /adv/v1/budget • POST /adv/v1/budget/deposit • GET /adv/v1/payments • POST /adv/v0/normquery/stats • GET /adv/v3/fullstats In the response of the method for getting search cluster bids POST /adv/v0/normquery/get-bids, we added the fields: • id_kopecks — current bid in minor currency units — 0.01 of the base unit of the seller account currency per mille • currency — seller account currency. Added the method GET /api/advert/v1/config. Use it to get the currency of your account and the allowed bid steps. To set bids for search clusters in the currency of your account, use the new method POST /api/advert/v1/normquery/bids. 📖 WB API Release Notes Best regards, WB API team

#dbs #in_store_pickup Изменения в заказах DBS и Самовывоз С 8 июля при закреплении за сборочными заданиями номеров деклараций на товары (ДТ) будет обязательно указывать код страны происхождения товара по Общероссийскому классификатору стран мира для B2B-заказов DBS и Самовывоз. Без корректного кода страны закрепить за сборочным заданием номер ДТ станет невозможно. Мы обновили документацию уже сейчас, чтобы вы заранее внесли изменения в свои интеграции. Обновление методов WB API состоится не ранее 8 июля, мы сообщим об этом дополнительно. Чтобы добавить код страны, используйте методы: • DBS — POST /api/marketplace/v3/dbs/orders/meta/customs-declaration, укажите числовой код страны происхождения товара в параметре originCountryCode. Доступно для сборочных заданий в статусах confirm или deliver. Сборочные задания без корректного кода страны вернутся в ответе 200 с ошибкой InvalidOriginCountryCode в массиве errors. • Самовывоз — POST /api/marketplace/v3/click-collect/orders/meta/customs-declaration, укажите числовой код страны происхождения товара в параметре originCountryCode. Доступно для сборочных заданий в статусах confirm или prepare. Сборочные задания без корректного кода страны вернутся в ответе 200 с ошибкой InvalidOriginCountryCode в массиве errors. Чтобы проверить код страны, используйте методы: • DBS — POST /api/marketplace/v3/dbs/orders/meta/details. Метод доступен для сборочных заданий в статусах confirm или deliver. • Самовывоз — POST /api/marketplace/v3/click-collect/orders/meta/details. Метод доступен для сборочных заданий в статусах confirm или prepare. Чтобы удалить код страны, используйте методы: • DBS — POST /api/marketplace/v3/dbs/orders/meta/delete • Самовывоз — POST /api/marketplace/v3/click-collect/orders/meta/delete 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Changes for DBS and In-Store Pickup Orders Starting July 8, when linking customs declarations number to assembly orders, it will be required to specify the country of origin code according to the Russian classification of countries of the world for DBS and In-store Pickup B2B orders. Without a correct country code, it will be impossible to link a customs declaration number to assembly orders. We have already updated the documentation so that you can make changes to your integrations in advance. The update of the WB API methods will take place no earlier than July 8; we will notify you additionally. To add the country code, use the following methods: • DBS — POST /api/marketplace/v3/dbs/orders/meta/customs-declaration. Specify the numeric country of origin code in the originCountryCode parameter. Available for assembly orders in confirm or deliver statuses. Assembly orders without a correct country code will return with the error InvalidOriginCountryCode in the errors array of the 200 response. • In-store Pickup — POST /api/marketplace/v3/click-collect/orders/meta/customs-declaration. Specify the numeric country of origin code in the originCountryCode parameter. Available for assembly orders in confirm or prepare statuses. Assembly orders without a correct country code will return with the error InvalidOriginCountryCode in the errors array of the 200 response. To check the country code, use the following methods: • DBS — POST /api/marketplace/v3/dbs/orders/meta/details. The method is available for assembly orders in confirm or deliver statuses. • In-store Pickup — POST /api/marketplace/v3/click-collect/orders/meta/details. The method is available for assembly orders in confirm or prepare statuses. To delete the country code, use the following methods: • DBS — POST /api/marketplace/v3/dbs/orders/meta/delete • In-store Pickup — POST /api/marketplace/v3/click-collect/orders/meta/delete 📖 WB API Release Notes Best regards, WB API team