Документация API¶
Адрес API:
Host: https://yavapteke.ru/YavaptekeAPI/¶
Быстрый старт¶
Для начала работы необходимо получить адрес персонального каталога на нашем FTP и учетные данные для доступа к нему. FTP необходим для регистрации в нашей системе Ваших аптек.
Далее необходимо выложить в персональный каталог на FTP файл с перечнем аптек в формате json с именем файла обычно addresses.json. Кодировка файла Windows CP-1251
Подробное описание формата и вложенный пример файла по ссылке:
YavaptekeAPI_-_Часть3_(Управление_набором_аптек)
Просьба обратить внимание что для дальнейшей работы с REST API каждой аптеке необходимо сгенерировать на Вашей стороне и присвоить уникальные идентификаторы "storeId", "client_id" и "secret" и указать их в файле addresses.json
После успешной обработки файла аптеки будут зарегистрированы в нашей системе и Вы сможете обращаться к ним через REST API, используя для авторизации указанные ранее в файле "storeId", "client_id" и "secret":
Авторизация в yaVapteke REST API
Следующий шаг это настройка передачи остатков (предложений) по каждой аптеке. Передача полных остатков должна производиться Вами один раз в сутки в ночное время (МСК). По мере изменений в остатках изменения выгружаете методами частичной выгрузки.
Подробнее по ссылке:
YavaptekeAPI - Часть1 (Прайс-листы)
После того, как выгрузка и актуализация предложений работает, на сайте отображаются Ваши предложения, необходимо настроить обмен информацией о заказах и их статусах через REST API. Подробнее по ссылке:
YavaptekeAPI - Часть2 (Заказы и статусы)
Обратите внимание на методы частичного подтверждения заказа, когда например некоторые из позиций заказа отсутствуют в аптеке, то заказ может быть подтвержден частично перед тем, как будет установлен статус "Готов к выдаче". В таком случае покупатель увидит что в заказе произошли изменения.
В том случае, если обмен данными по REST API невозможен, существует менее предпочтительный вариант взаимодействия путем файлового обмена через наш FTP:¶
YavaptekeAPI (Файловый обмен) - Часть1 (Прайс-листы)
YavaptekeAPI (Файловый обмен) - Часть2 (Заказы и статусы)