Загрузка отчета о продажах WildBerries для бухгалтера из API Статистики и Отчетов в формате *.xlsx в 1С документ "Отчет комиссионера"
Обработки адаптированы под Веб-клиент и требования облачных сервисов
При первоначальном запуске будет предложен вариант использования:
1. Отчеты Excel, поддерживаются следующие:
- детализированный отчет
- отчет к ОФЕРТЕ (с товарными позициями)
- приложение №4
- приложение №6
2. API статистики, потребуется получить Токен (процедура описана ниже в новостях), в результате будет доступно получение данных о продажах и возвратов за указанный период, поддерживаются следующие:
- Ключ API статистики x64
- Ключ нового API статистики (от 24-11-2022)
Технические требования
Тестировалось на платформе 1С:Предприятие 8.3 (8.3.21.1302) и минимально необходимые релизы конфигураций 1С:
- Бухгалтерия предприятия, редакция 3.0 (3.0.137.39)
- Управление нашей фирмой, редакция 3.0 (3.0.1.230)
- Розница, редакция 3.0 (3.0.1.230)
- Управление торговлей, редакция 10.3 (10.3.67.3)
- Управление торговлей, редакция 11 (11.4.13.136)
- Управление торговлей, редакция 11 (11.5.10.73)
- Комплексная автоматизация 2 (2.4.13.136)
- Комплексная автоматизация 2 (2.5.10.73)
- ERP Управление предприятием 2 (2.4.13.136)
- ERP Управление предприятием 2 (2.5.10.73)
Код открыт.
-
Вопрос по варианту загрузки в последующем задаваться не будет, для того чтобы сменить вариант – просто переустановите обработку
-
Какой именно ключ API вы пытаетесь "скормить" обработке, Content API - не подойдет, нужен именно API Статистики x64
-
WB гарантирует хранение данных о продажах и его получения по интерфейсу API не более 90 дней от текущей даты
-
Токен действует 180 дней после создания
-
Сопоставление номенклатурных позиций производится по Штрих коду (в приоритете, подтягиваются данные из ШК такие, как характеристики, упаковка) либо если ШК не найден поиск происходит по Артикулу, в противном случае по Номенклатуре контрагента
-
После загрузки документ не сохраняется, для того чтобы откатить изменения – просто закройте документ без сохранения
-
Для обычных форм (УТ-10.3) обработка подключается во Внешние обработки заполнения табличных частей, токен указывается в Параметрах обработки (более детально ниже в новостях)
-
Работа с наборами, комплектами и упаковками не поддерживается
-
Обработка заполняет табличную часть документа, сам документ при этом не создает. По этой причине при подключении снимите галку показывать в списках. Обработка вызывается лишь из формы документа.
Появляется как команда Загрузка из WildBerries в документе "Отчет комиссионера о продажах".
По нажатию на которую производится загрузка из файла либо АПИ в табличную часть документа "Отчет комиссионера (агента) о продажах".
Те позиции, которые не удалось сопоставить, будут отображены в окне сопоставления.
Обновление Токена
Новости
Для конфигурации Бухгалтерия предприятия загрузка в документ "Отчет комиссионера (агента)" с видом операции "Списание товаров" реализована лишь товарных позиций с обоснование для оплаты:
- компенсация брака
- компенсация потерянного товара
- компенсация подмененного товара
Сумму при этом, берутся из колонки "К перечислению Продавцу за реализованный Товар"
Обработки доработаны под новую версию API v5, решением послужило следующее сообщение:
Обработки обновлены под новую версию API v3, данные по ней доступны с 29-01-2024
Для обработок на управляемых формах опционально добавлены возможности по группировке номенклатурных позиций, а также получения данных по юридическим лицам и заполнения информации по ним в документе отчета комиссионера.
Изменено получение данных по строкам с обоснование для оплаты "Частичная компенсация брака" и "Авансовая оплата за товар без движения" согласно рекомендациям (см. ниже скриншот) представителей Wildberries.
Данные оплат (не всегда, лишь в ряде случаев) разбиваются на мелкие платежи. Ниже представлен скриншот переписки с тех.поддержкой где этот момент подтверждается представителем Wildberries.
Текущие строки сгруппированы по сумме оплат и приведены к одной единицы по ШК.
Добавлена возможность редактирования суммы реализации в окне сводной информации (пример на скриншоте ниже).
Для чего это реализовано: в редких случаях данные получают не для ведения бухгалтерского учета, а лишь для управленческого. Т.е. загружают товарные позиции и желают видеть не сумму реализации в которой присутствуют все издержки маркетплейса (комиссионное вознаграждение, штрафы и т.п.), а итоговую сумму к перечислению продавцу. Т.е. ту сумму которая поступает на счет, а она отличается от суммы реализации в меньшую сторону и присутствует лишь в личном кабинете (Итого к оплате, руб.). Вот именно её, при необходимости, появилась возможность внести в сумму реализации окна сводной информации и на выходе получить документ с необходимой суммой, пропорционально распределенной по всем товарным позициям.
Для формы получения данных через АПИ добавлены поля: номер отчета и его период, а также добавлен фильтр на номера отчетов.
Для конфигураций на управляемых формах, опционально добавлена возможность производить поиск номенклатурных позиций по любому строковому реквизиту номенклатуры.
16-05-2022 г. WB изменил отражение комиссионного вознаграждения в отчетах детализации и данных АПИ. На вопрос как именно рассчитать комиссию из детализации, представители WB дали следующий ответ:
Ответ от техподдержки WB: "Здравствуйте. В вознаграждение ВБ в отчете также входят теперь: услуги логистики (кроме международной), хранения и услуги поверенного Точная сумма вознаграждения указана в печатной форме отчета. Для того что бы выйти на итоговую сумму вознаграждения вайлдберриз указанную в УПД, необходимо суммировать колонки; Вознаграждение Вайлдберриз (ВВ), без НДС (колонка в детализации W) + НДС с Вознаграждения Вайлдберриз (колонка в детализации X) + сумма хранения (в шапке отчета) + логистика только РФ (фильтр по колонка «Страна»), так же, учтите, что расчёт колонок идёт только по продажам, т.е. суммируем только продажи и вычитаем возвраты. Благодарим за обращение. Просим Вас оценить предоставленный ответ."
Именно по данному варианту обработки ведут расчет комиссии, но как вы понимаете данный расчет не всегда достоверен, по той причине, что Сумма за хранения отсутствует в отчетах детализации и в данных АПИ, а присутствует лишь в личном кабинете. Так же нет возможности отразить отрицательные комиссии.
По этой причине, в конце загрузки, было добавлено окно информации.
В нём, при необходимости, можно скорректировать (ввести итоговые) суммы комиссии и НДС по комиссии из отчета по Оферте, данные суммы будут распределены по всему документу.
Реализована возможность получения данных по API статистики.
Вам необходимо зайти в раздел настроек профиля Пользователи, (найти номер со статусом Владелец, выйти из личного кабинета и зайти с номера владельца.) Это необходимо для получения возможности сгенерировать API токен.
Пройдите в раздел Доступ к API нажмите Создать новый токен, введите любые символы в поле Имя токена. Выберите тип токена Статистика и нажмите Создать токен -> Токен отобразится только 1 раз. Обязательно сохраните его.
Вариант подключения и задания Токена для обычных форм (УТ-10.3)
Техническая поддержка и обновления
Бесплатный период техподдержки и обновлений составляет 1 месяц со дня покупки
Задать вопрос по программе можно по кнопке "Техподдержка" на странице описания.
При создании тикета необходимо предоставить:
- Номер заказа
- Точную конфигурацию 1С, и релиз, на которой используете купленное решение (наименование и версию 1С можно взять из раздела "О программе"), версию купленной программы.
- Укажите метод вашей загрузки: через файл Excel или API (при этом приложенные файлы (детализация + оферта), либо предоставленный токен к статистики – ускорит решение вашей проблемы)
К созданной заявке подключается специалист. Дальнейшее обсуждение проблемы будет проходить в тикете техподдержки. Стандартный срок реакции - 24 часа в рабочие дни с момента обращения
Проверено на следующих конфигурациях и релизах:
- Бухгалтерия предприятия, редакция 3.0, релизы 3.0.137.39
- Управление торговлей, редакция 11, релизы 11.5.10.73, 11.4.13.136
- Управление торговлей, редакция 10.3, релизы 10.3.67.3
- Управление нашей фирмой, редакция 3.0, релизы 3.0.1.230
- Розница, редакция 3.0, релизы 3.0.1.230
- 1С:ERP Управление предприятием 2, релизы 2.5.10.73
- 1С:Комплексная автоматизация 2, релизы 2.5.10.73