Ceneo.pl — найбільший польський агрегатор товарних пропозицій. Історично це порівняння цін: магазин віддає фід, покупець порівнює й переходить у магазин. Але у Ceneo є й власний сервіс покупки — «Kup Teraz», де замовлення оформлюється просто на майданчику. Саме ці замовлення Elbuz і забирає до себе.
Ця стаття — про підключення саме Ceneo. Загальний порядок для всіх систем із замовленнями описано в огляді імпорту замовлень через API; тут — особливості майданчика.
Ceneo приносить у Elbuz лише замовлення. Каталог рухається у зворотний бік: товари ви віддаєте на майданчик фідом, а звідти повертаються замовлення. Тому це підключення — друга половина схеми, перша половина живе в розділі вивантаження даних.
Де це у програмі
У вікні завантаження створіть шаблон і оберіть тип «ceneo.pl». Це API-джерело: файл не потрібен. З усіх полів картки «Підключення» заповнюється одне — Токен, у нього вставляється ключ доступу з кабінету Ceneo.
1
Поле «Токен» — ключ доступу з кабінету Ceneo- Поле «Токен» — сюди вставляється ключ доступу, отриманий у кабінеті Ceneo.
Як влаштоване підключення
Ceneo працює у два кроки, і про це варто знати, бо воно пояснює вигляд повідомлень у журналі. Спершу Elbuz пред'являє ваш ключ і отримує в обмін тимчасовий доступ, а вже з ним звертається за замовленнями. Обидва кроки відбуваються автоматично при кожному запуску — зберігати чи продовжувати нічого не потрібно.
Якщо в журналі написано, що не вказано ключ, — порожнє поле «Токен». Якщо написано про помилку отримання доступу, ключ на місці, але майданчик його не прийняв: найчастіше це неповне копіювання, зайвий пробіл на кінці або відкликаний ключ. У другому випадку варто піти в кабінет Ceneo й скопіювати ключ наново.
Документація майданчика для партнерів: Ceneo Developers. Ключ доступу видається в кабінеті магазину, в розділі налаштувань сервісу «Kup Teraz».
Як підключити крок за кроком
Створіть шаблон типу «ceneo.pl», вставте ключ у поле «Токен» і переконайтеся, що ввімкнено завантаження замовлень. Збережіть шаблон і запустіть його вручну, не чекаючи розкладу: журнал одразу покаже, чи прийняв майданчик ключ і скільки замовлень знайшлося.
Перший запуск перевірте очима — відкрийте кілька документів і звірте позиції, суми, покупця й адресу доставки з кабінетом Ceneo. Найкорисніше подивитися саме на позиції: якщо вони зіставилися з вашими картками, значить фід і каталог узгоджені й далі все працюватиме само. Якщо ж товари приїхали новими картками, варто спершу навести лад у фіді, а вже потім ставити шаблон на розклад.
Що приходить із замовленням
Дані про замовлення Ceneo віддає частинами: спершу сам список, потім по кожному замовленню — окремо позиції й окремо дані доставки. Elbuz збирає це в один документ.
| Дані Ceneo | Поле документа в Elbuz |
|---|---|
| номер замовлення для покупця | Номер документа |
| внутрішній ідентифікатор замовлення | Зовнішній ключ (за ним замовлення впізнається повторно) |
| дата створення | Дата замовлення |
| сума замовлення й вартість доставки | Сума документа, ціна доставки |
| пошта й телефон покупця | E-mail, телефон |
| ім'я, прізвище, назва компанії | Дані отримувача |
| адреса, індекс, місто, регіон, країна | Адреса доставки |
| спосіб доставки | Вид доставки |
| спосіб оплати | Вид оплати (див. таблицю нижче) |
| коментар покупця | Опис замовлення |
| позиції: назва, ціна, кількість, сума | Рядки документа |
Види оплати
Спосіб оплати приходить кодом, і Elbuz розкладає його у свої види оплат:
| Оплата в Ceneo | Вид оплати в Elbuz |
|---|---|
| швидкий переказ | Онлайн-оплата |
| оплата при отриманні | Накладений платіж |
| кредитна картка | Банківська картка |
| переказ прямо на рахунок магазину | Банківський переказ |
| розстрочка, розділений платіж | Лишається порожнім — зіставте вручну, якщо такі оплати у вас трапляються |
Спосіб доставки Elbuz теж намагається розпізнати: кур'єрська доставка й InPost (польські поштомати) визначаються за назвою й лягають у відповідні служби доставки.
Сервіс «Kup Teraz» влаштовано так, що Elbuz забирає замовлення, за якими оплату вже підтверджено. Тому статус оплати одразу ставиться «Оплачено», і документ отримує відповідний статус. Для магазину це зручно: у роботу потрапляють замовлення, за якими гроші вже є, а не заявки-наміри.
Як зіставляються позиції
Тут спрацьовує та сама логіка, що й у польських та українських агрегаторів загалом: у позиції замовлення Ceneo передає ідентифікатор товару з вашого фіда. Якщо фід на Ceneo формується з Elbuz, коло замикається — позиція одразу знаходить свою картку в каталозі, без здогадок за назвою.
Перед підключенням замовлень перевірте, що фід для Ceneo віддає стабільні ідентифікатори товарів і формується з того самого каталогу. Тоді позиції зіставлятимуться автоматично, а не створюватимуть напівпорожні картки в службовій категорії.
Як іде завантаження
При регулярних запусках Elbuz просить у майданчика замовлення, створені після минулого завантаження, з запасом у дванадцять годин назад. Запас потрібен на випадок розбіжності годинників і затримок на боці майданчика: краще перечитати зайве, ніж пропустити замовлення.
Замовлення, яке вже є в Elbuz, при повторному завантаженні пропускається: дублікат не створюється, але й зміни з майданчика в нього не приїжджають. Далі документ веде ваш менеджер, і його робота не затирається. Якщо на боці Ceneo із замовленням щось сталося після того, як воно приїхало до вас, про це ви дізнаєтеся з кабінету майданчика.
Розклад
Ceneo працює поллінгом: Elbuz звертається до майданчика за розкладом, який задають кнопкою налаштування завдання у формі шаблону. Оскільки замовлення приходять уже оплаченими й потребують швидкого відвантаження, перевіряти варто часто — кілька разів на годину.
Часті труднощі
Перша — майданчик не приймає ключ. Скопіюйте його з кабінету наново: найчастіше винен зайвий пробіл або неповне копіювання, рідше — ключ уже відкликаний. Журнал у цьому випадку пише саме про невдалу авторизацію, а не про відсутність замовлень.
Друга — замовлень немає, хоча в кабінеті вони є. Перевірте, чи це замовлення сервісу «Kup Teraz»: переходи з порівняння цін прямо в ваш магазин замовленнями на Ceneo не стають, і в API їх немає. Такі продажі приходять з вашого сайту, а не звідси.
Третя — позиції створюють нові картки. Значить, ідентифікатори у фіді не збігаються з тими, за якими живуть товари в каталозі. Це лікується на боці фіда, а не налаштуваннями завантаження.
Навіщо зводити Ceneo в Elbuz
Для польського ринку Ceneo часто один із кількох каналів: свій магазин, Allegro, іноді ще й маркетплейси ЄС. Кожен кабінет показує тільки себе, а склад і бухгалтерія у вас спільні. Elbuz збирає замовлення всіх каналів в одну чергу: товар списується з одного складу, покупець лягає в одну базу, документи друкуються однаково. Замовлення Ceneo при цьому нічим не виділяються серед інших — ними займаються ті самі менеджери за тим самим процесом.
Часті питання
Де взяти ключ доступу до Ceneo?
Ключ видається в кабінеті магазину на Ceneo, у налаштуваннях сервісу «Kup Teraz». Він вставляється в поле «Токен» у картці «Підключення». Обмін ключа на тимчасовий доступ Elbuz робить сам при кожному запуску.
Чи можна завантажити з Ceneo товари?
Ні, каталог рухається у зворотний бік: товари ви віддаєте на Ceneo фідом, а звідти приходять замовлення. Позиції замовлення зіставляються з вашим каталогом за ідентифікатором товару з цього самого фіда.
Чому всі замовлення позначені як оплачені?
Тому що сервіс «Kup Teraz» віддає замовлення з підтвердженою оплатою — саме такі Elbuz і забирає. Статус оплати ставиться «Оплачено» одразу, і в роботу потрапляють замовлення, за якими гроші вже є.
Чому в деяких замовлень не заповнений вид оплати?
Для розстрочки й розділеного платежу вбудованої відповідності немає — вони лишаються порожніми. Якщо такі оплати у вас трапляються, додайте правила в таблиці зіставлення видів оплат у картці «Пов'язані налаштування».
Чому зміни замовлення на боці Ceneo не приїжджають у Elbuz?
Уже завантажене замовлення при повторних запусках пропускається: так робота менеджера в документі не затирається черговим завантаженням. Дублікатів при цьому теж не виникає, бо замовлення впізнається за своїм ідентифікатором.