> For the complete documentation index, see [llms.txt](https://rexant.gitbook.io/dokumentaciya/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rexant.gitbook.io/dokumentaciya/integracii/integraciya-s-pim.md).

# Интеграция с PIM

Внутренний проект компании объединяющий в одном окне работу со всеми внешними интеграциями (WB, OZON, Ya, СММ и т.д.).

## Описание версий:

{% hint style="success" %}
**Текущая версия 1.0.4**

Доступные интеграции: 

1. Мегамаркет.
2. Hoff.
3. Петрович.
4. Wildberries (отзывы покупателей).
   {% endhint %}

{% hint style="danger" %}
Список будущих интеграций:

1. Авито.
2. Леруа мерлен.
3. Wildberries.
4. Yandex.
5. OZON.
   {% endhint %}

## Оглавление

1. [**Общее описание**](#obshee-opisanie-obrabotki).
2. [**Раздел настройки**](#nastroiki-api).
3. [**Раздел номенклатура**](#razdel-nomenklatura).
   * [Ном. поставщика](#nom.-postavshika)*.*
   * [Остатки товаров](#ostatki-tovarov)*.*
   * [Цены поставщика](#ceny-postavshika).
4. [**Раздел документы**](#razdel-dokumenty).
   * [Заказы клиентов](#zakazy-klientov).
5. **Отзывы клиентов**.

## Общее описание обработки.

**PIM** (**Product information management system**) — система для централизованного управления большими массивами данных о товарах. Основная задача соединить все текущие и будущие интеграции с внешними партнерами в единой точке.

Автоматизация процессов при работе с маркетплейсами существенно позволяет сократить время обработки заказов, ответов на заказ, формирования поставок и т.д.

## Настройки API.

Важный раздел настроек выгрузки и обработки данных для маркетплейсов.

* **Настройка** – файл внутри 1С которых хранит в себе заполненные данные на форме Настройки API. При переключении файла меняются настройки (маркетплейсы).
* **Авторизация API.**
  * Адрес сервера – адрес сервера PIM.
  * API KEY – ключ доступа к обмену данными с PIM.
  * Партнер – основной партнер с которым взаимодействует обработка (маркетплейс).
* **Настройки заказов.**
  * Шаблон заказов – указывается шаблон заполнения документов при создании Заказа клиента.
  * Шаблон рекламаций – указывается шаблон заполнения документов при создании Рекламации.
  * Поставщик PIM – указывается партнер (id) которого есть в PIM для идентификации обмена данных между СУБД (настраивает администратор системы).
  * Маркетплейс PIM – указывается партнер (id) которого есть в PIM для идентификации обмена данных между СУБД (настраивает администратор системы).
  * <mark style="color:green;">Склады</mark> – Склады остатков, с этих складов суммируются остатки и передаются в маркетплейс, а также формируются заказы. Для заказов важна очередность, в каком порядке указаны склады в таком порядке будут устанавливаться склады остатков в заказе.
  * <mark style="color:green;">Резервы</mark> – Если указан документ заказ клиента в котором есть резервы, то для формирования заказа сперва будут списываться резервы из указанного заказа.
  * ID – Идентификатор партнера в СУБД PIM.
  * ID (МП) – Идентификатор маркетплейса в СУБД PIM.
  * Адрес оповещения – электронная поста сотрудника куда придет оповещение в случае ошибок при работе с маркетплейсом.
  * <mark style="color:green;">Коэффициент остатков</mark> – при выгрузке остатков в маркетплейс при наличие коэффициента сработает формула (Остаток \* К) = Костаток, пример Остаток 100, коэффициент 10, тогда 100\*0,1 = 10, в маркетплейс выгрузится остаток по товару равный 10.
  * <mark style="color:green;">Вид цены выгрузки</mark> – При указании вида цены, именно по нему будет осуществляться выгрузка цен в маркетплейс.
  * <mark style="color:green;">Минимальная цена</mark> – Для отсеивания низко маржинальных товаров можно задать порог минимальной цены, товар с ценой ниже указанно выгружаться не будет.
* **Номенклатура исключения** – таблица содержащая номенклатуру которая не будет учувствовать в обмене данных (остатки, цены).
* **Сезонный товар (без контроля минимальной цены)** – таблица содержащая номенклатуру, которая будет выгружаться не смотря на контроль минимальной цены.
* **Индивидуальный прайс - лист** – в таблицу можно загрузить соглашение или файл с индивидуальными прайс листами, тогда при выгрузке цен в первую очередь данные будут браться из этой таблицы.

<figure><img src="https://1786478310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNeAVhc1Kicp5bJqqVv5c%2Fuploads%2Fy8I8EDZmYCkALkJmhSA8%2Fimage.png?alt=media&amp;token=39af674d-295b-4326-9eb7-f86e1cb0972c" alt=""><figcaption><p>Источники данных.</p></figcaption></figure>

* **Создавать заказы со скидкой** – некоторые маркетплейсы присылают заказы с учетом скидок (к примеру бонусы Спасибо), если установлен данный признак тогда в заказ будет попадать цена полученная из API маркетплейса (к примеру сумма покупки 1 руб.).

## **Раздел номенклатура**

Раздел управления номенклатурой для выгрузки ее в маркетплейсы.

### Ном. поставщика.

{% hint style="info" %}
Раздел номенклатура поставщика показывает какие товары готовы к выгрузке на маркетплейс, для каких товаров настроены передача остатков и цен.
{% endhint %}

**Команды**

<figure><img src="https://1786478310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNeAVhc1Kicp5bJqqVv5c%2Fuploads%2FN1Qc5alotQFaB6tCcCMw%2Fimage.png?alt=media&amp;token=346880da-1a42-4209-9f71-1a25395a33f3" alt=""><figcaption><p>Командная панель</p></figcaption></figure>

* Выделить все строки – Поставить признак выделения на всех строках.
* Снять выделения со всех строк – Снять признак выделения на всех строках.
* Обновить в PIM (PATCH) – Обновляет выделенные строки товаров в СУБД PIM.
* Выгрузить в PIM (POST) – Выгружает в СУБД PIM новые товары. \
  *<mark style="color:orange;">Далее для ИТ - специалистов: в ответ придет код 200 с ID товара, запишется в элемент справочника Номенклатура поставщика. По данному ID происходит все обмены и связь.</mark>*
* Очистить ID PIM – Очищает ID PIM из элемента справочника Номенклатура поставщика.

**Таблица**

* Выбор – Пользователь отмечает какие товары к выгрузки.
* Продавец – Поставщик PIM из раздела настроек.
* Маркетплейс – Маркетплейс PIM из раздела настроек.&#x20;
* ID PIM – <mark style="color:purple;">не используется</mark>.
* Номенклатура поставщика – Ссылка на элемент справочника Номенклатура поставщика.
* Артикул поставщика – Артикул из карточки товара поставщика.
* Номенклатура – Номенклатура к которой привязана номенклатура поставщика.
* ID товара в PIM – ID присвоенное в СУБД PIM, возвращается после первичной выгрузки.
* Описание – Описание номенклатуры из карточки товара.
* Бренд – Бренд номенклатуры из карточки товара.
* Высота – ВГХ характеристика из карточки товара (сейчас скрыта).
* Глубина – ВГХ характеристика из карточки товара (сейчас скрыта).&#x20;
* Ширина – ВГХ характеристика из карточки товара (сейчас скрыта).
* Ед. измерения – Ед. измерения из карточки товра.
* Штрихкод – Штрихкод единицы товара (начинается на 46).
* ГТД – Последняя указанная в карточке товара ГТД.

### Остатки товаров.

**Команды**

<figure><img src="https://1786478310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNeAVhc1Kicp5bJqqVv5c%2Fuploads%2FDCCuBBocdFT80X01zE2C%2Fimage.png?alt=media&amp;token=6b25376e-d69a-454f-b3f3-697366d59169" alt=""><figcaption><p>Командная панель</p></figcaption></figure>

* Выделить все строки – Поставить признак выделения на всех строках.
* Снять выделения со всех строк – Снять признак выделения на всех строках.
* Получить данные - Собирает данные по номенклатуре и указанным в настройках складам, с учетом коэффициента.
* Выгрузить в PIM - Процедура выгрузки остатков в СУБД PIM, если остаток не указан передается 0.
* Тестирование автоматических процедур - команды для технических специалистов.

**Таблица**

* Выбор – Пользователь отмечает какие товары к выгрузки.
* Продавец – Поставщик PIM из раздела настроек.
* Маркетплейс – Маркетплейс PIM из раздела настроек.&#x20;
* ID товара в PIM – ID присвоенное в СУБД PIM, возвращается после первичной выгрузки.
* Номенклатура поставщика – Ссылка на элемент справочника Номенклатура поставщика.
* Артикул поставщика – Артикул из карточки товара поставщика.
* Номенклатура – Номенклатура к которой привязана номенклатура поставщика.
* Остаток - Отображение свободного остатка с учетом коэффициента.

### Цены поставщика.

**Команды**

<figure><img src="https://1786478310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNeAVhc1Kicp5bJqqVv5c%2Fuploads%2FDCCuBBocdFT80X01zE2C%2Fimage.png?alt=media&amp;token=6b25376e-d69a-454f-b3f3-697366d59169" alt=""><figcaption><p>Командная панель</p></figcaption></figure>

* Выделить все строки – Поставить признак выделения на всех строках.
* Снять выделения со всех строк – Снять признак выделения на всех строках.
* Получить данные - Собирает данные по номенклатуре и указанным в настройках складам, с учетом коэффициента.
* Выгрузить в PIM - Процедура выгрузки цен в СУБД PIM.
* Тестирование автоматических процедур - команды для технических специалистов.

**Таблица**

* Выбор – Пользователь отмечает какие товары к выгрузки.
* Продавец – Поставщик PIM из раздела настроек.
* Маркетплейс – Маркетплейс PIM из раздела настроек.&#x20;
* ID товара в PIM – ID присвоенное в СУБД PIM, возвращается после первичной выгрузки.
* Номенклатура поставщика – Ссылка на элемент справочника Номенклатура поставщика.
* Артикул поставщика – Артикул из карточки товара поставщика.
* Номенклатура – Номенклатура к которой привязана номенклатура поставщика.
* Цена – Отображение текущие цены из 1С (прайс - лист) или из соглашения.
* Цена со скидкой <mark style="color:purple;">– пока не учувствует в обмене.</mark>
* Процент скидки <mark style="color:purple;">– пока не учувствует в обмене.</mark>
* Процент НДС <mark style="color:purple;">– пока не учувствует в обмене.</mark>
* Описание ошибки – отображается текст ошибки при выгрузке.&#x20;

## **Раздел документы**

В разделе заказов происходит работа по созданию заказа, подтверждению, получению этикеток.

**Заказы клиентов**.

<figure><img src="https://1786478310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNeAVhc1Kicp5bJqqVv5c%2Fuploads%2FXoRQAw2c1WNTPljaNqnK%2F%D0%94%D0%B8%D0%B0%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%20%D0%B1%D0%B5%D0%B7%20%D0%BD%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F.drawio.png?alt=media&amp;token=f91d4c20-8d03-4c1e-888f-52628a9d847d" alt=""><figcaption><p>Схема получения заказов.</p></figcaption></figure>

**Фильтр.**

1. date\_to – Дата отбора (с какой даты загружать заказы).
2. date\_end – Дата отбора (до какой даты загружать заказы).
3. status – Статус заказа.
4. delivery\_id – Отбор по ID доставки.

**Данные по заказам.**

**Команды.**

<figure><img src="https://1786478310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNeAVhc1Kicp5bJqqVv5c%2Fuploads%2F1nASSfDo4ZCjnZHcCj20%2Fimage.png?alt=media&amp;token=1ac9ea3a-c60e-4910-8dc2-203cb237083d" alt=""><figcaption><p>Командная панель</p></figcaption></figure>

* Выделить все строки – Поставить признак выделения на всех строках.
* Снять выделения со всех строк – Снять признак выделения на всех строках.
* Получить заказы – Команда загружает новые заказы из маркетплейса.
* Подтвердить заказы – Для выделенных заказов отправляется подтверждение в маркетплейс.
* Получить этикетки – Загружает индивидуальные этикетки.

**Таблица с заказами.**

* Выбор – Пользователь отмечает какие товары к выгрузки.
* Этикетка – пиктограмма (глаз) отображается если этикетка получена и загружена в 1С.
* (PIM) № заказа – внутренний номер заказа в системе PIM (не относится к маркетплейсу).
* (PIM) Дата заказа – дата получения заказа от маркетплейса в систему PIM (не относится к маркетплейсу).
* (MP) № заказа – внутренний номер заказа маркетплейса (номер заказа на портале).
* (PIM) № доставки – если маркетплейс возвращает ID доставки, он отобразится в таблице.
* Статус – статус заказа.
* Дата ПДО – дата ПДО полученная от маркетплейса.
* Адрес – адрес доставки полученный от маркетплейса.
* Покупатель – конечный покупатель (не вносится в 1С).
* Текст на этикетку – дополнительный текст на этикетку (если маркетплейс предоставляет).

**Содержимое заказов (товары).**

* (MP) № заказа – внутренний номер заказа маркетплейса (номер заказа на портале).
* Номенклатура – номенклатура (карточка товара).
* Артикул – номенклатура, артикул товара.
* Номенклатура поставщика – номенклатура поставщика (карточка товара).
* SKU – артикул поставщика.
* product\_id – артикул поставщика.
* product id vendor product id – внутренний ID СУБД PIM.
* Количество – количество товара к отгрузке.
* Цена – цена товара полученная из маркетплейса.
* Цена со скидкой – цена товара со скидкой полученная из маркетплейса.
* Сумма – количество \* цена.
* Отмена – признак отмены строки товара.