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