Нова інтеграція через Pharmapoint

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

Основний набір API методів для роботи аптечної мережі:

• Вивантаження довідників
• Робота з замовленнями

1. Алгоритм дій для аптечних мереж

1. Отримання доступів та документації

• отримання API-ключа;
• отримання технічної документації (опис методів).

2. Реалізація інтеграції на стороні клієнта

• виконання всіх необхідних технічних налаштувань;
• реалізація та застосування наданих API-методів відповідно до документації.

3. Тестування. Перевірка на наявність помилок

• якщо немає помилок — перехід до кроку 4$
• якщо є помилки тестування — повернення до кроку 2.

4. Надання доступів до SkarbOne (після успішного тестування)

• вашій аптечній мережі надаються всі необхідні доступи до SkarbOne;

• передаються інструкції з встановлення та використання мобільного додатку.

2. Обов'язкові API методи для роботи зі SkarbOne

Обов'язкові API методи:

• Вивантаження залишків аптеки

• Вивантаження довідника аптек — /api/v1/marketplace/drugstore/import

• Вивантаження довідника товарів — /api/v1/marketplace/goods/import

• Вивантаження довідника фармацевтів — /api/v1/marketplace/users/import

• Отримання всіх необроблених замовлень — /api/v1/marketplace/order
  або
  Отримання всіх необроблених замовлень в аптеці — /api/v1/marketplace/drugstore/{drugstore_id}/order

• Отримання всіх оброблених замовлень за період — /api/v1/marketplace/order/all

• Оновлення замовлень — /api/v1/marketplace/order

Особливості методів API для роботи зі SkarbOne

API методи	Особливості
Вивантаження довідника товарів	Для коректної роботи з рецептами необхідно максимально повно заповнити такі поля: коди постачальників, штрихкод та код Моріон
Вивантаження довідника фармацевтів	ID аптек, які вивантажаються для фармацевта, будуть доступні користувачу SkarbOne
Вивантаження довідника лікарів	Вивантажується за потреби, якщо потрібне внесення даних лікаря безпосередньо в чек
Вивантаження залишків аптеки	Для роботи з партіями: використовуйте поле drugstore_goods_id для передачі ID партії. Важливо: значення drugstore_goods_id повинно бути унікальним і відмінним від загального goods_id Для роботи з програмою лояльності: обов'язково передавайте закупівельну ціну в полі buy_price_vat
Отримання всіх оброблених замовлень	Отримання онлайн-замовлень, які були підтверджені або скасовані в застосунку SkarbOne. Якщо замовлення не створене в обліковій системі і має статус canceled — його слід ігнорувати. Якщо замовлення не створене в обліковій системі і має інший статус — необхідно створити його в обліковій системі із поточним статусом. Якщо замовлення вже створене в обліковій системі — потрібно оновити його статус відповідно до актуального
Оновлення замовлень	Під час роботи з партіями товару обов'язково передавайте параметр goods.batch. Об'єкт goods має містити всі отримані або змінені поля, оскільки при оновленні замовлення товарні позиції в базі даних повністю перезаписуються. При оновленні замовлень (у межах роботи з програмою лояльності) облікова система повинна зберігати значення поля drugstore_order_number, згенероване в мобільному застосунку. Це поле є унікальним ідентифікатором операцій у межах програми лояльності, тому його збереження необхідне для запобігання дублюванню операцій з бонусами (повторному нарахуванню або списанню)

3. Особливості обробки статусів замовлення

Статус замовлення	Особливості
check_by_online_site	Продаж з онлайн сайту. Якщо замовлення вже існує в обліковій системі — необхідно оновити його в обліковій системі та викликати метод Оновлення замовлень зі статусом check. Якщо замовлення відсутнє в обліковій системі — слід створити його з відповідним статусом та викликати метод Оновлення замовлень зі статусом check
canceled_by_marketplace	Відміна з майданчика. Якщо замовлення існує в обліковій системі — необхідно скасувати його в обліковій системі та викликати метод Оновлення замовлень зі статусом canceled. Якщо замовлення відсутнє в обліковій системі — необхідно викликати метод Оновлення замовлень зі статусом canceled, не створюючи замовлення в обліковій системі
processed_by_pharmacy	Оброблено в аптеці. Якщо замовлення нове — необхідно створити його в системі та змінити статус на Готовий до видачі. Провести резервування товару або списання із залишків
canceled	Відміна замовлення: Якщо замовлення вже створене в обліковій системі — необхідно його скасувати. Якщо замовлення в обліковій системі відсутнє — жодних дій виконувати не потрібно (проігнорувати)

4. Чек-ліст початку роботи

Перед початком роботи переконайтесь, що виконані всі наступні пункти:

1. Вивантажено:

• Довідник аптек
• Довідник товарів
• Довідник фармацевтів
• Довідник лікарів (за потреби, якщо лікар зазначається в чеку)
• Вивантаження залишків аптеки

2. Налаштовано:

• Отримання замовлень
• Оновлення замовлень

3. Успішно пройдені спільні тести в рамках інтеграції Вашої аптечної мережі з Pharmapoint та роботи зі SkarbOne.