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

#promotion Рекомендованные ставки для CPC-кампаний Добавили отображение рекомендованных ставок для CPC-кампаний — по предложениям пользователей в Сообществе WB API. Теперь метод GET /api/advert/v0/bids/recommendations возвращает рекомендованные ставки не только для кампаний с типом оплаты CPM за показы, но и для CPC — за клики. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Recommended Bids for CPC Campaigns The GET /api/advert/v0/bids/recommendations method now returns recommended bids not only for campaigns with the CPM payment type — per impressions, but also for CPC — per clicks. 📖 WB API Release Notes Best regards, WB API team

#fbs Изменения в заказах FBS С 18 августа добавить номер декларации на товары (ДТ) можно будет только к сборочным заданиям в статусе confirm. Также с 18 августа продавцам из Армении будет обязательно указывать номер ДТ для товаров, произведённых вне ЕАЭС, если заказ из Армении доставляется в РФ. Чтобы проверить, обязательно ли закреплять номер ДТ за сборочным заданием, используйте метод GET /api/v3/orders/new. Обязательные идентификаторы маркировки указаны в поле requiredMeta. Чтобы добавить номер ДТ к сборочному заданию, передайте его в запросе метода PUT /api/marketplace/v3/orders/{orderId}/meta/customs-declaration в параметре customsDeclaration. Без обязательного номера ДТ невозможно получить стикеры сборочных заданий методом POST /api/v3/orders/stickers — если хотя бы для одного сборочного не будет указан обязательный номер ДТ, вы получите ошибку 409 CustomsDeclarationIsRequired. Также, если к сборочному заданию не добавлен обязательный номер ДТ, поставку с этим сборочным заданием невозможно перевести в доставку. В ответе метода PATCH /api/v3/supplies/{supplyId}/deliver вы получите ошибку 409 MetaValidationFail, при этом в поле decision для customsDeclaration вернётся значение required. Чтобы проверить, добавлен ли обязательный номер ДТ к сборочному заданию, до перевода поставки в доставку, используйте метод POST /api/marketplace/v3/orders/meta. Перевести поставку в доставку можно со статусами filled или optional в поле decision для customsDeclaration. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Changes in FBS Orders Starting from August 18, you will only be able to add a customs declaration number to assembly orders with the confirm status. Also, starting from August 18, sellers from Armenia will be required to specify a customs declaration number for items produced outside the EAEU if an order from Armenia is being delivered to the Russian Federation. To check whether it is required to add a customs declaration to an assembly order, use the GET /api/v3/orders/new method. The required label identifiers are listed in the requiredMeta field. To add a customs declaration number to an assembly order, pass it in the request of the PUT /api/marketplace/v3/orders/{orderId}/meta/customs-declaration method in the customsDeclaration parameter. Without the required customs declaration number, it is impossible to get assembly order stickers using the POST /api/v3/orders/stickers method — if the required customs declaration number is not specified for at least one assembly order, you will receive error 409 CustomsDeclarationIsRequired. Also, if the required customs declaration number is not added to the assembly order, the supply with this assembly order cannot be transferred to delivery. In the response of the PATCH /api/v3/supplies/{supplyId}/deliver method, you will receive error 409 MetaValidationFail, and the decision field for customsDeclaration will return the required value. To check whether the required customs declaration number is added to the assembly order before transferring the supply to delivery, use the POST /api/marketplace/v3/orders/meta method. You can transfer a supply to delivery if the decision field for customsDeclaration returns filled or optional statuses. 📖 WB API Release Notes Best regards, WB API team

