Як підключити OTTO Market до Elbuz: картки, замовлення й повернення

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

• Підключення вашим застосунком — Client ID і Client Secret, без посередників.
• Завантаження товарів — назва, бренд, опис, штрихкод, ціна, залишок, категорія й фото.
• Замовлення — з адресою, доставкою й цінами зі знижкою.
• Ціни й залишки — назад на OTTO, результат у журналі.
• Нові картки — з категорією OTTO, брендом, обов'язковими атрибутами й даними GPSR.
• Відвантаження й скасування — вашим статусом замовлення.
• Повернення — документом «Повернення від покупця», прийняття чи відмова — статусом.

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

Меню

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

Інші входи

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

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

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

Підготувати

застосунок в OTTO Partner Connect, ID профілю доставки

Що взяти в OTTO Partner Connect

Elbuz працює з OTTO через ваш власний застосунок. Створіть його в OTTO Partner Connect, розділ API-Zugriff, і дайте йому скоупи:

Застосунок без returns чи shipping-profiles працює, але повернення не завантажуються, а відвантаження посилок не передається.

1

Client ID застосунку

2

Client Secret застосунку

3

Пісочниця

4

ID профілю доставки

5

Термін обробки замовлення

1. Client ID застосунку — з OTTO Partner Connect, розділ API-Zugriff.
2. Client Secret застосунку — секрет того самого застосунку.
3. Пісочниця — 1 для тестового середовища OTTO, порожньо для робочого кабінету.
4. ID профілю доставки — без нього нові картки не можна буде замовити.
5. Термін обробки замовлення — від 1 до 99 днів; порожньо — як у профілі.

Вставивши ключі, дочекайтеся напису «Усі зміни збережено» й натисніть «Перевірити підключення». Відповідь «Підключення працює. OTTO Market» (з позначкою «sandbox» для пісочниці) означає, що ключі правильні.

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

Elbuz забирає ваші товари на OTTO разом із залишками й назвами брендів і кладе кожну варіацію в базовий каталог карткою товару.

Повторне завантаження знаходить картку за прив'язкою до SKU. Щоб прогін не чіпав картку зовсім, увімкніть у ній перемикач «Не оновлювати» (секція «Захист під час імпорту»); щоб не чіпав лише ціни — «Фіксована ціна».

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

Замовлення лягає документом «Замовлення покупця», непроведеним. Перше завантаження бере замовлення за останні 30 днів, далі — змінені від дати останнього завантаження, із запасом у 12 годин. Наявне замовлення впізнається за номером і оновлюється.

Прийняти замовлення на OTTO не треба: площадка передає його продавцю вже до обробки. Перші приблизно пів години нове замовлення стоїть у стані «оголошене» й без адреси — таке Elbuz пропускає й забирає наступним прогоном, коли адреса з'явиться.

• Позиції. OTTO рахує кожну штуку окремою позицією; Elbuz зводить однакові товари з однаковою ціною в один рядок із кількістю.
• Ціна — з ПДВ, уже зі знижкою.
• Доставка — сума доставки замовлення; сума документа — позиції разом із доставкою.
• Скасовані позиції в документ не потрапляють, якщо в замовленні є інші.

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

Статус площадки зіставляється з вашим кнопкою «Статуси замовлення» в картці «Повʼязані налаштування» шаблону завантаження: у колонку «Код (назва) на сайті (API)» навпроти свого статусу впишіть код OTTO.

Статус, навпроти якого стоїть SENT чи CANCELLED_BY_PARTNER, вивантаження відправляє на OTTO (відвантаження). Що відбувається з проведеним замовленням і резервом, описано в статті імпорт замовлень через API.

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

Зворотний напрямок — окремий шаблон вивантаження типу «OTTO». У ньому три поля:

• Client ID застосунку і Client Secret застосунку — ті самі, що в шаблоні завантаження. Пісочницю, профіль доставки й термін обробки вивантаження бере звідти.
• Версія API (параметри майданчика) — адреса, з якої ви відвантажуєте: країна|індекс|місто, наприклад DE|10115|Berlin. Без неї не передаються відвантаження.

