Этот баннер не будет напечатан

Эта страница собрана из всех страниц документации, к ней применены специальные стили для печати и сохранения в PDF. Печатайте или сохраняйте в PDF используя File > Print > Save as PDF.

Для создания PDF, убедитесь что вы используете функцию браузера для печати и сохранить-как-pdf функцию вместо системного диалога.

Регламент интеграции

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

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

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

Сервисы

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

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

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

ВНИМАНИЕ!

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

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

1. Пользователь в кассовом модуле ПО должен получать уведомления о приходе новых или измененных заказов, не мешающие работе на кассовом модуле, например в виде неблокирующего всплывающего окна, с максимальной периодичностью один раз в одну минуту, поверх окна «продажа товаров», либо другим способом, до подтверждения первостольником обработки заказа, например, до установки статуса «Собран». В случае, если заказ отредактирован покупателем, повторно отрабатываем данную логику в полном объеме. ПО должно извещать первостольника о том, что заказ можно разукомплектовывать в следующих случаях:

   • отмена на сайте покупателем
   • отмена в аптеке первостольником
   • сброшенные автоматически в аптеке по таймауту (достижении времени сброса резерва)

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

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

Интеграция

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

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

Тестирование интеграции

После реализации протокола и тщательного тестирования собственными силами, интегрируемое ПО должно пройти совместное приемочное тестирование с выделенным сотрудником отдела разработки веб-сервисов АСНА. Целью приемочного тестирования является обнаружение ошибок интеграции и своевременного их устранения, перед запуском сети или ПО в рабочем режиме. Перед выполнением совместного тестирования, аптечное ПО должно заранее обеспечить полную выгрузку остатков тестовой аптеки, желательно за несколько часов (более 3) до начала тестирования. Выделенный сотрудник аптечной сети или разработчик ПО должен убедиться, что тестовая аптека появилась на сайте, ее остатки видны и есть возможность формировать заказы.

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

Ended: Регламент интеграции

Документация API

Введение

Общие сведения об АСНА REST API

АСНА REST API предназначен для интеграции со сторонним ПО и построен по принципам REST¹. По мере развития проекта мы будем стараться максимально придерживаться принципов REST, чтобы наш API соответствовал Level 3 Maturity RESTful Services. Для работы с API используется HTTP(S) протокол.

Основным адресом АСНА REST API служит URL: https://api.asna.cloud/ или http://api.asna.cloud/ . Все обращения к API должны идти на этот адрес, дополненный адресом ресурса, к которому вы обращаетесь. Адреса ресурсов, а также разрешенные методы доступа к ресурсам описаны далее в документации.

Основные используемые HTTP методы

Метод	Описание
GET	Используется только для получения данных
PUT	Используется для изменения данных, а также для операций upsert
POST	Используется только для добавления новых данных
DELETE	Используется только для удаления данных

Основные коды состояний ответов

Успешные²

Код	Название	Описание
200	OK	Запрос прошел успешно и этот запрос не привел к изменению данных
201	Created	Запрос прошел успешно и этот запрос привел к созданию новых данных
202	Accepted	Запрос прошел успешно, но переданные данные требуют отложенной обработки
204	No Content	Запрос прошел успешно, данные удалены

Ошибочные²

Код	Название	Описание
400	Bad Request	Ошибка в передаваемых со стороны клиента данных
401	Unauthorized	Клиент не авторизован для выполнения запросов к API
403	Forbidden	Клиент авторизован, но у него нет прав на выполнение данного запроса
404	Not Found	Был запрошен отсутствующий URL
429	Too Many Requests	С клиента было превышено количество запросов в единицу времени
500	Internal Server Error	Произошла ошибка на стороне API, подробное описание ошибки уходит разработчикам сервисов

В 1С эти коды называются КодСостояния

Версионирование

В API сервисах АСНА используется версионирование. Версия API, которую вы используете, указывается в URL при запросах к сервису.

GET /v5/stores HTTP/1.1

Поддерживаемые, а также устаревшие версии API, вы можете узнать из заголовков api-supported-versions и api-deprecated-versions в каждом ответе от сервиса.

GET /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/stocks HTTP/1.1
Host: api.asna.cloud
Content-Type: application/json; charset=utf-8
Date: Sat, 08 Apr 2017 17:47:13 GMT
Server: Microsoft-HTTPAPI/2.0
Transfer-Encoding: chunked
X-Rate-Limit-Limit: 7d
X-Rate-Limit-Remaining: 9947
X-Rate-Limit-Reset: 2017-04-14T09:45:30.1113052Z
api-supported-versions: 5.0

Поддерживаемая версия API указана в документации у каждой операции над ресурсами.

Поддерживаемые форматы данных (media-types)

Основным форматом для работы с API является JSON. Для уменьшения объемов передаваемой и принимаемой информации вы можете настроить ваш сериализатор JSON так, чтобы поля, содержащие null или значения по умолчанию, не передавались (мы передаем данные именно в таком виде). Формат данных, передаваемых на сервисы АСНА, указывается в HTTP заголовке Content-Type запроса, для JSON это application/json. Формат, в котором вы хотите получить данные, указывается в заголовке Accept запроса. Кодировка текста - UTF-8.

ВНИМАНИЕ!

Еще раз обращаем особое внимание на то что мы передаем и можем принимать данные в JSON без полей, имеющих значение null или значение по умолчанию для типа данных. Т.е. если какое-то поле имеет значение null или значение по умолчанию (например, для булевого поля false, для целого 0), то его не будет в JSON, который мы вернем. Если ваше ПО или десериализатор не умеет работать с таким JSON, то можно получать его полную версию, добавив заголовок Accept со значением application/x-json-full, но просьба не злоупотреблять этим, так как это сильно увеличивает объемы передаваемых данных.

GET /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/stocks HTTP/1.1
Host: api.asna.cloud
Content-Type: application/json; charset=utf-8
Date: Sat, 08 Apr 2017 17:47:13 GMT
Server: Microsoft-HTTPAPI/2.0
Transfer-Encoding: chunked
X-Rate-Limit-Limit: 7d
X-Rate-Limit-Remaining: 9947
X-Rate-Limit-Reset: 2017-04-14T09:45:30.1113052Z
api-supported-versions: 5.0

Компрессия данных

При использовании HTTPS протокола не рекомендуется использование gzip компрессии. Это связано с потенциальной возможностью использования уязвимостей SSL в этом случае. Если объем передаваемых или принимаемых данных велик, и передача/прием занимает много времени или не проходит, или вы используете протокол HTTP, вы можете использовать компрессию. За компрессию отвечают HTTP заголовки Content-Encoding и Accept-Encoding.

Поддержка Swagger

Помимо данного руководства, сервисы API АСНА предоставляют автоматически генерируемую документацию в формате Swagger³. Вы можете использовать эту возможность для изучения нашего API, а также для автоматического формирования клиентского кода, используя обширный набор коммерческих и бесплатных инструментов. Получить swagger.json можно по адресу https://api.asna.cloud/swagger/v5/swagger.json. Подробнее про работу со Swagger можно прочитать в разделе Тестирование АСНА Web API. АСНА REST API имеет встроенный инструмент для просмотра документации в формате Swagger, которым можно воспользоваться, перейдя по адресу https://api.asna.cloud/swagger. Указанный инструмент позволяет не только просматривать документацию, но и выполнять запросы к API.

Локализация

С версии 5 API может возвращать большинство информации об ошибках на русском языке (по умолчанию используется английский). Для этого необходимо добавить в запросы HTTP-заголовок Accept-Language со значением ru. Возможно, не все сообщения имеют перевод на русский язык, если вы столкнулись с такой ситуацией, то сообщите, пожалуйста, службе технической поддержки.

Валидация данных

Все, передаваемые в API, данные проходят первичную валидацию (проверку на правильность заполнения данных). В случае, если в передаваемых данных содержится ошибка, то весь пакет отклоняется. При этом API возвращает 400 HTTP статус(код состояния) и подробную информацию об ошибках в теле ответа. Следует иметь в виду, что подробная информация об ошибках возможна только в том случае, если API удалось распарсить передаваемый пакет, в противном случае информация об ошибках несет только общий характер.

Основные этапы валидации

1. Проверяется соответствие типов данных
2. Проверяется заполнение обязательных полей
3. Проверяется корректность заполнения полей, например предельная розничная цена для ЖНВЛС не должна быть меньше розничной или закупочной
4. Проверяется дублирование ключа, например кода партии в остатках
5. Дополнительные проверки

Ограничение частоты запросов

Для поддержания необходимого уровня сервиса и исключения излишней нагрузки API использует механизмы ограничения частоты запросов с одного IP адреса (rate limiter). Возможная частота запросов либо указана в документации по конкретному методу, либо может быть получена в техподдержке. Кроме того, не стоит делать запросы к API, если вы не собрали никаких данных, например, не было изменений остатков за период, заказов, пр. Если вам необходимо с одного IP отправлять много запросов, по разным аптекам, то напишите в техподдержку АСНА.

Рекомендации по работе с API

РЕКОМЕНДАЦИЯ

Сервисы API АСНА расположены в облаке и используют облачные ресурсы, поэтому со стороны клиентов, работающих с API необходимо наличие логики повтора вызова API, в случае возникновения временных (transient errors) ошибок, например, таких как таймауты подключения и т.д.

Логика повтора (retry logic) необходима при работе с любыми ресурсами, расположенными в Интернет (в локальной сети это тоже будет не лишним), так как в любой момент возможна потеря связи, отказ коммутационного оборудования, а также апдейт облачных сервисов или внезапная пиковая нагрузка на них. При этом необходимо понимать, какие ошибки являются временными, а какие нет. Например, таймауты подключения, с высокой долей вероятности, ошибка временная, вызванная нагрузкой или временным отсутствием связи, а 400 статус ответа от сервиса является ошибкой постоянной. Если передаваемый на наши сервисы пакет данных содержит ошибки, то вне зависимости от количества попыток, результат будет тот же, пока передаваемый пакет не будет исправлен. В этом случае, нет смысла повторять запросы с ошибочным пакетом. К постоянным ошибкам относится и 404 статус.

При отсутствии со стороны клиента логики повтора, претензии к работе API, связанные с временной недоступностью, рассматриваться не будут.

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

Для решения проблем при возникновении инцидентов, необходимо наличие логирования запросов к API со стороны клиентского ПО, список необходимых данных указан ниже:

1. Точное время запроса с таймзоной
2. Полный URL запроса и метод
3. Все заголовки запроса
4. Тело запроса, если его размер небольшой
5. Статус ответа от API
6. Тело ответа, если его размер небольшой

---

1. Representational State Transfer (REST) в переводе — это передача состояния представления. Технология позволяет получать и модифицировать данные и состояния удаленных приложений, передавая HTTP-вызовы через интернет или любую другую сеть. Краткое введение ↩

2. HTTP статусы. Ссылка ↩↩

3. Swagger(OpenAPI) это язык описания интерфейсов для REST API, выраженный с помощью JSON. Swagger используется вместе с набором программных средств с открытым исходным кодом для проектирования, создания, документирования и использования веб-сервисов RESTful. Swagger включает автоматизированную документацию, генерацию кода (на многие языки программирования) и генерацию тестовых примеров. Ссылка ↩

Авторизация в АСНА REST API

АСНА REST API поддерживает авторизацию на основе JWT токенов.

Для обращения к любому из ресурсов АСНА REST API требуется наличие JWT токена в заголовке Authorization HTTP запроса, с типом Bearer. При отсутствии токена API вернет 401 статус (Unauthorized), этот же статус вернется в случае, если время действия токена закончилось (токен выдается на определенное время). В обоих случаях нужно запросить новый токен.

GET /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/stocks HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

Получение токена

Для выполнения запросов к API, необходимо получить JWT токен от службы единой авторизации облачных сервисов АСНА, расположенной по адресу https://sso.asna.cloud:5000

POST /connect/token

Описание

Получение авторизационного токена

Параметры запроса

Параметры этого запроса передаются в теле запроса, см. пример запроса

Имя	Обяз.	Описание
client_id		Идентификатор аптеки по справочнику АСНА
client_secret		Пароль аптеки, полученный от службы техподдержки или клиентского маркетинга
grant_type		Тип авторизации. В данном случае всегда client_credentials

Заголовки запроса

Имя	Описание
Content-Type	Должно иметь значение application/x-www-form-urlencoded

Пример запроса

HTTP

POST /connect/token HTTP/1.1
Host: sso.asna.cloud:5000
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

client_id=E45D3491-79EE-4EEA-92B2-22CEBE4BB8B5&client_secret=1234567&grant_type=client_credentials

C# (RestSharp)

var client = new RestClient("https://sso.asna.cloud:5000/connect/token");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/x-www-form-urlencoded");
request.AddParameter("client_id", "E45D3491-79EE-4EEA-92B2-22CEBE4BB8B5");
request.AddParameter("client_secret", "1234567");
request.AddParameter("grant_type", "client_credentials");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

CURL

curl --location --request POST 'https://sso.asna.cloud:5000/connect/token' --header 'Content-Type: application/x-www-form-urlencoded' --data-urlencode 'client_id=E45D3491-79EE-4EEA-92B2-22CEBE4BB8B5' --data-urlencode 'client_secret=1234567' --data-urlencode 'grant_type=client_credentials'

Успешный ответ

HTTP cтатус	Значение
200	ОК. Запрос к сервису авторизации прошел успешно, в теле ответа содержится JSON с информацией о выданном токене.

Пример ответа

{
  "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE4MTIzNzUsImV4cCI6MTQ5MTgxNTk3NSwiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.FNHlxnnNQJ5dCVZI31UdpRTYKvioWdd4ixKMTHYHw2YH4jrMku24VAuvo5jY5Vv4NuhgR9BaVa57xjwfym1RzZBTgPC40usszyDz1RGnxSX0gemg6yiECCoXvwkfB88dtAcYqm7zIrJab3OIc6dHJq87Yum2y0hA4estaIgDPabPQYCGCtBWm4Z6cbVXbHaZqsktAGGDGwUd0E8R3NvPsFuBwuWtwRAoMEb9qmIAx292vidNi8l6Q6uxZfIYCCoOjt1Cr9ToVRa0bEqEuk1tcnhmWdYdsX151UgpgSk9uLaW8rgV9R-XdKU2sKBVjvM2tQevwN_jHoP-fIHiDkrJEQ",
  "expires_in": 3600,
  "token_type": "Bearer"
}

Неуспешный ответ

HTTP статус	Значение
400	Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа. Например, при отсутствии аптеки с таким идентификатором выдается invalid_client
500	Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Порядок выполнения авторизации на сервисах API

1. Получаем токен на сервере авторизации

2. Полученный токен (берется из поля access_token ответа от службы единой авторизации) сохраняется клиентским ПО и используется для запросов к API.

   POST /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/stocks HTTP/1.1
   Host: api.asna.cloud
   Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE4MTIzNzUsImV4cCI6MTQ5MTgxNTk3NSwiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.FNHlxnnNQJ5dCVZI31UdpRTYKvioWdd4ixKMTHYHw2YH4jrMku24VAuvo5jY5Vv4NuhgR9BaVa57xjwfym1RzZBTgPC40usszyDz1RGnxSX0gemg6yiECCoXvwkfB88dtAcYqm7zIrJab3OIc6dHJq87Yum2y0hA4estaIgDPabPQYCGCtBWm4Z6cbVXbHaZqsktAGGDGwUd0E8R3NvPsFuBwuWtwRAoMEb9qmIAx292vidNi8l6Q6uxZfIYCCoOjt1Cr9ToVRa0bEqEuk1tcnhmWdYdsX151UgpgSk9uLaW8rgV9R-XdKU2sKBVjvM2tQevwN_jHoP-fIHiDkrJEQ
   Content-Type: application/json
   Accept: application/json
   Cache-Control: no-cache
   
   {
      "date":"2017-03-30T05:23:59.3021523+00:00",
      "stocks":[
         {
            "prtId":"3c1aefcb-ecef-495b-b111-12ed420d78ca",
            "nnt":55310,
            "sku":"360715",
            "qnt":8,
            "doc":"№610535",
            "supInn":"3673614100",
            "supId":"197384c4-285b-4d52-912e-a2507ea2e296",
            "supDate":"2017-03-18T21:04:52.4770438+00:00",
            "nds":18,
            "gnvls":true,
            "dp":true,
            "man":"Ferry Inc",
            "series":"xu7a1a8m8lj4",
            "exp":"2020-02-08T00:00:00+00:00",
            "prcMan":787.38,
            "prcOpt":883.23,
            "prcRet":1137.53,
            "prcReestr":1327.25,
            "sumOpt":5988,
            "sumOptNds":7065.84,
            "mrGnvls":6.12,
            "tag":3
         }
      ]
   }
   

3. При получении от API статуса 401 (Unauthorized), т.е. по истечении срока годности токена, токен запрашивается повторно

Схема авторизации

Справочники

Справочник номенклатуры нормализованный

Вы можете получать справочник номенклатуры АСНА, в нормализованном виде, через следующий вызов API. Дополнительные справочники, при необходимости, получаются отдельными вызовами API.

ВНИМАНИЕ!

Запрашивать справочник номенклатуры желательно не чаще одного раза в сутки. Из-за большого размера справочника, выдача ограничена 10000 записей за вызов. Для получения всего справочника используйте параметры count и rvInt при запросе.

GET /v5/references/goods_normalized?count={count}&rvInt={rvInt}

Описание

Получить справочник номенклатуры по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/goods_normalized?count=2&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. Запрос к сервису авторизации прошел успешно, в теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "nnt": 8726906,
    "name": "БЕТАГИСТИН-СЗ 24мг N20 таб. Северная звезда",
    "nameFull": "БЕТАГИСТИН 24мг N20 таб. Северная звезда",
    "tmId": 62171,
    "pack": 0,
    "doseVal": 24,
    "doseId": 1,
    "rfId": 234,
    "ppId": 33,
    "psId": 0,
    "ptId": 0,
    "manCId": 9,
    "manId": 82,
    "actual": true,
    "gnvls": true,
    "vat": 10,
    "gpId": 1660,
    "aaId": 1802,
    "mnnId": 482,
    "aId": 43244,
    "speId": 2000000205,
    "catId": 2000000029,
    "dirId": 2,
    "megaId": 1,
    "ex": false,
    "stm": false,
    "rv": "AAAAAAALQak="
  },
  {
    "nnt": 108969,
    "name": "ЛЕВОМИЦЕТИН 500мг N10 таб.",
    "nameFull": "ЛЕВОМИЦЕТИН 500мг N10 таб.",
    "tmId": 1184,
    "pack": 0,
    "doseVal": 500,
    "doseId": 1,
    "rfId": 234,
    "ppId": 113,
    "psId": 114,
    "ptId": 0,
    "manCId": 0,
    "manId": 0,
    "actual": true,
    "gnvls": true,
    "vat": 10,
    "gpId": 1660,
    "aaId": 1754,
    "mnnId": 831,
    "aId": 30129,
    "speId": 2000000099,
    "catId": 2000000014,
    "dirId": 2,
    "megaId": 1,
    "ex": false,
    "stm": false,
    "rv": "AAAAAAALQaw="
  }
]

Имя	Тип	Описание
nnt	int	Уникальный код товара по справочнику АСНА
name	string	Cокращенное наименование товара по справочнику АСНА
nameFull	string	Полное наименование товара по справочнику АСНА
tmId	int	Код справочника торговых марок АСНА
pack	double	Фасовка
doseVal	double	Значение дозировки
doseId	int	Код справочника дозировок АСНА
rfId	int	Код справочника форм выпуска АСНА
ppId	int	Код первичной упаковки из справочника упаковок АСНА
psId	int	Код вторичной упаковки из справочника упаковок АСНА
ptId	int	Код третичной упаковки из справочника упаковок АСНА
manCId	int	Код страны производителя из справочника стран АСНА
manId	int	Код справочника производителей АСНА
actual	bool	Признак актуальности строки
gnvls	bool	Признак ЖНВЛС
vat	double	НДС
gpId	int	Код справочника групп АСНА
aaId	int	Код справочника областей применения АСНА
mnnId	int	Код справочника МНН АСНА
aId	int	Код справочника аналогов АСНА
speId	int	Код справочника СПЕ АСНА
catId	int	Код справочника категорий АСНА
dirId	int	Код справочника направлений АСНА
megaId	int	Код справочника мегакатегорий АСНА
ex	bool	Признак эксклюзива
stm	bool	Признак СТМ
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник номенклатуры денормализованный

Вы можете получать справочник номенклатуры АСНА, в нормализованном виде, через следующий вызов API. Дополнительные справочники, при необходимости, получаются отдельными вызовами API.

ВНИМАНИЕ!

Запрашивать справочник номенклатуры желательно не чаще одного раза в сутки. Из-за большого размера справочника, выдача ограничена 10000 записей за вызов. Для получения всего справочника используйте параметры count и rvInt при запросе.

GET /v5/references/goods_denormalized?count={count}&rvInt={rvInt}

Описание

