Як підключити Cdiscount до Elbuz: каталог, замовлення, ціни й залишки пакетами

Що вміє підключення Cdiscount

• Підключення ключами продавця — без реєстрації застосунку й без перевірки з боку Octopia.
• Завантаження оферів — з назвою, описом, брендом, EANНомер штрихкоду товару з 13 (іноді 8) цифр. Однаковий у всіх продавців, тому за ним зручно знаходити той самий товар у різних постачальників., ціною, залишком, категорією й фото картки Cdiscount.
• Замовлення — 30 днів історії при першому запуску, далі лише зміни; замовлення, що чекають прийняття, Elbuz приймає сам.
• Ціни й залишки назад на Cdiscount — пакетами Octopia, з причиною кожної відмови в журналі.
• Публікація новинок — офер за EAN на наявну картку або нова картка за зіставленою категорією.

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

Меню

Довідники → Операції → Завантаження даних → новий шаблон типу «Cdiscount»

Інші входи

Довідники → Операції → Вивантаження даних — шаблон для цін, залишків і публікації

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

вікно «Завантаження даних» у «Правах груп»

Підготувати

Client ID, Client secret і Seller ID з Seller Portal Octopia

Продавати на Cdiscount можуть лише юридичні особи з французьким SIRET або європейським номером ПДВ. Один шаблон — один акаунт продавця й один канал продажу.

Де взяти ключі в Seller Portal

Cdiscount технічно обслуговує компанія Octopia: кабінет продавця, APIСпосіб, яким програми обмінюються даними між собою напряму, без людини й без вікон: одна програма надсилає запит, інша відповідає даними. і документація — на її боці. Застосунок реєструвати не потрібно: ключі створює сам продавець.

1. Увійдіть у Seller Portal Octopia і відкрийте сторінку API Credentials Management.
2. Натисніть «Create my clientId and clientSecret».
3. Скопіюйте показані clientId, clientSecret і sellerId.

У шаблоні завантаження п'ять полів, обов'язкові — перші три:

Коди доставки — з довідника Octopia: THD — з відстеженням, EHD — експрес, SHD — під підпис, NTHD — без відстеження, PPMR і PPLP — пункти видачі Mondial Relay і La Poste. Третє число через двокрапку — доплата за кожну наступну штуку: THD:4.99:1.

Вставивши ключі, збережіть шаблон і натисніть «Перевірити підключення». Elbuz отримає токен і запитає дані продавця — у відповідь прийде назва магазину й канал, наприклад «Cdiscount — ‹магазин› (CDISFR)». Так видно, що ключі скопійовано повністю, а Seller ID належить цим ключам.

1

Client ID

2

Client secret

3

Seller ID

4

Способи доставки нових оферів

1. Client ID — публічна половина ключа API з Seller Portal.
2. Client secret — секретна половина, після збереження не показується.
3. Seller ID — номер вашого акаунта продавця, іде з кожним запитом.
4. Способи доставки нових оферів — без нього нові офери не публікуються.

Що переноситься в картку

На Cdiscount картку товару веде майданчик, а продавець виставляє на неї свій офер — ціну й залишок. Elbuz забирає список ваших оферів каналу і до кожного запитує картку за EAN, щоб у каталозі опинився повноцінний товар, а не рядок з ціною.

Характеристики з Cdiscount не приходять. Якщо картку майданчика отримати не вдалося, а офер новий, товар ляже з назвою #‹EAN› — перейменуйте його або повторіть завантаження пізніше.

Категорія приходить назвою, без дерева. Якщо такої категорії у вас немає, Elbuz створить її. Офери без категорії потрапляють у службову категорію «Товари - cdiscount»: вона створюється вимкненою й без участі у вивантаженнях. Як із нею поводитися: службові категорії та бренди.

Що перезапише повторний прогін

