ключ для работы с api статистики x32 что это
Что такое API ключ ВБ? Какая история доступна по АПИ и что вообще по нему доступно?
В этой статье мы поговорим об АПИ/API ключе Вайлдберриз и о том какие данные можно с его помощью получить для аналитики.
В частности, мы ответим на следующие вопросы:
Что такое АПИ ключ?
АПИ ключ (или API ключ) — это просто код или последовательность символов, которая является паролем для того, чтобы можно было автоматически скачивать данные из Личного Кабинета поставщика на Wildberries
Физически API ключ представляет собой последовательность символов. Вайлдберриз предоставляет по факту два ключа х32 и х64, выглядят они следующим образом (в разделе Настройки — Доступ по API вашего кабинета Поставщика):
Если у вас еще нет АПИ ключа, но вы хотите его сделать, то здесь мы рассказывали как это сделать.
Какие данные можно получить, зная АПИ ключ?
По АПИ можно получить ТОЛЬКО следующие данные (исходя из офиц. документации по АПИ)
По факту работают первые пять пунктов — данные по платному хранению практически никогда не возвращаются (не передаются от ВБ), поэтому получить их для отчетов невозможно
Второй важный вывод — очевидно, что получить можно только часть данных, например, нельзя получить
Какую глубину истории можно скачать по API?
По официальной документации по сервису АПИ данные
А что на самом деле
Статистика ниже по 200+ Личным Кабинетам
Должны отметить, что есть небольшая корреляция — чем крупнее бренд/чем больше продажи, то тем лучше ВБ хранит их историю, вот такая вот дискриминация…
Что делать, если вы попали в последние категории и история ваших заказов и продаж доступна только за 1-2 недели? Или даже если у вас трехмесячная история, но вы хотите видеть историю за 2 года? Ситуацию исправить можно, но лишь частично — из вашего Личного Кабинета можно выгрузить историю продаж любой глубины и подгрузить в наши отчеты. Подробно это описано здесь, на практике это означает, что вы сможете смотреть график продаж за любой период + будут работать отчеты ABC и P&L, остальные лишь частично.
Если вас смущают вопросы безопасности и вы боитесь делиться своим АПИ ключом с нами, то вот здесь мы постарались описать почему это безопасно.
Дата актуализации статьи: 12 января 2021
Подключение wildberries в ecomcom по API
4. В открывшемся окне вам нужно ввести ключ нового API и ключ API статистики. Новый API отвечает за синхронизацию товаров, обновление остатков, цен и статусов заказов. API статистики отвечает за данные по FBO заказам и остаткам на складах маркетплейса.
6. В левом меню портала поставщика выберите «Мой профиль» —> «Доступ к новому API»
7. Введите имя токена (лучше его назвать ecomcom, чтобы случайно не удалить), и нажмите «Сгенерировать». После этого вставьте токен на страницу настроек wildberries в ecomcom в поле «Новый токен API» (п.4) текущей инструкции
Генерация токена API в wildberries
8. Перейдите в кабинете wb на вкладку «Доступ к API» и скопируйте Ключ для работы с API статистики x64
9. После этого вставьте токен на страницу настроек wb в ecomcom в поле «Ключ API статистики» (п.4) текущей инструкции
10. Нажмите кнопку «Сохранить». Система предложит сразу импортировать существующие товары из wildberries
Готово! Желаем вам отличных продаж и приятного использования системы. Если у вас возникнут вопросы по подключению, менеджер с радостью поможет вам. Инструкция по подключению озон доступна по ссылке.
Что такое API-ключ Wildberries
Каждый маркетплейс предлагает партнерам довольно ограниченный функционал по аналитике своих продаж, но при этом он совсем не против, чтобы вы делали это самостоятельно с помощью сервисов аналитики.
Поэтому он сохраняет все данные по заказам, остаткам, продажам и возвратам, чтобы вы могли экспортировать их в другую систему. Ключи Api WB — это способ получения данных или даже точнее — путь обмена данными от маркетплейса Wildberries к сервису статистики.
Интеграция с Api Wildberries довольно простая — достаточно ввести комбинацию цифр из личного кабинета продавца в раздел Api-кабинет на Moneyplace.
Посмотрим, какие данные можно получить с помощью Api, как получить Api от Wildberries и как подключить Api ключ в сервис аналитики.
Какие данные передает Wildberries по Api
Итак, по Api ключу вы получаете все необходимые данные для анализа. Теперь дело за сервисом аналитики, который проанализирует заказы клиентов, статусы заказов, выгрузку цен, оборачиваемость каждой позиции. Теперь вы видите не просто список товаров, как в личном кабинете Wildberries, но и детальную информацию по каждой позиции.
Как это происходит?
Как подключить Api ключ Wildberries
Для каждого магазина в системе есть свой апи ключ, то есть последовательность букв и цифр, которая позволяет идентифицировать каждый магазин. Поэтому в личном кабинете поставщика может быть несколько токенов Api. Даже если у вас модель FBS, вы сможете получить свой ключ, просто не получится сделать выгрузку остатков.
Для получения токенов в личном кабинете зах одим в раздел Настройки — “Доступ по API”. Здесь вы можете увидеть две последовательности — для аналитики подходит ключ х64. Копируем и вставляем в раздел Api-кабинет сервиса аналитики.
Как работает Api-ключ?
Данные по продажам, заказам и финансам подтягиваются за последние 90 дней. Данные по поставкам и остаткам подтягиваются на дату подключения, и здесь бывают проблемы. То есть Wildberries может “не отдать” часть поставок или остатков на конкретных складах. Как отвечают сотрудники поддержки, данную проблему планируют решить.
Еще один важный момент: есть лимит запросов к Api. Если говорить простым языком, то Api ключ стоит подключать только к одному аккаунту в сервисе, а для получения полной статистики — желательно только к одной программе. Только так можно получить максимум информации по своему магазину.
Когда вы подключаете свой токен в систему аналитики, несмотря на возможные неполадки со стороны WB, Moneyplace начнет накапливать ваши данные, и уже через пару недель вы сможете увидеть четкую картину по своему ассортименту, полностью проанализировать матрицу товаров и финансовую информацию.
На основе этих данных вы сможете в несколько раз увеличить свой доход на маркетплейсах: ликвидировать убыточные товары, изменить цену “средних товаров”, допоставить флагманы на конкретные склады.
А с помощью общей аналитики продаж от Moneyplace вы решите, какими именно товарами дополнить свой портфель, чтобы с успехом встретить новый сезон и заработать еще больше!
Как автоматизировать работу с Wildberries
Wildberries — крупный российский маркетплейс, который помогает бизнесу продавать и доставлять товары покупателям.
Albato позволит тебе настроить обмен данными между аккаунтом продавца на Wildberries и CRM, складом или другими сервисами.
Albato — это no-code сервис, который помогает связывать разные системы и настраивать интеграции. Тебе не придется привлекать разработчика — в интерфейсе Albato можно разобраться за 10 минут, а если у тебя появятся вопросы, их оперативно решит техническая поддержка.
Кому подойдет интеграция с Wildberries
Чем поможет интеграция
Интеграция позволяет работать с маркетплейсом по модели FBO и FBS.
Модель FBO — маркетплейс хранит, упаковывает и отправляет заказы.
Модель FBS — продавец хранит товар на складе, а когда получает заказы, упаковывает их и отправляет в маркетплейс.
Возможности интеграции по модели FBO:
Возможности интеграции по модели FBS:
Какие данные можно получать и передавать: модель FBO
Если ты работаешь с маркетплейсом по этой модели, доступны следующие события:
Триггер: Новый заказ
Это событие будет передавать информацию о новых заказах в кабинете продавца 1 раз в 30 минут
Триггер: Изменен статус заказа
Это событие будет передавать информацию о заказах, чей статус изменился, 1 раз в 30 минут.
А также информация о товарах:
Данные покупателя по этой модели не приходят, потому что маркетплейс сам обрабатывает заказы.
Какие данные можно получать и передавать: модель FBS
Триггер Новый заказ
Это событие передает информацию о новых сборочных заданиях в кабинете продавца. Сборочные задания формируются в единый заказ и передаются 1 раз в 5 минут.
Триггер Изменен статус заказа
Это событие 1 раз в 5 минут передает информацию о сборочных заданиях, чей статус изменился в кабинете продавца.
Экшн: Обновить статусы заказов
Это действие поможет изменять статусы сборочных заданий. Например, можно настроить изменение статуса заказа в зависимости от статуса заказа в CRM системе.
Экшн Обновить остатки
Это действие обновляет остаток товара на складе Wildberries. Для работы убедись, что штрихкод товара на Wildberries соответствует штрихкоду в твоей системе учета.
Как подключить Wildberries к Albato
В новом окне заполни поля:
Нажми «Далее» и «Сохранить». Подключение создано!
Как передавать данные в Wildberries
Настроим интеграцию Wildberries и retailCRM. Логика и правила настройки будут применимы и к другим системам.
Сначала нужно связать два эти сервиса, т.е. создать связку. Она нужна, чтобы ты быстро передавал данные между двумя или более сервисами, которые подключены к Albato.
Как получать новые заказы: модель FBO
Зайди в раздел «Мои связки» → «Создать связку» → «Новая».
Выбери сервис, откуда будешь передавать данные — Wildberries.
Выбери, при каком событии запустится связка — «Новый заказ FBO».
Выбери подключение или создай новое.
Выбери, куда будешь передавать данные:
Куда ты будешь отправлять данные — retailCRM.
Выбери действие — «Новый клиент».
Выбери готовое подключение или создай новое. Разреши доступ к сервису для Albato, если ещё не делал этого.
Этот шаг — обязательное условие в логике многих систем. При работе по FBO данные о покупателе не приходят и этот шаг поможет “крепить” все заказы от Wildberries к одному покупателю. Для удобства задай название покупателя — ООО «ВАЙЛДБЕРИЗ».
В настройках поиска дубликатов выбери «Обновить, если найден дубликат». В качестве значения для поиска укажи «Имя».
Дубликаты занимают лишнюю строчку в контактах, возникает путаница, приходится дольше искать нужную информацию. Чтобы этого избежать, поможет режим обработки дубликатов, в инструкции подробно про него рассказали.
Следующим шагом создай новый заказ в retailCRM. Для этого нажми на «+» и выбери «Действие».
Подставь в поля заказа соответствующие поля из Wildberries. Обязательно настрой передачу id заказа Wildberries в одно из полей. Это нужно, чтобы синхронизировались статусы.
Как получать новые заказы: модель FBS
Связка будет аналогичной, как для FBO, но есть пара важных моментов:
Как изменить статус заказа в CRM в зависимости от заказа в Wildberries: модель FBS
Чтобы получить данные об измененных заказах, создай новую связку. В ней настрой получение только отмененных заказов.
Вот итоговый вид связки:
Чтобы обновлять статусы заказов, выбери действие «Новый заказ» и функцию «Поиск дубликатов» в нем.
В настройках полей заполни «ID клиента» из предыдущего шага и «Внешний ID».
В настройках поиска дубликатов выбери «Обновить существующую запись, если найден дубликат».
Для поиска дубликатов выбери «Внешний ID заказа».
Для обновления статусов, выбери поле «Статус» и значение «Отменен».
Чтобы в Albato приходили заказы в статусе «Отменен» настрой фильтр триггера. Для этого воспользуйся инструметом «Фильтр входящих данных».
Значение «Статус пользователя» установи «Равно 1».
Готово. Теперь, если заказ будет переводиться в статус «Отменен», он будет переходить в соответствующий статус в CRM.
Как изменить статус заказа на Wildberries из своей CRM: модель FBS
Для этого создай еще одну связку. Она будет выглядеть так:
С помощью инструмента «Табличная замена» задай условие, в какой статус переводить заказ на Wildberries.
Чтобы добавить инструмент в связку, нажми «+» и «Инструмент».
В настройках полей у действия «Обновить статус заказа» укажи:
ID заказа — «Внешний ID заказа» (ты сохранял его, когда получал заказ из WB).
Статус заказа — «Результат» из табличной замены.
2 — Сборочное задание завершено.
3 — Сборочное задание отклонено
5 — На доставке курьером.
6 — Курьер довез и клиент принял товар.
7 — Клиент не принял товар.
8 — Товар для самовывоза из магазина принят к работе.
9 — Товар для самовывоза из магазина готов к выдаче.
Как получить API Wildberries и что с ним делать?
Для начала небольшое вступление, что такое API и для чего он нужен? Краткий и простой обзор для начинающих.
В век технологий этот термин стал всё чаще на слуху. Однако мало кто понимает, что именно он обозначает и для чего нужен. В данной статье постараемся объяснить простыми словами, что такое API.
Краткий экскурс:
Аббревиатура API расшифровывается как «Application Programming Interface» (интерфейс программирования приложений, программный интерфейс приложения) – это набор готовых классов, функций, процедур, структур и констант. Вся эта информация предоставляется самим приложением (или операционной системой). При этом пользователю не обязательно понимать, что это API технология обеспечивает взаимодействие модулей. Цель предоставленной информации – использование этих данных при взаимодействии с внешними программами.
Допустим разработчикам, поставщикам маркетплейсов (об этом чуть позже) или же обычному пользователю не нужно знать, как работает та или иная платформа (Facebook, VK, Wildberries, Ozon и другие…). Но благодаря API, обыденный пользователь может публиковать статьи нужных пользователей в своём приложении. Разработчик без проблем сможет делать интеграции в код. Поставщику быстрее и удобнее работать с данными маркетплейсов, даже не вникая в принцип работы API.
Пример для обычного обывателя
Приведу простую аналогию. У вас есть розетка и допустим компьютер. Для того, чтобы компьютер заработал, вам нужно его подключить к сети. Так вот, в данном случае «Сеть» можно назвать программой, от которой мы берем все необходимые данные, соответственно «розетка» выступает аналогом API. Обратите внимание, что розетки бывают разные (как по типу, так и по напряжению), исходя из этого будет отличаться сам интерфейс API и предоставляемая ею информация.
Принцип работы API
Многие компании предлагают API как готовый продукт и зачастую являются платными. Например, Weather Underground продаёт доступ к своему API для получения метеорологических данных. Таких сервисов можно привести большое множество. Имеются сервисы и с бесплатным доступом с API, однако многие из них предоставляют лишь базовый набор функций. Возможен вариант, когда API разрабатывается исключительно для внутренних нужд отдельной компании и является полностью закрытым.
Ну и наконец, постепенно мы дошли до таких сервисов как маркетплейсы. Собственно говоря из-за чего и написана данная статья. На сегодняшний день их становится всё больше, но гигантами на Российском рынке остаются Wildberries, Ozon, Янедекс.Маркет (Беру!), Goods и частично Aliexpress (представитель Tmall). Все эти площадки предоставляют API в открытом доступе и совершенно бесплатно. Благодаря этому поставщики, пользуясь сторонними сервисами, могут свободно анализировать свои данные, будь то заказы, продажи, логистика и многие другие аспекты аналитики. К примеру сервис разработанный нами ECHelper и другими аналогичными программами или же прямым запросом в браузере (для этого требуются необходимые навыки).
Доступ к API в Wildberries
Многие при регистрации на нашем сервисе, застревают на моменте ввода API ключа, так как его у них нет и как получить, тоже не знают. Так как мы пока работаем только с Wildberries, с него и начнем. Давайте подробно пройдёмся по цепочке получения данного ключа, а тем, кому будет лень читать, просьба пролистать ниже к краткому видео обзору или скачать инструкцию ТУТ.
Несколько месяцев назад Wildberries перешли на новый личный кабинет поставщика, но оставив возможность использовать и старый кабинет, однако с минимальным функционалом. Сначала разберёмся как получить ключ в новом личном кабинете.
Новый портал
Заходим в раздел «Настройки» в меню слева под выбором языка. В открывшейся вкладке справа кликаем на пункт «Доступ к API».
Если вы ранее не генерировали ключи, система вам предложит их сгенерировать.
После генерации, у вас появится 2 API ключа для работы с 32-разрядной и 64-разрядной системой.
Уточняю, для работы с нашим сервисом вам нужен ключ именно 64-разрядный.
Для тех, у кого уже были ранее сгенерированы API ключи, они сразу будут отображены на этой вкладке. Ключи вы можете удалить, если в них нет необходимости или они были скомпрометированы или перевыпустить, старый ключ естественно будет не рабочим.
Старый портал
Способ получения API ключа на старой версии личного кабинета. Здесь процесс получения тоже не сложный, но более длительный. Заходим в раздел Service Desk, жмём вкладку «Создать Заявку».
В пункте «Категория» выбираете «Поддержка». Для «Тема» выбираете «Поддержка/Консультация». Заполните поле «Комментарий» следующим текстом: «Здравствуйте! Могли бы вы мне предоставить API-ключ для интеграции? Спасибо!» и нажмите кнопку «Создать заявку».
Как правило, выдача API ключа занимает около суток, но учитывая, что площадка перешла на новый портал, есть вероятность большой задержки или вовсе не дождаться ответа.
Учтите, что после подключения ключа к нашему сервису, данные о товарах будут доступны только с момента получения первого API ключа. К примеру, если вы получили ключ 01 января, то в сервисе данные будут показываться, начиная с 01 января.
Короткий видео обзор, как получить API ключ Wildberries?
Доступ к API в Ozon
В личном кабинете поставщика в правом верхнем углу заходим в «Настройки», для этого наведите на «человечка».
Доступ к API в Goods
Зайдя в раздел «Интеграция по API», вам будет доступна функция интегрирования API ключа в интересующий вас сервис. Если прямая интеграция не интересует, тогда достаточно копировать ключ с права и привязывать к сервисам стандартным способом.
Доступ к API в Яндекс.Маркет
На открывшейся странице задаем следующие настройки:
Отрывок статьи взят с сайта UCOZ. Подробнее ознакомиться можно ТУТ!
Доступ к API в Aliexpress
Отрывок статьи взят с сайта OPENMALL. Подробнее ознакомиться можно ТУТ!