#dbs #in_store_pickup Изменения в сборочных заданиях DBS и Самовывоз Добавили методы получения данных о ценах продавца без учёта скидок и суммах к оплате покупателем с учетом всех скидок и кэшбека по ID сборочных заданий: • DBS — POST /api/marketplace/v3/dbs/orders/final-price • Самовывоз — POST /api/marketplace/v3/click-collect/orders/final-price Для расчётов используйте суммы к оплате покупателем из ответов новых методов, поля: • originalFinalPrice — сумма к оплате покупателем в валюте продажи с учетом всех скидок и кэшбека, умноженная на 100. • convertedOriginalFinalPrice — сумма к оплате покупателем в валюте страны продавца с учетом всех скидок и кэшбека, умноженная на 100. Значения полей finalPrice и convertedFinalPrice из ответов методов получения сборочных заданий используйте только в случае, когда в ответе новых методов для переданных сборочных заданий возвращается "data": null. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Changes for DBS and In-Store Pickup Orders Added methods for getting seller prices excluding discounts and amounts charged to the buyer including all discounts and cashback by assembly order IDs: • DBS — POST /api/marketplace/v3/dbs/orders/final-price • In-Store Pickup — POST /api/marketplace/v3/click-collect/orders/final-price For calculations, use the sums charged to the buyer from the responses of the new methods, fields: • originalFinalPrice — the amount charged to the buyer in the sale currency including all discounts and cashback, multiplied by 100. • convertedOriginalFinalPrice — the amount charged to the buyer in the seller’s country currency including all discounts and cashback, multiplied by 100. Use the values of the finalPrice and convertedFinalPrice fields from the methods for getting assembly orders only when the response of the new methods returns "data": null for the specified assembly orders. 📖 WB API Release Notes Best regards, WB API team

#analytics #reports Лента заказов в WB API Получить отчёт Лента заказов теперь можно с помощью WB API — методом POST /api/analytics/v1/order-feed. Используйте его в качестве замены методов: • GET /api/v1/supplier/orders — Заказы • GET /api/v1/supplier/sales — Продажи Делитесь с нами обратной связью в Сообществе WB API. На основе ваших комментариев мы сможем сделать переход на новый метод максимально комфортным. Методы Заказы и Продажи продолжают работать, но, как мы сообщали ранее, в будущем они будут отключены. О дате отключения сообщим заранее. Преимущества Ленты заказов в сравнении с методами Заказы и Продажи: • данные обновляются в режиме реального времени • нет разделения на заказы и выкупы, данные отдаются в рамках одного метода • есть статусы заказов и причины отмен • отчёт содержит заказы с отложенной оплатой • для каждого заказа определён тип продажи: B2B или B2C • изменяться могут только статусы • используется офсетная пагинация и товарные фильтры: артикулы WB, бренды, предметы, ярлыки Метод доступен по токену любого типа для категории Аналитика. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Order Feed in WB API Using WB API you can now get the Order Feed report with the POST /api/analytics/v1/order-feed method. Use it as substitution for the methods: • GET /api/v1/supplier/orders — Orders • GET /api/v1/supplier/sales — Sales Share your feedback with us in WB API Community. Based on your comments, we can make the transition to the new method as comfortable as possible. The Orders and Sales methods continue to work, but, as we reported earlier, we will disable them in the future. We will inform you about the disabling date in advance. Order Feed advantages in comparison with the Orders and Sales methods: • the data is updated in real time • no division into orders and purchases, the data is given within the same method. • there are order statuses and cancellation reasons • the report includes orders with delayed payments • sale type — B2B or B2C — is defined for every order • only statuses can be changed • offset pagination and item filters — WB item numbers, brands, subcategories, labels — are used The method is available for any type of token for the Analytics category. 📖 WB API Release Notes

#fbs Изменения в Заказах FBS С 21 июля получить сборочные задания, созданные более 3 месяцев назад, вы сможете только методом GET /api/marketplace/v3/fbs/orders/archive. Метод GET /api/v3/orders будет возвращать информацию только о сборочных заданиях,…