Свій товар повторне завантаження шукає спершу за прив'язкою до офера — референсом, який запам'ятав будь-який шаблон Cdiscount, у тому числі шаблон вивантаження, що опублікував офер. Не знайшло — шукає за назвою. Тому перейменування картки на майданчику дубля не створює.

Окремого перемикача «не оновлювати назву» в шаблоні Cdiscount немає. Якщо французькі назви майданчика вам не потрібні, завантажте каталог один раз для прив'язки, а далі лишіть у шаблоні тільки «Замовлення» (сценарій). Закрити окремі картки можна в самій картці товару, секція «Захист під час імпорту»:

• «Не оновлювати» — прогін не чіпає картку взагалі;
• «Фіксована ціна» — прогін не переписує ціни, решту полів оновлює.

Офер, якого в прогоні не було, завантаження не торкається: товар лишається з останньою ціною й залишком. Зняті з продажу позиції прибирайте руками. Детальніше: два шаблони на той самий товар.

Як приходять і приймаються замовлення

З галочкою «Замовлення» кожен запуск забирає замовлення каналу, змінені з минулого разу. Перший запуск бере 30 днів історії, наступні — від дати в полі «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)» блоку «Розширене», із запасом у дванадцять годин. Наявні замовлення впізнаються за номером і оновлюються, а не дублюються.

Автоматичне прийняття

Замовлення в статусі «очікує прийняття» (WaitingAcceptance) Elbuz приймає на Cdiscount сам, ще до збереження в каталог. Неприйняте вчасно замовлення майданчик скасовує, тому так ви його не втратите. Документ одразу лягає зі статусом «прийнято» (Accepted).

Якщо Octopia не прийняла запит, у журналі з'явиться червоний рядок «Cdiscount: помилка API — … (approval-status ‹номер›)», а замовлення завантажиться в статусі «очікує прийняття». Прийміть його в Seller Portal, доки майданчик не скасував.

Що потрапляє в документ

• номер замовлення, дати покупки й останньої зміни, статус Cdiscount;
• ім'я, прізвище, телефон і пошта отримувача, адреса доставки;
• платник і його адреса, спосіб оплати, спосіб доставки й вартість доставки;
• позиції: артикул (ваш референс офера), EAN, назва, ціна, кількість; валюта.

Статус приходить кодом Cdiscount. Зіставте коди зі своїми статусами кнопкою «Статуси замовлення» в картці «Повʼязані налаштування». Як повторний прогін поводиться з документом, який уже веде менеджер, і чому проведений документ не змінюється: хто перезаписує замовлення.

Трек-номер і відправку Elbuz на Cdiscount не передає: відправку підтверджуйте в Seller Portal.

Як ціни й залишки повертаються на Cdiscount

Зворотний напрямок — окремий шаблон вивантаження типу «Cdiscount». У ньому той самий Client ID і Client secret, а поле «Версія API (параметри майданчика)» містить Seller ID|канал|способи доставки, наприклад 98979|CDISFR|THD:4.99,EHD:9.99. Порожні частини Elbuz бере з шаблону завантаження Cdiscount з тим самим Client ID.

1

Client ID

2

Client secret

3

Версія API (параметри майданчика)

1. Client ID — той самий ключ, що в шаблоні завантаження.
2. Client secret — секретна половина ключа API.
3. Версія API (параметри майданчика) — Seller ID, канал і способи доставки через «|».

Оновлюються товари, прив'язані до оферів, — тому спершу один раз завантажте каталог з Cdiscount. Що саме йде на майданчик:

• Ціна — числом з каталогу, без перерахунку валют. Майданчик чекає євро з ПДВ (канал CDISFR). Якщо каталог ведеться в гривнях, 1 200 грн піде на Cdiscount як 1 200 €, тож перед першим вивантаженням переконайтеся, що ціни у відборі шаблону — у євро.
• Залишок — кількість товару, не менше нуля; спільний для всіх каналів продажу вашого акаунта Octopia.
• Які товари — визначає відбір шаблону вивантаження, як і для інших каналів.

