Регламент интеграции с веб-сервисами АСНА⚓︎

Перед тем как приступать к интеграции с веб-сервисами АСНА, аптечная сеть должна пройти первичную интеграцию с АСНА согласно Регламенту информационного обмена, выполнить связки справочника товаров на портале связок Alphaone.

Сервисы asna.ru и функциональные возможности аптечного ПО⚓︎

Сервисы⚓︎

Сервисы asna.ru	Описание
Бронирование	Возможно забронировать товар по ценам аптеки и выкупить заказ в ваших аптеках
Подмена аптечных цен	Возможность транслировать цены на товар, отличные от розничных цен в аптеках по трем шаблонам ценообразования
Контроль сроков годности	Контроль сроков годности на asna.ru
Контроль цен списка ЖНВЛС	Контроль максимально допустимой цены на товары из списка ЖНВЛС
Асна Экономия	Возможность увеличить товарооборот за счёт новых покупателей с большими покупками
Предзаказ	Возможность увеличить широту аптечного ассортимента, уменьшать затраты на товарные запасы и текущие издержки
Доставка со склада	Доставка готового заказа в аптеку. Возврат невыкупленных заказов на склад
Доставка на дом	Возможность предложить покупателю доставку на дом

Функциональные возможности ПО⚓︎

Функциональные возможности аптечного ПО	Описание
Получение новых заказов в автоматическом режиме	Получение с asna.ru новых/измененных заказов, резервирование товара в аптеке
Получение новых заказов в ручном режиме	Получение с asna.ru новых/измененных заказов, резервирование товара в аптеке
Уведомление на кассе о новых/измененных/сброшенных/отмененных заказах	Информирование первостольника о событиях требующих обработки заказов
Распечатка сборочных листов	Формирование и печать сборочных листов по заказам asna.ru
Комплектация заказа	Уведомление покупателя о готовности заказа к выдаче после фактической сборки заказа в аптеке
Изменение времени бронирования	Продление срока хранения/бронирования заказа в аптеке
Отпуск заказа покупателю	Реализация заказа в ценах на товара, обещанные покупателю на asna.ru
Сбор заказа по истечению времени резерва	Заказ в аптеке снимается с резерва
Отмена заказа покупателем	Заказ в аптеке снимается с резерва
Отмена заказа аптекой(ручной привод)	Заказ в аптеке снимается с резерва
Выход с кассы в админку первостольника	Просмотр, редактирование и отмена заказов покупателей сотрудником аптеки
Редактирование заказа	Поддержка изменений в заказах после их первичной обработки

ВНИМАНИЕ!

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

Требования к функционалу аптечного ПО⚓︎

Пользователь в кассовом модуле ПО должен получать уведомления о приходе новых или измененных заказов, не мешающие работе на кассовом модуле, например в виде неблокирующего всплывающего окна, с максимальной периодичностью один раз в одну минуту, поверх окна «продажа товаров», либо другим способом, до подтверждения первостольником обработки заказа, например, до установки статуса «Собран». В случае, если заказ отредактирован покупателем, повторно отрабатываем данную логику в полном объеме. ПО должно извещать первостольника о том, что заказ можно разукомплектовывать в следующих случаях:
- отмена на сайте покупателем
- отмена в аптеке первостольником
- сброшенные автоматически в аптеке по таймауту (достижении времени сброса резерва)
Пользователь должен иметь возможность распечатать заказ (форма произвольная), для комплектации и удобства работы с сервисом сотруднику аптеки, из кассового модуля. В распечатанном документе выводится список зарезервированных партий по подтвержденному заказу с необходимой информацией по партии для сбора заказа(серия, срок годности, поставщик, количество, название товара, производитель, обещанная покупателю цена реализации в момент оформления заказа на сайте и т.п.)
Пользователь должен иметь возможность переходить на сайт по кнопке «Кабинет первостольника» (вызывается браузер «по умолчанию» с введенным URL https://www.asna.ru/bitrix/admin/?guid={GUID_аптеки} ) для возможности просмотра заказов на сайте, редактирования, отмены. GUID_аптеки - обязательный параметр.
Пользователь должен иметь возможность принудительно запустить обмен с сайтом для получения заказов по нажатию кнопки «Получить заказы» (т.к. клиент, оформивший заказ на терминале не должен ждать стандартного обмена по расписанию).

Интеграция⚓︎

Для интеграции с веб-сервисами АСНА, аптечная сеть силами своих специалистов или с помощью разработчиков ПО, которое использует аптечная сеть, должна реализовать протокол обмена, описанный в этой документации. Протокол реализуется в следующем порядке:

Авторизация (раздел Авторизация в АСНА REST API). Для авторизации требуется выбрать тестовую аптеку из интегрируемой сети и сообщить ее юридическое лицо, а также полный адрес, выделенному сотруднику отдела разработки веб-сервисов АСНА. Сотрудник АСНА выдаст необходимые для авторизации данные (client_id и client_secret), а также настроит эту аптеку на тестовый режим. Аптека будет видна на сайте АСНА, после регулярной выгрузки полных остатков, на ней можно будет делать заказы, но сумма тестового заказа не может превышать 500 рублей. Кроме этого, при оформлении заказа на тестовой аптеке, сайт может выводить предупреждение о том что эта аптека временно не обрабатывает заказы.
Загрузка справочников АСНА (раздел Справочник связок номенклатуры). Этот вызов API нужно использовать для получения связок номенклатуры аптечной сети и АСНА. Связки аптечная сеть выполняет на этапе базовой интеграции с АСНА.
Выгрузка остатков (раздел Остатки товаров). Необходимо реализовать выгрузку полных остатков аптеки, раз в сутки, желательно ночью, а также выгрузку изменений остатков, каждые 10 минут, если было движение за этот период.
Бронирование (раздел Заказы (бронирование)). Необходимо реализовать запрос изменений по заказам, бронирование, выгрузку ответа по обработанным заказам. Необходимо реализовать обработку 100, 102, 108, 111 статусов от сайта и перередачу на сайт статусов 200, 201, 202, 204, 205, 210, 211, 212, 213. Запрос изменений по заказам, а также передача ответа, должны происходить раз в минуту.
Предзаказы (раздел Сводный прайс-лист). Необходимо реализовать выгрузку полного сводного прайс-листа юридического лица, раз в сутки, после загрузки всех прайс-листов поставщиков, а также изменений по сводному прайс-листу, после обновления прайс-листа поставщика, участвующего в формировании сводного прайс-листа. В рамках работы с бронированием по сводному прайс-листу должны быть реализованы следующие статусы заказов: 203, 206, 207, 208, 209. Реализовать доработку по предзаказам можно после реализации бронирования с наличия, совместного тестирования и запуска ПО в рабочем режиме.

Последнее обновление: 17 августа 2021 г. 11:14:40
Созданный: 6 августа 2021 г. 12:08:38