Первоначальная настройка расширения «Загрузка документов МП»

Обновлено Текст в Markdown

После установки расширения нужно создать в 1С карточки двух видов. Оба справочника находятся в разделе MP Docs → Настройки кабинетов.

Видео: настройка за ~5,5 минут

Обзор помощника начала работы, карточек сервиса и кабинета Ozon, ключей API. Ниже — те же шаги текстом. Установка модуля — в инструкции по установке.

  1. «Личный кабинет в сервисе MPDocs» — подключение вашей базы к сервису MP Docs. Обычно одна карточка на базу.
  2. «Личные кабинеты МП» — по одной карточке на каждый кабинет маркетплейса Ozon. В ней указано, к какому кабинету на сайте она относится и с какими реквизитами (организация, контрагент, договор, склад…) создавать документы в 1С.

Создать карточки можно двумя способами: помощником (рекомендуется) или вручную. Правила заполнения полей одинаковы для обоих способов — они описаны во второй части.

Часть 1. Создание кабинетов

Способ 1. Помощник начала работы рекомендуется

Помощник берёт сведения о ваших кабинетах с сайта mpdocs.ru и сам создаёт карточки. Он открывается автоматически при первом запуске после установки. Повторно его можно открыть в разделе MP Docs → Настройки кабинетов → Помощник начала работы.

  1. Введите email и пароль от личного кабинета на mpdocs.ru.
  2. Нажмите «Подключить».

Помощник автоматически:

Если маркетплейс или организация не определились, помощник покажет предупреждение («неизвестный маркетплейс … — выберите вручную», «организация … не найдена в базе — выберите вручную»). Выберите их в карточке сами.

Что нужно дозаполнить в каждой открытой карточке «Личные кабинеты МП»:

  1. Ключи Ozon Seller API — раздел «Вкладка "Настройки подключения к API"».
  2. Реквизиты документов: контрагент, договор, склад и остальные — раздел «Вкладка "Реквизиты документов"».

Повторный запуск. Помощник можно запускать повторно, например после добавления нового кабинета на сайте:

Способ 2. Вручную

Используйте, если помощник недоступен или вы нажали в нём «Пропустить».

Порядок важен: сначала подключение к сервису, потом кабинеты маркетплейсов.
  1. MP Docs → Настройки кабинетов → Личный кабинет в сервисе MPDocs → Создать. Заполните карточку по разделу «Карточка "Личный кабинет в сервисе MPDocs"» и нажмите «Проверить подключение».
  2. MP Docs → Настройки кабинетов → Личные кабинеты МП → Создать — по одной карточке на каждый кабинет Ozon. Заполните её по разделу «Карточка "Личные кабинеты МП" (Ozon)»: сначала шапку и вкладку подключения, затем реквизиты документов.

Когда настройка закончена

Настройка закончена, если:

Остальные поля можно заполнить позже, когда появятся соответствующие операции: выкупы, продажи юрлицам, компенсации, услуги.

Часть 2. Правила заполнения

Карточка «Личный кабинет в сервисе MPDocs»

Подключение базы 1С к сервису MP Docs, через который загружаются документы маркетплейсов. Если карточку создал помощник, здесь ничего менять не нужно.

Вкладка «Настройки соединения»

ПолеЧто указатьЗачем
НаименованиеЛюбое, например «Основная»Для выбора карточки в кабинетах маркетплейсов
Адрес сервераmpdocs.ruАдрес сервиса MP Docs
Порт443Порт защищённого соединения
Использовать SSLУстановленСоединение с сервисом шифруется
Client-Id сервиса MP DocsИз личного кабинета на mpdocs.ruИдентифицирует вас в сервисе
AccessKey сервиса MP DocsИз личного кабинета на mpdocs.ruКлюч доступа к сервису. Хранится в защищённом хранилище 1С, после записи в поле не виден
Не хранить ранее полученные документы в кеше сервераОбычно не устанавливатьСервис запоминает уже полученные от маркетплейса документы, поэтому повторная загрузка за тот же период идёт быстро. С флажком документы каждый раз запрашиваются у маркетплейса заново — дольше

Кнопка «Проверить подключение» проверяет адрес и ключи.

Вкладка «Клиент и биллинг»

Информация из вашего личного кабинета на сайте, заполнять здесь ничего не нужно. Данные обновляются кнопкой обновления на вкладке.

Карточка «Личные кабинеты МП» (Ozon)

Одна карточка — один кабинет продавца на Ozon или WB. Если у вас несколько кабинетов, нужна карточка на каждый.

Часть полей зависит от вашей конфигурации — такие поля отмечены метками:

Расширение само определяет конфигурацию и показывает только подходящие поля.

Почти все значения выбираются из справочников вашей базы. Скорее всего, нужные элементы (организация, контрагент, договор, склад, статьи) у вас уже есть — выберите их. Если какого-то нет, его можно создать прямо из окна выбора.

Шапка

