На сайте партнеров есть инструкции по интеграции, которые достаточно полно освещают все методы интеграции. Мне пришлось работать с получением статистики об остатках, продажах, заказах и отгрузках «Вайлтберриз». Дополнительной задачей было сравнение остатков на складе в 1С с получаемой информаций с интернет площадки, а также создание документов отгрузки для формирования реальной картины на складе в 1С и занесение стоимости услуг «Вайлтберриз». Сразу скажу, что если с реализацией номенклатуры, всё вполне неплохо, то полностью отказаться от использования отчетов «Эксель» для занесения стоимости услуг «Вайлтберриз» не удалось, по причине того, что «Вайлтберриз» по API передает не все данные по услугам.
Например, не передаются данные по стоимости хранения или международной перевозки, а также обработки товаров. Но, так как есть возможность избавиться от ручного занесения номенклатуры, было принято решение создать отчеты для получения информации по API. На основе отчетов необходимо было создавать документы реализации и возврата товаров.
Поступление услуг «Вайлтберриз» было принято решение тоже частично автоматизировать. По услугам приходит информация о «Вознаграждении Вайлтберриз» и стоимости доставки.
По другим услугам нужно было добавить возможность пользователю самостоятельно вводить сумму из отчета Эксель и автоматизировать заполнение всех необходимым полей. Все товары и услуги должны были быть без НДС.
Для реализации задачи пригодились:
- пример работы с HTTPСоединение, выложенный на ИТС. Пример можно скачать или просмотреть на сайте https://its.1c.ru/db/metod8dev#content:5574:hdoc ,
- а также инструкция https://images.wbstatic.net/portal/education/Kak_rabotat'_s_servisom_statistiki.pdf?abc=1612952230000 .
При работе по API с «Вайлтберриз», стоит обратить внимание, что остатки, как в инструкции и указано, не хранятся на любую дату: «Сервис статистики не хранит историю остатков товаров, поэтому получить данные об остатках товаров на прошедшую, не сегодняшнюю, дату невозможно. Можно получить данные только на момент запроса к API».
Чтобы остатки приходили всегда, я делал запрос всегда на предыдущий день. Если делал запрос на текущую дату слишком рано, то возвращалось пустое значение, так как записей на текущий день ещё не было. Точная дата актуальности приходит в ответе и в любом случае вы будете знать, на какую дату и время информация актуально по каждой строке.
Информация об остатках приходит подробно по всем складам «Вайлтберриз», это возможно интересно для статистики, но неудобно для работы.
Для сравнения остатков с 1С я сворачивал данные по номенклатуре, используя штрихкод номенклатуры, так как все штрихкоды на 46 являются уникальными. При начале работы с «Вайлтберриз» штрихкоды нужно было присвоить номенклатуре самостоятельно, либо воспользоваться услугами сторонних фирм. Процедура получения штрихкодов не сложная и бесплатная, если вы зарегистрированы и платите небольшую сумму членских взносов. Если вы ещё не получили штрихкоды и только собираетесь разместить свои товары на «Вайлтберриз», требуется описать товары через «Каталог GS46» https://srs.gs1ru.org/login .
Для работы также потребуется получить ключ API «Вайлтберриз» на момент, когда я получал ключ, рекомендовалось получать его под основным пользователем (Владельцем) https://seller.wildberries.ru/supplier-settings/access-to-api .
При отладке обработки использовал токен 64. Обязательно устанавливайте с сайтом «Защищенное» соединение, иначе получите ошибку!
Пришлось общаться с техподдержкой партнеров «Вайлтберриз». На большинство вопросов отвечали 2-3 дня вместо указанных 8 часов. На некоторые обращения по истечении трех дней запрашивали дополнительную информацию, не предоставив ответа.
Первый вопрос, который возник - это «Ошибка 429» (несмотря на то, что я не делал слишком частых запросов). Был получен следующий ответ техподдержки: «Здравствуйте. Лимит запросов к API - не более двух одновременно работающих запросов в минуту, в любых комбинациях типов АПИ. Ошибка 429 говорит о превышении лимита запросов...». При ошибки 429 токен временно блокируется, но через какое-то время начинает работать вновь, если токен на заработал, тогда его можно создать заново.
В приложенной инструкции подробно описаны:
- Запросы по API, которые содержат ссылку на сайт с параметрами. Например, метод получения остатков на складах содержит ссылку https://suppliers-stats.wildberries.ru/api/v1/supplier/stocks к нему нужно добавить дату с параметром в формате: ?dateFrom=2017-03-25T21:00:00.000Z и полученный токен через параметр &key= Токен, получится https://suppliers-stats.wildberries.ru/api/v1/supplier/stocks?dateFrom=2017-03-25T21:00:00.000Z&key=токен.
- Названия полей, которые возвращает метод. Я использовал структуру с описание формата получаемых полей. Загружал полученные с сайта данные в таблицу значений, далее таблицу значений, через параметр помещал во временную таблицу в запрос и уже в запросе группировал и сравнивал с данными 1С.
На примере конфигурации Управление нашей фирмой, редакция 1.6 (1.6.25.166):
- для формирования расходов, связанных с «Вайлтберриз» рекомендую завести в 1С отдельное подразделение или, если номенклатура отгружается только на «Вайлтберриз», завести дополнительное направление деятельности. Если у вас их несколько подразделений, нужно их разрешить. Для этого в настройках конфигурации, в разделе «Больше возможностей», «Компания» установить галочки «Несколько подразделений», «Несколько направлений деятельности».
- Информация по услугам доставки приходит как «Логистика» вместо «доставка конечному покупателю» и «международная доставка». Если разделение для аналитики принципиально, тогда нужно вручную разделить суммы по соответствующий услугам.
Выложил две обработки.
- "ОбработкаHTTPСтатусовWildberriesУправляемыеФормы1С.epf" - чтобы посмотреть работу методов работы с сайтом или загрузить статистику, имея токен. Обработка получает данные статистики без привязки к какой либо конфигурации, работает на управляемых формах. Проверял работу на платформе 1С 8.3.18.1483.
- "ОбработкаHTTPСтатусовWildberriesУправляемыеФормы1СУНФ.epf" - для конфигурации УНФ 1.6. с возможностью загрузки статистики, сравнения остатков «Вайлтберриз» и создания документов "Расходная накладная" и "Приходная накладная". Обработка после загрузки статистики продаж создает список загруженных отчетов, которые необходимо сравнить с отчетами эксель, если данные совпадают, выбрать нужные отчеты и автоматически создать на их основании документы отгрузки товаров и получение услуг. Получение услуг «Вайлтберриз» можно дополнить, вручную заполнив суммы в поля которые не приходят по API, либо отказаться от автоматического создания приходной накладной на услуги. Проверялось на Управление нашей фирмой, редакция 1.6 (1.6.25.166), (1.6.26.132).
В ближайшее время планирую выложить пример для Управление торговлей 11.4 и Розница 2.3.
