1. Для интеграции вам нужно реализовать серверную часть - методы на основе нашей спецификации (методы работы с номенклатурой и заказами, а так же OAuth2.0 авторизацию). При работе мы будем опрашивать ваш сервер для получения данных по товарам и отсылать заказы. В присланных вам файлах методы описаны в nomenclature_retail - получения меню с товарами, стоки, в orders - работа с заказом (см методы только в /order).

2. Авторизация для всех методов одинаковая: вы реализуете у себя OAuth2.0, выдаете нам хост сервера (только по домену, не по IP), ключ, секрет, мы с этими данными получаем токен запросом /security/oauth/token. Далее с этим токеном мы выполняем все остальные запросы (обновление товаров, отправка вам заказа и тп).

3. Файлы спецификации вы можете открыть в любом swagger-редакторе, например в https://editor.swagger.io/

4. Обязательные поля отмечены в спецификации текстом, если в визуальном виде - звездочкой. Обратите внимание на Content-type в запросах, нужно смотреть тот, который отмечен как актуальный вариант в модели.

5. Тестового стенда у нас нет. После вашей разработки мы можем провести совместное тестирование, мы проверим работу запросов и ответов (на примере одной точки, хост может быть ваш тестовый/продовый) - получение номенклатуры, отправка тестового заказа в вашу систему (с вашей стороны нужно будет провести заказ по нужным статусам), проверка статусов и тп. После тестирования реальные точки будут созданы и настроены под интеграцию в нашей системе.

6. Расписание запросов: 1 раз утром парсинг всех товаров (возможно перенастроить), доступность - остатки/стоки мы запрашиваем раз в 5 минут, после создание заказа статусы раз в минуту. Цены забираем вместе с товарами при парсинге, не отдельно, это один общий запрос массива с данными по номенклатуре.

7. В методе работы с доступностью (GET ​/v1​/nomenclature​/{placeId}​/availability) неточность:
сейчас: Отсутствующие в списке продукты будут недоступными для заказа
Следует читать: Отсутствующие в списке продукты будут доступными для заказа с бесконечным количеством. Если вы хотите убрать товар из выдачи в Яндекс.Еде, убедитесь, что по нему передаются остатки со значением 0.
То есть список тут будет совпадать со списком товаров, полученным исходно при парсинге номенклатуры, и недоступный к заказу товар должен быть указан там со значением 0.

8. Вашей системе надо уметь поддерживать создание заказа, отмену заказа. Обновление заказа с вашей стороны или со стороны Я.Еды - дополнительное.

9. Изображения для товаров/категорий вы присылаете в images в виде url на изображение и хеша для понимания изменения изображения. Картинка по url должна быть доступна для скачивания изображения роботом по ссылке.

10. Запросы за товарами/с заказами отправляются нами согласно спецификации на конкретную точку. То есть у ваших магазинов будет общий хост для запросов, в запросе мы передаем id точки в вашей системе. С вашей стороны уже надо научить ваши системы передавать нам данные товаров по конкретной запрошенной точке, принимать туда заказы.