Як підключити MTI за API: ключ компанії, кількість на складі й замовлення

Що вміє інтеграція з MTI

• Завантажує прайс MTI — код MTI, партномер, модель, назву українською, бренд, штрихкод, ціну дилера й РРЦ, гарантію, категорію.
• Бере кількість на складі — точну до 9 штук, далі «10 і більше» та «50 і більше».
• Відправляє замовлення в MTI з документа; номер замовлення MTI записується в документ.

Де це і хто має доступ

Меню

Довідники → Обробка прайс-листів → Список прайс-листів

Нове джерело MTI

майстер нового джерела, крок «Звідки» → плитка «API» → «MTI»

Доступ і параметри замовлення

картка джерела, секція «Джерело» → «Налаштування параметрів API»

Відправка замовлення

документ «Замовлення постачальнику» → «Відправити постачальнику»

Право доступу

вікно «Список прайс-листів» і «Налаштування завантаження: файл із прайс-листом»; для замовлення — редагування документів

Підготувати

ідентифікатор компанії й ключ API від MTI

Ідентифікатор компанії й ключ API від MTI

Для API MTI потрібні дві речі, і обидві видає сам MTI: ідентифікатор компанії і ключ, яким програма підписує кожен запит. Попросіть їх у свого менеджера MTI або напишіть у підтримку API MTI — support_dd@mti.ua.

Ідентифікатор вписується в «Логін», ключ — у «Пароль (токен)». Неправильні — MTI відмовляє, а причина видна в журналі (коли прайс не приїхав).

Як підключити MTI і задати параметри замовлення

У майстрі нового джерела на кроці «Звідки» оберіть плитку «API» і «MTI». Адресу https://api.mti.ua/, формат XML і колонки програма ставить сама (що робить привʼязка). Кнопка «Отримати довідкові дані» для MTI показує лише «У цієї інтеграції немає довідкових даних…»: коди платника й адреси доставки дізнайтеся в менеджера MTI.

Параметри в картці «Параметри запиту» стосуються тільки відправки замовлення; на прайс вони не впливають. У джерел, підключених раніше, стоять значення за замовчуванням.

1

Тип обліку

2

Склад

3

Платник

1. Замовлення: тип обліку MTI — NS за замовчуванням; BS або US, якщо так домовлено з менеджером MTI.
2. Замовлення: склад MTI — W600 або W300.
3. Замовлення: платник MTI (код) — порожньо: платник за замовчуванням у MTI.

Що приходить від MTI: теги XML і ціни в гривнях

MTI віддає прайс одним XML-файлом, і колонки джерела MTI — це назви тегів, а не номери. Колонки, які привʼязка розмічає сама:

1

Ціна

2

Статус наявності (з прайсу)

3

Артикул контрагента

1. Ціна — адреса price_uah_order: ціна дилера в гривнях.
2. Статус наявності (з прайсу) — адреса store: залишок.
3. Артикул контрагента — адреса mticode: код MTI для замовлення.

Решту тегів беруть вільним рядком секції «Колонки», вписавши назву тегу в «Адреса стовпця»:

• prodname_invoice — назва для рахунку; country — країна виробництва; tnved — код УКТ ЗЕД; nds — ставка ПДВ;
• weight — вага; length, width, height і volume — габарити;
• reserved — скільки вже у ваших невідвантажених замовленнях; similar_products — коди схожих товарів MTI;
• rrp_control — контроль РРЦ (Y або N); purchase — умови закупівлі (FOB, DDP).

Фото, описів і характеристик MTI через API не віддає.

Ціна і РРЦ

Ціна дилера й РРЦ у MTI в гривнях, тож у рядках «Ціна» і «Ціна РРЦ» має стояти UAH; нові джерела розмічаються так самі. Ціна в доларах у прайсі MTI порожня, курс перераховувати не треба. Продаєте за РРЦ — візьміть вільним рядком rrp_control і стежте за товарами з Y.

Наявність і кількість: точно до 9 штук

Привʼязка бере наявність з тегу store. MTI показує точну кількість від 1 до 9 штук, а більше — текстом: «10 и более» (від 10 до 49) і «50 и более» (від 50). Товарів без залишку в прайсі немає.

Стандартні статуси розпізнають це без налаштувань: будь-яке число від 1 — «В наявності». Кількість програма бере з того самого тегу: 1–9 — як є, «10 и более» — 10, «50 и более» — 50. Окремий рядок «Кількість» не потрібен.

Склад на прайс не впливає: MTI віддає однаковий прайс для W600 і W300. Склад має значення тільки для замовлення.

Як відправити замовлення в MTI

Замовлення постачальнику, створене в Elbuz на контрагента MTI, відправляється з документа, і MTI створює справжнє замовлення. Налаштування — рядки «Замовлення: …» у параметрах запиту; програма бере їх з першого активного API-джерела контрагента документа.

Що відбувається після натискання

Відкрийте документ «Замовлення постачальнику», натисніть «Відправити постачальнику» і підтвердіть. Програма:

1. перевіряє, чи не відправлявся вже цей документ у MTI;
2. відправляє позиції за кодом MTI; однакові товари складаються в один рядок;
3. передає тип обліку й склад, коментар «Elbuz ‹номер документа›» до кожного рядка, а платника й адресу — тільки якщо вони задані.

Номер замовлення MTI записується в документ, статус від постачальника — «Створено», результат — у повідомленні й історії документа.

1

Відправити постачальнику

2

Оновити статус від постачальника

1. Відправити постачальнику — створює замовлення в MTI.
2. Оновити статус від постачальника — підтягує номер замовлення MTI.

Коли MTI додав не все

MTI у відповіді перелічує товари, які потрапили в замовлення. Якщо якогось там немає, програма пише «Увага: MTI не додав до замовлення: ‹товари›», а статус від постачальника стає «Створено частково». Перевірте ці позиції в кабінеті MTI і дозамовте окремим документом.

Коли нічого не відправляється

• у позиції немає коду MTI — товар не зіставлений з прайсом; назви таких позицій є в повідомленні (зіставлення товарів);
• у документі немає позицій з кількістю більше нуля;
• MTI відмовив — його текст стоїть після «MTI:», номер у документ не пишеться, тож після виправлення документ можна відправити знову.

Повтор не створює друге замовлення. Якщо в документі вже є номер замовлення MTI, повторне натискання показує «Замовлення вже відправлено в MTI (номер ‹номер›) — повторно не створено.». Кожен документ — окреме замовлення MTI.

Стан замовлення

MTI не передає стан замовлення через API, тож пункт «Оновити статус від постачальника» лише нагадує номер замовлення MTI. Стан, резерв, відвантаження, зміни й видалення замовлення — у кабінеті MTI.

Відправку замовлення ми перевірили на імітації сервера MTI, а не на справжньому замовленні. Перше замовлення відправте невелике й звірте результат у кабінеті MTI.

Сценарії

Показувати покупцю точний залишок

Що зробити. Нічого: кількість іде з тегу store сама.

Що вийде. Товари з 1–9 штуками мають точну кількість, решта — 10 або 50. Якщо на сайті виводиться «залишилось N шт.», для таких товарів це буде нижня межа.

Замовлення на інший склад або іншого платника

Що зробити. У параметрах API поставте «Замовлення: склад MTI» = W300, а в «Замовлення: платник MTI (код)» — код платника від менеджера MTI.

Що вийде. Замовлення з Elbuz створюються в MTI на цей склад і цього платника.

Додати в каталог вагу й країну виробництва

Що зробити. У секції «Колонки» вкажіть у рядку «Вага» тег weight, а вільним рядком — country.

Що вийде. Вага й країна приходять разом з прайсом і можуть потрапити в картку товару під час додавання в каталог.

Що робити, коли MTI відмовляє або додав не все

Коли прайс не приїхав

У журналі завантаження робота з MTI видно рядками «Отримуємо файл за API» і «Отримано файл: ‹розмір› МБ». Якщо MTI відповів помилкою, у журналі — «Помилка API постачальника: MTI: ‹текст від MTI›»:

• «MTI: Компания с указаным идентификатором не найдена» — у «Логін» не той ідентифікатор компанії;
• відмова за підписом — неправильний ключ.

Прайс тоді не затирається: ціни й наявність лишаються з попереднього завантаження (чому так). Якщо помилка на боці MTI, текст запиту й відповіді можна надіслати в підтримку API MTI.

Часті запитання

Чи можна завантажувати з MTI фото й описи товарів?

Ні. API MTI віддає прайс з цінами, наявністю, штрихкодом, гарантією, вагою й габаритами, але без фото, описів і характеристик.

Чому в товарів MTI кількість 10 або 50?

MTI показує точну кількість лише до 9 штук, а далі — «10 і більше» та «50 і більше». Програма бере з цього нижню межу: 10 або 50.

Чи створиться дубль, якщо натиснути «Відправити постачальнику» двічі?

Ні. Якщо в документі вже є номер замовлення MTI, програма повторно не відправляє і показує цей номер.

Чи можна побачити в Elbuz, що замовлення MTI відвантажене?

Ні. MTI не передає стан замовлення через API, тож стан дивіться в кабінеті MTI.

Чи прийдуть з MTI уцінені товари?

Ні. Прайс MTI за API містить тільки звичайні товари, без уцінки й товарів у пошкодженій упаковці.

Суміжні теми

• Якщо треба зрозуміти, що програма робить з будь-яким джерелом за API і де вписати доступи, — Як підключити постачальника за API.
• Якщо кількість чи статуси MTI треба рахувати інакше, — Наявність товару в прайсі постачальника.
• Якщо треба взяти додатковий тег MTI в колонку, — Розмітка колонок прайсу.
• Якщо замовлення постачальнику ще треба зібрати з замовлень покупців, — Замовлення постачальнику.