Warning: array_combine(): Both parameters should have an equal number of elements in /var/www/api.muk.ua/index.php on line 83 API MUK Co.

Сервіс: API компанії МУК

Історія версій
Основний запит
[PRICE]
3.1 Запит
3.2 Відповідь
[DETAILE]
4.1 Запит
4.2 Відповідь
[CATEGORY]
5.1 Запит
5.2 Відповідь
[CURRENCY]
6.1 Запит
6.2 Відповідь
Приклади
6.1 [PRICE]
6.2 [DETAILE]
6.3 [CATEGORY]

1. Історія версій

API v.2.4 07.06.2022

Оновлено документацію;

API v.2.3 07.04.2016

Додана історія курсів валют CURRENCY;

API v.2.2 01.10.2013

Атрибут MODEL перенесений з DETAILE в TOVAR;

API v.2.1 12.09.2013

Сервіс API перенесено на нову адресу: https://api.muk.ua/ ;
Зменшено структуру основного запиту;
Змінено ключ користувача SID для підвищення безпеки;
Увімкнено перевірку IP-адреси користувача;
Оновлено нові поля у детальному описі товару відповіді по Запиту [DETAILE];
Додано обробку основних Запитів у будь-якому регістрі;
Додано обробку на помилки більшості запитів;
Зменшено час видачі відповіді;
Виправлено низку помилок;

2. Основний запит

https://api.muk.ua/[SID]/[CALLBACK]/[LIST]/

Значення	Опис
[SID]	Унікальний ключ користувача
[CALLBACK]	Формат отримання відповіді Значення: xml, json, soap
[LIST]	Запит списку даних Значення: PRICE, CATEGORY, DETAILE

ВАЖЛИВО! Зверніть увагу на процедуру отримання SID!
Для отримання SID потрібно написати повідомлення на адресу webhelp@muk.ua, повідомлення має містити таке:

Тема повідомлення: Запит доступу до МУК API
У тексті повідомлення вказати:

Код ЕДРПОУ;

Логін на партнерський портал b2b.muk.ua;

IP адреса (зовнішня статична IP), з якої здійснюватимуться запити;

Приклад:

https://api.muk.ua/1234567890987654321/json/PRICE/

Примітки:

Формат запиту:
Правильно: https://api.muk.ua/[SID]/[CALLBACK]/[LIST]/
Не правильно: https://api.muk.ua/[LIST]/[SID]/[CALLBACK]/
Не правильно: https://api.muk.ua/[CALLBACK]/[LIST]/[SID]/
Основні запити є обов'язковими і можуть приймати лише одне значення;
Доступ обмежений за IP-адресою;

3. [PRICE]

3.1 Запит

Приклад:

https://api.muk.ua/AABBCCDDEEFF11223344556677889900/XML/PRICE/

Параметри запиту для фільтрації списку

Значення	Опис
KOD1	Множинний атрибут фільтрації за категорією №1 Набуває значення унікального ідентифікатора категорії №1 Приклад: /XML/PRICE/?KOD1=… Якщо більше одного атрибуту KOD1: Приклад: /XML/PRICE/?KOD1[]=… &KOD1[]=…
KOD2	Множинний атрибут фільтрації за категорією №2 Набуває значення унікального ідентифікатора категорії №2 Приклад: /XML/PRICE/?KOD2=… Якщо більше одного атрибуту KOD2: Приклад: /XML/PRICE/?KOD2[]=… &KOD2[]=…
VENDOR	Множинний атрибут фільтрації за вендором Приймає значення унікального ідентифікатора вендора Приклад: /XML/PRICE/?VENDOR=… Якщо більше одного атрибуту VENDOR: Приклад: /XML/PRICE/?VENDOR[]=… &VENDOR[]=…
AVAILABLE	Атрибут фільтрації за наявністю товару на складі Варіанти запиту: YY – весь товар: в наявності і немає в наявності (за замовчуванням) YN – тільки в наявність NY – тільки немає в наявності NN – атрибут передає пріоритетність фільтрації наступними запитами.
TRANSIT	Атрибут фільтрації статусу товару "У дорозі" Варіанти запиту: Y – в дорозі (за замовчуванням) N – не очікується
ACTION	Атрибут фільтрації статусу товару "Акція" Варіанти запиту: Y – акція (за замовчуванням) N – без акції
DEFECTS	Атрибут фільтрації статусу товару "Знижений товар" Варіанти запиту: Y – знижений в ціні товар (за замовчуванням) N – без уцінки
SEARCH	Параметри запиту для пошуку товару Пошук здійснюється за полями Артикул (PART_NUMBER) та найменуванням (NAME) Атрибут фільтрації для пошуку товару. Може приймати будь-який набір алфавітно-числових символів. Усі не алфавітно-числові символи (крім _) повинні бути замінені на знак % з наступними 16-річними цифрами з пробілами. Детальніше про кодування URL-рядка: http://www.php.su/functions/?urlencode