Получить денормализованный справочник номенклатуры по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/goods_denormalized?count=2&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. Запрос к сервису авторизации прошел успешно, в теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "nnt": 108969,
    "name": "ЛЕВОМИЦЕТИН 500мг N10 таб.",
    "nameFull": "ЛЕВОМИЦЕТИН 500мг N10 таб.",
    "tm": "ЛЕВОМИЦЕТИН",
    "pack": 0,
    "doseVal": 500,
    "doseName": "мг",
    "rf": "таб.",
    "pp": "уп. контурн. яч.",
    "ps": "пач. картон.",
    "pt": null,
    "manC": null,
    "man": null,
    "actual": true,
    "gnvls": true,
    "vat": 10,
    "gp": "Лекарственные препараты",
    "aa": "Антибиотики",
    "mnnRus": "Хлорамфеникол*",
    "mm": null,
    "mc": "АНТИБИОТИКИ_ ЖКТ ТАБ/КАПС",
    "a": "ЛЕВОМИЦЕТИН 500МГ N10 ТАБ.",
    "brand": "Левомицетин",
    "spe": "АНТИБИОТИКИ",
    "cat": "АНТИБИОТИКИ И ПРОТИВОМИКРОБНЫЕ ,ПРОТИВОПАРАЗИТАРНЫЕ ПРЕПАРАТЫ",
    "dir": "ЛЕЧЕНИЕ И ПРОФИЛАКТИКА",
    "mega": "1. RX",
    "ex": false,
    "stm": false,
    "rv": "AAAAAAALQaI="
  },
  {
    "nnt": 8726906,
    "name": "БЕТАГИСТИН-СЗ 24мг N20 таб. Северная звезда",
    "nameFull": "БЕТАГИСТИН 24мг N20 таб. Северная звезда",
    "tm": "БЕТАГИСТИН-СЗ",
    "pack": 0,
    "doseVal": 24,
    "doseName": "мг",
    "rf": "таб.",
    "pp": "упак.",
    "ps": null,
    "pt": null,
    "manC": "Россия",
    "man": "Северная звезда",
    "actual": true,
    "gnvls": true,
    "vat": 10,
    "gp": "Лекарственные препараты",
    "aa": "Для улучшения мозгового кровообращения",
    "mnnRus": "Бетагистин*",
    "mm": null,
    "mc": "ГОЛОВОКРУЖЕНИЕ_БЕТАГИСТИН(МНН)",
    "a": "БЕТАГИСТИН 24МГ N20 ТАБ. СЕВЕРНАЯ ЗВЕЗДА",
    "brand": "Бетагистин-СЗ",
    "spe": "ПРИ НАРУШЕНИЯХ ВЕСТИБУЛЯРНОГО АППАРАТА",
    "cat": "НЕРВНАЯ СИСТЕМА",
    "dir": "ЛЕЧЕНИЕ И ПРОФИЛАКТИКА",
    "mega": "1. RX",
    "ex": false,
    "stm": false,
    "rv": "AAAAAAALQaQ="
  },
  {
    "nnt": 110092,
    "name": "ЭТАМЗИЛАТ 12,5% 2мл N10 р-р д/инъекций",
    "nameFull": "ЭТАМЗИЛАТ 12,5% 2мл N10 р-р д/инъекций",
    "tm": "ЭТАМЗИЛАТ",
    "pack": 0,
    "doseVal": 12.5,
    "doseName": "%",
    "rf": "р-р д/инъекций",
    "pp": "амп.",
    "ps": null,
    "pt": null,
    "manC": null,
    "man": null,
    "actual": true,
    "gnvls": true,
    "vat": 10,
    "gp": "Лекарственные препараты",
    "aa": "Кровоостанавливающие препараты",
    "mnnRus": "Этамзилат*",
    "mm": null,
    "mc": "КРОВООСТАНАВЛИВАЮЩИЕ_Д/ИНЪЕКЦИЙ_ЭТАМЗИЛАТ",
    "a": "ЭТАМЗИЛАТ 12,5% 2МЛ N10 Р-Р Д/ИНЪЕКЦИЙ",
    "brand": "Этамзилат",
    "spe": "КРОВООСТАНАВЛИВАЮЩИЕ",
    "cat": "КРОВЕТВОРЕНИЕ И КРОВЬ",
    "dir": "ЛЕЧЕНИЕ И ПРОФИЛАКТИКА",
    "mega": "1. RX",
    "ex": false,
    "stm": false,
    "rv": "AAAAAAALQag="
  }
]

Имя	Тип	Описание
nnt	int	Уникальный код товара по справочнику АСНА
name	string	Cокращенное наименование товара по справочнику АСНА
nameFull	string	Полное наименование товара по справочнику АСНА
tm	string	Торговая марка
pack	double	Фасовка
doseVal	double	Значение дозировки
doseName	string	Наименование дозировки
rf	string	Форма выпуска
pp	string	Первичная упаковка
ps	string	Вторичная упаковка
pt	string	Третичная упаковка
manC	string	Cтрана производителя
man	string	Производитель
actual	bool	Признак актуальности строки
gnvls	bool	Признак ЖНВЛС
vat	double	НДС
gp	string	Группа товаров
aa	string	Область применения
mnnRus	string	МНН
mm	string	Маркетинговый производитель
a	string	Аналог
spe	string	СПЕ
cat	string	Категория
dir	string	Направление
mega	string	Мегакатегория
ex	bool	Признак эксклюзива
stm	bool	Признак СТМ
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник связок номенклатуры

Работа с REST API АСНА происходит в кодах справочников АСНА. Для получения информации о связках номенклатуры вашей аптеки со справочником АСНА, можно использовать следующий вызов API.

ОГРАНИЧЕНИЕ

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

GET /v5/references/goods_links?names={false|true}

Описание

Получение справочника связок номенклатуры АСНА и аптеки по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
names	bool		Возвращать или нет наименования товаров по справочнику АСНА, по умолчанию false(не возвращать)

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/goods_links HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со связками.

Пример ответа

[
  {
    "nnt": 410819,
    "sku": "88900593"
  },
  {
    "nnt": 411915,
    "sku": "88898887"
  },
  {
    "nnt": 8706334,
    "sku": "88900761"
  },
  {
    "nnt": 8740302,
    "sku": "88903177"
  },
  {
    "nnt": 116063,
    "sku": "91824"
  },
  {
    "nnt": 115823,
    "sku": "91827"
  }
]

Имя	Тип	Описание
nnt	int	Уникальный код товара по справочнику АСНА
sku	string	Уникальный код товара по справочнику аптеки
name	string	Наименование товара по справочнику АСНА

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник торговых марок

Данный вызов API предназначен для получения справочника торговых марок АСНА.

GET /v5/references/trademarks?count={count}&rvInt={rvInt}

Описание

Получить справочник торговых марок по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/trademarks?count=2&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 49,
    "name": "ЛАНЗАП",
    "actual": true,
    "rv": "AAAAAAANY7Q="
  },
  {
    "id": 147,
    "name": "АЛТАЛЕКС",
    "actual": true,
    "rv": "AAAAAAANY7U="
  }
]

Имя	Тип	Описание
id	int	Уникальный код торговой марки по справочнику АСНА
name	string	Наименование торговой марки
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник дозировок

Данный вызов API предназначен для получения справочника дозировок АСНА.

GET /v5/references/dosages?count={count}&rvInt={rvInt}

Описание

Получить справочник дозировок по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/dosages?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 1,
    "name": "мг",
    "actual": true,
    "rv": "AAAAAAANxe0="
  },
  {
    "id": 2,
    "name": "ме",
    "actual": true,
    "rv": "AAAAAAANxe4="
  },
  {
    "id": 3,
    "name": "%",
    "actual": true,
    "rv": "AAAAAAANxe8="
  }
]

Имя	Тип	Описание
id	int	Уникальный код дозировки по справочнику АСНА
name	string	Наименование дозировки
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник форм выпуска

Данный вызов API предназначен для получения справочника форм выпуска АСНА.

GET /v5/references/release_forms?count={count}&rvInt={rvInt}

Описание

Получить справочник форм выпуска по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	ОБяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/release_forms?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 4,
    "name": "суппозитории",
    "actual": true,
    "rv": "AAAAAAANWyg="
  },
  {
    "id": 6,
    "name": "сироп",
    "actual": true,
    "rv": "AAAAAAANWyk="
  },
  {
    "id": 8,
    "name": "гель",
    "actual": true,
    "rv": "AAAAAAANWyo="
  }
]

Имя	Тип	Описание
id	int	Уникальный код формы выпуска по справочнику АСНА
name	string	Наименование формы выпуска
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник упаковок

Данный вызов API предназначен для получения справочника упаковок АСНА.

GET /v5/references/packagings?count={count}&rvInt={rvInt}

Описание

Получить справочник упаковок по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/packagings?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 13,
    "name": "амп.",
    "actual": true,
    "rv": "AAAAAAANxig="
  },
  {
    "id": 14,
    "name": "баллон",
    "actual": true,
    "rv": "AAAAAAANxik="
  },
  {
    "id": 15,
    "name": "банка",
    "actual": true,
    "rv": "AAAAAAANxio="
  }
]

Имя	Тип	Описание
id	int	Уникальный код упаковки по справочнику АСНА
name	string	Наименование упаковки
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник стран

Данный вызов API предназначен для получения справочника стран АСНА.

GET /v5/references/countries?count={count}&rvInt={rvInt}

Описание

Получить справочник стран по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/countries?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 1,
    "name": "Армения",
    "actual": true,
    "rv": "AAAAAAANx4I="
  },
  {
    "id": 2,
    "name": "Болгария",
    "actual": true,
    "rv": "AAAAAAANx4M="
  },
  {
    "id": 3,
    "name": "Венгрия",
    "actual": true,
    "rv": "AAAAAAANx4Q="
  }
]

Имя	Тип	Описание
id	int	Уникальный код страны по справочнику АСНА
name	string	Наименование страны
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник производителей

Данный вызов API предназначен для получения справочника производителей АСНА.

GET /v5/references/manufacturers?count={count}&rvInt={rvInt}

Описание

Получить справочник производителей по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/manufacturers?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 6,
    "name": "Agio Pharmaceuticals",
    "actual": true,
    "rv": "AAAAAAANx+0="
  },
  {
    "id": 7,
    "name": "Акос",
    "actual": true,
    "rv": "AAAAAAANx+4="
  },
  {
    "id": 8,
    "name": "Акрихин",
    "actual": true,
    "rv": "AAAAAAANx+8="
  }
]

Имя	Тип	Описание
id	int	Уникальный код производителя по справочнику АСНА
name	string	Наименование производителя
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник групп товаров

Данный вызов API предназначен для получения справочника групп товаров АСНА.

GET /v5/references/groups?count={count}&rvInt={rvInt}

Описание

Получить справочник групп товаров по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/groups?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 1613,
    "parentId": 0,
    "name": "ГРУППЫ ТОВАРА",
    "actual": true,
    "rv": "AAAAAAAN3ik="
  },
  {
    "id": 1660,
    "parentId": 0,
    "name": "Лекарственные препараты",
    "actual": true,
    "rv": "AAAAAAAN3io="
  },
  {
    "id": 1661,
    "parentId": 0,
    "name": "БАД",
    "actual": true,
    "rv": "AAAAAAAN3is="
  }
]

Имя	Тип	Описание
id	int	Уникальный код группы товара по справочнику АСНА
parentId	int	Уникальный код родительской группы товара по справочнику АСНА
name	string	Наименование группы товара
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник МНН

Данный вызов API предназначен для получения справочника МНН АСНА.

GET /v5/references/mnns?count={count}&rvInt={rvInt}

Описание

Получить справочник МНН по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/mnns?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 1,
    "rusName": "Дипивефрин*",
    "latName": "Dipivefrine*",
    "engName": "Dipivefrine*",
    "actual": true,
    "rv": "AAAAAAAN35s="
  },
  {
    "id": 2,
    "rusName": "Дактиномицин*",
    "latName": "Dactinomycin*",
    "engName": "Dactinomycin*",
    "actual": true,
    "rv": "AAAAAAAN35w="
  },
  {
    "id": 3,
    "rusName": "Тирозил-D-аланил-глицил-фенилаланил-лейцил-аргинина диацетат",
    "latName": "Tirosine-D-alanyl-glycil-phenylalanyl-leucyl-arginine diacetate",
    "engName": "Tirosine-D-alanyl-glycil-phenylalanyl-leucyl-arginine diacetate",
    "actual": true,
    "rv": "AAAAAAAN350="
  }
]

Имя	Тип	Описание
id	int	Уникальный код МНН по справочнику АСНА
rusName	string	Русское наименование МНН
latname	string	Латинское наименование МНН
engName	string	Английское наименование МНН
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник областей применения

Данный вызов API предназначен для получения справочника областей применения АСНА.

GET /v5/references/application_areas?count={count}&rvInt={rvInt}

Описание

Получить справочник групп товаров по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/application_areas?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 1612,
    "parentId": 0,
    "name": "ОБЛАСТЬ ПРИМЕНЕНИЯ",
    "actual": true,
    "rv": "AAAAAAAN3oY="
  },
  {
    "id": 1626,
    "parentId": 1612,
    "name": "Витамины",
    "actual": true,
    "rv": "AAAAAAAN3oc="
  },
  {
    "id": 1628,
    "parentId": 1612,
    "name": "От укачивания",
    "actual": true,
    "rv": "AAAAAAAN3og="
  }
]

Имя	Тип	Описание
id	int	Уникальный код области применения по справочнику АСНА
parentId	int	Уникальный код родительской области применения по справочнику АСНА
name	string	Наименование области применения
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник маркетинговых производителей

Данный вызов API предназначен для получения справочника маркетинговых производителей АСНА.

GET /v5/references/marketing_manufacturers?count={count}&rvInt={rvInt}

Описание

Получить справочник маркетинговых производителей по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/marketing_manufacturers?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 1,
    "name": "Авангард",
    "actual": true,
    "rv": "AAAAAAH6j38="
  },
  {
    "id": 2,
    "name": "Аспен",
    "actual": true,
    "rv": "AAAAAAAPae0="
  },
  {
    "id": 3,
    "name": "Вокхард",
    "actual": true,
    "rv": "AAAAAAAPae4="
  }
]

Имя	Тип	Описание
id	int	Уникальный код маркетингового производителя по справочнику АСНА
name	string	Наименование маркетингового производителя
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник аналогов

Данный вызов API предназначен для получения справочника маркетинговых производителей АСНА.

GET /v5/references/analogs?count={count}&rvInt={rvInt}

Описание

Получить справочник аналогов по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/analogs?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 28,
    "name": "ЗИНГЕР КЛИППЕР LP-L16-2020 (SLN-602-MAT) ZINGER",
    "clusterId": 0,
    "actual": true,
    "rv": "AAAAAAAN/Hw="
  },
  {
    "id": 30,
    "name": "ЗИНГЕР КЛИППЕР ZO-NA-02-C БОКОВОЙ (СКОШЕННЫЙ) ZINGER",
    "clusterId": 0,
    "actual": true,
    "rv": "AAAAAAAN/H4="
  },
  {
    "id": 46,
    "name": "ЗОЛИНГЕН YES 96650 КНИПСЕР Д/НОГТЕЙ В БЛИСТЯЩЕЙ УПАКОВКЕ",
    "clusterId": 0,
    "actual": true,
    "rv": "AAAAAAAN/H0="
  }
]

Имя	Тип	Описание
id	int	Уникальный код аналога по справочнику АСНА
name	string	Наименование аналога
clusterId	int	Уникальный код кластера
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник категорий

Данный вызов API предназначен для получения справочника категорий АСНА.

GET /v5/references/categories?count={count}&rvInt={rvInt}

Описание

Получить справочник категорий по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/categories?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 2000000000,
    "name": "АКСЕССУАРЫ ДЛЯ МАНИКЮРА И ПЕДИКЮРА",
    "dirId": 1,
    "actual": true,
    "rv": "AAAAAAAPu+w="
  },
  {
    "id": 2000000001,
    "name": "ГИГИЕНА",
    "dirId": 1,
    "actual": true,
    "rv": "AAAAAAAPu+0="
  },
  {
    "id": 2000000002,
    "name": "ДЕКОРАТИВНАЯ КОСМЕТИКА, АКСЕССУАРЫ ДЛЯ МАКИЯЖА",
    "dirId": 1,
    "actual": true,
    "rv": "AAAAAAAPu+4="
  }
]

Имя	Тип	Описание
id	int	Уникальный код категории по справочнику АСНА
name	string	Наименование категории
dirId	int	Уникальный код направления
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник направлений

Данный вызов API предназначен для получения справочника направлений АСНА.

GET /v5/references/directions?count={count}&rvInt={rvInt}

Описание

Получить справочник направлений по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/directions?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 1,
    "name": "КОСМЕТИКА И ГИГИЕНА",
    "actual": true,
    "rv": "AAAAAAANWxU="
  },
  {
    "id": 2,
    "name": "ЛЕЧЕНИЕ И ПРОФИЛАКТИКА",
    "actual": true,
    "rv": "AAAAAAANWxY="
  },
  {
    "id": 3,
    "name": "МАМА И МАЛЫШ",
    "actual": true,
    "rv": "AAAAAAANWxc="
  }
]

Имя	Тип	Описание
id	int	Уникальный код направления по справочнику АСНА
name	string	Наименование направления
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник мегакатегорий

Данный вызов API предназначен для получения справочника мегакатегорий АСНА.

GET /v5/references/megacategories?count={count}&rvInt={rvInt}

Описание

Получить справочник мегакатегорий по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/megacategories?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 1,
    "name": "1. RX",
    "actual": true,
    "rv": "AAAAAAANWxA="
  },
  {
    "id": 2,
    "name": "2. OTC",
    "actual": true,
    "rv": "AAAAAAANWxE="
  },
  {
    "id": 3,
    "name": "3. Trade Goods",
    "actual": true,
    "rv": "AAAAAAANWxI="
  }
]

Имя	Тип	Описание
id	int	Уникальный код мегакатегории по справочнику АСНА
name	string	Наименование мегакатегории
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник СПЕ

Данный вызов API предназначен для получения справочника СПЕ(стратегических плановых единиц) АСНА.

GET /v5/references/spes?count={count}&rvInt={rvInt}

Описание

Получить справочник СПЕ по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/spes?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 2000000000,
    "name": "БАФ ДЛЯ МАНИКЮРА",
    "catId": 2000000000,
    "actual": false,
    "rv": "AAAAAAAPueM="
  },
  {
    "id": 2000000001,
    "name": "ВАННОЧКИ ДЛЯ МАНИКЮРА И ПЕДИКЮРА",
    "catId": 2000000000,
    "actual": false,
    "rv": "AAAAAAAPueQ="
  },
  {
    "id": 2000000002,
    "name": "КИСТИ ДЛЯ МАНИКЮРА",
    "catId": 2000000000,
    "actual": false,
    "rv": "AAAAAAAPueU="
  }
]

Имя	Тип	Описание
id	int	Уникальный код СПЕ по справочнику АСНА
name	string	Наименование СПЕ
actual	bool	Признак актуальности строки
catId	int	Уникальный код категории
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник маркетинговых кластеров

Данный вызов API предназначен для получения справочника маркетинговых кластеров АСНА.

GET /v5/references/marketing_clusters?count={count}&rvInt={rvInt}

Описание

Получить справочник маркетинговых кластеров по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/marketing_clusters?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 1,
    "name": "АНТ_Новокаин_амп 2%",
    "actual": true,
    "rv": "AAAAAAAPy+g="
  },
  {
    "id": 2,
    "name": "АНКС_Фенибут",
    "actual": true,
    "rv": "AAAAAAAPy+k="
  },
  {
    "id": 3,
    "name": "АНТИДЕП_ПАРОКСЕТИН",
    "actual": true,
    "rv": "AAAAAAAPy+o="
  }
]

Имя	Тип	Описание
id	int	Уникальный код маркетингового кластера по справочнику АСНА
name	string	Наименование маркетингового кластера
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник маркетинговых брендов

Данный вызов API предназначен для получения справочника маркетинговых брендов АСНА.

GET /v5/references/marketing_brands?count={count}&rvInt={rvInt}

Описание

Получить справочник маркетинговых брендов по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/marketing_brands?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 46,
    "name": "Горец птичий",
    "isAsna": false,
    "actual": true,
    "rv": "AAAAAAAPjlg="
  },
  {
    "id": 63,
    "name": "Здоровые почки",
    "isAsna": false,
    "actual": true,
    "rv": "AAAAAAAPjlk="
  },
  {
    "id": 148,
    "name": "СБОР Жизнедар",
    "isAsna": false,
    "actual": true,
    "rv": "AAAAAAAPjlo="
  }
]

Имя	Тип	Описание
id	int	Уникальный код маркетингового бренда по справочнику АСНА
name	string	Наименование маркетингового бренда
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник связей кластер-бренд-товар

Данный вызов API предназначен для получения справочника связей кластер-бренд-товар АСНА.

GET /v5/references/cluster_brand_product_links?count={count}&rvInt={rvInt}

Описание

Получить справочник связей кластер-бренд-товар по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/cluster_brand_product_links?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "mcId": 1288,
    "nnt": 8606702,
    "brandId": 10680,
    "actual": true,
    "rv": "AAAAAAH/ja8="
  },
  {
    "mcId": 1267,
    "nnt": 8728458,
    "brandId": 3526,
    "actual": true,
    "rv": "AAAAAAH/jbA="
  },
  {
    "mcId": 1290,
    "nnt": 405964,
    "brandId": 2985,
    "actual": true,
    "rv": "AAAAAAH/jbE="
  }
]

Имя	Тип	Описание
mcId	int	Уникальный код маркетингового кластера по справочнику АСНА
nnt	int	Уникальный код товара
brandId	int	Уникальный код маркетингового бренда
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник связей товар - маркетинговый производитель

Данный вызов API предназначен для получения справочника связей товар - маркетинговый производитель АСНА.

GET /v5/references/product_marketing_manufacturer_links?count={count}&rvInt={rvInt}

Описание

Получить справочник связей товар - маркетинговый производитель по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/product_marketing_manufacturer_links?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 2,
    "mmId": 246,
    "actual": true,
    "nnt": 109374,
    "rv": "AAAAAAHjBLU="
  },
  {
    "id": 3,
    "mmId": 249,
    "actual": true,
    "nnt": 112279,
    "rv": "AAAAAAHjBLY="
  },
  {
    "id": 5,
    "mmId": 360,
    "actual": true,
    "nnt": 109862,
    "rv": "AAAAAAHjBLg="
  }
]

Имя	Тип	Описание
id	int	Уникальный код связи товар - маркетинговый производитель по справочнику АСНА
mmId	int	Уникальный код маркетингового производителя
actual	bool	Признак актуальности строки
nnt	int	Уникальный код товара
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник связей маркетинговый производитель - поставщик

Данный вызов API предназначен для получения справочника связей маркетинговый производитель-поставщик АСНА.

GET /v5/references/marketing_manufacturer_supplier_links?count={count}&rvInt={rvInt}

Описание

Получить справочник связей маркетинговый производитель - поставщик по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 10000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/marketing_manufacturer_supplier_links?count=3&rv=AAAAAAALQag= HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "id": 35178,
    "mmId": 3,
    "inn": "1660169622",
    "begDate": "2019-07-01T00:00:00+00:00",
    "endDate": "2019-09-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAAIwWnI="
  },
  {
    "id": 35179,
    "mmId": 3,
    "inn": "2130174989",
    "begDate": "2019-07-01T00:00:00+00:00",
    "endDate": "2019-09-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAAIwWnM="
  },
  {
    "id": 35180,
    "mmId": 3,
    "inn": "2308169476",
    "begDate": "2019-07-01T00:00:00+00:00",
    "endDate": "2019-09-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAAIwWnQ="
  }
]

Имя	Тип	Описание
id	int	Уникальный код связи маркетинговый производитель - поставщик по справочнику АСНА
mmId	int	Уникальный код маркетингового производителя
inn	string	ИНН поставщика
begDate	datetime	Дата начала действия. В формате ISO8601 с указанием часового пояса
endDate	datetime	Дата окончания действия. В формате ISO8601 с указанием часового пояса
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Справочник штрих-кодов производителя

Данный вызов API предназначен для получения справочника штрих-кодов производителя

GET /v5/references/barcodes?count={count}&rvInt={rvInt}&actual={actual}

Описание