#items Изменение в методах работы со складами продавца С 5 августа с помощью API нельзя будет создавать и редактировать склады продавца для сверхгабаритных товаров (СГТ). Данная возможность будет только в личном кабинете. Что изменится в методах: • Получить список складов WB — GET /api/v3/offices — в ответе теперь не будут возвращаться СГТ-склады WB • Создать склад продавца — POST /api/v3/warehouses — при создании СГТ-склада вы получите ошибку 404 • Обновить склад продавца — PUT /api/v3/warehouses/{warehouseId} — при изменении данных СГТ-склада вы получите ошибку 404 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Change in Seller Warehouses Methods Starting from August 5, you will not be able to create and edit seller warehouses for over dimensional cargo (ODC) using the API. This feature will only be available in seller account. What will be changed in the methods: • Get Offices — GET /api/v3/offices — WB warehouses for ODC will no longer be returned in the response • Create Warehouse — POST /api/v3/warehouses — when you create an ODC warehouse, you will get the error 404 • Update Warehouse — PUT /api/v3/warehouses/{warehouseId} — when you edit ODC warehouse details, you will get the error 404 📖 WB API Release Notes Best regards, WB API team

#fbs Настройки автовозврата для заказов FBS Добавили методы для работы с автовозвратами FBS для малогабаритных товаров — "cargoType":1 — по предложениям пользователей в Сообществе WB API. Теперь с помощью WB API вы можете: • Получить настройки автовозврата продавца — GET /api/marketplace/v3/fbs/settings/autoreturns • Обновить настройки автовозврата продавца — PATCH /api/marketplace/v3/fbs/settings/autoreturns • Получить настройки автовозврата товаров — POST /api/marketplace/v3/fbs/settings/autoreturns/items • Обновить настройки автовозврата товаров — PATCH /api/marketplace/v3/fbs/settings/autoreturns/items • Получить предметы, которые не хранятся на складах WB — GET /api/marketplace/v3/fbs/settings/autoreturns/subcategories/restricted 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС Auto-Return Settings for FBS Orders Added auto-return settings methods for FBS orders for small-sized items — "cargoType":1. Now you can: • Get auto-return seller settings — GET /api/marketplace/v3/fbs/settings/autoreturns • Update seller auto-return settings — PATCH /api/marketplace/v3/fbs/settings/autoreturns • Get item auto-return settings — POST /api/marketplace/v3/fbs/settings/autoreturns/items • Update item auto-return settings — PATCH /api/marketplace/v3/fbs/settings/autoreturns/items • Get subcategories that can't be returned to the warehouse — GET /api/marketplace/v3/fbs/settings/autoreturns/subcategories/restricted 📖 WB API Release Notes Best regards, WB API team

#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 и Самовывоз С 8 июля при закреплении за сборочными заданиями номеров деклараций на товары (ДТ) будет обязательно указывать код страны происхождения товара по Общероссийскому классификатору стран мира для B2B…

#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

#documents_and_accounting Новые методы отчётов реализации Добавили новую версию метода получения детализаций к отчётам реализации за период — POST /api/finance/v1/sales-reports/detailed. В новой версии: • добавили настройку полей отчёта: теперь вы можете…

#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

Новости и обновление в Сообществе WB API Наша команда продолжает развивать форум для разработчиков WB API. Рассказали о нескольких важных новостях о площадке в отдельном анонсе. 💬 Перейти на форум

#documents Новoе поле в детализациях к отчётам реализации Добавили поле b2bCustomerTin с информацией об ИНН B2B-покупателя в детализации к отчётам реализации — POST /api/finance/v1/sales-reports/detailed/{reportId} и POST api/finance/v1/sales-reports/detailed. 📖 Журнал изменений WB API 💬 Сообщество WB API С уважением, команда WB API 🔗 Читайте в МАКС New Field in Details for the Realization Reports Added the b2bCustomerTin field — taxpayer identification number (TIN, or INN in Russian) of B2B buyer — to details for the realization reports — POST /api/finance/v1/sales-reports/detailed/{reportId} and POST api/finance/v1/sales-reports/detailed. 📖 WB API Release Notes