3.2 Відповідь

Значення	Опис
Теги
PRICE	Кореневий тег
TOVAR	Тег з атрибутами характеристик товару та з вкладеним найменуванням товару
Атрибути
PART_NUMBER	Артикул
MODEL	Модель товару
GUID	Ідентифікатор товару (унікальний)
VENDOR	Ім'я вендора (виробника)
VENDOR_GUID	Ідентифікатор вендора (унікальний)
KOD1	Ім'я категорії №1
KOD1_GUID	Ідентифікатор категорії №1 (унікальний)
KOD2	Ім'я категорії №2
KOD2_GUID	Ідентифікатор категорії №2 (унікальний, підпорядкований категорії №1)
KOD3	Ім'я категорії №3
KOD3_GUID	Ідентифікатор категорії №3 (унікальний, підпорядкований категорії №2)
TNVED	ТНВЭД (приклад: 8471 41 00 00)
AVAILABLE	Наявність товару на складі (Варіанти відповіді: Y - є в наявність, N - немає в наявність)
EXPECTED	Товар в очікуванні (варіанти відповіді: 1 – очікується, 0 – немає даних)
EXPECTED_DATE	Дата очікування товару (виведення даних про час прибуття товару)
TRANSIT	Товар у дорозі (варіанти відповіді: 1 – у дорозі, 0 – немає даних)
PRICE_CHANGE	Зміна ціни (варіанти відповіді: 1 – підвищено, 2 – знижено, 0 – немає даних)
ACTION	На цей товар поширюється акція (варіанти відповіді: 1 – аукціонний товар, 0 – немає даних)
DEFECTS	Знижений в ціні товар (товар з можливими дефектами) (варіанти відповіді: 1 – знижений у ціні товар, 0 – немає даних)
IMAG	Шлях до зображення товару https://cdn.api.muk.ua Якщо зображення відсутнє, атрибут дорівнюватиме «NONE» Формат: http://cdn.api.muk.ua/imag/ef2a926c-c461-11de-89da-0018fe8ad168/01_ef2a926c-c461-11de-89da-0018fe8ad168.JPEG
PRICE_UAH	Роздрібна ціна (грн.)
PRICE_RETAIL	Роздрібна ціна (дол.)
PRICE_DILER	Дилерська ціна, згідно сітки цін компанії (дол.)
QUANTITY	Загальна кількість товару
QUANTITY_M	Кількість товару на складі Мукачево
QUANTITY_K	Кількість товару на складі Київ
EAN	Ідентифікація

4. [DETAILE]

4.1 Запит

Приклад:

https://api.muk.ua/AABBCCDDEEFF11223344556677889900/XML/DETAILE/?GUID=00112233

Значення	Опис
GUID	Атрибут унікального ідентифікатора товару (обов'язковий)

4.2 Відповідь

Значення	Опис
Теги
TOVAR_DETAILE	Кореневий тег
DESCRIPTION	Опис товару
COMPLETE_SET	Комплектація товару
ADDITIONALLY	Додаткова інформація про товар
WARRANTY	Гарантія товару
WEIGHT	Вага (Брутто, кг)
PROPORTIONS	Габарити упаковки (ШхДхВ, см)
BULK	Об'єм упаковки (куб. см)
IMAG	Тег IMAG у цьому випадку приймає повний шлях до зображення. http://cdn.api.muk.ua/imag/ef2a926c-c461-11de-89da-0018fe8ad168/01_ef2a926c-c461-11de-89da-0018fe8ad168.JPEG
!	Інші теги переносять значення атрибутів із відповіді прайс-листа [PRICE] з тими ж іменами атрибутів.
Атрибути
Відсутні

5. [CATEGORY]

5.1 Запит

Приклад:

https://api.muk.ua/AABBCCDDEEFF11223344556677889900/XML/CATEGORY/

5.2 Відповідь

Значення	Опис
Теги
CATEGORY	Корневий тег
KOD1	Тег категорії №1 (вкладений тег)
KOD2	Тег категорії №2 (вкладений тег)
VENDOR	Тег вендора (вкладений тег)
Атрибути
NAME	Атрибут імені категорії/вендора
GUID	Ідентифікатор категорії/вендора (унікальний)