Получить справочник штрих-кодов по протоколу версии 5, count записей, начиная с версии rvInt

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.
actual	bool		Возвращать только актуальные записи, если параметр выставлен в true, иначе все. По умолчанию false. Если параметр выставлен в true, не забывайте предварительно зачищать свои таблицы.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/barcodes?count=3&rvInt=99281423 HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP	cтатус Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "nnt": 505447,
    "barcode": "0300652144672",
    "actual": true,
    "rvInt": 99281424
  },
  {
    "nnt": 8700225,
    "barcode": "1013929306022",
    "actual": true,
    "rvInt": 99281425
  },
  {
    "nnt": 8701212,
    "barcode": "1077642104730",
    "actual": true,
    "rvInt": 99281427
  }
]

Имя	Тип	Описание
nnt	int	Код товара по справочнику АСНА
barcode	string	Штрих-код производителя
actual	bool	Признак актуальности строки
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Остатки товаров

Передача остатков в АСНА

Передача остатков в АСНА осуществляется следующими методами:

1. Передача информации о полных остатках
2. Передача изменений

Передача полных остатков аптеки

Ежедневно, желательно в период наименьшей загруженности сервисов, интегрированное с АСНА программное обеспечение должно отправлять полные сведения о наличии товаров в каждой аптеке. Выгрузка полных сведений об остатках должна производиться не чаще одного раза в сутки. Так как объем передаваемой информации о полных остатках большой, пакет не обрабатывается сразу, а ставится в очередь на обработку.

ОГРАНИЧЕНИЕ

Передача полных остатков ограничена одним запросом в 30 минут, но отправлять полные остатки чаще чем раз в сутки нет необходимости. Желательно отправлять полные остатки в период с 05:15 до 08:45 по московскому времени.

ВНИМАНИЕ

Перед обработкой полных остатков и записью их в БД, сервис произведет удаление всех остатков в БД по этой аптеке.

POST /v5/stores/{storeId}/stocks

Описание

Передать полные остатки по аптеке storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Тело запроса

Объект запроса

Имя	Тип	Обяз.	Описание
date	datetime		Дата выгрузки остатков в формате ISO8601 с указанием часового пояса
stocks	Stock[]		Массив строк остатков

Объект запроса Stock (строка остатков)

Имя	Тип	Обяз.	Описание
prtId	string(50)		Уникальный код партии, должен быть уникальным в пределах отправляемого пакета, т.к. это ключ, по которому происходит, обновление записей. Максимум 50 символов.
nnt	int		Код товара по справочнику АСНА
sku	string(50)		Код товара по справочнику клиента. Максимум 50 символов.
qnt	float		Текущее количество в партии (с учетом забронированного товара). Не передавать дробное количество.
doc	string(50)		Номер документа. Максимум 50 символов.
supInn	string		ИНН поставщика
supId	GUID		Идентификатор поставщика по справочнику АСНА
supDate	datetime		Дата поставки в формате ISO8601 с указанием часового пояса
nds	int		НДС товара. Все расчеты идут по ставкам НДС из справочника номенклатуры АСНА
gnvls	bool		Признак ЖНВЛС товара (поле обязательно для ЖНВЛС). Если ПО самостоятельно не контролирует максимально допустимые цены ЖНВЛС, то поле обязательно
dp	bool		Признак Детское питание
man	string(255)		Производитель. Максимум 255 символов
series	string(50)		Cерия товара. Максимум 50 символов
exp	datetime		Cрок годности в формате ISO8601. Поле не является обязательным, т.к. не у всех товаров есть срок годности, но если у товара есть срок, убедительная просьба его заполнять. Покупатели хотят видеть срок на сайте. Для сервиса Контроль сроков годности поле обязательно.
prcMan	decimal		Цена производителя
prcOpt	decimal		Цена оптовая
prcOptNds	decimal		Цена оптовая (закупочная) с НДС. Для сервисов Подмена аптечных цен, Асна Экономия поле обязательно
prcRet	decimal		Цена реализации
prcReestr	decimal		Цена реестра
prcGnvlsMax	decimal		Максимально допустимая розничная цена для ЖНВЛС (поле обязательно для ЖНВЛС). Если товар не ЖНВЛС, то это поле заполнять не нужно, если товар ЖНВЛС и включен расчет цен, то поле обязательно заполняется значением, и оно не может быть меньше розничной цены аптеки. Если ПО самостоятельно не контролирует максимально допустимые цены ЖНВЛС, то поле обязательно
sumOpt	decimal		Cумма оптовая без НДС
sumOptNds	decimal		Cумма оптовая с НДС
mrGnvls	decimal		Процент наценки для ЖВЛНС
tag	int		Признак товара. Может принимать значения: 0 - нормальный, 1- сроковый, 2 - уценка, 3 - мятая упаковка

Ссылка на JSON схему для валидации и тестирования

Пример запроса

POST /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/stocks HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache

{
"date": "2017-04-25T01:29:20.4520214+00:00",
"stocks": [
    {
    "prtId": "fb851e60-b472-4e8f-ba1e-bcbe3df3cf1c",
    "nnt": 14404,
    "sku": "028091",
    "qnt": 5,
    "doc": "№916483",
    "supInn": "2804850309",
    "supId": "cd315d09-4f76-4e31-b869-6a62d85289a1",
    "supDate": "2017-04-20T02:29:31.104986+00:00",
    "nds": 10,
    "gnvls": false,
    "dp": true,
    "man": "Metz - Beer",
    "series": "pbepvhu6xpuj",
    "exp": "2020-01-07T00:00:00+00:00",
    "prcMan": 242.12,
    "prcOpt": 293.6,
    "prcOptNds": 304.72,
    "prcRet": 388.99,
    "prcReestr": 483.22,
    "prcGnvlsMax": 483.22,
    "sumOpt": 1385.09,
    "sumOptNds": 1523.6,
    "mrGnvls": 8.81,
    "tag": 2
    },
    {
    "prtId": "d4340309-c32c-4215-935e-de028a691eff",
    "nnt": 42692,
    "sku": "585703",
    "qnt": 2,
    "doc": "№620730",
    "supInn": "9145332298",
    "supId": "853e47f1-ade0-44e8-a7be-60ede795f7a5",
    "supDate": "2017-04-15T15:30:59.9716512+00:00",
    "nds": 20,
    "gnvls": true,
    "dp": false,
    "man": "O'Connell Inc",
    "series": "8b1l4itzs5pl",
    "exp": "2020-08-27T00:00:00+00:00",
    "prcMan": 668.3,
    "prcOpt": 743.57,
    "prcOptNds": 760.07,
    "prcRet": 972.67,
    "prcReestr": 1134.28,
    "prcGnvlsMax": 1134.28,
    "sumOpt": 1288.25,
    "sumOptNds": 1520.14,
    "mrGnvls": 10.19,
    "tag": 1
    }
 ]
}

Успешный ответ

HTTP cтатус	Значение
202	Accepted. Принято к обработке. В заголовке Location содержится URL для получения статуса обработки переданного пакета.

Пример ответа

HTTP/1.1 202 Accepted
Vary: Accept
Location: https://api.asna.cloud/v5/messages/09006a8b-826d-48a0-91ad-f4d05a454b56/status

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Передача изменений по остаткам аптеки

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

ОГРАНИЧЕНИЕ

Передача изменений остатков ограничена одним запросом в 10 минут.

ВНИМАНИЕ!

Если товар по партии закончился, то необходимо передать эту запись с количеством равным нулю.

ИНФОРМАЦИЯ

Перед обработкой изменений по остаткам аптеки и записью их в БД, сервис не будет производить удаление всех остатков в БД по этой аптеке. Будет произведена операция upsert (update для уже имеющихся в БД строк и insert для отсутствующих).

PUT /v5/stores/{storeId}/stocks

Описание

Передать изменения по остаткам аптеки storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Тело запроса

Объект запроса

Имя	Тип	Обяз.	Описание
date	datetime		Дата выгрузки остатков в формате ISO8601 с указанием вашего часового пояса
stocks	Stock[]		Массив строк остатков

Объект запроса Stock (строка остатков)

Имя	Тип	Обяз.	Описание
prtId	string		Уникальный код партии, должен быть уникальным в пределах отправляемого пакета, т.к. это ключ, по которому происходит, обновление записей. Максимум 50 символов.
nnt	int		Код товара по справочнику АСНА
sku	string		Код товара по справочнику клиента. Максимум 50 символов.
qnt	float		Текущее количество в партии (с учетом забронированного товара). Не передавать дробное количество.
doc	string		Номер документа. Максимум 50 символов.
supInn	string		ИНН поставщика
supId	GUID		Идентификатор поставщика по справочнику АСНА
supDate	datetime		Дата поставки в формате ISO8601 с указанием часового пояса
nds	int		НДС товара. Все расчеты идут по ставкам НДС из справочника номенклатуры АСНА
gnvls	bool		Признак ЖНВЛС товара (поле обязательно для ЖНВЛС). Если ПО самостоятельно не контролирует максимально допустимые цены ЖНВЛС то поле обязательно
dp	bool		Признак Детское питание
man	string		Производитель. Максимум 255 символов
series	string		Cерия товара. Максимум 50 символов
exp	datetime		Cрок годности в формате ISO8601. Поле не является обязательным, т.к. не у всех товаров есть срок годности, но если у товара есть срок, убедительная просьба его заполнять. Покупатели хотят видеть срок на сайте. Для сервиса Контроль сроков годности поле обязательно
prcMan	decimal		Цена производителя
prcOpt	decimal		Цена оптовая
prcOptNds	decimal		Цена оптовая (закупочная) с НДС. Для сервисов Подмена аптечных цен, Асна Экономия поле обязательно
prcRet	decimal		Цена реализации
prcReestr	decimal		Цена реестра
prcGnvlsMax	decimal		Максимально допустимая розничная цена для ЖНВЛС (поле обязательно для ЖНВЛС). Если товар не ЖНВЛС, то это поле заполнять не нужно, если товар ЖНВЛС и включен расчет цен, то поле обязательно заполняется значением, и оно не может быть меньше розничной цены аптеки. Если ПО самостоятельно не контролирует максимально допустимые цены ЖНВЛС то поле обязательно
sumOpt	decimal		Cумма оптовая без НДС
sumOptNds	decimal		Cумма оптовая с НДС
mrGnvls	decimal		Процент наценки для ЖВЛНС
tag	int		Признак товара. Может принимать значения: 0 - нормальный, 1- сроковый, 2 - уценка, 3 - мятая упаковка

Ссылка на JSON схему для валидации и тестирования

Пример запроса

PUT /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/stocks HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache

{
   "date":"2017-04-25T01:29:20.4520214+00:00",
   "stocks":[
      {
         "prtId":"fb851e60-b472-4e8f-ba1e-bcbe3df3cf1c",
         "nnt":14404,
         "sku":"028091",
         "qnt":5,
         "doc":"№916483",
         "supInn":"2804850309",
         "supId":"cd315d09-4f76-4e31-b869-6a62d85289a1",
         "supDate":"2017-04-20T02:29:31.104986+00:00",
         "nds":10,
         "gnvls":false,
         "dp":true,
         "man":"Metz - Beer",
         "series":"pbepvhu6xpuj",
         "exp":"2020-01-07T00:00:00+00:00",
         "prcMan":242.12,
         "prcOpt":293.6,
         "prcOptNds":304.72,
         "prcRet":388.99,
         "prcReestr":483.22,
         "prcGnvlsMax":483.22,
         "sumOpt":1385.09,
         "sumOptNds":1523.6,
         "mrGnvls":8.81,
         "tag":2
      },
      {
         "prtId":"d4340309-c32c-4215-935e-de028a691eff",
         "nnt":42692,
         "sku":"585703",
         "qnt":2,
         "doc":"№620730",
         "supInn":"9145332298",
         "supId":"853e47f1-ade0-44e8-a7be-60ede795f7a5",
         "supDate":"2017-04-15T15:30:59.9716512+00:00",
         "nds":20,
         "gnvls":true,
         "dp":false,
         "man":"O'Connell Inc",
         "series":"8b1l4itzs5pl",
         "exp":"2020-08-27T00:00:00+00:00",
         "prcMan":668.3,
         "prcOpt":743.57,
         "prcOptNds":760.07,
         "prcRet":972.67,
         "prcReestr":1134.28,
         "prcGnvlsMax":1134.28,
         "sumOpt":1288.25,
         "sumOptNds":1520.14,
         "mrGnvls":10.19,
         "tag":1
      }
   ]
}

Успешный ответ

HTTP cтатус	Значение
202	Accepted. Принято к обработке. В заголовке Location содержится URL для получения статуса обработки переданного пакета.

Пример ответа

HTTP/1.1 202 Accepted
Vary: Accept
Location: https://api.asna.cloud/v5/messages/09006a8b-826d-48a0-91ad-f4d05a454b56/status

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Удаление информации по остаткам аптеки

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

ВНИМАНИЕ!

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

DELETE /v5/stores/{storeId}/stocks

Описание

Удалить информацию по остаткам аптеки storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА

Заголовки запроса

Имя	Описание
Authorization	Bearer token

Пример запроса

DELETE /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/stocks HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw

Успешный ответ

HTTP cтатус	Значение
204	No Content. Данные удалены

Пример ответа

HTTP/1.1 204 No Content

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Получение информации по остаткам аптеки

Для периодической проверки остатков, переданных в АСНА, вы можете получить данные по остаткам аптеки, используя следующий запрос:

GET /v5/stores/{storeId}/stocks

Описание

Передать изменения по остаткам аптеки storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА
since	datetime		Дата/время в формате ISO8601, с которой необходимо получить остатки

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/stocks?since=2017-04-20T02:29:31.104986%2B00:00 HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw

Успешный ответ

HTTP cтатус	Значение
200	ОК. Успешный запрос. Тело запроса содержит массив остатков

Пример ответа

[
  {
    "realNetId": 10000211,
    "storeId": "BC164E55-B612-4A04-800B-34CCF10F6858",
    "nnt": 14404,
    "sku": "028091",
    "qnt": 5,
    "doc": "№916483",
    "supInn": "2804850309",
    "supId": "cd315d09-4f76-4e31-b869-6a62d85289a1",
    "supDate": "2017-04-20T02:29:31.103+00:00",
    "nds": 10,
    "gnvls": false,
    "dp": true,
    "man": "Metz - Beer",
    "series": "pbepvhu6xpuj",
    "exp": "2020-01-07T00:00:00+00:00",
    "prcMan": 242.12,
    "prcOpt": 293.6,
    "prcOptNds": 304.72,
    "prcRet": 388.99,
    "prcReestr": 483.22,
    "prcGnvlsMax": 483.22,
    "sumOpt": 1468,
    "sumOptNds": 1523.6,
    "mrGnvls": 8.81,
    "tag": 2,
    "stkDate": "2017-04-25T01:29:20.4520214+00:00",
    "loadDate": "2017-04-26T15:34:04.28+00:00",
    "rv": "AAAAAAAAB+Y="
  },
  {
    "realNetId": 10000211,
    "storeId": "BC164E55-B612-4A04-800B-34CCF10F6858",
    "nnt": 42692,
    "sku": "585703",
    "qnt": 2,
    "doc": "№620730",
    "supInn": "9145332298",
    "supId": "853e47f1-ade0-44e8-a7be-60ede795f7a5",
    "supDate": "2017-04-15T15:30:59.97+00:00",
    "nds": 20,
    "gnvls": true,
    "dp": false,
    "man": "O'Connell Inc",
    "series": "8b1l4itzs5pl",
    "exp": "2020-08-27T00:00:00+00:00",
    "prcMan": 668.3,
    "prcOpt": 743.57,
    "prcOptNds": 760.07,
    "prcRet": 972.67,
    "prcReestr": 1134.28,
    "prcGnvlsMax": 1134.28,
    "sumOpt": 1487.14,
    "sumOptNds": 1520.14,
    "mrGnvls": 10.19,
    "tag": 1,
    "stkDate": "2017-04-25T01:29:20.4520214+00:00",
    "loadDate": "2017-04-26T15:34:04.28+00:00",
    "rv": "AAAAAAAAB+c="
  }
]

Объект ответа (строка остатков)

Имя	Тип	Описание
realNetId	int	Идентификатор сети
storeId	GUID	Идентификатор аптеки по справочнику АСНА
prtId	string	Уникальный код партии, должен быть уникальным в пределах отправляемого пакета, т.к. это ключ, по которому происходит, обновление записей. Максимум 50 символов.
nnt	int	Код товара по справочнику АСНА
sku	string	Код товара по справочнику клиента. Максимум 50 символов.
qnt	float	Текущее количество в партии (с учетом забронированного товара)
doc	string	Номер документа. Максимум 50 символов.
supInn	string	ИНН поставщика
supId	GUID	Идентификатор поставщика по справочнику АСНА
supDate	datetime	Дата поставки в формате ISO8601 с указанием часового пояса
nds	int	НДС товара
gnvls	bool	Признак ЖНВЛС товара (поле обязательно для ЖНВЛС)
dp	bool	Признак Детское питание
man	string	Производитель. Максимум 255 символов
series	string	Cерия товара. Максимум 50 символов
exp	datetime	Cрок годности в формате ISO8601. Поле не является обязательным, т.к. не у всех товаров есть срок годности, но если у товара есть срок, убедительная просьба его заполнять. Покупатели хотят видеть срок на сайте
prcMan	decimal	Цена производителя
prcOpt	decimal	Цена оптовая
prcOptNds	decimal	Цена оптовая (закупочная) с НДС
prcRet	decimal	Цена реализации
prcReestr	decimal	Цена реестра
prcGnvlsMax	decimal	Максимально допустимая розничная цена для ЖНВЛС (поле обязательно для ЖНВЛС). Если товар не ЖНВЛС, то это поле заполнять не нужно, если товар ЖНВЛС и включен расчет цен, то поле обязательно заполняется значением, и оно не может быть меньше розничной цены аптеки
sumOpt	decimal	Cумма оптовая без НДС
sumOptNds	decimal	Cумма оптовая с НДС
mrGnvls	decimal	Процент наценки для ЖВЛНС
tag	int	Признак товара. Может принимать значения: 0 - нормальный, 1- сроковый, 2 - уценка, 3 - мятая упаковка
stkDate	datetime	Дата остатков в формате ISO8601 с указанием часового пояса
loadDate	datetime	Дата загрузки остатков в формате ISO8601 с указанием часового пояса
rv	byte[]	Версия записи

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Фильтрация остатков

Для исключения попадания на сайт товаров с некорректными(слишком низкими) ценами, которые, как правило, получаются из-за некорректных привязок справочника товаров аптеки и справочника товаров АСНА, мы фильтруем такие товары.

Если вы подписаны на рассылку мониторинга, то ежедневно вы будете получать уведомления по электронной почте с вложенной инструкцией, если нет то вы можете перейти на веб-интерфейс фильтра по ссылке http://api.asna.cloud/dispersion?storeId={storeId}, где storeId - идентификатор вашей аптеки.

Инструкция по работе с веб-интерфейсом фильтра встроена в веб-интефейс.

Сводный прайс-лист (предзаказ)

Сводный прайс-лист - это прайс-лист, сформированный из прайс-листов всех поставщиков аптеки, где по каждой номенклатуре выбирается только один поставщик, с наиболее выгодной для аптеке ценой. Исходя из этого, сводный прайс-лист должен содержать в себе только строки с уникальными (не повторяющимися в пределах прайс-листа) кодами номенклатуры (nnt).

Передача сводных прайс-листов в АСНА

Передача сводных прайс-листов в АСНА осуществляется следующими методами:

1. Передача полного сводного прайс-листа
2. Передача изменений по сводному прайс-листу

Передача полного сводного прайс-листа юридического лица

Ежедневно, желательно в период наименьшей загруженности сервисов, интегрированное с АСНА программное обеспечение должно отправлять полный сводный прайс-лист по каждому юридическому лицу. Выгрузка полного сводного прайс-листа должна производиться не чаще одного раза в сутки. Так как объем передаваемой информации большой, она не обрабатывается сразу, а ставится в очередь на обработку.

ВНИМАНИЕ!

Перед обработкой полного прайс-листа и записью его в БД, сервис произведет удаление сводного прайс-листа в БД по этому юрлицу.

POST /v5/legal_entities/{storeId}/preorders

Описание

Передать полный сводный прайс-лист по юрлицу аптеки storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА. По нему мы определяем юридическое лицо.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Тело запроса

Объект запроса

Имя	Тип	Обяз.	Описание
date	datetime		Дата выгрузки полного прайс-листа в формате ISO8601 с указанием часового пояса
preorders	Preorder[]		Массив строк полного прайс-листа

Объект запроса Preorder(строка прайс-листа)

Имя	Тип	Обяз.	Описание
nnt	int		Код товара по справочнику АСНА
sku	string(50)		Код товара по справочнику клиента. Максимум 50 символов.
qnt	float		Количество товара
supInn	string		ИНН поставщика. Обязательно, если хотите получать ИНН в строках заказа с asna.ru
supDate	datetime		Дата поставки в формате ISO8601 с указанием часового пояса
exp	datetime		Cрок годности в формате ISO8601. Поле не является обязательным, т.к. не у всех товаров есть срок годности, но если у товара есть срок, убедительная просьба его заполнять. Покупатели хотят видеть срок на сайте. Для сервиса Контроль сроков годности поле обязательно
prcOptNds	decimal		Цена оптовая (закупочная) с НДС. Обязательно, если не передается Цена реализации
prcRet	decimal		Цена реализации. Обязательно, если не передается Цена оптовая (закупочная) с НДС
prcGnvlsMax	decimal		Максимально допустимая розничная цена для ЖНВЛС (поле обязательно для ЖНВЛС). Если эта цена не указана, то АСНА не будет контролировать превышение наценки на ЖНВЛС при расчете розничной цены. В этом случае ПО должно делать это самостоятельно. Если ПО самостоятельно не контролирует максимально допустимые цены ЖНВЛС то поле обязательно
prclDate	datetime		Дата прайс-листа в формате ISO8601 с указанием часового пояса
plType	int		Тип прайслиста, 0 - для юрлица, 1 - для хаба, 2 - для аптеки
status	int		Признак активной или удаленной строки (0 - активная, 1 - удаленная). В полном прайс-листе всегда 0, т.к. в нем должны быть только активные строки

Ссылка на JSON схему для валидации и тестирования

Пример запроса

POST /v5/legal_entities/BC164E55-B612-4A04-800B-34CCF10F6858/preorders HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

