При установке расширения необходимо снимать флаг безопасного режима.
Настройка после установки расширения
Wildberries.
1) Получить ключ API Wildberries: Для получения ключа API нужно на кабинете партнера https://seller.wildberries.ru/ зайти в "Настройки", далее вкладка "Доступ к API", "Ключ для работы с API статистики x64".
2) В базе открыть настройки ВБ (Раздел WB, далее ссылка "Настройки WB") и добавить новую запись. Для каждой записи нужно указать:
а) организацию, по которой будут загружаться отчеты комиссионера.
б) сервер сервиса Wildberries. Это statistics-api.wildberries.ru.
в) API-ключ.
OZON.
ВНИМАНИЕ! Суммы продаж, комиссий полученные методами API OZON могут расходиться с суммами полученными через скачивание файлов Excel из сервиса OZON!
1) Получить Client Id и ключ API OZON: Для получения этих параметров нужно на кабинете партнера https://seller.ozon.ru/ перейти в "Настройки", далее вкладка "API ключи", на ней поля "Client Id" и "API key".
2) В базе открыть настройки озон (Раздел OZON, далее ссылка "Настройки OZON") и добавить новую запись. Для каждой записи нужно указать:
а) организацию, по которой будут загружаться отчеты комиссионера.
б) сервер сервиса Wildberries. Это api-seller.ozon.ru.
в) идентификатор клиента и API-ключ.
Инструкция.
Алгоритмы загрузки данных из сервисов одинаковые. Для настройки доступа к подсистемам используются роли "Доступ к подсистеме WB" / "Доступ к подсистеме OZON".
1) Открыть обработку "Загрузка отчетов комиссионера". При открытии обработки система попытается по ИНН найти контрагента Вайлдберриз или Озон и подставит его в обработку.
2) Записать документ "Отчет комиссионера (агента) о продажах" с заполненными полями в шапке документа и пустой табличной частью "Товары" указать его в обработке.
3) Указать в обработке договор оказания услуг сборки, доставки, маркетинга комиссионером.
4) Нажать кнопку "1. Загрузить данные из WB/OZON в таблицу". При нажатии система отправит запрос на получение продаж и оказанных услугах за период, указанный в отчете комиссионера и заполнит ими таблицу в обработке для анализа и проверки данных. Поиск товаров в обработке осуществляется по штрихкоду. Для Вайлдберриз, если штрихкод не указан, то поиск продолжается по артикулу номенклатуры и наименованию характеристики.
5) Нажать кнопку "2. Заполнить отчет комиссионера". Система заполнит выбранный документ "Отчет комиссионера (агента) о продажах" данными из таблицы. Далее документ нужно провести.
6) Нажать кнопку "3. Создать документ оказания услуг". Будет создан новый документ "Приобретение товаров и услуг" с указанным в обработке договором. Документ будет создан и открыт, но не записан. Если расчету в договоре оказания услуг ведутся по заказам или накладным, то после записи данный документ следует указать в обработке в поле "Документ оказания услуг".
7) Нажать кнопку "4. Создать взаимозачет задолженности". Будет создан новый документ "Взаимозачет задолженности". Данным документом задолженность по договору оказания услуг (или документу оказания услуг) будет перенесена на отчет комиссионера. Документ будет создан и открыт, но не записан.
Ограничения
1) В базе для комиссионера должна быть включена возможность ведения договоров с поставщиками.
2) В базе должна присутствовать услуга с наименованием "Доставка товара до покупателя".
3) Загрузка из ОЗОН возможна максимум 10000 строк. Если в обработке вышло 10000 строк, то нужно делить отчеты комиссионеров по периоду так, чтобы количество строк было менее 10000.
Расширения проверялись в УТ 11.5.11.70 на платформе 8.3.22.1704.
12.11.2021. Добавлена возможность загрузки наборов в отчет комиссионера. Вместо набора в документ будут попадать его комплектующие по основному варианту комплектации.
06.09.2022. В запросе /api/v1/supplier/reportDetailByPeriod в Вайлдберриз появилось ограничение в получении записей не больше 1000 за один запрос. Внесено исправление.
08.09.2022. Исправлена ошибка при заполнении отчета комиссионера о продажах. (Поле объекта не обнаружено (Организация)) Ошибка появлялась на версиях УТ с 11.5.8.
21.09.2022. Исправлена ошибка загрузки данных о продажах в сервисе ОЗОН. Было http, стало https подключение.
24.12.2022. В запросе /api/v1/supplier/reportDetailByPeriod в Вайлдберриз ограничение в получении записей не больше 1000 за один запрос изменили до 100000. В связи с этим количество получаемых записей теперь 10000. Переделан алгоритм получения данных из сервиса через фоновое задание, чтобы сеанс у пользователя не зависал, пока идет считывание данных из сервиса.
07.02.2022. В расширении WB токен увеличен до 500 знаков. Изменено выполнение запроса /api/v1/supplier/reportDetailByPeriod.
03.03.2023. Расширения WB и OZON изменены под конфигурацию УТ 11.5.11.70 и выше.
20.03.2023. В запросе о продажах из сервиса OZON появилось ограничение в 1000 записей за один запрос. Изменено расширение обработка для работы с OZON.
03.05.2024. В расширении по WB изменен запрос /api/v5/supplier/reportDetailByPeriod.
Проверено на следующих конфигурациях и релизах:
- Управление торговлей, редакция 11, релизы 11.5.15.40