1

Client ID застосунку

2

Client Secret застосунку

3

Адреса відвантаження

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

Оновлюються товари, прив'язані до карток OTTO. Ціна йде в євро з ПДВ — Elbuz не перераховує валюту, тож ціни у відборі мають бути в євро. Залишок — кількість товару, не менше нуля.

Чому ціна оновлюється не одразу

Ціни й нові картки OTTO приймає завданням і обробляє його на своєму боці. Elbuz близько хвилини чекає результату. Не дочекався — у журналі «OTTO: завдання ‹номер› ще обробляється, результат — наступним запуском», і наступний запуск забере результат. Залишки площадка приймає одразу.

Розклад і ліміт запитів

Elbuz звертається до OTTO за розкладом, який задає кнопка «Налаштування розкладу» в картці «Повʼязані налаштування». Орієнтир — замовлення й повернення кілька разів на годину, каталог — раз на добу, ціни й залишки — від кількох разів на день до щогодини.

OTTO обмежує частоту запитів. Elbuz сам тримає темп нижчий за ліміт, а на відмову через ліміт чекає й повторює. Не допомогло — у журналі «OTTO: перевищено ліміт запитів, повторіть пізніше». Обірваний прогін безпечно повторити: якщо прогін обірвався.

Нові картки на OTTO

Виставити офер на чужу картку OTTO не дозволяє: кожен товар продавець описує сам. Тому з галочкою «Публікувати нові товари» товар без прив'язки йде на OTTO повною карткою. Перед відправкою Elbuz перевіряє, чи є все потрібне:

Назва (до 100 символів) і опис беруться мовою з поля «Мова описів» шаблону вивантаження — для OTTO оберіть німецьку. Ставка ПДВ — з податкового класу товару: до 10 % — знижена (7 %), інакше й без класу — повна (19 %). Код картки — артикул товару; без нього чи з артикулом довшим за 50 символів — ID товару в Elbuz.

Чогось бракує — картка не відправляється, а в журналі стоїть перелік: «OTTO: картку «‹назва›» не надіслано — немає фото; не заповнено обов'язкові атрибути категорії OTTO: ‹атрибути›». Значень, яких немає в товарі, Elbuz не вигадує: додайте атрибути з назвами з переліку.

Дані GPSR

Регламент безпеки продукції ЄС вимагає в картці дані виробника й відповідальної особи в ЄС. Elbuz бере їх із вікна «Безпека продукції (GPSR) — eMAG, OTTO» — воно відкривається кнопкою у формі шаблону завантаження OTTO (або eMAG), реквізити спільні. Потрібна щонайменше відповідальна особа в ЄС. Якщо дані не заповнено, Elbuz відправляє картку без них, і OTTO вирішує сама — зазвичай відхиляє.

Що відбувається після відправки

1. Журнал: «OTTO: надіслано карток: N, завдання ‹номер›». Поки OTTO обробляє завдання, ці товари наступні запуски пропускають: «OTTO: нові картки ще обробляються площадкою: N».
2. Прийнята картка — «OTTO: картку «‹назва›» (‹SKU›) прийнято», товар прив'язано. Elbuz одразу відправляє для нього профіль доставки й термін обробки з шаблону завантаження.
3. Відхилена — «OTTO: «‹назва›» (‹SKU›) відхилено: ‹причина›», прив'язка знімається, наступний запуск спробує знову.

Відвантаження, номер повернення й скасування

Галочка «Замовлення» в шаблоні вивантаження передає на OTTO дві події з ваших замовлень:

Для відвантаження OTTO вимагає три речі, і без будь-якої з них подія не йде:

• Трек-номер — поле «Сервіс доставки: номер» у картці «Доставка» документа (розгорніть «Більше полів»).
• Перевізник зі списку OTTO — DHL, DPD, GLS, HERMES, UPS та інші. Elbuz бере код із кнопки «Види доставки» шаблону завантаження, а без зіставлення — назву служби доставки з документа.
• Адреса відвантаження — з поля «Версія API (параметри майданчика)» шаблону вивантаження.

Номер повернення для посилок