{
    "date": "2017-06-22T00:21:12.1788669+00:00",
    "preorders": [
        {
            "nnt": 65192,
            "sku": "840883",
            "supInn": "3769761555",
            "prcOptNds": 21.27,
            "prcGnvlsMax": 25.37,
            "status": 0,
            "exp": "2020-11-14T09:32:32.437353+00:00",
            "supDate": "2017-06-24T20:26:37.0825228+00:00",
            "prclDate": "2017-06-21T14:43:56.604495+00:00",
            "plType": 0
        },
        {
            "nnt": 78713,
            "sku": "045998",
            "supInn": "7444215734",
            "prcOptNds": 489.06,
            "prcGnvlsMax": 614.44,
            "status": 0,
            "exp": "2018-11-22T15:37:11.8230938+00:00",
            "supDate": "2017-06-24T20:43:40.4941116+00:00",
            "prclDate": "2017-06-21T14:12:31.2273135+00:00",
            "plType": 1
        },
        {
            "nnt": 10990,
            "sku": "090794",
            "supInn": "2671494234",
            "prcOptNds": 852.67,
            "prcGnvlsMax": 1089.3,
            "status": 0,
            "exp": "2020-04-13T21:00:34.6708683+00:00",
            "supDate": "2017-06-23T10:23:07.3306094+00:00",
            "prclDate": "2017-06-20T17:53:03.778358+00:00",
            "plType": 0
        }
    ]
}

Успешный ответ

HTTP cтатус	Значение
202	Accepted. Принято к обработке. В заголовке Location содержится URL для получения статуса обработки переданного пакета.

Пример ответа

HTTP/1.1 202 Accepted
Vary: Accept
Location: https://api.asna.cloud/v5/messages/09006a8b-826d-48a0-91ad-f4d05a454b56/status

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Передача изменений по сводному прайс-листу юридического лица

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

ВНИМАНИЕ!

Если товар был удален из сводного прайс-листа, то необходимо передать эту запись со статусом равным 1.

ИНФОРМАЦИЯ

Перед обработкой изменений по сводному прайс-листу юрлица и записью их в БД, сервис не будет производить удаление сводного прайс-листа в БД по этому юрлицу. Будет произведена операция upsert (update для уже имеющихся в БД строк и insert для отсутствующих).

PUT /v5/legal_entities/{storeId}/preorders

Описание

Передать изменения по сводному прайс-листу юрлица аптеки storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА. По нему мы определяем юридическое лицо.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Тело запроса

Объект запроса

Имя	Тип	Обяз.	Описание
date	datetime		Дата выгрузки полного прайс-листа в формате ISO8601 с указанием часового пояса
preorders	Preorder[]		Массив строк полного прайс-листа

Объект запроса Preorder(строка прайс-листа)

Имя	Тип	Обяз.	Описание
nnt	int		Код товара по справочнику АСНА
sku	string		Код товара по справочнику клиента. Максимум 50 символов.
qnt	float		Количество товара
supInn	string		ИНН поставщика. Обязательно, если хотите получать ИНН в строках заказа с asna.ru
supDate	datetime		Дата поставки в формате ISO8601 с указанием часового пояса
exp	datetime		Cрок годности в формате ISO8601. Поле не является обязательным, т.к. не у всех товаров есть срок годности, но если у товара есть срок, убедительная просьба его заполнять. Покупатели хотят видеть срок на сайте. Для сервиса Контроль сроков годности поле обязательно
prcOptNds	decimal		Цена оптовая (закупочная) с НДС. Обязательно, если не передается Цена реализации
prcRet	decimal		Цена реализации. Обязательно, если не передается Цена оптовая (закупочная) с НДС
prcGnvlsMax	decimal		Максимально допустимая розничная цена для ЖНВЛС (поле обязательно для ЖНВЛС). Если эта цена не указана, то АСНА не будет контролировать превышение наценки на ЖНВЛС при расчете розничной цены. В этом случае ПО должно делать это самостоятельно. Если ПО самостоятельно не контролирует максимально допустимые цены ЖНВЛС то поле обязательно
prclDate	datetime		Дата прайс-листа в формате ISO8601 с указанием часового пояса
plType	int		Тип прайслиста, 0 - для юрлица, 1 - для хаба, 2 - для аптеки
status	int		Признак активной или удаленной строки (0 - активная, 1 - удаленная). В полном прайс-листе всегда 0, т.к. в нем должны быть только активные строки

Ссылка на JSON схему для валидации и тестирования

Пример запроса

PUT /v5/legal_entities/BC164E55-B612-4A04-800B-34CCF10F6858/preorders HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

{
    "date": "2017-06-22T00:21:12.1788669+00:00",
    "preorders": [
        {
            "nnt": 65192,
            "sku": "840883",
            "supInn": "3769761555",
            "prcOptNds": 21.27,
            "prcGnvlsMax": 25.37,
            "status": 0,
            "exp": "2020-11-14T09:32:32.437353+00:00",
            "supDate": "2017-06-24T20:26:37.0825228+00:00",
            "prclDate": "2017-06-21T14:43:56.604495+00:00",
            "plType": 0
        },
        {
            "nnt": 78713,
            "sku": "045998",
            "supInn": "7444215734",
            "prcOptNds": 489.06,
            "prcGnvlsMax": 614.44,
            "status": 1,
            "exp": "2018-11-22T15:37:11.8230938+00:00",
            "supDate": "2017-06-24T20:43:40.4941116+00:00",
            "prclDate": "2017-06-21T14:12:31.2273135+00:00",
            "plType": 0
        },
        {
            "nnt": 10990,
            "sku": "090794",
            "supInn": "2671494234",
            "prcOptNds": 852.67,
            "prcGnvlsMax": 1089.3,
            "status": 1,
            "exp": "2020-04-13T21:00:34.6708683+00:00",
            "supDate": "2017-06-23T10:23:07.3306094+00:00",
            "prclDate": "2017-06-20T17:53:03.778358+00:00",
            "plType": 0
        }
    ]
}

Успешный ответ

HTTP cтатус	Значение
202	Accepted. Принято к обработке. В заголовке Location содержится URL для получения статуса обработки переданного пакета.

Пример ответа

HTTP/1.1 202 Accepted
Vary: Accept
Location: https://api.asna.cloud/v5/messages/09006a8b-826d-48a0-91ad-f4d05a454b56/status

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Получение информации по сводному прайс-листу юрлица

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

GET /v5/legal_entities/{storeId}/preorders?since={since}

Описание

Получить сводный прайс-лист по юрлицу аптеки storeId по протоколу v5, с даты since

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА. По нему мы определяем юридическое лицо
since	datetime		Дата/время в формате ISO8601, с которой необходимо получить сводный прайс-лист

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/legal_entities/BC164E55-B612-4A04-800B-34CCF10F6858/preorders?since=2017-04-20T02:29:31.104986%2B00:00 HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw

Успешный ответ

HTTP cтатус	Значение
200	OK. Успешный запрос. В теле ответа содержится массив строк прайс-листа

Пример ответа

[
  {
    "srcId": "bc164e55-b612-4a04-800b-34ccf10f6858",
    "nnt": 73357,
    "sku": "587457",
    "supInn": "6178564994",
    "prcOptNds": 729.64,
    "prcGnvlsMax": 901.73,
    "exp": "2020-09-02T02:03:19.3303596+00:00",
    "supDate": "2017-06-28T09:57:04.651992+00:00",
    "prclDate": "2017-06-26T05:47:37.4603053+00:00",
    "status": 1
  },
  {
    "srcId": "bc164e55-b612-4a04-800b-34ccf10f6858",
    "nnt": 23317,
    "sku": "446478",
    "supInn": "9473035455",
    "prcOptNds": 317.57,
    "prcGnvlsMax": 374.97,
    "exp": "2020-01-15T09:05:44.8573497+00:00",
    "supDate": "2017-06-28T00:00:20.3622931+00:00",
    "prclDate": "2017-06-25T18:54:06.2889833+00:00",
    "status": 0
  }
]

Объект ответа (строка прайс-листа)

Имя	Тип	Описание
srcId	GUID	Уникальный код юрлица по справочнику АСНА
nnt	int	Код товара по справочнику АСНА
sku	string	Код товара по справочнику клиента. Максимум 50 символов.
qnt	float	Количество товара
supInn	string	ИНН поставщика
supDate	datetime	Дата поставки в формате ISO8601 с указанием часового пояса
exp	datetime	Cрок годности в формате ISO8601. Поле не является обязательным, т.к. не у всех товаров есть срок годности, но если у товара есть срок, убедительная просьба его заполнять. Покупатели хотят видеть срок на сайте
prcOptNds	decimal	Цена оптовая (закупочная) с НДС
prcRet	decimal	Цена реализации
prcGnvlsMax	decimal	Максимально допустимая розничная цена для ЖНВЛС (поле обязательно для ЖНВЛС). Если эта цена не указана, то АСНА не будет контролировать превышение наценки на ЖНВЛС при расчете розничной цены. В этом случае ПО должно делать это самостоятельно
prclDate	datetime	Дата прайс-листа в формате ISO8601 с указанием часового пояса
plType	int	Тип прайслиста, 0 - для юрлица, 1 - для хаба, 2 - для аптеки
status	int	Признак активной или удаленной строки (0 - активная, 1 - удаленная). В полном прайс-листе всегда 0, т.к. в нем должны быть только активные строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Передача полного сводного прайс-листа аптеки

Ежедневно, желательно в период наименьшей загруженности сервисов, интегрированное с АСНА программное обеспечение может отправлять полный сводный прайс-лист по аптеке. Выгрузка полного сводного прайс-листа должна производиться не чаще одного раза в сутки. Так как объем передаваемой информации большой, она не обрабатывается сразу, а ставится в очередь на обработку.

ВНИМАНИЕ!

Перед обработкой полного прайс-листа и записью его в БД, сервис произведет удаление сводного прайс-листа в БД по этой аптеке.

POST /v5/stores/{storeId}/preorders

Описание

Передать полный сводный прайс-лист по аптеке storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА. По нему мы определяем юридическое лицо.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Тело запроса

Объект запроса

Имя	Тип	Обяз.	Описание
date	datetime		Дата выгрузки полного прайс-листа в формате ISO8601 с указанием часового пояса
preorders	Preorder[]		Массив строк полного прайс-листа

Объект запроса Preorder(строка прайс-листа)

Имя	Тип	Обяз.	Описание
nnt	int		Код товара по справочнику АСНА
sku	string		Код товара по справочнику клиента. Максимум 50 символов.
qnt	float		Количество товара
supInn	string		ИНН поставщика
supDate	datetime		Дата поставки в формате ISO8601 с указанием часового пояса
exp	datetime		Cрок годности в формате ISO8601. Поле не является обязательным, т.к. не у всех товаров есть срок годности, но если у товара есть срок, убедительная просьба его заполнять. Покупатели хотят видеть срок на сайте
prcOptNds	decimal		Цена оптовая (закупочная) с НДС
prcRet	decimal		Цена реализации
prcGnvlsMax	decimal		Максимально допустимая розничная цена для ЖНВЛС (поле обязательно для ЖНВЛС). Если эта цена не указана, то АСНА не будет контролировать превышение наценки на ЖНВЛС при расчете розничной цены. В этом случае ПО должно делать это самостоятельно
prclDate	datetime		Дата прайс-листа в формате ISO8601 с указанием часового пояса
plType	int		Тип прайслиста, 0 - для юрлица, 1 - для хаба, 2 - для аптеки
status	int		Признак активной или удаленной строки (0 - активная, 1 - удаленная). В полном прайс-листе всегда 0, т.к. в нем должны быть только активные строки

Ссылка на JSON схему для валидации и тестирования

Пример запроса

POST /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/preorders HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

{
    "date": "2017-06-22T00:21:12.1788669+00:00",
    "preorders": [
        {
            "nnt": 65192,
            "sku": "840883",
            "supInn": "3769761555",
            "prcOptNds": 21.27,
            "prcGnvlsMax": 25.37,
            "status": 0,
            "exp": "2020-11-14T09:32:32.437353+00:00",
            "supDate": "2017-06-24T20:26:37.0825228+00:00",
            "prclDate": "2017-06-21T14:43:56.604495+00:00",
            "plType": 2,
            "qnt": 100,
            "prcRet": 24.00
        },
        {
            "nnt": 78713,
            "sku": "045998",
            "supInn": "7444215734",
            "prcOptNds": 489.06,
            "prcGnvlsMax": 614.44,
            "status": 0,
            "exp": "2018-11-22T15:37:11.8230938+00:00",
            "supDate": "2017-06-24T20:43:40.4941116+00:00",
            "prclDate": "2017-06-21T14:12:31.2273135+00:00",
            "plType": 2,
            "qnt": 100,
            "prcRet": 500.00
        },
        {
            "nnt": 10990,
            "sku": "090794",
            "supInn": "2671494234",
            "prcOptNds": 852.67,
            "prcGnvlsMax": 1089.3,
            "status": 0,
            "exp": "2020-04-13T21:00:34.6708683+00:00",
            "supDate": "2017-06-23T10:23:07.3306094+00:00",
            "prclDate": "2017-06-20T17:53:03.778358+00:00",
            "plType": 2,
            "qnt": 100,
            "prcRet": 900.00
        }
    ]
}

Успешный ответ

HTTP cтатус	Значение
202	Accepted. Принято к обработке. В заголовке Location содержится URL для получения статуса обработки переданного пакета.

Пример ответа

HTTP/1.1 202 Accepted
Vary: Accept
Location: https://api.asna.cloud/v5/messages/09006a8b-826d-48a0-91ad-f4d05a454b56/status

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Передача изменений по сводному прайс-листу аптеки

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

ВНИМАНИЕ!

Если товар был удален из сводного прайс-листа, то необходимо передать эту запись со статусом равным 1.

ИНФОРМАЦИЯ

Перед обработкой изменений по сводному прайс-листу аптеки и записью их в БД, сервис не будет производить удаление сводного прайс-листа в БД по этой аптеке. Будет произведена операция upsert (update для уже имеющихся в БД строк и insert для отсутствующих).

PUT /v5/stores/{storeId}/preorders

Описание

Передать изменения по сводному прайс-листу аптеки storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА. По нему мы определяем юридическое лицо.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Тело запроса

Объект запроса

Имя	Тип	Обяз.	Описание
date	datetime		Дата выгрузки полного прайс-листа в формате ISO8601 с указанием часового пояса
preorders	Preorder[]		Массив строк полного прайс-листа

Объект запроса Preorder(строка прайс-листа)

Имя	Тип	Обяз.	Описание
nnt	int		Код товара по справочнику АСНА
sku	string(50)		Код товара по справочнику клиента. Максимум 50 символов.
qnt	float		Количество товара
supInn	string(50)		ИНН поставщика
supDate	datetime		Дата поставки в формате ISO8601 с указанием часового пояса
exp	datetime		Cрок годности в формате ISO8601. Поле не является обязательным, т.к. не у всех товаров есть срок годности, но если у товара есть срок, убедительная просьба его заполнять. Покупатели хотят видеть срок на сайте
prcOptNds	decimal		Цена оптовая (закупочная) с НДС
prcRet	decimal		Цена реализации
prcGnvlsMax	decimal		Максимально допустимая розничная цена для ЖНВЛС (поле обязательно для ЖНВЛС). Если эта цена не указана, то АСНА не будет контролировать превышение наценки на ЖНВЛС при расчете розничной цены. В этом случае ПО должно делать это самостоятельно
prclDate	datetime		Дата прайс-листа в формате ISO8601 с указанием часового пояса
plType	int		Тип прайслиста, 0 - для юрлица, 1 - для хаба, 2 - для аптеки
status	int		Признак активной или удаленной строки (0 - активная, 1 - удаленная). В полном прайс-листе всегда 0, т.к. в нем должны быть только активные строки

Ссылка на JSON схему для валидации и тестирования

Пример запроса

PUT /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/preorders HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

{
    "date": "2017-06-22T00:21:12.1788669+00:00",
    "preorders": [
        {
            "nnt": 65192,
            "sku": "840883",
            "supInn": "3769761555",
            "prcOptNds": 21.27,
            "prcGnvlsMax": 25.37,
            "status": 0,
            "exp": "2020-11-14T09:32:32.437353+00:00",
            "supDate": "2017-06-24T20:26:37.0825228+00:00",
            "prclDate": "2017-06-21T14:43:56.604495+00:00",
            "plType": 2,
            "qnt": 100,
            "prcRet": 24.00
        },
        {
            "nnt": 78713,
            "sku": "045998",
            "supInn": "7444215734",
            "prcOptNds": 489.06,
            "prcGnvlsMax": 614.44,
            "status": 1,
            "exp": "2018-11-22T15:37:11.8230938+00:00",
            "supDate": "2017-06-24T20:43:40.4941116+00:00",
            "prclDate": "2017-06-21T14:12:31.2273135+00:00",
            "plType": 2,
            "qnt": 100,
            "prcRet": 500.00
        },
        {
            "nnt": 10990,
            "sku": "090794",
            "supInn": "2671494234",
            "prcOptNds": 852.67,
            "prcGnvlsMax": 1089.3,
            "status": 1,
            "exp": "2020-04-13T21:00:34.6708683+00:00",
            "supDate": "2017-06-23T10:23:07.3306094+00:00",
            "prclDate": "2017-06-20T17:53:03.778358+00:00",
            "plType": 2,
            "qnt": 100,
            "prcRet": 900.00
        }
    ]
}

Успешный ответ

HTTP cтатус	Значение
202	Accepted. Принято к обработке. В заголовке Location содержится URL для получения статуса обработки переданного пакета.

Пример ответа

HTTP/1.1 202 Accepted
Vary: Accept
Location: https://api.asna.cloud/v5/messages/09006a8b-826d-48a0-91ad-f4d05a454b56/status

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Получение информации по сводному прайс-листу аптеки

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

GET /v5/stores/{storeId}/preorders?since={since}

Описание

Получить сводный прайс-лист по аптеке storeId по протоколу v5, с даты since

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА. По нему мы определяем юридическое лицо
since	datetime		Дата/время в формате формат ISO8601, с которой необходимо получить сводный прайс-лист

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/preorders?since=2017-04-20T02:29:31.104986%2B00:00 HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw

Успешный ответ

HTTP cтатус	Значение
200	OK. Успешный запрос. В теле ответа содержится массив строк прайс-листа

Пример ответа

[
  {
    "srcId": "bc164e55-b612-4a04-800b-34ccf10f6858",
    "nnt": 73357,
    "sku": "587457",
    "supInn": "6178564994",
    "prcOptNds": 729.64,
    "prcGnvlsMax": 901.73,
    "exp": "2020-09-02T02:03:19.3303596+00:00",
    "supDate": "2017-06-28T09:57:04.651992+00:00",
    "prclDate": "2017-06-26T05:47:37.4603053+00:00",
    "status": 1
  },
  {
    "srcId": "bc164e55-b612-4a04-800b-34ccf10f6858",
    "nnt": 23317,
    "sku": "446478",
    "supInn": "9473035455",
    "prcOptNds": 317.57,
    "prcGnvlsMax": 374.97,
    "exp": "2020-01-15T09:05:44.8573497+00:00",
    "supDate": "2017-06-28T00:00:20.3622931+00:00",
    "prclDate": "2017-06-25T18:54:06.2889833+00:00",
    "status": 0
  }
]

Объект ответа (строка прайс-листа)

Имя	Тип	Описание
srcId	GUID	Уникальный код юрлица по справочнику АСНА
nnt	int	Код товара по справочнику АСНА
sku	string	Код товара по справочнику клиента. Максимум 50 символов.
qnt	float	Количество товара
supInn	string	ИНН поставщика
supDate	datetime	Дата поставки в формате ISO8601 с указанием часового пояса
exp	datetime	Cрок годности в формате ISO8601. Поле не является обязательным, т.к. не у всех товаров есть срок годности, но если у товара есть срок, убедительная просьба его заполнять. Покупатели хотят видеть срок на сайте
prcOptNds	decimal	Цена оптовая (закупочная) с НДС
prcRet	decimal	Цена реализации
prcGnvlsMax	decimal	Максимально допустимая розничная цена для ЖНВЛС (поле обязательно для ЖНВЛС). Если эта цена не указана, то АСНА не будет контролировать превышение наценки на ЖНВЛС при расчете розничной цены. В этом случае ПО должно делать это самостоятельно
prclDate	datetime	Дата прайс-листа в формате ISO8601 с указанием часового пояса
plType	int	Тип прайслиста, 0 - для юрлица, 1 - для хаба, 2 - для аптеки
status	int	Признак активной или удаленной строки (0 - активная, 1 - удаленная). В полном прайс-листе всегда 0, т.к. в нем должны быть только активные строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Бронирование (интернет-заказ)

Бизнес-процессы работы с заказами

Бронирование

Возможные варианты схем интеграции в части требований этапов жизненного цикла заказа:

1. Полная схема интеграции
2. Уведомительная схема интеграции

С определенной периодичностью клиентское ПО должно опрашивать API для получения информации о новых или измененных заказах. Все полученные с сайта заказы должны быть приняты и обработаны клиентским ПО.

ВНИМАНИЕ!

Продажа товара по заказам с сайта должна производиться в ценах, не выше, чем указанные в документе заказа, с обязательным контролем максимально допустимой наценки для ЖНВЛС. Указанная цена берется из поля prc.

Заказ может быть трех видов:

1. Товар только из наличия
2. Товар только по предзаказу
3. Комбинированый, товар как из наличия, так и по предзаказу

Новый заказ

При создании заказа на сайте формируется статус на заголовок с кодом 100. В этом статусе в поле rcDate сайт передает информацию о времени сброса резерва, которое аптечное ПО должно контролировать.

При получении нового заказа, если присутствуют строки с товаром из наличия, клиентское ПО пытается бронировать все товары по этим строкам, в количестве, которое указано в поле qnt.

Если заказ со строками только из наличия, возможны следующие варианты:

1. Товары полностью зарезервировались - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 200 на заголовок.
2. Товары полностью не зарезервировались - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 202 на заголовок.
3. Товары зарезервировались частично - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 201 на заголовок, а так же возвращаются строки заказа, по которым не хватило количества в наличии (код строки в поле rowId и незарезервированное количество в поле qntUnrsv).

Если заказ со строками только по предзаказу, клиентское ПО должно сформировать и вернуть новый статус (с новым уникальным идентификатором) с кодом 200 на заголовок.

В случае комбинированного заказа возможны варианты:

1. Товары из наличия полностью зарезервировались и принялись строки предзаказа - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 200 на заголовок.
2. Товары из наличия полностью не зарезервировались или зарезервировались частично, и принялись строки предзаказа - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 201 на заголовок, а так же возвращаются строки заказа, по которым не хватило количества в наличии (код строки в поле rowId и незарезервированное количество в поле qntUnrsv).

Если в документе присутствуют строки по предзаказу, то клиентское ПО должно разместить заказы на эти товары у поставщиков (API возвращает в строках заказа информацию об ИНН поставщика в поле supInn, взятую из сводного прайс-листа юрлица) и cформировать и вернуть новый статус (с новым уникальным идентификатором) с кодом 203 на заголовок заказа.

Редактирование заказа

На сайте и в мобильном приложении для пользователя отсутствует возможность редактировать заказ после его создания. Редактирование активных заказов разрешено:

1. Операторам колл-центра АСНА до статуса 213 - Заказ собран (укомплектован);
2. Сотрудникам аптеки(первостольникам) вне зависимости от статуса заказа в учетной системе аптеки.

При редактировании заказа на сайте формируется статус на заголовок с кодом 108. В этом статусе в поле rcDate сайт передает информацию о времени сброса резерва, которое аптечное ПО должно контролировать. Если при редактировании заказа на сайте была удалена строка, то на эту строку формируется статус с кодом 102. Отредактированный заказ ПОЛНОСТЬЮ (заголовок, строки и созданные статусы) передается в аптеку.

При получении отредактированного заказа, если присутствуют строки с товаром из наличия, клиентское ПО пытается бронировать все товары по этим строкам, в количестве, которое указано в поле qnt.

Если заказ со строками только из наличия, возможны следующие варианты:

1. Товары полностью зарезервировались - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 200 на заголовок.
2. Товары полностью не зарезервировались - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 202 на заголовок.
3. Товары зарезервировались частично - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 201 на заголовок, а так же возвращаются строки заказа, по которым не хватило количества в наличии (код строки в поле rowId и незарезервированное количество в поле qntUnrsv).

Если заказ со строками только по предзаказу, клиентское ПО должно сформировать и вернуть новый статус (с новым уникальным идентификатором) с кодом 200 на заголовок.

В случае комбинированного заказа возможны варианты:

1. Товары из наличия полностью зарезервировались и принялись строки предзаказа - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 200 на заголовок.
2. Товары из наличия полностью не зарезервировались или зарезервировались частично, и принялись строки предзаказа - формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 201 на заголовок, а так же возвращаются строки заказа, по которым не хватило количества в наличии (код строки в поле rowId и незарезервированное количество в поле qntUnrsv).

Если в документе присутствуют строки по предзаказу, то клиентское ПО должно разместить заказы на эти товары у поставщиков (API возвращает в строках заказа информацию об ИНН поставщика в поле supInn, взятую из сводного прайс-листа юрлица) и cформировать и вернуть новый статус (с новым уникальным идентификатором) с кодом 203 на заголовок заказа.

При полном поступлении товаров по предзаказу в аптеку, ПО должно отправить статус 207. В ответ сайт отправит в аптеку статус 104, содержащий новое время сброса резерва, которое ПО должно контролировать.

Сбор (комплектация) заказа

После того как заказ в аптеке был собран (укомплектован), необходимо отправить статус на заголовок 213. Отправка этого статуса инициируется из аптечного ПО, после того как сотрудник аптеки выставил в ПО статус полной комплектации заказа. Этот статус может формироваться из ПО сотрудником аптеки после каждого изменения комплектации заказа (например, в случае редактирования заказа покупателем). Если заказ содержал в себе строки предзаказа, то можно отправлять этот статус из ПО в случае подтверждения сотрудником аптеки полного прихода товара по ИЗП (предзаказу) и комплектации заказа.

Отмена покупателем

При отмене заказа покупателем на сайте формируется статус на заголовок с кодом 111. Аптека формирует и возвращает новый статус (с новым уникальным идентификатором) подтверждения отмены заказа покупателем с кодом 211. Заказ снимается с резерва.

Отмена заказа аптекой

В случае если у аптеки выставлен параметр cancelOrder, аптека должна иметь возможность отменить заказ. При отмене формируется и возвращается новый статус (с новым уникальным идентификатором) отмены заказа по инициативе аптеки с кодом 212. Заказ снимается с резерва.

Изменение времени бронирования

Покупатель может попросить продлить время бронирования заказа. Если аптека принимает решение о продлении бронирования, то формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 204 с измененной датой снятия товара с резерва (поле rcDate).

Сброс резерва

Клиентское ПО должно контролировать дату снятия заказа с резерва. Эту дату сайт передает в статусах 100, 104, 108. По достижению даты снятия товара с резерва, если товар не был выкуплен, формируется и возвращается новый статус (с новым уникальным идентификатором) с кодом 205. Заказ снимается с резерва.

Выкуп заказа

Возможны следующие варианты: Если заказ был полностью выкуплен, то формируется и возвращается статус с кодом 210. Если был выкуплен только резерв из наличия и(или) товар, частично пришедший по предзаказу, но не выкуплен весь заказ, то формируется и возвращается статус с кодом 209 на каждую выкупленную строку. Этот статус может формироваться несколько раз, на каждый из чеков.

Статусы заказов, формируемые сайтом

Код	Название	Описание
100	New	Новый заказ. Формируется на заголовок
102	OrderRowCancelled	Отмена строки на сайте. Формируется на строку
104	ChangeReservationTimeBySite	Изменение времени бронирования с сайта. Формируется на заголовок
108	OrderEditedByBuyer	Заказ отредактирован покупателем на сайте. Формируется на заголовок
109	PartiallyPurchased	Резерв выкуплен, ожидает предзаказ. Формируется на заголовок только в случае онлайн-оплаты
110	Purchased	Заказ выкуплен. Формируется на заголовок только в случае онлайн-оплаты
111	CancelledByBuyer	Отмена заказа покупателем на сайте. Формируется на заголовок

Статусы заказов, формируемые аптекой

Код	Название	Описание
200	Accepted	Заказ принят аптекой. Формируется на заголовок
201	PartiallyAccepted	Заказ частично принят аптекой. Формируется на заголовок
202	Rejected	Отказ со стороны аптеки. Формируется на заголовок
203	WaitingForPreorder	Ожидание предзаказа. Формируется и на строку и на заголовок
204	ChangeReservationTime	Изменение времени бронирования. Формируется на заголовок
205	ReserveCancelled	Резерв сброшен. Формируется на заголовок
206	ExceededDeliveryTime	Превышение ожидаемого срока поставки. Формируется на заголовок
207	PreorderCompleted	Предзаказ выполнен. Формируется на заголовок
208	EditingIsForbidden	Редактирование строки запрещено. Формируется на строку
209	PartiallyPurchased	Резерв выкуплен, ожидает предзаказ. Формируется на каждую выкупленную строку
210	Purchased	Заказ выкуплен. Формируется на заголовок
211	CancellationAccepted	Отмена заказа подтверждена. Формируется на заголовок
212	CancelledByStore	Заказ отменен аптекой (если у нее есть такие права). Формируется на заголовок
213	Assembled	Заказ собран (укомплектован). Формируется на заголовок
214	IssuedToCourier	Выдан курьеру (для АСНА-МАРКЕТ). Формируется на заголовок
215	Delivered	Доставлен (для АСНА-МАРКЕТ). Формируется на заголовок

ВНИМАНИЕ!

При получении в пакете нескольких статусов на один и тот же заголовок заказа или строку, ваше ПО обязано применить их к этому заголовку или строке четко в порядке их создания. Для этого нужно предварительно провести сортировку статусов по 2-м полям, полю ts, а затем по полю date в порядке возрастания этих дат.

Бизнес-процессы работы с заказами АСНА-Маркет

Работа с заказами АСНА-МАРКЕТ аналогична работе с обычными заказами Заказы (бронирование) с некоторыми изменениями, указанными ниже.

В заказы добавились 2 новых статуса со стороны аптеки, 214 Выдан курьеру и 215 Доставлен. В заголовках заказов появилось 2 дополнительных поля delivery (признак доставки) и deliveryInfo (информация о доставке). При заказах с доставкой нет необходимости контролировать время резервирования в аптеке, поэтому текущие поля с временем резерва на всем жизненном цикле заказа = NULL.

Доставка

Если заказ имел признак необходимости доставки(поле delivery), то при выдаче заказа курьеру ПО должно формировать и отсылать статус 214. При этом в поле cmnt можно передать ФИО курьера, время доставки, телефон курьера. Передача информации о курьере - не обязательна для ПО. После фактической доставки заказа покупателю, ПО обязано сформировать и отправить статус 215.

Получение информации о заказах аптеки

Клиенты, которые работают с сайтом АСНА, могут получать через API информацию о новых заказах, сформированных на сайте, а также информацию об изменении статусов этих заказов.

ОГРАНИЧЕНИЕ

Запрашивать заказы необходимо не чаще 1-го раза в минуту для каждой аптеки.

ВНИМАНИЕ

Необходимо иметь в ПО возможность, например, по кнопке в кассовом модуле, запросить изменения заказов, так как заказ может быть сделан на терминале и клиент сразу подойдет к кассе.

GET /v5/stores/{storeId}/orders_exchanger?since={since}&orderId={orderId}&excludeOwn={false|true}

Описание

Получить информацию по заказам аптеки storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА
since	datetime		Дата, с которой необходимо получить изменения (не включительно) в формате ISO8601
orderId	GUID		Уникальный код заказа
excludeOwn	bool		Исключать или не исключать собственные изменения, по умолчанию true, т.е. при запросе изменений с какой-либо даты, вы получите в ответ только изменения, созданные сайтом, иначе получите назад и созданные аптекой статусы. Только для тестирования можно его выставлять в false.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/orders_exchanger?since=2017-04-20T02:29:31.104986%2B00:00 HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. Успешный запрос. Тело запроса содержит объект заказов

Пример ответа

{
  "headers": [
    {
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "storeId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "issuerId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "src": "desktop",
      "num": "1",
      "date": "2017-05-23T02:52:50.9461641+00:00",
      "name": "Dorothy",
      "mPhone": "(713)576-1427",
      "payType": "payment",
      "payTypeId": 7,
      "dCard": "4005519200000004",
      "ae": 1,
      "unionId": "e5a5a7ca-0293-4318-b942-9b9328cccb73",
      "ts": "2017-05-23T02:52:51.9461641+00:00",
      "delivery": true,
      "deliveryInfo": "{\"address\":\"ул.Докукина, 15\"}"
    },
    {
      "orderId": "07e09592-937f-4a86-ad62-3c81118bc808",
      "storeId": "28082368-ef51-441a-b627-c53ea82355ec",
      "issuerId": "28082368-ef51-441a-b627-c53ea82355ec",
      "src": "terminal",
      "num": "4",
      "date": "2017-05-23T10:47:39.9011267+00:00",
      "name": "Denis",
      "mPhone": "(664)904-8190",
      "payType": "deposit",
      "payTypeId": 2,
      "dCard": "4009348888881881",
      "ae": 1,
      "unionId": "3075c830-0b90-4c3c-a6c6-192a5b0f78e6",
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    }
  ],
  "rows": [
    {
      "rowId": "ace19789-ae52-484d-b8b5-e8e3089c4b02",
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "rowType": 1,
      "prtId": "f00279e9-662a-45bd-942c-74ddefc2496c",
      "nnt": 76688,
      "qnt": 8,
      "prc": 219.76,
      "prcDsc": 219.76,
      "dscUnion": "EliLilly",
      "dtn": 1.88,
      "prcLoyal": 219.76,
      "prcOptNds": 219.76,
      "supInn": "48141893",
      "dlvDate": "2017-05-22T09:54:34.584838+00:00",
      "qntUnrsv": 2,
      "prcFix": 650.52,
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    },
    {
      "rowId": "2127300c-f40f-4f97-8324-c45d44901ac3",
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "rowType": 1,
      "prtId": "564b3d19-e716-415d-8af6-e669ab97fd69",
      "nnt": 63475,
      "qnt": 3,
      "prc": 700.2,
      "prcDsc": 700.2,
      "dscUnion": "Pfizer",
      "dtn": 5.92,
      "prcLoyal": 700.2,
      "prcOptNds": 700.2,
      "supInn": "73306247",
      "dlvDate": "2017-05-22T19:46:37.6307193+00:00",
      "qntUnrsv": 1,
      "prcFix": 736.74,
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    }
  ],
  "statuses": [
    {
      "statusId": "0dea195c-3222-4751-bdde-021806fb8dfc",
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "storeId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "date": "2017-05-23T00:17:09.8996805+00:00",
      "status": 100,
      "rcDate": "2017-05-23T16:55:50.9970809+00:00",
      "cmnt": "no comments",
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    },
    {
      "statusId": "8705f990-9443-4960-8cc7-d0dc31d2cde6",
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "rowId": "2127300c-f40f-4f97-8324-c45d44901ac3",
      "storeId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "date": "2017-05-22T21:52:24.2957718+00:00",
      "status": 102,
      "cmnt": "no comments",
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    }
  ]
}

Объект ответа

Имя	Тип	Описание
headers	Header[]	Массив заголовков заказов
rows	Row[]	Массив строк заказов
statuses	Status[]	Массив статусов заказов

Объект ответа Header(заголовок)

Имя	Тип	Описание
orderId	GUID	Уникальный код заказа. Поле необходимо протаскивать в чек, сформированный по этому заказу, для дальнейшей выгрузки этого поля в хранилище данных АСНА (передача товародвижения через FTP)
storeId	GUID	Уникальный код аптеки, на которой сделан заказ
issuerId	GUID	Уникальный код аптеки, которая выдает заказ (для самовывоза)
src	string	Источник заказа («desktop», «terminal», «mobile», «cashier» и т.д.). Поле необходимо протаскивать в чек, сформированный по этому заказу, для дальнейшей выгрузки этого поля в хранилище данных АСНА (передача товародвижения через FTP). Cписок источников заказа
num	string	Номер заказа
date	datetime	Дата заказа в формате ISO8601 с указанием часового пояса
name	string	Имя покупателя
mPhone	string	Номер телефона
payType	string	Тип оплаты
payTypeId	int	ИД типа оплаты по справочнику АСНА
dCard	string	Дисконтная карта
ae	int	Признак АСНА-Экономия (0 - нет, 1 - да). Заказ с признаком АСНА-Экономия не должен редактироваться через клиентское ПО
unionId	GUID	ИД совместной покупки
ts	datetime	Отметка времени, в формате ISO8601. Представляет собой дату и время создания или обновления заголовка сервисом АСНА(в нулевом часовом поясе)
delivery	bool	Признак доставки (true - необходима доставка, false - самовывоз)
deliveryInfo	string	Информация о доставке. Содержит строку в виде экранированного JSON, который при необходимости, можно распарсить и получить данные. Поля addr - адрес доставки, cmnt - комментарий покупателя, type - тип доставки, prc - стоимость доставки, email - почта покупателя

Пример заполнения поля deliveryInfo

{
  "addr": "Докукина 16 стр.1",
  "cmnt": "Домофон 33333",
  "type": "Курьером",
  "prc": 200,
  "email": "asna@asna.ru",
  "phone": "89126765544"
}

Объект ответа Row(строка заказа)

Имя	Тип	Описание
rowId	GUID	Уникальный код строки заказа
orderId	GUID	Уникальный код заказа
rowType	int	Тип строки (0 - наличие, 1 - предзаказ)
prtId	string	Уникальный код партии. На данный момент не возвращается
nnt	int	Код товара по справочнику АСНА
qnt	float	Количество в заказе
prc	decimal	Цена товара в момент заказа
prcDsc	decimal	Цена товара, обещанная покупателю в момент оформления заказа, с учетом наценки или скидки (АСНА-Экономия,акции производителей, промо-кодов и т.д.)
dscUnion	string	Признак дисконта
dtn	decimal	Дотация для единицы товара. Поле необходимо протаскивать в чек, сформированный по этому заказу, для дальнейшей выгрузки этого поля в хранилище данных АСНА (передача товародвижения через FTP)
prcLoyal	decimal	Цена реализации со скидкой по программам Pfizer, AstraZeneca и Eli Lilly
prcOptNds	decimal	Цена поставки
supInn	string	ИНН поставщика
dlvDate	datetime	Дата поставки в формате ISO8601
qntUnrsv	float	Количество незарезервированного товара
prcFix	decimal	Фиксированная цена
ts	datetime	Отметка времени, в формате ISO8601. Представляет собой дату и время создания или обновления строки сервисом АСНА (в нулевом часовом поясе).
mark	int	Признак расчета цены реализации с возмещаемой скидкой от производителей, ООО "АСНА" (промо-коды). 1 - Запрещается применение по строке заказа скидки производителей на стороне аптечного ПО, 0(null) - разрешены дополнительные скидки производителей на стороне аптечного ПО

ВАЖНО

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

1. Двойного применения скидки - скидка по заказам asna.ru компенсируется в аптечную сеть от производителя через АСНА.
2. Ошибочной выгрузки транзакций по заказам asna.ru производителю со стороны аптечной сети - скидки по подобным транзакциям со стороны производителя компенсировать не будут.

Объект ответа Status(строка статуса)

Имя	Тип	Описание
statusId	GUID	Уникальный код статуса
orderId	GUID	Уникальный код заказа
rowId	GUID	Уникальный код строки заказа (заполняется только если статус на строку)
storeId	GUID	Уникальный код аптеки
date	datetime	Дата и время статуса
status	int	Код статуса
rcDate	datetime	Дата и время сброса резерва в формате ISO8601. Поле заполняется только для 100, 108 ,104 статусов заказа
cmnt	string	Комментарий
ts	datetime	Отметка времени, в формате ISO8601. Представляет собой дату и время создания или обновления статуса сервисом АСНА(в нулевом часовом поясе)

ВНИМАНИЕ!

Поле ts в заголовках, строках и статусах заказа имеет чрезвычайно важное значение для корректного получения изменений по заказам. При запросе изменений по заказам, всегда задавайте параметр since следующего запроса равным максимальному значению поля ts из всех трех массивов(заголовки, строки, статусы) предыдущего запроса. Не используйте локальное время на ваших серверах в качестве параметра since.

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Список источников заказа

Ид	Источник	Описание
1	asna.ru	Заказ от сервисов asna.ru

Получение информации о заказах сети

Клиенты, которые работают с сайтом АСНА, могут получать через API информацию о новых заказах, сформированных на сайте, а также информацию об изменении статусов этих заказов по сети.

GET /v5/nets/{storeId}/orders_exchanger?since={since}&excludeOwn={false|true}

Описание

Получить информацию по заказам сети, в которую входит аптека storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА
since	datetime		Дата, с которой необходимо получить изменения (не включительно) в формате ISO8601
excludeOwn	bool		Исключать или не исключать собственные изменения, по умолчанию true, т.е. при запросе изменений с какой-либо даты, вы получите в ответ только изменения, созданные сайтом, иначе получите назад и созданные аптекой статусы. Только для тестирования можно его выставлять в false.

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/nets/BC164E55-B612-4A04-800B-34CCF10F6858/orders_exchanger?since=2017-04-20T02:29:31.104986%2B00:00 HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. Успешный запрос. Тело запроса содержит объект заказов

Пример ответа

{
  "headers": [
    {
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "storeId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "issuerId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "src": "desktop",
      "num": "1",
      "date": "2017-05-23T02:52:50.9461641+00:00",
      "name": "Dorothy",
      "mPhone": "(713)576-1427",
      "payType": "payment",
      "payTypeId": 7,
      "dCard": "4005519200000004",
      "ae": 1,
      "unionId": "e5a5a7ca-0293-4318-b942-9b9328cccb73",
      "ts": "2017-05-23T02:52:51.9461641+00:00",
      "delivery": true,
      "deliveryInfo": "{\"address\":\"ул.Докукина, 15\"}"
    },
    {
      "orderId": "07e09592-937f-4a86-ad62-3c81118bc808",
      "storeId": "28082368-ef51-441a-b627-c53ea82355ec",
      "issuerId": "28082368-ef51-441a-b627-c53ea82355ec",
      "src": "terminal",
      "num": "4",
      "date": "2017-05-23T10:47:39.9011267+00:00",
      "name": "Denis",
      "mPhone": "(664)904-8190",
      "payType": "deposit",
      "payTypeId": 2,
      "dCard": "4009348888881881",
      "ae": 1,
      "unionId": "3075c830-0b90-4c3c-a6c6-192a5b0f78e6",
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    }
  ],
  "rows": [
    {
      "rowId": "ace19789-ae52-484d-b8b5-e8e3089c4b02",
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "storeId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "rowType": 1,
      "prtId": "f00279e9-662a-45bd-942c-74ddefc2496c",
      "nnt": 76688,
      "qnt": 8,
      "prc": 219.76,
      "prcDsc": 219.76,
      "dscUnion": "EliLilly",
      "dtn": 1.88,
      "prcLoyal": 219.76,
      "prcOptNds": 219.76,
      "supInn": "48141893",
      "dlvDate": "2017-05-22T09:54:34.584838+00:00",
      "qntUnrsv": 2,
      "prcFix": 650.52,
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    },
    {
      "rowId": "2127300c-f40f-4f97-8324-c45d44901ac3",
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "storeId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "rowType": 1,
      "prtId": "564b3d19-e716-415d-8af6-e669ab97fd69",
      "nnt": 63475,
      "qnt": 3,
      "prc": 700.2,
      "prcDsc": 700.2,
      "dscUnion": "Pfizer",
      "dtn": 5.92,
      "prcLoyal": 700.2,
      "prcOptNds": 700.2,
      "supInn": "73306247",
      "dlvDate": "2017-05-22T19:46:37.6307193+00:00",
      "qntUnrsv": 1,
      "prcFix": 736.74,
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    }
  ],
  "statuses": [
    {
      "statusId": "0dea195c-3222-4751-bdde-021806fb8dfc",
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "storeId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "date": "2017-05-23T00:17:09.8996805+00:00",
      "status": 100,
      "rcDate": "2017-05-23T16:55:50.9970809+00:00",
      "cmnt": "no comments",
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    },
    {
      "statusId": "8705f990-9443-4960-8cc7-d0dc31d2cde6",
      "orderId": "ad392db0-53e0-4e46-b797-ebf1bc531241",
      "rowId": "2127300c-f40f-4f97-8324-c45d44901ac3",
      "storeId": "383426fd-ab3a-4139-9845-9a880a8f69c7",
      "date": "2017-05-22T21:52:24.2957718+00:00",
      "status": 102,
      "cmnt": "no comments",
      "ts": "2017-05-23T02:52:51.9461641+00:00"
    }
  ]
}

Объект ответа

Имя	Тип	Описание
headers	Header[]	Массив заголовков заказов
rows	Row[]	Массив строк заказов
statuses	Status[]	Массив статусов заказов

Объект ответа Header(заголовок)