Чому результат приходить не одразу

Octopia приймає зміни не по одному оферу, а пакетом: Elbuz створює пакет, наповнює його, відправляє й чекає обробки близько хвилини. Майданчик обробляє пакет від кількох секунд до десятків хвилин.

Підсумковий рядок «Cdiscount: ціни та залишки оновлено, оферів: N (помилок: M)» рахує лише ті офери, результат яких уже прийшов. Нуль у ньому одразу після відправки пакета — не збій, а очікування.

Знімати офери Elbuz не вміє: товар, що випав із відбору вивантаження, просто перестане оновлюватися. Щоб зупинити продаж, вивантажте нульовий залишок або зніміть офер у Seller Portal.

Публікація нових товарів

З галочкою «Публікувати нові товари» в шаблоні вивантаження Elbuz виставляє товари, у яких офера на Cdiscount ще немає. Для кожного він шукає картку майданчика за EAN:

Ставку ПДВ офер бере з податкового класу товару, без класу — 20 %. Стан (новий, уживаний, відновлений) — з поля стану товару; не заповнено — «новий». Референсом офера стає артикул товару, а без артикула — ID товару в Elbuz.

Нова картка: що передається і чого бракує

Категорію Cdiscount для своїх категорій виберіть у вікні «Зіставлення категорій та атрибутів з маркетплейсами», чип «Cdiscount». Довідник категорій завантажує кнопка «Завантажити довідник майданчика» ключами шаблону завантаження Cdiscount. Детальніше: зіставлення категорій з маркетплейсами.

1

Чип «Cdiscount»

2

Завантажити довідник майданчика

3

Категорія Cdiscount

1. Чип «Cdiscount» — показує в таблиці колонки цього майданчика.
2. Кнопка «Завантажити довідник майданчика» — підтягує дерево категорій Cdiscount ключами шаблону завантаження.
3. Колонка «Категорія Cdiscount» — сюди вибирається категорія для нових карток.

У новій картці йдуть назва (до 132 символів), опис без розмітки (до 5000), виробник як бренд, до 6 фото й код зіставленої категорії. Кожен товар — окрема картка: варіації в одну картку Elbuz не об'єднує.

Схвалену картку журнал показує рядком «Cdiscount: картку «…» (EAN …) додано до каталогу, публікуємо офер» — і в тому самому запуску відправляє на неї офер. Опублікований офер позначається рядком «Cdiscount: опубліковано товар «…» (референс …)».

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

Миттєвих сповіщень Cdiscount не надсилає: Elbuz сам звертається до майданчика за розкладом, який задає кнопка «Налаштування розкладу» у формі шаблону. Орієнтир — замовлення кілька разів на годину, щоб приймати їх вчасно; каталог — раз на добу; ціни й залишки — частіше, якщо залишки рухливі. Пакетам потрібен час, тому ставити вивантаження частіше ніж раз на 15–20 хвилин немає сенсу.

1

Статуси замовлення

2

Налаштування розкладу

1. Статуси замовлення — зіставлення статусів Cdiscount зі своїми.
2. Налаштування розкладу — як часто запускати завантаження.

Octopia обмежує кількість запитів за годину. Наткнувшись на ліміт, Elbuz чекає й повторює запит до трьох разів. Не допомогло — у журналі «Cdiscount: вичерпано ліміт запитів Octopia, повторіть пізніше». Це не помилка ключів: запуск просто відкладається до наступної години. Найбільше запитів витрачає завантаження каталогу — по одному на картку кожного офера.

Пілюля «Активний» / «Вимкнений» знімає шаблон із розкладу (вимкнути шаблон). Вивантаження цін — окремий шаблон зі своїм перемикачем.

Якщо прогін обірвався