Для товарів, що їдуть посилкою (профіль доставки типу PARCEL), OTTO приймає відвантаження лише разом із номером посилки, якою покупець поверне товар. Впишіть його в поле «Номер повернення» у картці «Доставка» документа, під «Більше полів»:

• номер — перевізник повернення той самий, що й відвантаження;
• GLS:номер, DHL:номер або HERMES:номер — інший перевізник повернення.

Повернення OTTO приймає лише через DHL, GLS і Hermes. Для вантажної доставки поле не потрібне.

1

Сервіс доставки: номер

2

Номер повернення

1. Сервіс доставки: номер — трек-номер відвантаження.
2. Номер повернення — номер посилки для повернення; інший перевізник — з префіксом, напр. GLS:…

Кожна подія відправляється один раз: після відправки Elbuz запам'ятовує новий статус площадки. У журналі — рядки «OTTO: замовлення ‹номер› → SENT» і підсумок «OTTO: статусів замовлень передано: N, помилок: M». Відмову видно рядком «OTTO: замовлення ‹номер› → SENT не передано — ‹причина›».

Повернення від покупців

Повернення, яке покупець оголосив, і повернення, помилково доставлене на склад OTTO, приходять разом із замовленнями — документом «Повернення від покупця» на підставі замовлення. Кожна повернена позиція — окремий документ: OTTO рахує штуки окремо.

У документі — товар, ціна й покупець із замовлення, трек-номер і перевізник поверненої посилки. Номер документа — номер замовлення з хвостом -R…. Повторне завантаження оновлює той самий документ, а не створює новий.

Як прийняти чи відхилити повернення

Рішення передається статусом документа повернення, зіставленим у вікні «Статуси замовлення» шаблону завантаження. Відправляє його вивантаження з галочкою «Замовлення».

Причина відмови обов'язкова. Статус із голим REJECTED не відправляється: у журналі «OTTO: повернення ‹номер› не відхилено — у зіставленні статусів вкажіть причину, напр. REJECTED:ITEM_DAMAGED». Для повернень зручно завести окремі статуси «Повернення прийнято» й «Повернення відхилено (пошкоджено)».

Сценарії

Виставити на OTTO каталог, який ви ведете в Elbuz

Що ввімкнути. Зіставте свої категорії з категоріями OTTO (вкладка OTTO, кнопка «Завантажити довідник майданчика»), заповніть дані GPSR, у шаблоні завантаження — ID профілю доставки. Додайте товарам атрибути з назвами обов'язкових атрибутів OTTO. У шаблоні вивантаження — «Мова описів» німецька, галочки «Товари» й «Публікувати нові товари».

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

Відвантажувати замовлення OTTO з Elbuz

Що ввімкнути. У шаблоні завантаження — галочку «Замовлення», зіставлення статусів (щонайменше PROCESSABLE, SENT, CANCELLED_BY_PARTNER) і кодів перевізників кнопкою «Види доставки». У шаблоні вивантаження — адресу відвантаження й галочку «Замовлення».

Що вийде. Менеджер вписує трек-номер і, для посилки, номер повернення, ставить статус, зіставлений із SENT, — найближче вивантаження передасть відвантаження на OTTO.

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

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

Чи можна продавати на чужій картці OTTO, як на Amazon?

Ні, OTTO такого не дозволяє: кожен продавець описує товар сам, тому Elbuz відправляє повну картку (нові картки).

Замовлення є в кабінеті OTTO, а в Elbuz його немає — чому?

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

Мої атрибути українською — чи підійдуть вони для OTTO?

Ні, назва атрибута має точно збігатися з назвою атрибута OTTO, зазвичай німецькою. Додайте атрибути з такими назвами (нові картки).

Як спершу перевірити все без реальних замовлень?

Впишіть 1 у поле «Пісочниця» шаблону завантаження — Elbuz працюватиме з тестовим середовищем OTTO (поля шаблону).

Повернення прийшло кількома документами — це помилка?

Ні, OTTO рахує кожну штуку окремою позицією, тому кожна повернена позиція — свій документ (повернення).

Суміжні теми

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