Имя	Тип	Описание
orderId	GUID	Уникальный код заказа. Поле необходимо протаскивать в чек, сформированный по этому заказу, для дальнейшей выгрузки этого поля в хранилище данных АСНА (передача товародвижения через FTP)
storeId	GUID	Уникальный код аптеки, на которой сделан заказ
issuerId	GUID	Уникальный код аптеки, которая выдает заказ (для самовывоза)
src	string	Источник заказа («desktop», «terminal», «mobile», «cashier» и т.д.). Поле необходимо протаскивать в чек, сформированный по этому заказу, для дальнейшей выгрузки этого поля в хранилище данных АСНА (передача товародвижения через FTP). Cписок источников заказа
num	string	Номер заказа
date	datetime	Дата заказа в формате ISO8601 с указанием часового пояса
name	string	Имя покупателя
mPhone	string	Номер телефона
payType	string	Тип оплаты
payTypeId	int	ИД типа оплаты по справочнику АСНА
dCard	string	Дисконтная карта
ae	int	Признак АСНА-Экономия (0 - нет, 1 - да). Заказ с признаком АСНА-Экономия не должен редактироваться через клиентское ПО
unionId	GUID	ИД совместной покупки
ts	datetime	Отметка времени, в формате ISO8601. Представляет собой дату и время создания или обновления заголовка сервисом АСНА(в нулевом часовом поясе)
delivery	bool	Признак доставки (true - необходима доставка, false - самовывоз)
deliveryInfo	string	Информация о доставке. Содержит строку в виде экранированного JSON, который при необходимости, можно распарсить и получить данные. Поля addr - адрес доставки, cmnt - комментарий покупателя, type - тип доставки, prc - стоимость доставки, email - почта покупателя

Пример заполнения поля deliveryInfo

{
  "addr": "Докукина 16 стр.1",
  "cmnt": "Домофон 33333",
  "type": "Курьером",
  "prc": 200,
  "email": "asna@asna.ru",
  "phone": "89126765544"
}

Объект ответа Row(строка заказа)

Имя	Тип	Описание
rowId	GUID	Уникальный код строки заказа
orderId	GUID	Уникальный код заказа
storeId	GUID	Уникальный код аптеки, на которой сделан заказ
rowType	int	Тип строки (0 - наличие, 1 - предзаказ)
prtId	string	Уникальный код партии. На данный момент не возвращается
nnt	int	Код товара по справочнику АСНА
qnt	float	Количество в заказе
prc	decimal	Цена товара в момент заказа
prcDsc	decimal	Цена товара, обещанная покупателю в момент оформления заказа, с учетом наценки или скидки (АСНА-Экономия,акции производителей, промо-коды и т.д.)
dscUnion	string	Признак дисконта
dtn	decimal	Дотация для единицы товара. Поле необходимо протаскивать в чек, сформированный по этому заказу, для дальнейшей выгрузки этого поля в хранилище данных АСНА (передача товародвижения через FTP)
prcLoyal	decimal	Цена реализации со скидкой по программам Pfizer, AstraZeneca и Eli Lilly
prcOptNds	decimal	Цена поставки
supInn	string	ИНН поставщика
dlvDate	datetime	Дата поставки в формате ISO8601
qntUnrsv	float	Количество незарезервированного товара
prcFix	decimal	Фиксированная цена
ts	datetime	Отметка времени, в формате ISO8601. Представляет собой дату и время создания или обновления строки сервисом АСНА (в нулевом часовом поясе).
mark	int	Признак расчета цены реализации с возмещаемой скидкой от производителей, ООО "АСНА" (промо-коды). 1 - Запрещается применение по строке заказа скидки производителей на стороне аптечного ПО, 0(null) - разрешены дополнитель=ные скидки производителей на стороне аптечного ПО

ВАЖНО

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

1. Двойного применения скидки - скидка по заказам asna.ru компенсируется в аптечную сеть от производителя через АСНА.
2. Ошибочной выгрузки транзакций по заказам asna.ru производителю со стороны аптечной сети - скидки по подобным транзакциям со стороны производителя компенсировать не будут.

Объект ответа Status(строка статуса)

Имя	Тип	Описание
statusId	GUID	Уникальный код статуса
orderId	GUID	Уникальный код заказа
rowId	GUID	Уникальный код строки заказа (заполняется только если статус на строку)
storeId	GUID	Уникальный код аптеки
date	datetime	Дата и время статуса
status	int	Код статуса
rcDate	datetime	Дата и время сброса резерва в формате ISO8601. Поле заполняется только для 100, 108 ,104 статусов заказа
cmnt	string	Комментарий
ts	datetime	Отметка времени, в формате ISO8601. Представляет собой дату и время создания или обновления статуса сервисом АСНА(в нулевом часовом поясе)

ВНИМАНИЕ!

Поле ts в заголовках, строках и статусах заказа имеет чрезвычайно важное значение для корректного получения изменений по заказам. При запросе изменений по заказам, всегда задавайте параметр since следующего запроса равным максимальному значению поля ts из всех трех массивов(заголовки, строки, статусы) предыдущего запроса. Не используйте локальное время на ваших серверах в качестве параметра since.

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Список источников заказа

Ид	Источник	Описание
1	asna.ru	Заказ от сервисов asna.ru

Отправка информации о заказах

Клиенты, которые работают с заказами с сайта АСНА, должны передавать информацию об изменениях в заказах, произошедших в аптеке, а также информацию о статусе заказов.

PUT /v5/stores/{storeId}/orders_exchanger

Описание

Передать информацию по заказам аптеки storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Тело запроса

Объект запроса

Имя	Тип	Обяз.	Описание
rows	Row[]		Массив строк заказов
statuses	Status[]		Массив статусов заказов

Объект запроса Row(строка заказа)

Имя	Тип	Обяз.	Описание
rowId	GUID		Уникальный код строки заказа
qntUnrsv	float		Количество незарезервированного товара

Объект запроса Status(статус заказа)

Имя	Тип	Обяз.	Описание
statusId	GUID		Уникальный код статуса. Генерируется клиентским ПО
orderId	GUID		Уникальный код заказа. Берется из обрабатываемого заказа
rowId	GUID		Уникальный код строки заказа (заполняется только если статус на строку). Берется из обрабатываемого заказа
storeId	GUID		Уникальный код аптеки. Берется из обрабатываемого заказа
date	datetime		Дата и время создания статуса в формате ISO8601 с указанием часового пояса
status	int		Код статуса
rcDate	datetime		Дата и время сброса резерва в формате ISO8601 с указанием часового пояса. Поле заполняется только для 204 статуса заказа
cmnt	string		Комментарий

Ссылка на JSON схему для валидации и тестирования

Пример запроса

PUT /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/orders_exchanger HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

{
    "rows": [
        {
        "rowId": "e10b7e67-b6ef-4eb2-8c73-efbc556f77eb",
        "qntUnrsv": 9
        },
        {
        "rowId": "de0fb428-1a9d-4635-9e8d-67577348869b",
        "qntUnrsv": 2
        }
    ],
    "statuses": [
        {
        "statusId": "0711c000-f54a-4854-877f-e8b8b9e5b6d1",
        "orderId": "903a9021-35a8-402e-a037-17e64f066aeb",
        "storeId": "9bebe7c1-142f-4474-ab11-45575dafbf8b",
        "date": "2017-05-22T16:55:50.9970809+00:00",
        "rcDate": "2017-05-23T16:55:50.9970809+00:00",
        "status": 204
        },
        {
        "statusId": "4d25f7c6-9299-4eb2-a512-407b3936b3f9",
        "orderId": "903a9021-35a8-402e-a037-17e64f066aeb",
        "storeId": "b3ecd8d0-665c-4057-a103-9cc3a2cb72c2",
        "date": "2017-05-23T01:16:07.3800902+00:00",
        "status": 200
        }
    ]
}

Успешный ответ

HTTP cтатус	Значение
201	Created. Данные успешно записаны

Пример ответа

HTTP/1.1 201 Created

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Бизнес-процесс работы с заказами Пульс

Требования к обработке электронных накладных интернет заказов от поставщика ФК Пульс

По каждому интернет заказу поставщик выгружает отдельную электронную накладную.

В текущую структуру электронной накладной для аптеки добавляются новые поля:

• PRICER - розничная цена, включающая все налоги;
• IDOC - оригинальный номер интернет заказа;
• ONLINE - признак интернет-заказ, возможные значения: 1 – интернет-заказ; 0 - обычная накладная;

Если в накладной поля pricer и idoc заполнены значениями или поле online = 1, то данная накладная сформирована и выгружена в аптеку по интернет заказу покупателя.

В аптечном ПО необходимо настроить прием и обработку электронных накладных интернет заказов от поставщика ФУ Пульс по аналогии обработки накладных по заказам apteka.ru и zdravcity.ru.

Минимальные требования к ПО:

• После прихода товара с розничными ценами по электронной накладной ФК Пульс, необходимо забронировать товар(исключить из свободной продажи, отложенный чек, чек резерва и т.п..);
• Сотрудник аптеки(первостольник) должен иметь возможность по номеру заказа(IDOC) найти/скопировать содержимое оприходованной накладной интернет заказа в чек.

Дополнительные возможности:

В накладных интернет заказов от поставщика ФК Пульс выгружается информация о покупателе (ФИО, телефон и email):

1. В агрегированном виде в поле: ECOM_BUYER

2. В разагрегированном виде в полях:

3. ECOM_PERS – ФИО покупателя

4. ECOM_PHONE – телефон покупателя
5. ECOM_MAIL – email покупателя

Каждый заказ собирается на складе поставщика в отдельный пакет/коробку и маркируется этикеткой. Скачать пример этикетки.

На этикетке присутствует штрихкод, который содержит номер заказа(IDOC) дополненный лидирующими нулями слева до 12 символов + контрольный символ.

Данная информация может быть использована в аптечном ПО, для удобства обработки заказов сотрудником аптеки – поиск заказ по ФИО, номеру телефона, email покупателя, через сканирование ШК.

Если аптека получает накладные от поставщика ФК Пульс через сервисы сводных прайс-листов PharmSM и т.п.., то для обработки интернет заказов необходимо настроить прямое получение электронных накладных от поставщика.

Для этого необходимо согласовать с поставщиком:

• Способ получение электронных накладных: Email или FTP, передать адрес для доставки электронных накладных.
• Структуру файла электронной накладной: шаблон поставщика(Скачать) или шаблон аптечного ПО(передать требования к файлу накладной).

Требования к доработке файловой выгрузки в АСНА

Требования к доработке файловой выгрузки в АСНА, согласно Регламенту информационного обмена

Доработать логику формирования файла "Данные о товародвижении" по приходным и расходным документам интернет заказов с доставкой со склада Пульс:

Название	Тип	Описание
5) Тип документа	Целочисленный	15 - Приход сторонний интернет-заказ, 16 - Продажи сторонний интернет-заказ, 2 – продажа через ККМ
26) Уникальный код заказа	Строковый(40)	Уникальный внутренний код заказа. Данное поле заполняется только для расходных документов типа – 2 (Чеки), документов типа 15 (Приход сторонний интернет-заказ) и 16 (Продажи сторонний интернет-заказ) В данном поле указывать оригинальный номер заказа из электронной накладной поставщика: поле IDOC Пример: "5093447"
27) Источник заказа	Строковый(40)	Данное поле заполняется только для расходных документов типа – 2 (Чеки), 16 (Продажи сторонний интернет-заказ) и для приходных документов типа – 15 (Приход сторонний интернет-заказ). В данном поле указывать "puls.asna.ru"

Требования к интеграции с сайтом asna.ru

Для работы с заказами Пульс необходимо провести упрощенную интеграцию с сайтом asna.ru, если ваше ПО не интегрированно, а именно:

1. Авторизация (см. Авторизация в АСНА REST API)
2. Реализовать метод, описанный ниже (Отправка информации о выкупленных заказах)

Если ваше ПО уже интегрированно с сайтом asna.ru, то п.1 из списка выше выполнять не надо. Отправка информации о выкупленных заказах может производиться одним из двух способов.

• Это можно делать при пробитии чека с заказом на кассе, но обязательно способом, не блокирующим работу кассы, например в отдельном потоке.
• Информацию о выкупленных заказах можно передавать и по расписанию, например каждые 10-15 минут.

Обязательно наличие retry-логики, попытки отправить информацию должны продолжаться до тех пор, пока не будет получен статус успешного завершения операции, если вы получали от api транзиентную(временную) ошибку.

Отправка информации о выкупленных заказах Пульс

Клиенты, которые работают с заказами Пульс на сайте asna.ru, должны передавать на сайт информацию о выкупленных в аптеке заказах.

POST /v5/stores/{storeId}/redeemed_orders_pulse

Описание

Передать информацию по выкупленным заказам Пульс аптеки storeId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Тело запроса

Массив строк в формате JSON, где каждая строка - номер заказа Пульс, полученный в накладной.

Пример запроса

POST /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/redeemed_orders_pulse HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

[
    "1674849533",
    "6984849534"
]

Успешный ответ

HTTP cтатус	Значение
201	Created. Данные успешно записаны

Пример ответа

HTTP/1.1 201 Created

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа. В случае если было отправлено несколько номеров заказов и не все заказы найдены в БД, то вернется этот статус со списком заказов, которые не были найдены в БД, в теле ответа. Найденные заказы при этом будут записаны. См. пример ниже.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Пример ответа, если заказ не найден

{
  "statusCode": 400,
  "isError": true,
  "isTransient": false,
  "exceptionMessage": "Please correct the specified validation errors",
  "referenceDocumentLink": "https://api.asna.cloud/docs/v5/validation.html",
  "validationErrors": [
    {
      "field": "4849534",
      "message": "Order not found"
    }
  ]
}

Маркетинговые мероприятия

Общие положения начисления бюджета

1. Бюджет для каждой аптеки начисляется отдельно, но зависит от показателей работы всей сети, к которой относится аптека
2. Бюджет делится на две части: «Общий маркетинг» и «Товар дня» итоговая сумма складывается арифметически из двух этих частей, которые рассчитываются независимо.
3. Бюджет за мероприятие «Товар дня» начисляется независимо от выполнения планов по другим типам мероприятий. Базой для расчета бонуса является объем закупки в промо-период (стандарт: месяц проведения акции и 10 дней до него) конкретных товаров (или разрешенных для их замены SKU), в зачет идет закуп только у разрешенных дистрибьюторов (по контракту, содержащему конкретный товар). В одном мероприятии участвует 4 товара (без учета разрешенных заменителей), мероприятие организуется на каждый месяц отдельно. План выставляется в упаковках на каждый товар и на каждую участвующую аптеку. Бонус за каждую закупленную упаковку устанавливается для каждого товара в каждом мероприятии индивидуально (стандарт = 30% от суммы закупа в учетных ценах АСНА) Выполнение оценивается по сети целиком, в соответствии с описанием мероприятия «Товар дня»
4. Бюджет по «Общему маркетингу» начисляется по каждому товару из маркетингового ассортимента в отдельности. На каждый товар может быть несколько уровней возможного бонуса (2 или 4) в зависимости от группы маркетингового ассортимента, к которой товар относится. Какой уровень бонуса в итоге получит сеть по каждому товару зависит от выполнения сетью планов по маркетинговым мероприятиям.
5. Базой для расчета бюджета аптеки является маркетинговая закупка в учетных ценах АСНА-CIP (учетная цена на каждый маркетинговый товар устанавливается на квартал со стороны АСНА) закупленного аптекой товара, при условии, что для этой аптеки товар является маркетинговым в данном квартале (определяется мероприятиями типа «Маркетинговый ассортимент») и товар был куплен у разрешенного поставщика (для части производителей на квартал устанавливаются ограничения дистрибьюторов – только купленный у этих поставщиков товар данного производителя идет в зачет для начисления бюджета).

Условия начисления бюджета

Маркетинговый ассортимент

Для товаров из Группа 1 и Группа 2

На товары данных групп начисляется:

• Бонус 1, если БДН по сети не выполнено.
• Бонус 2, если БДН по сети выполнено.

Для товаров из Группа 3 УСТМ

На товары данной группы начисляется:

• Бонус 1, если БДН по сети не выполнено и план по УСТМ-мероприятию (с данным товаром) не выполнен.
• Бонус 2, если БДН по сети выполнено, но план по УСТМ-мероприятию (с данным товаром) не выполнен.
• Бонус 3, если БДН по сети не выполнено, но план по УСТМ-мероприятию (с данным товаром) выполнен.
• Бонус 4, если БДН по сети выполнено, и план по УСТМ-мероприятию (с данным товаром) тоже выполнен.

Бездефектурное наличие

Для всех товаров

Выполнение считается по сети целиком. Выполненным условие БДН для сети считается от 85% строк.

УСТМ

Для товаров из Группа 3 УСТМ

Выполнение считается в разрезе Сеть-мероприятие-квартал. Мероприятие считается выполненным для сети, если план выполнен на 100% и более.

Товар дня

Если мероприятие выполнено по сети, то за зачтенный (по разрешенным дистрибьюторам) факт закупки каждого товара в учетных ценах (АСНА-CIP цены) начисляется заранее обозначенный процент бонуса.

Условия выполнения мероприятия

Маркетинговый ассортимент

Сеть в любом случае получает минимум Бонус 1. Получение бонуса от 2 до 4 уровня определяется выполнением БДН и УСТМ-мероприятий.

Бездефектурное наличие

Процент выполнения сетью матрицы БДН = количество строк (товаров по аптекам сети с планом по БДН), по которым товар был на остатке 80% и более дней в квартале, разделить на суммарное количество строк с планом по аптекам данной сети. Выполненным условие БДН для сети считается от 85% строк.

УСТМ

Сеть имеет план закупа в учетных ценах (АСНА-CIP) по каждому мероприятию (набор SKU одного бренда в одной конкурентной группе - "кластере") на квартал. В зачет идет только закуп у разрешенных дистрибьюторов.

Товар дня

Мероприятие считается выполненым для сети, если план по 3 из 4-х товаров, участвующих в акции, выполенн минимум на 90%, а на 1 товар минимум на 50%.

Варианты использования в аптечном ПО, повышающие эффективность работы сети с маркетингом

Маркетинговый ассортимент

1. Подсветка в интерфейсе закупки товара
2. Приоритезация товаров в рамках группы аналогичных к закупке (если расчет потребности и закуп организован "слотами", и возможен закуп аналогичного товара при более выгодной цене или отсутствии первичного по потребности)
3. Использование в кассовом интерфейсе: приоритет при запросе покупателя, подсветка, часть мотивации персонала.
4. Комплексный подход к мотивации персонала - начисление баллов за маркетинговые товары, 0 или "-" за немаркетинговые и немаржинальные товары. Отчетность по индивидуальной мотивации, информаирование на кассе о результатах текущей сессии по набранным баллам/выполнению плана конкретным фармацевтом/аптекой/сменой.

Бездефектурное наличие

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

1. Автоматический заказ/попадание в черновые заказы
2. Увеличенная потребность для заказа - например, на 1 упаковку больше, чем под статистику продаж, чтобы сток не обнулялся.
3. Оповещения при обнулении стоков по данным SKU
4. Внутренняя аналитика выполнения условий по БДН в разрезе аптек и сети
5. Автоматическое включение в ассортиментный план аптеки, невозможность локального (заведующей) исключения позиций - при централизованном управлении сетью.

Разрешенные дистрибьюторы

1. При заказе товара в первую очередь посылать заказ только разрешенным дистрибьюторам, а к запрещенным, например, только при согласовании ответственным пользователем, если ни у одного разрешенного нет товара, или, какой-то лимит по отличию цены превышен. То есть приоритезация заказа товара по разрешенным поставщикам.
2. Подсветка товаров, для которых есть ограничения поставщиков в интерфейсах заказа товара, ассортиментного плана.

УСТМ

1. Внутренний мониторинг сетью/аптекой выполнения планов АСНА в отчетности. Более оперативен относительно куба и портала АСНА - так как данные не надо валидировать и ждать обменов.
2. Настройка мотивации персоанала на продажу конкретных товаров в конкурентных группах (кластерах) - баллы/планы на фармацевта/аптеку + системы мониторинга - индивидуальные на кассе и общие в отчетности.
3. Настройка замен/расширения с приоритетом для товаров УСТМ в кассовых модулях. Запрос покупателя на аналогичные товары - напоминание фармацевту о замене в порядке приоритета, о расширении (связанная нозология/группа) - тоже в порядке приоритета с учетом принадлежности товаров к УСТМ и маркетинговому ассортименту в принципе.

Выкладка

1. Товар из выкладки всегда есть в мероприятиях бездефектурного наличия, поэтому дополнительные меры контроля наличия при соблюдении выше описанных рекомендаций не нужны.
2. Если в ПО есть признаки и интерфейс по работе с выкладкой (адресация выкладки, напоминания, авто-печать ценников и т.п.), то там везде можно учитывать этот признак автоматически. Подсвечивать в прайсе, если необходимо.
3. При приходовании товаров (в накладных или в ином интерфейсе) нужно подсвечивать и напоминать о необходимости выложить данный товар.

Товар дня

1. Если в ПО есть календарь мероприятий/ электронная отметка принадлежности к акционной витрине - можно использовать информацию там.
2. Можно заранее добавить нужные количества товара/какую-то часть плана в авто-заказ для каждой участвующей аптеки. Избежать таким образом акционной дефектуры.
3. Если есть возможность автоматической настройки скидок под мероприятие на определенный период - можно также использовать поступившую информацию.
4. Можно использовать для мотивации персонала, загружая планы в систему напрямую/распределяя между сотрудниками.
5. Напоминание первостольнику в кассовом модуле при запросе товара из нозологии/группы аналогов. Напоминание на расширение покупки при заказе связанной группы товаров.
6. Мотивация персонала: план на аптеку/фармацевта в ПО, отчеты, мониторинг выполнения планов, баллы за продажу и т.п.
7. Внутренний мониторинг сетью/аптекой выполнения планов АСНА в отчетности. Более оперативен относительно куба и портала АСНА - так как данные не надо валидировать и ждать обменов.

Скачать описание мероприятий в виде файла Excel

Рекомендуемые поставщики

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

ВНИМАНИЕ!

Справочник содержит очень большое количество записей, поэтому необходимо запрашивать его частями. Если в ответе пришло количество записей меньше чем запрашиваемое количество, то вы получили все имеющиеся записи на данный момент. Кроме этого существует возможность получить справочник рекомендуемых поставщиков другим способом, см. Справочник связей маркетинговый производитель - поставщик и Справочник связей товар - маркетинговый производитель

GET /v5/references/recommended_suppliers?rv={rv}&count={count}&rvInt={rvInt}&actual={false|true}

Описание

Получить справочник рекомендуемых поставщиков по протоколу версии 5, count строк, начиная с версии rv (массив байт) или версии rvInt (int64)

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 100000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.
actual	bool		Если true, то возвращает только актуальные записи за текущий период. Не забывайте в этом случае перед получением зачищать все полученные ранее данные по рекомендуемым поставщикам в своей базе. Следует иметь в виду, что с этим параметром при получении данных частями, если в момент получения какая-либо запись стала неактуальной, то она не будет передана. Таким образом до следующего получения полного списка, эта строка будет у вас числиться актуальной. По умолчанию false.
test	bool		Если true, то вы получите тестовый набор данных

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/references/recommended_suppliers?rv=AAAAAACRObs=&count=4 HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "nnt": 102010,
    "inn": "1660169622",
    "begDate": "2019-04-01T00:00:00+00:00",
    "endDate": "2019-06-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAACRObs=",
    "rvInt": 9517499
  },
  {
    "nnt": 102010,
    "inn": "2130174989",
    "begDate": "2019-04-01T00:00:00+00:00",
    "endDate": "2019-06-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAACRObw=",
    "rvInt": 9517500
  },
  {
    "nnt": 102010,
    "inn": "2308169476",
    "begDate": "2019-04-01T00:00:00+00:00",
    "endDate": "2019-06-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAACROb0=",
    "rvInt": 9517501
  },
  {
    "nnt": 102010,
    "inn": "2311074538",
    "begDate": "2019-04-01T00:00:00+00:00",
    "endDate": "2019-06-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAACROb4=",
    "rvInt": 9517502
  }
]

