Як LEGKO працює з Prom.ua

LEGKO підключається до кабінету продавця через публічне API Prom (my.prom.ua/api/v1) за API-токеном компанії. Нижче всі методи, які ми викликаємо, як часто і навіщо.

Про продукт

LEGKO: українська CRM для інтернет-магазинів, що продають на Prom, Rozetka й Епіцентр. Замовлення, чати, ТТН, склад і прибуток з урахуванням комісії маркетплейсу в одному кабінеті. Хмарний сервіс, вхід через браузер, 14 днів безкоштовно.

Підключення

У кабінеті Prom відкрийте «Налаштування → Керування API-токенами» і створіть токен.
Дайте токену права на замовлення, доставку, повідомлення, чат і товари. Для одних лише замовлень достатньо перших трьох.
У LEGKO відкрийте «Налаштування → Підключення API», оберіть Prom і вставте токен.
Перші замовлення з'являться протягом хвилини.

Методи Prom API, які використовує LEGKO

Функція	Метод	Частота	Що відбувається
Замовлення	`GET /api/v1/orders/list`	щохвилини	нові та змінені замовлення з покупцем, адресою доставки й товарами
Прийняття замовлення	`POST /api/v1/orders/set_status`	щохвилини	нове замовлення одразу отримує статус «Прийнято» (received)
ТТН у Prom	`POST /api/v1/delivery/save_declaration_id`	кожні 2 хв	номер ТТН Нової пошти чи Укрпошти, створеної в LEGKO, записується в замовлення Prom
ТТН з Prom	`GET /api/v1/orders/list`	кожні 3 хв	ЕН, створені в кабінеті Prom (Rozetka Delivery, Пром-доставка), підтягуються в LEGKO
Чати покупців	`GET /api/v1/chat/rooms, /chat/messages_history; POST /chat/send_message`	щохвилини	листування з покупцями в одному вікні з Rozetka, відповідь з LEGKO
Повідомлення	`GET /api/v1/messages/list; POST /messages/reply`	щохвилини	повідомлення з форми зворотного зв'язку Prom
Каталог	`GET /api/v1/products/list`	на вимогу	звірка товарів LEGKO з товарами Prom, щоб не створювати дублі
Залишки й наявність	`POST /api/v1/products/edit`	після зміни складу	quantity_in_stock і presence (в наявності, під замовлення, немає)
Нові товари	`POST /api/v1/products/import_url; GET /products/import/status/{id}`	на вимогу	імпорт YML-фіду LEGKO; наявні товари на Prom не змінюються

Опис методів: public-api.docs.prom.ua. Усі запити йдуть із заголовком Authorization: Bearer <токен>.

Дані та безпека

Запити до Prom робить сервер LEGKO, токен не передається третім сторонам.
Дані кожної компанії відокремлені: інші користувачі LEGKO їх не бачать.
LEGKO не видаляє товари й замовлення на Prom. Імпорт нових товарів не змінює наявні картки.
Відкликати доступ можна будь-коли: видаліть токен у кабінеті Prom, і синхронізація зупиниться.
Політика конфіденційності: legko.net/privacy.

Обмеження

ЕН Rozetka Delivery для замовлень Prom створюються лише в кабінеті Prom (правило Prom), LEGKO їх підтягує.
Для роботи з товарами потрібен токен з правами на товари; без них працюють замовлення, ТТН і чати.

Контакти для партнерів і підтримки

Технічні питання щодо інтеграції: support@legko.net. Допомагаємо з підключенням безкоштовно.

Підключіть Prom.ua у LEGKO

14 днів безкоштовно, без картки.

Зареєструватися