• Каталог пишеться пачками по 500 оферів: що встигло лягти — оновлене, решта зі старими даними.
• Замовлення зберігаються одним заходом після читання всіх сторінок; дата для наступної порції зсувається тільки після збереження, тож повтор забере той самий проміжок. Уже прийняті на майданчику замовлення повторно не приймаються — вони вже не в статусі очікування.
• Вивантаження: відправлений пакет Octopia обробить і без Elbuz, результат забере наступний запуск.

Повтор безпечний. Загальні правила: якщо прогін обірвався.

Сценарії

1

Товари

2

Фото

3

Замовлення

1. Товари — каталог оферів Cdiscount.
2. Фото — зображення карток.
3. Замовлення — завантаження замовлень з Cdiscount.

Перенести каталог Cdiscount у Elbuz

Що ввімкнути. Заповніть «Client ID», «Client secret» і «Seller ID», у картці «Вибір даних для завантаження» — «Товари», для зображень ще й «Фото».

Що вийде. Кожен офер каналу ляже карткою з французькою назвою, описом, брендом, штрихкодом, ціною, залишком і категорією однією назвою. Артикулом стане ваш референс офера — за ним потім ходить вивантаження.

Приймати замовлення й не пропускати строки

Що ввімкнути. Галочку «Замовлення»; кнопкою «Статуси замовлення» зіставити коди Cdiscount зі своїми статусами, кнопкою «Налаштування розкладу» — запуски кілька разів на годину.

Що вийде. Нові замовлення приймаються на майданчику автоматично й лягають документами зі статусом «прийнято». Рядок про помилку прийняття в журналі — сигнал прийняти замовлення в Seller Portal вручну.

Cdiscount як канал для каталогу, який ви ведете в Elbuz

Що ввімкнути. Один раз запустіть завантаження з галочкою «Товари» — воно прив'яже картки до оферів. Далі лишіть тільки «Замовлення», інакше прогін каталогу перезаписуватиме назви, ціни й залишки даними Cdiscount. Ціни відправляє шаблон вивантаження — у євро, без перерахунку.

Що вийде. Прив'язані товари отримують ціну й залишок пакетами; з галочкою «Публікувати нові товари» решта товарів з EAN виставляється на наявні картки, а для зіставлених категорій — новими картками.

Що робити, коли Cdiscount не віддає чи не приймає дані

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

Ціни в каталозі в гривнях — що піде на Cdiscount?

Те саме число, без перерахунку: 1 200 грн стануть 1 200 €. Ціни товарів для Cdiscount мають бути в євро (вивантаження).

Чому назви товарів французькою?

Elbuz бере назву з картки Cdiscount, а майданчик веде картки французькою. Після першого завантаження лишіть тільки «Замовлення» або закрийте картки «Не оновлювати» (повторний прогін).

Чи можна вимкнути автоматичне прийняття замовлень?

Ні, завантаження замовлень Cdiscount завжди приймає ті, що чекають прийняття. Не хочете цього — зніміть галочку «Замовлення» й приймайте в Seller Portal (прийняття).

Чи передає Elbuz трек-номер на Cdiscount?

Ні. Відправку й номер посилки підтверджуйте в Seller Portal (замовлення).

Чому Octopia відхиляє нові картки?

Найчастіше категорія вимагає обов'язкових властивостей, яких Elbuz не передає. Причина — у журналі вивантаження (нова картка).

Ціну змінили, а на Cdiscount стара — чому?

Пакет ще обробляється або чекає наступного запуску. Подивіться в журналі рядок про стан пакета (пакети).

Суміжні теми

• Якщо потрібна загальна механіка завантаження — розклад, обрив, службові категорії: огляд завантаження даних.
• Якщо менеджер веде замовлення в Elbuz і важливо, що перезапише прогін: імпорт замовлень через API.
• Якщо для нових карток бракує категорій майданчика: зіставлення категорій з маркетплейсами.
• Якщо продаєте ще й на Kaufland: підключення Kaufland.