Имя	Тип	Описание
nnt	int	Уникальный код товара по справочнику АСНА
inn	string	ИНН поставщика
begDate	datetime	Дата начала действия рекомендуемого поставщика
endDate	datetime	Дата окончания действия рекомендуемого поставщика
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Рекомендуемые поставщики по ИНН

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

POST /v5/references/recommended_suppliers?rv={rv}&count={count}&rvInt={rvInt}&actual={false|true}

Описание

Получить справочник рекомендуемых поставщиков, по списку ИНН, по протоколу версии 5, count строк, начиная с версии rv (массив байт) или версии rvInt (int64)

Параметры запроса

Имя	Тип	Обяз.	Описание
count	int		Количество возвращаемых записей, для загрузки частями. Не должно превышать 100000.
rv	byte[]		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных. В JSON массив байт представлен в кодировке base64.
rvInt	long		Версия последней записи, для загрузки частями. Берется текущее максимальное значение поля из базы данных.
actual	bool		Если true, то возвращает только актуальные записи за текущий период. Не забывайте в этом случае перед получением зачищать все полученные ранее данные по рекомендуемым поставщикам в своей базе. Следует иметь в виду, что с этим параметром при получении данных частями, если в момент получения какая-либо запись стала неактуальной, то она не будет передана. Таким образом до следующего получения полного списка, эта строка будет у вас числиться актуальной. По умолчанию false.
test	bool		Если true, то вы получите тестовый набор данных

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json
Accept	application/json или application/x-json-full

Тело запроса

Массив строк(ИНН поставщиков) в формате JSON, см. пример ниже

Пример запроса

POST /v5/references/recommended_suppliers?rv=AAAAAACRObs=&count=4 HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

[ "0273099415", "0278058074", "1657147234", "1659025432" ]

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со справочником.

Пример ответа

[
  {
    "nnt": 102010,
    "inn": "0273099415",
    "begDate": "2019-04-01T00:00:00+00:00",
    "endDate": "2019-06-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAACRObs=",
    "rvInt": 9517499
  },
  {
    "nnt": 102010,
    "inn": "0273099415",
    "begDate": "2019-04-01T00:00:00+00:00",
    "endDate": "2019-06-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAACRObw=",
    "rvInt": 9517500
  },
  {
    "nnt": 102010,
    "inn": "0278058074",
    "begDate": "2019-04-01T00:00:00+00:00",
    "endDate": "2019-06-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAACROb0=",
    "rvInt": 9517501
  },
  {
    "nnt": 102010,
    "inn": "1657147234",
    "begDate": "2019-04-01T00:00:00+00:00",
    "endDate": "2019-06-30T00:00:00+00:00",
    "actual": true,
    "rv": "AAAAAACROb4=",
    "rvInt": 9517502
  }
]

Имя	Тип	Описание
nnt	int	Уникальный код товара по справочнику АСНА
inn	string	ИНН поставщика
begDate	datetime	Дата начала действия рекомендуемого поставщика
endDate	datetime	Дата окончания действия рекомендуемого поставщика
actual	bool	Признак актуальности строки
rv	byte[]	Версия строки. В JSON массив байт представлен в кодировке base64.
rvInt	int	Версия строки

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Маркетинговые планы

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

GET /v5/stores/{storeId}/marketing?type={typeId}&test={false|true}

Описание

Получить планы по маркетинговым мероприятиям для аптеки storeId по протоколу версии 5, с типом typeId

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА
type	int		Тип мероприятия, параметр не является обязательным, если его не указать то вернутся все типы. Таблица с типами мероприятий расположена в конце раздела. Можно передать несколько типов мероприятий, например type=13&type=16&type=9
test	bool		Если true, то вы получите тестовый набор данных
full	bool		Если true, то получать не только со статусом Активно, но и с другими статусами. По умолчанию false

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/marketing HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON с планами.

Пример ответа

{
    "full":true,
    "currentVersion":22,
    "headers":[
        {
            "id":1,
            "name":"Мероприятие 1",
            "begDate":"2019-02-01T00:00:00+00:00",
            "endDate":"2019-03-31T23:59:59+00:00",
            "typeId":9,
            "type":"Бездефектурное наличие"
            "stateId":2
            "stateName":"Оплачено"
        },
        {
            "id":63,
            "name":"Мероприятие 2",
            "begDate":"2019-02-01T00:00:00+00:00",
            "endDate":"2019-03-31T23:59:59+00:00",
            "typeId":9,
            "type":"Бездефектурное наличие",
            "status":1
            "stateId":2
            "stateName":"Оплачено"
        }
    ],
    "plans":[
        {
            "actionId":1,
            "periodYM":201902,
            "nnt":108821,
            "qnt":28
        },
        {
            "actionId":63,
            "periodYM":201903,
            "nnt":108824,
            "qnt":28,
            "status":1
        }
    ]
}

Объект ответа

Имя	Тип	Описание
full	bool	Признак того что в пакете пришли все мероприятия, а не только изменения (пока true для всех пакетов)
currentVersion	int	Версия данных (пока не используется)
headers	Header[]	Массив заголовков маркетинговых мероприятий
plans	Plan[]	Массив планов мероприятий

Объект ответа Header

Имя	Тип	Описание
id	int	Уникальный код мероприятия
name	string	Наименование мероприятия
begDate	datetime	Дата начала действия мероприятия
endDate	datetime	Дата окончания действия мероприятия
typeId	int	Код типа мероприятия
type	string	Наименование типа мероприятия
status	int	Признак удаления (1 - удалена)
stateId	int	Код состояния мероприятия
stateName	string	Состояние мероприятия

Объект ответа Plan

Имя	Тип	Описание
actionId	int	Уникальный код мероприятия
periodYM	int	Месяц, на который рассчитан план (ггггмм).
nnt	int	Код номенклатуры по справочнику АСНА
qnt	float	План в упаковках
nntParent	int	Код основного товара по справочнику АСНА
cip	decimal	АСНА CIP-цена
bonusPerPiece	decimal	Бонус в рублях на упаковку
sum	decimal	План в рублях
status	int	Признак удаления (1 - удалена)
pf	bool	Признак ПФ (парафарма)

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Типы маркетинговых мероприятий

Код	Название	Описание
9	Бездефектурное наличие	Ежедневное наличие на остатках. Передаются поля nnt, qnt (равно 1 для рекомендуемого наличия), nntParent (если есть)
10	Выкладка	Ежедневное наличие на витринах. Передаются поля nnt, nntParent (если есть)
13	Маркетинговый ассортимент	Наличие в маркетинговом асортименте. Передаются поля nnt, nntParent (если есть), cip
15	Товар дня	План продаж. Передаются поля nnt, cip, qnt, bonus, nntParent (если есть)
16	УСТМ	План закупок. Передаются поля nnt, cip, sum

Маркетинговые планы по сети

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

GET /v5/nets/{storeId}/marketing?type={typeId}

Описание

Получить планы по маркетинговым мероприятиям для сети, в которую входит аптека со storeId по протоколу версии 5, с типом typeId

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА
type	int		Тип мероприятия, параметр не является обязательным, если его не указать то вернутся все типы. Таблица с типами мероприятий расположена в конце раздела. Можно передать несколько типов мероприятий, например type=13&type=16&type=9
full	bool		Если true, то получать не только со статусом Активно, но и с другими статусами. По умолчанию false

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/nets/BC164E55-B612-4A04-800B-34CCF10F6858/marketing HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON с планами.

Пример ответа

{
    "full":true,
    "currentVersion":22,
    "headers":[
        {
            "id":1,
            "name":"Мероприятие 1",
            "begDate":"2019-02-01T00:00:00+00:00",
            "endDate":"2019-03-31T23:59:59+00:00",
            "typeId":9,
            "type":"Бездефектурное наличие"
            "stateId":2
            "stateName":"Оплачено"
        },
        {
            "id":63,
            "name":"Мероприятие 2",
            "begDate":"2019-02-01T00:00:00+00:00",
            "endDate":"2019-03-31T23:59:59+00:00",
            "typeId":9,
            "type":"Бездефектурное наличие",
            "status":1
            "stateId":2
            "stateName":"Оплачено"
        }
    ],
    "plans":[
        {
            "actionId":1,
            "periodYM":201902,
            "nnt":108821,
            "qnt":28
        },
        {
            "actionId":63,
            "periodYM":201903,
            "nnt":108824,
            "qnt":28,
            "status":1
        }
    ]
}

Объект ответа

Имя	Тип	Описание
full	bool	Признак того что в пакете пришли все мероприятия, а не только изменения (пока true для всех пакетов)
currentVersion	int	Версия данных (пока не используется)
headers	Header[]	Массив заголовков маркетинговых мероприятий
plans	Plan[]	Массив планов мероприятий

Объект ответа Header

Имя	Тип	Описание
id	int	Уникальный код мероприятия
name	string	Наименование мероприятия
begDate	datetime	Дата начала действия мероприятия
endDate	datetime	Дата окончания действия мероприятия
typeId	int	Код типа мероприятия
type	string	Наименование типа мероприятия
status	int	Признак удаления (1 - удалена)
stateId	int	Код состояния мероприятия
stateName	string	Состояние мероприятия

Объект ответа Plan

Имя	Тип	Описание
actionId	int	Уникальный код мероприятия
periodYM	int	Месяц, на который рассчитан план (ггггмм).
nnt	int	Код номенклатуры по справочнику АСНА
qnt	float	План в упаковках
nntParent	int	Код основного товара по справочнику АСНА
sum	decimal	План в рублях
status	int	Признак удаления (1 - удалена)

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Маркетинговые группы и бонусы

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

GET /v5/stores/{storeId}/marketing_groups_bonuses

Описание

Получить информацию по маркетинговым группам и бонусам для аптеки storeId по протоколу версии 5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/marketing_groups_bonuses HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON с планами.

Пример ответа

[
  {
    "nnt": 109398,
    "actionId": 10856,
    "groupId": 2,
    "bonusGrnt": 6.8,
    "bonusMin": 13.6,
    "bonusMid": 6.8,
    "bonusMax": 13.6
  },
  {
    "nnt": 110042,
    "actionId": 10856,
    "groupId": 2,
    "bonusGrnt": 6.8,
    "bonusMin": 13.6,
    "bonusMid": 6.8,
    "bonusMax": 13.6
  },
  {
    "nnt": 111745,
    "actionId": 10856,
    "groupId": 2,
    "bonusGrnt": 6.8,
    "bonusMin": 13.6,
    "bonusMid": 6.8,
    "bonusMax": 13.6
  }
]

Имя	Тип	Описание
nnt	int	Уникальный код товара АСНА
actionId	int	Уникальный код мероприятия
groupId	int	Группа товара ( 1 - Группа 1, 2 - Группа 2, 3 - Группа 3 УСТМ)
bonusGrnt	decimal	Бонус 1. Гарантированный
bonusMin	decimal	Бонус 2. Минимальный
bonusMid	decimal	Бонус 3. Средний
bonusMax	decimal	Бонус 4. Максимальный

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Ассортиментный план

Получение ассортиментного плана

Ежедневно, желательно не чаще одного раза в сутки, вы можете получать ассортиментный план аптеки.

GET /v5/stores/{storeId}/assortment_plan

Описание

Получить ассортиментный план для аптеки storeId по протоколу версии 5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

HTTP

GET /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/assortment_plan HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw

C# (RestSharp)

