| Оглавление |
|---|
Требования и шаги настройки.
Приобрести лицензию на модуль Сервер обмена данными (API): Яндекс.Еда (₽)
- Выполнить настройку сервера "Сервер обмена данными".
- Выполнить настройку вспомогательных справочников: Классификатор категорий товаров; Виды цен мест хранений;
- Определиться контрагентом от имени которого в Торговой системе будут проводиться продажи товара сервиса Яндекс Еда.
- Произвести настройку прав доступа для пользователей, которые будут работать с сервисом.
- Для работы с сервисом, считается, что оптимальным условием будет использование мобильного решения Супермаг Мобайл. В котором реализованы такие процессы как: Комплектация заказа от клиента; Отгрузка.
Интеграция с сервисом «Яндекс.Еда».
В сервер обмена данными добавлен новый формат обмена данных «Яндекс.Еда». Новый формат обмена применим только для адресата типа «Доверительная база». Адресат с таким форматом обмена может быть только один в базе данных. Предполагается, что «Яндекс.Еда» обслуживает заказы всех магазинов базы данных по одному каналу обмена.
...
В интерфейсе задания атрибутов необходимо указать перечень магазинов, для которых покупатели будут создавать заказы, а Яндекс.Еда будет получать цены и остатки.
В элементе «Товары» необходимо указать группу классификатора категорий товаров, выбранную для привязки доступных для сервиса товаров. В ответах на запросы сервиса будут задействованы только те товары, у которых есть привязка к выбранному узлу классификатора категорий.
Флажок «Передавать старую цену» («Не передавать маркетинговую цену») управляет правилом передачи цены. Если флаг не установлен, то передается текущая цена для кассы, какая бы она не была – регулярная или маркетинговая. Если флаг установлен, то в случае, если текущая цена артикула является маркетинговой, будет передана его ближайшая цена из истории цен, превышающая текущую цену.
Опция "Цена для кассы", "Цена для интернет магазина" - Виды цен для кассы и для интернет-магазина настраиваются в разделе «Склады и магазины» на закладке «Цены»:
Если месту хранения вид цены для интернет-магазина не назначен, то товар будет выгружаться с ценой для кассы. Если вид цены для интернет-магазина назначен, но для конкретного товара цена не установлена, то товар будет выгружен с ценой для кассы.
Опция «URLссылки и хэш изображения товара» управляет способом генерации хэш-кода для изображения товара. Изображение товара может иметь большой размер, и его передача при каждом запросе информации об артикуле нерациональна. Вычисление хэш-кода картинки позволяет понять, произошло ли изменение картинки, и запрашивать картинку только при изменении.
...
GET /nomenclature/{placeId}/availability - Список товаров с указанием их остатков
Остатки:
Перечисленным товарам обновляются остатки. В зависимости от значения остатков также обновляется и доступность продукта. Если остаток <= 0, продукт становится недоступным для заказа, если > 0 - доступным для заказа. Отсутствующие в списке продукты будут недоступными для заказа.
При выгрузке информации по запросу «Список продуктов с указанием их остатков» оперативно доступные остатки артикула + «В приемке / в пути» для указанного места хранения берутся либо из таблицы текущих остатков, либо из таблицы статистики остатков. Объект «Статистика по текущим остаткам» содержит данные об остатках мест хранения, обслуживаемых в других базах данных. Эта информация приходит в базу данных по почте. Товар, который принят, но не прошел полный цикл оформления приходных документов, не будет исключаться из количества, доступного для заказа товара.
Выбор источника данных выполняется следующим образом. Если место хранение локальное в текущей базе данных и у него не отключен перерасчет остатков, то остатки берутся из таблицы текущих остатков, в противном случае - из таблицы статистики остатков.
| Команды Яндекс Еда | Описание |
|---|---|
| POST / |
...
| order | Создание заказа |
| GET /order/{orderId} |
...
| Выдача актуальной информации о заказе | |
| DELETE /order/{orderId} |
...
| Отмена заказа | |
| PUT /order/{orderId} | Обновление заказа |
| PUT /order/{orderId} |
...
| /status | Обновление статуса заказа в системе партнера по инициативе Яндекс Еды. При получении такой команды со значением статуса «CANCELLED» соответствующий заказ от клиента блокируется с указанием причины завершения «Отменен». При получении команды с другими значениями статуса возвращается код ошибки 500 с описанием «неподдерживаемая смена статуса». |
| GET /order/{orderId}/status |
...
| Выдача актуального статуса заказа |
...
Для передачи изображений категорий товаров в раздел «Классификатор категорий товаров» добавлена возможность сохранять картинки для группы классификатора:
Для осуществления автоматической процедуры закрытия Заказа от клиента, при выполнении отгрузки товара. Рекомендуется использовать опцию в модуле Административный модуль СуперМаг:
