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