var client = new RestClient("http://api.asna.cloud/v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/assortment_plan");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
request.AddHeader("Authorization", "Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

CURL

curl --location --request GET 'http://api.asna.cloud/v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/assortment_plan' --header 'Accept: application/json' --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw'

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON с планом.

Пример ответа

{
    "planId": "676A6268-5586-4BA7-99E0-CE567A0676DE",
    "loadDate": "2019-12-03T15:07:49+00:00",
    "plans": [
        {
            "nnt": 110680,
            "statusId": 1,
            "status": "Оставлено в АП",
            "method": "Метод не задан"
            "qnt": 1
        },
        {
            "nnt": 112484,
            "statusId": 1,
            "status": "Оставлено в АП",
            "method": "Метод не задан"
            "qnt": 2
        },
        {
            "nnt": 113579,
            "statusId": 1,
            "status": "Оставлено в АП",
            "methodId": 1,
            "method": "Переключение покупателя на приоритетную позицию"
            "qnt": 1
        }]
}

Объект ответа

Имя	Тип	Описание
planId	Guid	Уникальный идентификатор плана
loadDate	datetime	Дата загрузки ассортиментного плана в систему
plans	AssortmentPlanRow[]	Массив планов мероприятий

Объект ответа AssortmentPlanRow

Имя	Тип	Описание
nnt	int	Уникальный код товара
bdn	bool	Признак БДН
statusId	int	Уникальный идентификатор статуса
status	string	Статус
methodId	int	Уникальный идентификатор метода
method	string	Метод
qnt	int	Количество

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Статусы строк ассортиментного плана

Ид	Наименование
1	Оставлено в АП
2	Исключено из АП
3	Добавлено в АП_БДН-позиция
4	Добавлено в АП_Эксклюзивы
5	Добавлено в АП_Группа 3 УСТМ

Методы строк ассортиментного плана

Ид	Наименование
1	Переключение покупателя на приоритетную позицию
2	Поддержание текущих продаж
3	Чистка кластера
4	Приоритетная рекомендация

Подтверждение обработки ассортиментного плана

После обработки полученного ассортиментного плана, аптека должна отправить результаты обработки в АСНА.

POST /v5/stores/{storeId}/assortment_plan

Описание

Отправить результаты обработки ассортиментного плана для аптеки storeId по протоколу версии 5

Параметры запроса

Имя	Тип	Обяз.	Описание
storeId	GUID		Идентификатор аптеки по справочнику АСНА

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Тело запроса

Объект запроса AssortmentPlanAcceptance

Имя	Тип	Обяз.	Описание
planId	Guid		Уникальный идентификатор ассортиментного плана
acceptance	AssortmentPlanAcceptanceRow[]		Массив объектов AssortmentPlanAcceptanceRow

Объект запроса AssortmentPlanAcceptanceRow

Имя	Тип	Обяз.	Описание
nnt	int		Уникальный код товара АСНА
statusId	int		Код статуса обработки. 1 - Оставили, 2- Удалили, 3 - Добавили

Пример запроса

HTTP

POST /v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/assortment_plan HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

{
   "planId":"676A6268-5586-4BA7-99E0-CE567A0676DE",
   "acceptance":[
      {
         "nnt":110738,
         "statusId":1
      },
      {
         "nnt":110739,
         "statusId":2
      }
   ]
}

C# (RestSharp)

var client = new RestClient("http://api.asna.cloud/v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/assortment_plan");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Accept", "application/json");
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw");
request.AddParameter("application/json", "{\"planId\":\"676A6268-5586-4BA7-99E0-CE567A0676DE\",\"acceptance\":[{\"nnt\":110738,\"statusId\":1},{\"nnt\":110739,\"statusId\":2}]}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

CURL

curl --location --request POST 'http://api.asna.cloud/v5/stores/BC164E55-B612-4A04-800B-34CCF10F6858/assortment_plan' --header 'Accept: application/json' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw' --data-raw '{
   "planId":"676A6268-5586-4BA7-99E0-CE567A0676DE",
   "acceptance":[
      {
         "nnt":110738,
         "statusId":1
      },
      {
         "nnt":110739,
         "statusId":2
      }
   ]
}'

Успешный ответ

HTTP cтатус	Значение
201	Created. Данные успешно записаны

Пример ответа

HTTP/1.1 201 Created

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Прочие возможности

Информирование о событиях API (Webhooks)

АСНА REST API может уведомлять заинтересованных подписчиков о событиях, происходящих в сервисе. Например, вы можете получать уведомление о поступлении новых заказов или об успешной загрузке ваших остатков в облако. Для это API использует технологию Webhooks, т.е. осуществляет HTTP запросы на ваши адреса, зарегистрированные в API. Использование уведомлений возможно, если ваши сервисы находятся в открытом доступе и имеют либо постоянный IP адрес, либо постоянное доменное имя. В случае отсутствия постоянного доменного имени или адреса можно воспользоваться службами Dynamic DNS или утилитами, типа ngrok¹ . За консультацией вы можете обратиться в Отдел веб-сервисов компании АСНА.

Список событий, поддерживаемых API

Название	Описание
stocks_full	Приняты полные остатки аптеки
stocks_updates	Приняты изменения остатков аптеки
preorders_full	Принят полный сводный прайс-лист юрлица
preorders_updates	Приняты изменения сводного прайс-листа юрлица
orders_updates_store	Приняты изменения заказов со стороны аптеки
orders_updates_site	Приняты изменения заказов со стороны сайта

Безопасность webhooks

В целях обеспечения безопасности, при запросе на ваш адрес, в заголовке X-Signature запроса мы передаем хэш (HMAC SHA256) тела запроса.

POST / HTTP/1.1
X-Signature: sha256=37B1103A5B784AEABC772167F7232EECC2886048FC85CB482F0DB45EB2199DDC
Content-Type: application/json; charset=utf-8
Host: 09a08e915c7a.ngrok.io
Content-Length: 189

{
    "ClientId":"BC164E55-B612-4A04-800B-34CCF10F6858",
    "Event":"stocks_full",
    "Message":"Processed",
    "MessageId":"9ebec167-ddf5-4de0-b4df-c4c1749afb1a",
    "Date":"2017-07-25T12:47:05.1210444+00:00"
}

При получении запроса на ваш URL, вы можете вычислить хэш тела запроса по алгоритму SHA256 и сравнить его значение с содержимым заголовка X-Signature. В случае если вычисленное вами значение совпадает с тем, что находится в заголовке, вы обрабатываете запрос, иначе отклоняете его.

Алгоритм формирования значения заголовка X-Signature

• Содержимое тела запроса в виде массива байт хэшируется по алгоритму SHA256 с использованием секретного ключа.
• Полученный массив байт переводим в строку с шестнадцатиричным кодированием (hex-encoded string)
• Спереди к полученной строке добавляем строку sha256=

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

Получение ключа

Клиенты, которые желают защитить от несанкционированного доступа свои URL, используемые для получения уведомлений от АСНА REST API, должны получить ключ, который будет использоваться для формирования подписи запроса.

GET /v5/keys/webhooks

Описание

Получить ключ для проверки подписи webhooks по протоколу v5

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json

Пример запроса

GET /v5/keys/webhooks HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	OK. Ключ выдан.

Пример ответа

HTTP/1.1 200 OK
Content-Type: application/json

{
  "secret": "9xU78vt430"
}

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Подписка на события

Клиенты, которые желают получать уведомление от API о событии, должны подписаться на это событие.

POST /v5/events/{eventName}

Описание

Подписаться на событие eventName по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
eventName	string		Название события

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Пример запроса

POST /v5/events/stocks_full HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

{
    "clientId": "BC164E55-B612-4A04-800B-34CCF10F6858",
    "url": "http://mycompany.ru/webhooks_handler"
}

Имя	Тип	Обяз.	Описание
clientId	GUID		Уникальный идентификатор клиента по справочнику АСНА (например, если нужно получить уведомление о событии приема полных остатков по определенной аптеке, то в качестве clientId подставляется уникальный идентификатор этой аптеки )
url	string		URL, на который API должен делать запрос при возникновении события

Успешный ответ

HTTP cтатус	Значение
201	Created. Новая подписка создана.

Пример ответа

HTTP/1.1 201 Created

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Обновление информации о подписке

Клиенты могут изменить подписку на событие, например, при изменении URL, который должен вызывать API.

PUT /v5/events/{eventName}

Описание

Изменить подписку на событие eventName по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
eventName	string		Название события

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Пример запроса

PUT /v5/events/stocks_full HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

{
    "clientId": "BC164E55-B612-4A04-800B-34CCF10F6858",
    "url": "http://mycompany.ru/new_webhooks_handler"
}

Имя	Тип	Обяз.	Описание
clientId	GUID		Уникальный идентификатор клиента по справочнику АСНА (например, если нужно получить уведомление о событии приема полных остатков по определенной аптеке, то в качестве clientId подставляется уникальный идентификатор этой аптеки )
url	string		URL, на который API должен делать запрос при возникновении события

Успешный ответ

HTTP cтатус	Значение
200	OK. Подписка изменена.

Пример ответа

HTTP/1.1 200 OK

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Удаление подписки

Клиенты могут удалить подписку на событие, если в ней больше нет необходимости.

DELETE /v5/events/{eventName}

Описание

Удалить подписку на событие eventName по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
eventName	string		Название события

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Пример запроса

DELETE /v5/events/stocks_full HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Content-Type: application/json
Cache-Control: no-cache

{
    "clientId": "BC164E55-B612-4A04-800B-34CCF10F6858"
}

Имя	Тип	Обяз.	Описание
clientId	GUID		Уникальный идентификатор клиента по справочнику АСНА (например, если нужно удалить уведомление о событии приема полных остатков по определенной аптеке, то в качестве clientId подставляется уникальный идентификатор этой аптеки )

Успешный ответ

HTTP cтатус	Значение
204	No Content. Подписка удалена.

Пример ответа

HTTP/1.1 204 No Content

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Проверка отложенной обработки

Если вы, при вызове API, получили в ответ HTTP-статус 202 Accepted, то это значит что переданные данные требуют отложенной обработки и были поставлены в очередь на обработку. В этом случае HTTP-заголовок Location содержит URL, запросив который вы получите статус обработки.

Проверить статус отложенной обработки можно несколькими способами.

1. Через вызов API, описанный в этом разделе, можно получить информацию о статусе отложенной обработки.
2. Получить статус отложенной обработки можно, кроме вышеописанного, способом, описанным в Информирование о событиях API (Webhooks).
3. Запросить через API остатки назад и убедиться что они соответствуют отправленным Получение информации по остаткам аптеки.
4. Получить информацию об остатках и прайс-листах можно через бота.

GET /v5/messages/{messageId}/status

Описание

Получить информацию о статусе отложенной обработки упаковки данных c messageId по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
messageId	GUID		Идентификатор упаковки данных

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Accept	application/json или application/x-json-full

Пример запроса

GET /v5/messages/0e238a6a-c9f7-435f-9f9e-a9257e613879/status HTTP/1.1
Host: api.asna.cloud
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjdGQzk0RDU4N0UzQzg4QUM0M0FDQkQyOEU0Njk4RDZCOTE3RkQyOUUiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJmOGxOV0g0OGlLeERyTDBvNUdtTmE1Rl8wcDQifQ.eyJuYmYiOjE0OTE1NzY2MDcsImV4cCI6MTQ5MTU4MDIwNywiaXNzIjoiaHR0cHM6Ly9zc28uYXNuYS5jbG91ZDoxODgxIiwiYXVkIjpbImh0dHBzOi8vc3NvLmFzbmEuY2xvdWQ6MTg4MS9yZXNvdXJjZXMiLCJhcGkiXSwiY2xpZW50X2lkIjoiRTQ1RDM0OTEtNzlFRS00RUVBLTkyQjItMjJDRUJFNEJCOEI1IiwiY2xpZW50X2FjY2VzcyI6WyJzdG9ja3MuZWRpdCIsInN0b2Nrcy5mdWxsX2FjY2VzcyIsInN0b2Nrcy52aWV3Il0sInNjb3BlIjpbImFwaSJdfQ.OvGjvdbOk6QI3CNRyjOmj5mSrUZ7v1LjWRgH9TjwhNTTKiEaww1iEr8CnSKOfpGUdhkFGiup8kzvW0PIsqrVZHEx2r5gmT9SO6orznDg-ESprgjjiBC-uYSSTzK_WmPZp-cjP4OVt8ovGY3ncNhrTYFmBy0CJh0XBtMmO5IkE9ASxyaw5Ou5by0SaMTF8Vh9ocE0Uaj8xf-m6ivKQYv_4gEsKs6XEjKBN0khfZGOvv1qQJ4iBn-fVtOqPUpv1ypcOskGZhVHo200ZjvPalbemV-51D45k1KZcE_K9qiYK8Y1vX_lzRDSaQI30PACuQc-VpB-WcCMAtVEEuo0paL2fw
Accept: application/json
Cache-Control: no-cache

Успешный ответ

HTTP cтатус	Значение
200	ОК. В теле ответа содержится JSON со связками.
204	No Content. Информации о пакете нет в БД

Пример ответа

{
  "id": 5,
  "messageId": "0e238a6a-c9f7-435f-9f9e-a9257e613879",
  "statusId": 2,
  "statusMessage": "Обработано",
  "statusDate": "2017-04-26T15:34:02.9112524+00:00"
}

Имя	Тип	Описание
id	int	Идентификатор записи
messageId	GUID	Идентификатор упаковки
statusId	int	Код статуса
statusMessage	string	Статус
statusDate	datetime	Дата статуса в формате ISO8601 в нулевом часовом поясе

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Статусы пакетов

Код (statusId)	Название	Описание
0	Accepted	Принято к обработке
1	Processing	Обрабатывается
2	Processed	Обработано
3	Error	Ошибка. Пакет не был обработан

Валидация данных в формате JSON

Иногда может возникнуть необходимость проверить отправляемые данные на соответствие формату JSON. Как правило, это происходит если API отклоняет запрос со статусом 400, но вы не можете обнаружить причину. Для проверки ваших данных, вы можете использовать следующий вызов API:

POST /v5/json_schemas/{schemaName}/validation

Описание

Валидировать данные по схеме schemaName по протоколу v5

Параметры запроса

Имя	Тип	Обяз.	Описание
schemaName	string		Имя схемы для валидации. Может принимать значения: stocks, preorders, orders, transactions

Заголовки запроса

Имя	Описание
Authorization	Bearer token
Content-Type	application/json

Тело запроса

Тело запроса должно содержать в формате JSON пакет, который требуется валидировать

Пример запроса

POST /v5/json_schemas/stocks/validation HTTP/1.1
Host: api.asna.cloud
Content-Type: application/json

{
    "date": "2018-11-22T16:01:13.032+03:00",
    "stocks": [
        {
            "prtId": 111445,
            "nnt": 6072,
            "qnt": 5,
            "doc": "1к",
            "supInn": "",
            "supId": "",
            "supDate": "",
            "nds": 0,
            "gnvls": 1,
            "dp": 0,
            "man": "Beaufour-ipsen",
            "series": "",
            "exp": 0,
            "prcMan": 120,
            "prcOpt": 0,
            "prcOptNds": 137.5,
            "prcRet": 170,
            "prcReestr": 0,
            "prcGnvlsMax": 170,
            "sumOpt": 0,
            "sumOptNds": 0,
            "mrGnvls": 0,
            "tag": 0
        },
        {
            "prtId": 8608872,
            "nnt": 29534,
            "qnt": 10,
            "doc": "1к",
            "supInn": "",
            "supId": "",
            "supDate": "",
            "nds": 0,
            "gnvls": 1,
            "dp": 0,
            "man": "Beaufour-ipsen",
            "series": "",
            "exp": 0,
            "prcMan": 115,
            "prcOpt": 0,
            "prcOptNds": 132,
            "prcRet": 164,
            "prcReestr": 0,
            "prcGnvlsMax": 164,
            "sumOpt": 0,
            "sumOptNds": 0,
            "mrGnvls": 0,
            "tag": 0
        }
    ]
}

Успешный ответ

HTTP cтатус	Значение
200	OK. Пакет не содержит ошибок

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

Пример ответа с ошибками валидации

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
   "statusCode":400,
   "isError":true,
   "isTransient":false,
   "exceptionMessage":"Please correct the specified validation errors and try again",
   "validationErrors":[
      {
         "field":"stocks[0].prtId",
         "message":"Line: 1 Position: 88 Value: 111445 Error: Invalid type. Expected String but got Integer."
      },
      {
         "field":"stocks[0].supDate",
         "message":"Line: 1 Position: 166 Value: Error: String '' does not validate against format 'date-time'."
      },
      {
         "field":"stocks[0].gnvls",
         "message":"Line: 1 Position: 188 Value: 1 Error: Invalid type. Expected Boolean, Null but got Integer."
      },
      {
         "field":"stocks[0].dp",
         "message":"Line: 1 Position: 197 Value: 0 Error: Invalid type. Expected Boolean, Null but got Integer."
      },
      {
         "field":"stocks[0].exp",
         "message":"Line: 1 Position: 246 Value: 0 Error: Invalid type. Expected String, Null but got Integer."
      },
      {
         "field":"stocks[1].prtId",
         "message":"Line: 1 Position: 436 Value: 8608872 Error: Invalid type. Expected String but got Integer."
      },
      {
         "field":"stocks[1].supDate",
         "message":"Line: 1 Position: 516 Value: Error: String '' does not validate against format 'date-time'."
      },
      {
         "field":"stocks[1].gnvls",
         "message":"Line: 1 Position: 538 Value: 1 Error: Invalid type. Expected Boolean, Null but got Integer."
      },
      {
         "field":"stocks[1].dp",
         "message":"Line: 1 Position: 547 Value: 0 Error: Invalid type. Expected Boolean, Null but got Integer."
      },
      {
         "field":"stocks[1].exp",
         "message":"Line: 1 Position: 596 Value: 0 Error: Invalid type. Expected String, Null but got Integer."
      }
   ]
}

Имя	Тип	Описание
field	string	Поле, в котором обнаружена ошибка
message	string	Описание ошибки

Возможна ситуация когда пакет не удается распарсить, в этом случае мы не можем понять в каких полях ошибка. Ниже пример такого ответа.

{
  "statusCode": 400,
  "isError": true,
  "isTransient": false,
  "exceptionMessage": "Invalid character after parsing property name. Expected ':' but got: 1. Path 'stocks[0]', line 5, position 20."
}

Неуспешный ответ

HTTP статус	Значение
400	Bad Request. Полученные службой данные содержат ошибки. Информация об ошибке возвращается в теле ответа.
401	Unauthorized. Токен авторизации неверный или истек срок его действия
403	Forbidden. У вас нет прав на выполнение данной операции
429	Too Many Requests. Слишком много запросов с одного IP адреса за промежуток времени
500	Internal Server Error. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса

---

1. Ngrok - утилита, обеспечивающая безопасные туннели для инструментов разработки и отладки вебхуков с локального хоста. Имеется бесплатная и платная версии. Ссылка ↩

Ended: Документация API

Техподдержка

Техподдержка

Тестирование АСНА REST API

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

Swagger

Помимо данного руководства, сервисы API АСНА предоставляют автоматически генерируемую документацию в формате Swagger (OpenAPI). Скачать ее можно по ссылке https://api.asna.cloud/swagger/v5/swagger.json. Существует целый ряд бесплатных и коммерческих инструментов, которые позволяют просматривать документацию в этом формате в структурированном виде. АСНА Web API имеет встроенный инструмент для просмотра документации в формате Swagger, которым можно воспользоваться, перейдя по адресу https://api.asna.cloud/swagger, либо Открыть его из документации. Указанный инструмент позволяет не только просматривать документацию, но и выполнять запросы к API.

Postman

Для тестирования любого REST API, не исключая и АСНА Web API, существует приложение Postman. Официальная страница приложения расположена по адресу https://www.getpostman.com , а само приложение можно скачать для вашей операционной системы по ссылке https://www.getpostman.com/apps . Приложение бесплатно. Postman удобнее всего использовать совместно со Swagger.

АСНА-бот

Для получения ссылки на эту документацию, а также для получения информации по аптеке, заказу, отправки информации об ошибке вы можете использовать бот.

Для подключения бота можно использовать ссылки, указанные ниже. Бот работает в популярных мессенджерах Skype и Telegram, Facebook Messenger, Slack, а также в Webchat и по электронной почте.

Skype:

Веб клиент Skype, кроме того, расположен в правом нижнем углу этой страницы (голубой круг).

Telegram: @AsnaWebBot

Slack:

Facebook Messenger:

Email: bot@asna.cloud

Webchat: Бот в Webchat

Если у вас есть предложения по добавлению в бота функционала, то пишите на адрес техподдержки.

7KkALBzGNB5ye4CEJcUPBg==;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;^

Содержимое данной страницы защищено

Свяжитесь с автором для получения пароля!

Swagger (OpenAPI спецификация)

ВНИМАНИЕ!

Если вы видите ошибку на экране, переключитесь, пожалуйста, на протокол версии V5 в SwaggerUI вместо V1. Мы исправим это в следующей версии сервиса.

hKmDqTIXIbVJduVQUgyhOg==;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;^

Содержимое данной страницы защищено

Свяжитесь с автором для получения пароля!

Ended: Техподдержка

FAQ

Решение проблем при работе с API

ВОПРОС

Отправленные данные не появляются на сервисах АСНА.

При каждом вызове API сервис возвращает HTTP статус (код ответа, КодОтвета в 1С), именно он служит индикатором успешной или неуспешной передачи. Как правило, при успешном вызове, сервис возвращает статусы 200, 201, 202. Если при вызове сервис вернул 400 статус (Bad Request), то с большой вероятностью вы отправляете данные, которые не проходят первичную валидацию на сервере. При этом сервис возвращает в теле ответа информацию об ошибках в полученных данных и данные не поступают на дальнейшую обработку.

Если в теле ответа вы получили сообщение Missing required data или {«»:[«The input was not valid.»]}, то это говорит о том что JSON, который вы отправляете на сервис, не является валидным с точки зрения стандарта.

• Проверьте ваш JSON на наличие ошибок и соответствие стандарту через онлайн-валидаторы, такие как JSON Formatter & Validator и JSONLint.
• Убедитесь в том что JSON не содержит символа запятая в качестве разделителя дробной и целой части в числах, т.к. в стандарте запятыми разделяются поля. Убедитесь в том что в значениях полей типа string не содержатся двойные кавычки, т.к. в стандарте этот символ используется для указания начала и конца значения текстового поля. Если же в значении текстового поля необходимо передать символ двойной кавычки, то этот символ необходимо экранировать символом .
• Убедитесь в том что необязательные поля, которые вы не заполняете по тем или иным причинам, либо отсутствуют в сформированном JSON, либо имеют значение null. Убедитесь в том, что кодировка текста в передаваемых данных UTF-8. Данные должны пересылаться без маркера BOM.
• Внесите необходимые исправления и, при необходимости, снова проверьте онлайн-валидатором.

Если сформированный вами JSON валиден с точки зрения стандарта, но не проходит валидацию на обязательные поля и типы значений на сервере АСНА, то сервис вернет в теле ответа подробную информацию о том, какие поля не прошли валидацию.

• Для проверки вы можете использовать JSON схему, которая прилагается в виде ссылки в каждом разделе документации, связанном с передачей данных. Произвести валидацию по схеме вы можете по ссылке JSON Schema Lint. В левое окно загружается схема, в правое ваш JSON. Не забудьте указать версию спецификации схемы - draft-04.
• Внесите соответствующие изменения и повторите отправку.

Видео-инструкция по валидации данных с помощью схемы

ВОПРОС

При передаче данных на сервисы АСНА возвращается 400 «Missing required data».

Этот статус и сообщение сервисы АСНА возвращают, если не могут десериализовать присланные данные. Проверьте что кодировка JSON utf-8, а также наличие HTTP-заголовка Content-Type со значением application/json. Если json загружается в тело запроса из файла, то убедитесь что в тело запроса не попадает BOM (несколько байт перед началом json), например для utf-8 BOM EF BB BF.

ВОПРОС

Я получил токен на сервере авторизации и передаю его при вызовах API, но в ответ приходит HTTP статус 401.

Авторизационный токен действителен в течение некоторого времени (на данном этапе это время составляет 60 минут), это сделано для того, чтобы даже перехватив токен, злоумышленник не смог им пользоваться постоянно . Кроме того, короткоживущий токен позволяет быстро отключить от API клиентов, которые по тем или иным причинам прекратили сотрудничество с АСНА. В случае получения 401 статуса, клиентское ПО должно получить новый токен на сервере авторизации. Этот процесс подробно описан в разделе Авторизация в АСНА REST API документации.

ВОПРОС

Мы не видим своей аптеки на сайте asna.ru

Для того, чтобы аптека появилась на сайте asna.ru, необходимо выполнение следующих условий:

• Аптека должна выполнить интеграцию по протоколу АСНА Web API в части выгрузки полных остатков и изменений по остаткам, а также бронирования товара.
• Аптека должна регулярно выгружать по протоколу полные остатки (раз в сутки) и изменения остатков (раз в 10 минут), если было товародвижение за этот интервал времени. При отсутствии выгрузки полных остатков более 24 часов, аптека убирается с сайта.
• На Портале настроек АСНА-Экономия у данной аптеки должны быть выполнены настройки в разделе Центр управления параметрами АСНА-Экономия: включено бронирование товара и выставлены параметры брони.

После включения настроек аптека появится на сайте после синхронизации настроек (1-2 часа). Для проверки даты остатков вы можете использовать АСНА-бот.

Если все три пункта выполнены, но аптеки на сайте нет, то обратитесь, пожалуйста, в техподдержку отдела веб-сервисов.

Авторизация

ВОПРОС

Не могу подключиться к серверу авторизации. В чем причина?

Сервер авторизации работает по адресу sso.asna.cloud, используя порт 5000 для протокола HTTPS и порт 6000 для протокола HTTP. Всегда используйте протокол HTTPS для работы с сервером авторизации, за исключением ситуаций, когда это физически невозможно. Если при подключении по HTTPS на порт 5000 возникают проблемы, а подключение к серверу авторизации по HTTP (порт 6000) работает, то убедитесь что ваше ПО использует для подключения по HTTPS один из следующих протоколов - TLS 1.0, TLS 1.1, TLS 1.2. Протоколы SSL 2.0, SSL 3.0 не поддерживаются, как устаревшие и небезопасные. Проверьте настройки Свойства браузера (Internet Options) в Панели управления, согласно приведенной ниже картинке:

Общий порядок действий при возникновении проблемы подключения к серверу авторизации

1. Убедитесь в том что ваш DNS сервер разрешает хост sso.asna.cloud в IP адрес, дав команду ping sso.asna.cloud в командной строке. Если вы увидели в ответе IP адрес, то DNS работает.
2. Убедитесь что вы запрашиваете корректный адрес. Это должен быть либо https://sso.asna.cloud:5000/connect/token , либо http://sso.asna.cloud:6000/connect/token.
3. Убедитесь что включена поддержка TLS 1.0 или TLS 1.1 или TLS 1.2 в Свойствах браузера.

Остатки товаров

ВОПРОС

Нужно ли выгружать разобранные упаковки на сайт?

Нет, не нужно. На сайт должны выгружаться только целые упаковки, цена должна соответствовать цене целой упаковки.

ВОПРОС

У нас к одному коду товара по справочнику АСНА привязано несколько наших кодов. Как нам выгружать остатки?

Если есть множественная привязка ваших товаров к одному по справочнику АСНА, то такие позиции выгружать на сайт не нужно. Для того чтобы эти товары попали на сайт, необходимо избавиться от множественных связок, используя возможности портала связок Alphaone.

ВОПРОС

У нас несколько партий товара с разными ценами. Почему на сайте мы видим не все партии?

Мы сворачиваем все остатки по номенклатуре, отбирая максимальную розничную цену и минимальный срок годности, при этом суммируя количество. Принцип, по которому идет сворачивание остатков, может в дальнейшем измениться.

ВОПРОС

Мы не видим нашей аптеки на сайте. В чем причина?

Причин может быть много, например, у аптеки сняли признак Активна, не выставлены признаки выгрузки на сайт и бронирования на портале Alphaone. Кроме этого, аптека убирается с сайта, если не было выгрузки полных остатков больше 24 часов. Все эти параметры можно проверить в боте отдела веб-сервисов АСНА Бот отдела веб-сервисов АСНА.

Бронирование

ВОПРОС

Что такое административная панель первостольника?

Административная панель первостольника это закрытая часть сайта, в которую возможен доступ только сотрудникам аптеки. В этой административной панели сотрудники аптеки могут видеть все заказы покупателей в этой аптеке, а также изменять их, при необходимости. Разработчики аптечного ПО могут реализовать возможность входа в админку первостольника непосредственно из ПО, например по кнопке или пункту меню.

Ссылки на административную панель первостольника

Действие	Ссылка
Переход в админку	https://www.asna.ru/bitrix/admin/sale_order.php?lang=ru&guid={storeId}
Новый заказ	https://www.asna.ru/bitrix/admin/sale_order_create.php?lang=ru&SITE_ID=s1&guid={storeId}
Редактирование заказа	https://www.asna.ru/bitrix/admin/sale_order_edit.php?lang=ru&guid={storeId}&ID={num}

В ссылках необходимо подставить параметры storeId - уникальный идентификатор аптеки по справочнику АСНА, а num - номер заказа

ВОПРОС

Что делать, если при сборе заказа выяснилось что та или иная позиция заказа отсутствует в аптеке?

Так как процесс бронирования из наличия автоматизирован и предполагает что бронирование осуществляется по тем остаткам товара, которые числятся в ПО, то возможны ситуации, когда в ПО товар есть, а в наличии его нет (пересорт, недостача и т.д.). При обнаружении такой ситуации, аптека должна уведомить покупателя по телефону, а покупатель в свою очередь может либо отредактировать заказ либо отменить его. Именно для того, чтобы избежать таких ситуаций, мы просим выгружать нам остатки своевременно и из первоисточника (аптеки), а не из центральной БД (офиса), что, конечно, не устанит проблему на 100%, но уменьшит количество подобных ситуаций.

ВОПРОС

Как должна происходить продажа заказа, в котором есть товар и по наличию и по предзаказу?

Идеальная ситуация, к которой мы стремимся - один чек на один заказ, т.е. покупатель ожидает поступления всего предзаказа и только потом выкупает весь заказ. В случае, если заказ был сделан с терминала в аптеке или покупатель находится рядом с аптекой и хочет выкупить ту часть заказа, которая была забронирована из наличия, есть возможность выкупить заказ в два этапа. Сначала покупатель может выкупить то что было забронировано из наличия аптеки, затем, после получения подтверждения о поступлении предзаказа, выкупить оставшуюся часть. Продажа предзаказа в несколько этапов нежелательна и не предусмотрена, в крайнем случае, покупатель может выкупить то что уже поступило по предзаказу и отказаться от оставшейся части.

ВОПРОС

Может ли покупатель редактировать заказ, в котором есть товар по предзаказу?

Да, может, при этом ни добавлять товары по предзаказу, ни увеличивать количество товара по предзаказу будет невозможно, как только сайт получит 203 статус по заказу.

ВОПРОС

Может ли покупатель редактировать заказ с признаком АСНА-Экономия?

Да, может. При этом цены на товары будут перерасчитываться, исходя из суммы заказа. При уменьшении суммы заказа ниже порога АСНА-Экономии, признак АСНА-Экономия на заказ будет сброшен и покупатель получит заказ по черным (розничным) ценам.

ВОПРОС

Заказ был сделан по АСНА-Экономия, но при выкупе заказа покупатель решил отказаться от некоторых товаров. Как должна происходить продажа?

Заказ с признаком АСНА-Экономия не должен редактироваться через клиентское ПО. Есть два варианта:

1. Первостольник, через админку первостольника, может изменить заказ покупателя. Цены на товары могут перерасчитаться, исходя из суммы заказа. Желательно, чтобы ПО имело возможность быстро получить изменения с сайта, например, по нажатию на кнопку или пункт меню.
2. Покупатель может отменить заказ и купить товар, который ему нужен, по ценам аптеки.

ВОПРОС

Что делать если к одному sku по справочнику АСНА привязано 2 или более sku по справочнику номенклатуры аптеки?

В случае, если существуют множественные привязки (много кодов аптеки к одному коду АСНА), клиентское ПО должно иметь возможность проверять каждый код аптеки и бронировать актуальный товар.

Маркетинг

ВОПРОС

Может ли товар находиться в нескольких маркетинговых мероприятиях одного типа?

Один товар может находиться во всех мероприятиях, но не может находиться дважды в одном мероприятии.

ВОПРОС

nntParent - за что отвечает данное поле?

В некоторых мероприятиях есть основной товар и дополнительный. План рассчитывается только на основной товар, а если товар дополнительный, то у него будет заполнено parentNnt, а план нулевой. Дополнительные товары идут в зачет.

ВОПРОС

Для типа мероприятий 9 количество всегда равно 1, или есть исключения?

Количество не всегда равно 1. Возможны другие значения. 30(31) - обязательные товары для БДН, 1 - рекомендуемые товары для БДН(например, новый вводимый товар или товар, который сложно заказать у поставщиков)

ВОПРОС

periodYM - для чего нужен данный параметр, если у мероприятия есть период действия?

Например, мероприятие Товар дня, может быть на месяц, но мероприятие само годовое. И значения ННТ меняются от месяца к месяцу.

ВОПРОС

Меняется ли CIP-цена в зависимости от мероприятия?

Нет, не изменяется. CIP-цена одна для одного SKU во всех типах мероприятий.

Комментарии