Webhook

Загальна інформація

Клієнт надає Webhook URL для автоматичного отримання залишків аптек на свій сервер.

Запити будуть надходити по всіх аптеках, з різними ID аптеки в кінці URL.

1. Налаштування сервера

Налаштуйте ендпоінт для прийому запитів з інформацією про актуальні залишки аптеки. Ендпоінт має приймати дані у форматі JSON методом POST

2. Реєстрація Webhook

Повідомте про бажання використовувати функцію Webhook та надайте ендпоінт вашого сервера для отримання даних.

Алгоритм роботи

1. Вивантаження залишків

Клієнт вивантажує залишки з аптеки наступними методами:

• Повне вивантаження залишків аптеки
• Часткове вивантаження залишків аптеки

2. Отримання залишків

Система отримує залишки з аптеки.

3. Надсилання POST-запиту на Webhook

Система автоматично надсилає POST-запит із JSON-даними на вказаний Webhook.

4. Обробка даних

Ваш сервер отримує POST-запит, обробляє JSON-дані.

URI

URI: //yourserver.com/pharmapoint/stock/{id}

Важливо!

URL довільний і обовя'зково має прйимати ID аптеки

НАШ сервер робить відправку інформації на цей URL методом POST з тілом запиту у JSON форматі.

Авторизація буде виконана через заголовок API-Key — унікальний API-ключ, що використовується клієнтом для аутентифікації та авторизації.

Параметри Webhook

URL запиту має містити змінну:

Ім'я	Тип	Обов'язковий	Опис
id	string	Так	Ідентифікатор аптеки

Параметри JSON

Ім'я	Тип	Обов'язковий	Опис
goods_id	string	Так	ID товару в аптеці
ext_goods_id	string	Так	ID товару Фармапоінт
quantity	float	Так	Кількість товару
vat	integer	Так	Відсоток ПДВ
online_price_vat	float	Так	Онлайн ціна з ПДВ
drugstore_price_vat	float	Так	Ціна в аптеці з ПДВ
series	string | null	Ні	Серія товару
expire_date	string | null	Ні	Термін придатності в форматі Y-m-d

інформація

Усі поля завжди присутні в запиті, але їх заповненість залежить від даних, отриманих від аптеки

Приклад JSON

Запит: //yourserver.com/pharmapoint/stock/75758

[
    {     
        "goods_id": "456790",
        "ext_goods_id": "17", 
        "quantity": 1,
        "vat": 20,
        "online_price_vat": 150,    
        "drugstore_price_vat": 160.8,
        "series": "123123",  
        "expire_date": "2021-12-31",
     },
     {     
        "goods_id": "456790", 
        "ext_goods_id": "17",
        "quantity": 1,
        "vat": 20,
        "online_price_vat": 150,    
        "drugstore_price_vat": 160.8,
        "series": "123123",  
        "expire_date": "2021-12-31",
     }
]

Приклад успішної відповіді

Ми відправляємо інформацію на Ваш сервер, і сервер повинен надіслати код статусу відповіді - 200