YavaptekeAPI - Часть1 (Прайс-листы)¶
Клиенты, которые работают с сайтом yaVapteke, могут передавать через API полные остатки по аптекам, выгружать изменения по остаткам, а так же есть возможность удаление остатков.
Передача полных остатков аптеки¶
POST /v5/stores/{storeId}/stocks
Передать полные остатки по аптеке storeId по протоколу v5
Заголовки запросаЗаголовки запроса
| Authorization | Bearer token |
| Content-Type | application/json |
Параметры запросаПараметры запроса
| Имя | Тип | Обяз. | Описание |
| storeId | GUID | • | Идентификатор аптеки |
| Имя | Тип | Обяз. | Описание |
| date | datetime | • | Дата выгрузки остатков в формате ISO8601 с указанием часового пояса |
| stocks | Stock[] | • | Массив строк остатков |
| Имя | Тип | Обяз. | Описание |
| prtId | string | • | Уникальный код партии |
| barcode | string(50) | • | Штрих-код производителя |
| qnt | float | • | Текущее количество в партии |
| name | string(255) | • | Наименование |
| man | string(255) | • | Производитель |
| exp | datetime | • | Cрок годности в формате ISO8601. |
| prcRet | decimal | • | Цена реализации |
POST v5/stores/e294488f-a0b1-11ed-bf8f-001517d411ad/stocks
Host: yavapteke.ru/YavaptekeAPI/
Authorization: Bearer 08da627f-6773-4112-8355-47c94c7ac717
Content-Type: application/json
{
"date" : "2023-10-03T18:23:17+03:00",
"stocks":
[
{
"prtId": "08db9973-fd5e-470f-8702-c616ce0cbf30",
"barcode": "4601669000606",
"qnt": 5,
"name": "Парацетамол табл. 500мг N20",
"man": "Фармстандарт-Лексредства",
"exp": "2024-10-01",
"prcRet": 156
},
{
"prtId": "e29447ec-a0b1-11ed-bf5f-001517d411ad",
"barcode": "4604060998657",
"qnt": 10,
"name": "Рамни №20 табл. жев.",
"man": "Татхимфармпрепараты",
"exp": "2024-04-01",
"prcRet": 249
}
]
}
| 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. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса |
Передача изменений по остаткам аптеки¶
PUT /v5/stores/{storeId}/stocks
Выгрузить изменения по остаткам по аптеке storeId по протоколу v5
Заголовки запросаЗаголовки запроса
| Authorization | Bearer token |
| Content-Type | application/json |
Параметры запросаПараметры запроса
| Имя | Тип | Обяз. | Описание |
| storeId | GUID | • | Идентификатор аптеки |
| Имя | Тип | Обяз. | Описание |
| date | datetime | • | Дата выгрузки остатков в формате ISO8601 с указанием часового пояса |
| stocks | Stock[] | • | Массив строк остатков |
Объект запроса Stock (строка остатков)
| Имя | Тип | Обяз. | Описание |
| prtId | string | • | Уникальный код партии |
| barcode | string(50) | • | Штрих-код производителя |
| qnt | float | • | Текущее количество в партии |
| name | string(255) | • | Наименование |
| man | string(255) | • | Производитель |
| exp | datetime | • | Cрок годности в формате ISO8601. |
| prcRet | decimal | • | Цена реализации |
PUT v5/stores/e294488f-a0b1-11ed-bf5f-001517d411ad/stocks
Host: yavapteke.ru/YavaptekeAPI/
Authorization: Bearer 08da627f-6773-4112-8365-47c94c7ac717
Content-Type: application/json
{
"date" : "2023-10-03T18:23:17+03:00",
"stocks":
[
{
"prtId": "08db9973-fd5e-470f-8702-c616ce0cbf30",
"barcode": "4601669000606",
"qnt": 4,
"name": "Парацетамол табл. 500мг N20",
"man": "Фармстандарт-Лексредства",
"exp": "2024-10-01",
"prcRet": 155
},
{
"prtId": "e29447ec-a0b1-11ed-bf5f-001517d411ad",
"barcode": "4604060998657",
"qnt": 9,
"name": "Рамни №20 табл. жев.",
"man": "Татхимфармпрепараты",
"exp": "2024-04-01",
"prcRet": 248
}
]
}
| 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/stores/{storeId}/stocks
Удаление всех остатков по аптеке storeId по протоколу v5
Заголовки запросаЗаголовки запроса
| Authorization | Bearer token |
| Content-Type | application/json |
Параметры запросаПараметры запроса
| Имя | Тип | Обяз. | Описание |
| storeId | GUID | • | Идентификатор аптеки |
DELETE v5/stores/e294488f-a0b1-11ed-bf5f-001517d411ad/stocks
Host: yavapteke.ru/YavaptekeAPI/
Authorization: Bearer 08da627f-6773-4112-8355-47c94c7ac717
Content-Type: application/json
| 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. Ошибка сервиса. Если ошибка повторяется, сообщите, пожалуйста, разработчикам сервиса |