# Первоначальная настройка расширения «Загрузка документов МП» После установки расширения (см. [«Установка модуля в 1С»](https://mpdocs.ru/docs/install.md)) нужно создать в 1С два вида карточек: 1. **«Личный кабинет в сервисе MPDocs»** — подключение вашей базы к сервису MP Docs. Обычно одна карточка на базу. 2. **«Личные кабинеты МП»** — по одной карточке на каждый кабинет маркетплейса Ozon. В ней указано, к какому кабинету на сайте она относится и с какими реквизитами (организация, контрагент, договор, склад…) создавать документы в 1С. Оба справочника находятся в разделе **MP Docs → Настройки кабинетов**. Создать карточки можно двумя способами: автоматически помощником (рекомендуется) или вручную. Правила заполнения полей одинаковы для обоих способов и описаны во второй части инструкции. --- # Часть 1. Создание кабинетов ## Способ 1. Помощник начала работы (рекомендуется) Помощник берёт сведения о ваших кабинетах с сайта mpdocs.ru и сам создаёт карточки. Он открывается автоматически при первом запуске после установки. Повторно его можно открыть в разделе **MP Docs → Настройки кабинетов → Помощник начала работы**. 1. Введите **email** и **пароль** от личного кабинета на mpdocs.ru. 2. Нажмите **«Подключить»**. Помощник автоматически: - создаст и откроет карточку **«Личный кабинет в сервисе MPDocs»**. В ней уже заполнено всё необходимое, менять ничего не нужно. Что означают поля — в разделе [«Карточка "Личный кабинет в сервисе MPDocs"»](https://mpdocs.ru/docs/setup#mpdocs-card); - создаст и откроет карточки **«Личные кабинеты МП»** для всех кабинетов, заведённых на сайте. В них уже заполнены: - наименование; - маркетплейс; - организация — помощник ищет её по ИНН и КПП, затем по наименованию; - на вкладке «Настройки подключения к API»: «Личный кабинет API» и «ID личного кабинета МП в сервисе». Если маркетплейс или организация не определились, помощник покажет предупреждение («неизвестный маркетплейс … — выберите вручную», «организация … не найдена в базе — выберите вручную») — выберите их в карточке сами. **Что нужно дозаполнить в каждой открытой карточке «Личные кабинеты МП»:** 1. Ключи Ozon Seller API — раздел [«Вкладка "Настройки подключения к API"»](https://mpdocs.ru/docs/setup#mp-api). 2. Реквизиты документов: контрагент, договор, склад и остальные — раздел [«Вкладка "Реквизиты документов"»](https://mpdocs.ru/docs/setup#mp-requisites). **Повторный запуск.** Помощник можно запускать повторно, например после добавления нового кабинета на сайте. - Новые карточки создаются только для новых кабинетов, существующие не дублируются. - В существующих карточках обновляется только подключение к сервису: адрес, ключ доступа, ссылка на «Личный кабинет в сервисе MPDocs». - Маркетплейс и организация заполняются, только если были пустыми. - Остальные заполненные вами поля (контрагент, договор, склад, ключи Ozon и т.д.) не меняются. ## Способ 2. Вручную Используйте, если помощник недоступен или вы нажали в нём **«Пропустить»**. Порядок важен: сначала подключение к сервису, потом кабинеты маркетплейсов. 1. **MP Docs → Настройки кабинетов → Личный кабинет в сервисе MPDocs → Создать.** Заполните карточку по разделу [«Карточка "Личный кабинет в сервисе MPDocs"»](https://mpdocs.ru/docs/setup#mpdocs-card) и нажмите «Проверить подключение». 2. **MP Docs → Настройки кабинетов → Личные кабинеты МП → Создать** — по одной карточке на каждый кабинет Ozon. Заполните её по разделу [«Карточка "Личные кабинеты МП" (Ozon)»](https://mpdocs.ru/docs/setup#mp-card): сначала шапку и вкладку подключения, затем реквизиты документов. ## Когда настройка закончена Настройка закончена, если: - в карточке «Личный кабинет в сервисе MPDocs» проходит **«Проверить подключение»**; - в каждой карточке «Личные кабинеты МП» проходят **«Проверить доступ к MPBUH»** и проверка ключей **Seller API**; - в каждой карточке «Личные кабинеты МП» заполнены организация, контрагент, договор и склад; - **УТ/КА/ERP:** у контрагента-маркетплейса заполнен партнёр. Остальные поля можно заполнить позже, когда появятся соответствующие операции: выкупы, продажи юрлицам, компенсации, услуги. --- # Часть 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. Если у вас несколько кабинетов, нужна карточка на каждый кабинет. Часть полей зависит от вашей конфигурации: - **БП** — 1С:Бухгалтерия предприятия 3.0; - **УТ/КА/ERP** — 1С:Управление торговлей 11, 1С:Комплексная автоматизация 2, 1С:ERP 2. Расширение само определяет конфигурацию и показывает только подходящие поля. Почти все значения выбираются из справочников вашей базы. Скорее всего, нужные элементы (организация, контрагент, договор, склад, статьи) у вас уже есть — выберите их. Если какого-то нет, его можно создать прямо из окна выбора. ### Шапка | Поле | Что указать | Зачем | |---|---|---| | Наименование | Например «Ozon — ООО Ромашка» | Для выбора кабинета в обработке загрузки | | Маркетплейс | OZON | От маркетплейса зависит, какие поля показаны в карточке | ### Вкладка «Настройки подключения к API» Без подключения загрузка не работает. | Поле | Что указать | Зачем | |---|---|---| | Личный кабинет API | Карточку «Личный кабинет в сервисе MPDocs» | Через какое подключение к сервису загружать документы. Помощник заполняет сам | | ID личного кабинета МП в сервисе | Выберите из списка. Кнопка рядом обновляет список с сайта | Связывает карточку с кабинетом на сайте mpdocs.ru: из него сервис отдаёт документы. Помощник заполняет сам | | Seller Client-Id, Seller Api-Key | Ключ Seller API из личного кабинета продавца Ozon | **Обязательно.** Через Seller API документы загружаются быстро и полностью | | Performance Client-Id, Client-Secret | Можно не заполнять | Сейчас не используется | Кнопки: - **«Проверить доступ к MPBUH»** — проверяет связь с сервисом по выбранному ID кабинета; - кнопка проверки рядом с Seller API — проверяет ключи Ozon. Ключи хранятся в защищённом хранилище 1С и после записи карточки в полях не видны. ### Вкладка «Реквизиты документов» Эти значения подставляются во все документы, которые расширение создаёт по данным Ozon. #### Основные реквизиты | Поле | Что указать | Зачем | |---|---|---| | Организация | Ваша организация, от имени которой вы торгуете на маркетплейсе. Помощник заполняет сам | Организация во всех документах | | Контрагент | Контрагент, представляющий маркетплейс (например, «ООО "Интернет Решения"») | Маркетплейс выступает комиссионером: ему передаются товары, от него приходят отчёты о продажах и акты услуг. Без контрагента загрузка не начнётся | | Договор | Договор с этим контрагентом от вашей организации. Список ограничен договорами выбранных контрагента и организации | Договор во всех документах. Из него же берётся валюта документов | | Склад | Склад, на котором учитываются товары, переданные Ozon | Склад отгрузок, возвратов, списаний и оприходований | | Соглашение (**УТ/КА/ERP**) | Соглашение с партнёром Ozon, если в базе используются соглашения | Подставляется в документы продаж и возвратов | **Требования к договору:** - **УТ/КА/ERP:** хозяйственная операция — **«Передача на комиссию»**. Версия комиссионных продаж в договоре определяет, какими документами расширение оформит операции: УТ **11.5**, КА и ERP **2.5** — новая схема; УТ **11.0**, КА и ERP **2.0** — прежняя. Если в вашей базе выбора версии нет, используется схема, которую поддерживает конфигурация. - **БП:** вид договора — с комиссионером на продажу. **Контрагент в УТ/КА/ERP:** у контрагента должен быть заполнен **партнёр**. За этим партнёром закрепляется сопоставление товаров Ozon с вашей номенклатурой. #### Покупатели | Поле | Что указать | Зачем | |---|---|---| | Создавать покупателей | Установите, если продаёте юрлицам через Ozon (B2B) | При загрузке продаж юрлицам покупатель ищется в базе по ИНН/КПП. С флажком недостающие покупатели создаются автоматически, без него такие строки пропускаются | | Папка для новых покупателей | Группа справочника, например «Покупатели Ozon» | Куда помещать автоматически созданных покупателей | | Розничный покупатель (**БП**) | Контрагент, например «Розничный покупатель» | Покупатель в отчёте комиссионера для продаж физическим лицам | | Договор для выкупов (**УТ/КА/ERP**, версия 11.5 / 2.5) | Договор с покупателем, который выкупает товары | Нужен, если у вас бывают выкупы товаров маркетплейсам: по ним создаётся реализация по этому договору. Если выкупов нет — оставьте пустым | #### Статьи при списании и оприходовании товаров у комиссионера Маркетплейс может потерять или повредить товар и возместить его стоимость (**компенсация**) либо списать товар без возмещения. Иногда компенсированный товар находится и возвращается на учёт (**декомпенсация**). Эти статьи нужны для таких операций. | Поле | Что указать | Зачем | |---|---|---| | Статья расходов по компенсациям | Статья расходов на списание товаров | Списание товара, за который Ozon выплатил компенсацию | | Статья доходов по компенсациям (**УТ/КА/ERP**) | Статья прочих доходов | Сумма компенсации от Ozon | | Статья расходов по списаниям без компенсации | Статья расходов на списание товаров | Списание товара без возмещения (утилизация, брак и т.п.) | | Статья доходов по декомпенсациям (оприходование) | Статья прочих доходов | Оприходование найденного товара | | Статья расходов по декомпенсациям (**УТ/КА/ERP**) | Статья прочих расходов | Возврат Ozon ранее полученной компенсации | Виды статей зависят от конфигурации: - **УТ/КА/ERP** — статьи расходов и статьи доходов; - **БП** — статьи прочих доходов и расходов; в карточке видны три поля из пяти. #### Статьи расходов для документов услуг Ozon Маркетплейс выставляет акты на свои услуги: комиссию, логистику, хранение, продвижение и т.п. Эти поля определяют, на какие статьи расходов они попадут. | Поле | Что указать | Зачем | |---|---|---| | Номенклатура для услуг (**БП**) | Услуга, например «Услуги маркетплейса» | Номенклатура в документе поступления услуг | | Статья расходов по умолчанию | Общая статья для услуг маркетплейса | Используется для всех услуг, для которых в таблице ниже не задана своя статья | | Подразделение затрат | Подразделение, на которое относятся расходы | Подразделение в документах услуг | | Таблица «Операция OZON → Статья расходов» | Название услуги Ozon и статья для неё | Позволяет разнести разные услуги по разным статьям. Заполнять необязательно: таблицу можно пополнять при загрузке актов услуг — обработка сохраняет выбранные статьи сюда | Виды статей и подразделений зависят от конфигурации: - **УТ/КА/ERP** — статьи расходов, подразделение из структуры предприятия; - **БП** — статьи затрат, подразделение организации. После заполнения запишите карточку. ## Поддержка Если проблема не решается, напишите в поддержку MP Docs: чат https://mpdocs.ru/chat. Приложите текст сообщения и название и версию конфигурации.