Позиция синхронизации каталога Seller API передаёт категорию своего магазина названиями уровней от корня вместо категории площадки: позиция встаёт в категорию по сопоставлению категорий магазина — тому же, что у файлов и фидов; новая категория магазина появляется в перечне сопоставления раздела разработчиков, позиция несопоставленной категории отклоняется с её путём. Операция категорий строк отдаёт категорию каждой позиции без записи объявлений — по ней клиент загружает файлы позиции.
Позиция синхронизации каталога Seller API передаёт упаковку товара — вес в граммах, длину, ширину и высоту в сантиметрах и вид упаковки: товар с сайта уходит заказом службой доставки площадки. Позиция без упаковки прежнюю не меняет. Клиенты на PHP и TypeScript берут упаковку путями сопоставления и округляют дробное вверх.
Открытый плагин WordPress выгружает каталог магазина WooCommerce на площадку без кода: товары, вариации, остатки, вес и габариты — при изменении и раз в час, категории магазина — сопоставлением карточки «Категории магазина» раздела «API». Заказы площадки приходят заказами WooCommerce, их исполнение — панелью «ОПОТОПО» экрана заказа: своя доставка с трек-номером, передача службе доставки площадки с местами, готовность к выдаче, отмена и документы отправления.
Открытый модуль 1С-Битрикс выгружает каталог интернет-магазина на площадку без кода: товары, торговые предложения, остатки, вес и габариты — при изменении и раз в час, категории магазина — сопоставлением карточки «Категории магазина» раздела «API». Заказы площадки приходят оплаченными заказами сайта, их исполнение — блоком «ОПОТОПО» формы заказа: своя доставка с трек-номером, передача службе доставки площадки с местами, готовность к самовывозу, отмена и документы отправления.
Система продавца ключом Seller API читает свои заказы, передаёт их своей доставкой, службой платформы либо к самовывозу, отменяет и получает документ отправления; уведомление о смене статуса заказа приходит на выбранный webhook. Пакет npm @opotopo/seller-api выгружает каталог сайта на Node.js без сторонних зависимостей: сопоставляет поля своих записей с позициями площадки, снимает позиции, выпавшие из каталога, и отчитывается об отказах по артикулам. Заказы ведут клиенты на PHP, TypeScript и для Laravel, руководства — в разделе «Разработчикам» базы знаний.
Пакет Composer opotopo/seller-api выгружает каталог сайта на любом фреймворке PHP, загружает файлы, снимает позиции, выпавшие из каталога, принимает уведомления о покупках и выдаёт покупателю ключ своей системы лицензий; opotopo/seller-api-laravel делает то же из моделей Eloquent командой и расписанием Laravel. Руководства — в разделе «Разработчикам» базы знаний.
Подтверждённый владелец бренда передаёт модели пакетом ключом с разрешением «Ведение моделей брендов»: модель находится по штрихкоду, коду производителя либо имени, иначе заводится, характеристики и фото приходят той же строкой, публикация — признаком пакета. Значения редактора площадки строка не перетирает, ответ приходит по каждой строке отдельно.
Внешняя система передаёт позиции пакетом: артикул отличает новую позицию от заведённой, повторная передача обновляет объявление и не заводит дубли. Изображения площадка забирает по ссылкам сама, ответ приходит по каждой позиции отдельно, а признак публикации сразу отправляет заведённое на проверку.
Сайту, который уже отдаёт каталог файлом, писать код передачи не нужно: в разделе интеграций указывается адрес и частота обновления. Площадка забирает файл по расписанию, применяет его теми же правилами и снимает с публикации позиции, исчезнувшие из файла.
В разделе интеграций появилось руководство: порядок подключения от ключа до первой синхронизации, сопоставление своего каталога с категориями площадки, поведение при ошибках и ограничении частоты, готовые примеры вызова.