ПолеЧто указатьЗачем
НаименованиеНапример «Ozon — ООО Ромашка»Для выбора кабинета в обработке загрузки
МаркетплейсOZONОт маркетплейса зависит, какие поля показаны в карточке

Вкладка «Настройки подключения к API»

Без подключения загрузка не работает.

ПолеЧто указатьЗачем
Личный кабинет APIКарточку «Личный кабинет в сервисе MPDocs»Через какое подключение к сервису загружать документы. Помощник заполняет сам
ID личного кабинета МП в сервисеВыберите из списка. Кнопка рядом обновляет список с сайтаСвязывает карточку с кабинетом на сайте mpdocs.ru: из него сервис отдаёт документы. Помощник заполняет сам
Seller Client-Id, Seller Api-KeyКлюч Seller API из личного кабинета продавца OzonОбязательно. Через Seller API документы загружаются быстро и полностью
Performance Client-Id, Client-SecretМожно не заполнятьСейчас не используется

Кнопки:

Ключи хранятся в защищённом хранилище 1С и после записи карточки в полях не видны.

Вкладка «Реквизиты документов»

Эти значения подставляются во все документы, которые расширение создаёт по данным Ozon.

Основные реквизиты
ПолеЧто указатьЗачем
ОрганизацияВаша организация, от имени которой вы торгуете на маркетплейсе. Помощник заполняет самОрганизация во всех документах
КонтрагентКонтрагент, представляющий маркетплейс (например, «ООО "Интернет Решения"»)Маркетплейс выступает комиссионером: ему передаются товары, от него приходят отчёты о продажах и акты услуг. Без контрагента загрузка не начнётся
ДоговорДоговор с этим контрагентом от вашей организации. Список ограничен договорами выбранных контрагента и организацииДоговор во всех документах. Из него же берётся валюта документов
СкладСклад, на котором учитываются товары, переданные OzonСклад отгрузок, возвратов, списаний и оприходований
Соглашение УТ/КА/ERPСоглашение с партнёром Ozon, если в базе используются соглашенияПодставляется в документы продаж и возвратов

Требования к договору:

УТ/КА/ERP У контрагента должен быть заполнен партнёр. За этим партнёром закрепляется сопоставление товаров Ozon с вашей номенклатурой.
Покупатели
ПолеЧто указатьЗачем
Создавать покупателейУстановите, если продаёте юрлицам через Ozon (B2B)При загрузке продаж юрлицам покупатель ищется в базе по ИНН/КПП. С флажком недостающие покупатели создаются автоматически, без него такие строки пропускаются
Папка для новых покупателейГруппа справочника, например «Покупатели Ozon»Куда помещать автоматически созданных покупателей
Розничный покупатель БПКонтрагент, например «Розничный покупатель»Покупатель в отчёте комиссионера для продаж физическим лицам
Договор для выкупов УТ/КА/ERP версия 11.5 / 2.5Договор с покупателем, который выкупает товарыНужен, если у вас бывают выкупы товаров маркетплейсам: по ним создаётся реализация по этому договору. Если выкупов нет — оставьте пустым
Статьи при списании и оприходовании товаров у комиссионера

Маркетплейс может потерять или повредить товар и возместить его стоимость (компенсация) либо списать товар без возмещения. Иногда компенсированный товар находится и возвращается на учёт (декомпенсация). Эти статьи нужны для таких операций.

ПолеЧто указатьЗачем
Статья расходов по компенсациямСтатья расходов на списание товаровСписание товара, за который Ozon выплатил компенсацию
Статья доходов по компенсациям УТ/КА/ERPСтатья прочих доходовСумма компенсации от Ozon
Статья расходов по списаниям без компенсацииСтатья расходов на списание товаровСписание товара без возмещения (утилизация, брак и т.п.)
Статья доходов по декомпенсациям (оприходование)Статья прочих доходовОприходование найденного товара
Статья расходов по декомпенсациям УТ/КА/ERPСтатья прочих расходовВозврат Ozon ранее полученной компенсации

Виды статей зависят от конфигурации:

Статьи расходов для документов услуг Ozon

Маркетплейс выставляет акты на свои услуги: комиссию, логистику, хранение, продвижение и т.п. Эти поля определяют, на какие статьи расходов они попадут.

ПолеЧто указатьЗачем
Номенклатура для услуг БПУслуга, например «Услуги маркетплейса»Номенклатура в документе поступления услуг
Статья расходов по умолчаниюОбщая статья для услуг маркетплейсаИспользуется для всех услуг, для которых в таблице ниже не задана своя статья
Подразделение затратПодразделение, на которое относятся расходыПодразделение в документах услуг
Таблица «Операция OZON → Статья расходов»Название услуги Ozon и статья для неёПозволяет разнести разные услуги по разным статьям. Заполнять необязательно: таблицу можно пополнять при загрузке актов услуг — обработка сохраняет выбранные статьи сюда

Виды статей и подразделений зависят от конфигурации:

После заполнения запишите карточку.

Поддержка

Если проблема не решается, напишите в чат поддержки. Приложите текст сообщения и название и версию конфигурации.