فارمافلاي كلاود برو · للمطورين

بيانات صيدلياتك في أنظمتك

واجهة برمجة (REST API) بصيغة JSON لتقارير كلاود برو، وخادم MCP للمساعدات الذكية. اربط لوحات المتابعة وبرامج الحسابات وأنظمة الشركة ببيانات المبيعات والأرباح والمشتريات والمخزون والعملاء والمصروفات، لكل فروع السلسلة.

البداية

  1. فعّل الوصولكلمنا ونفعّل الـ API لحساب كلاود برو بتاعك.
  2. سجّل دخولابعت اسم المستخدم وكلمة السر لـ /api/login وخد Token صالح لمدة ساعة.
  3. اطلب التقاريرابعت الـ Token في Authorization: Bearer مع كل طلب.

تسجيل الدخول

curl -X POST https://api.pharmafly.com/api/login \
  -H "Content-Type: application/json" \
  -d '{"Login":"mybranch","Password":"secret"}'

الرد هو الـ Token نفسه كنص. لو الاشتراك منتهي بيرجع 401 بـ SubscriptionExpired.

مثال: مبيعات شهر بالأقسام لكل الفروع

curl -X POST https://api.pharmafly.com/v1/reports/sales \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "BranchLogins": [],
    "DateFrom": "2026-10-01T00:00:00Z",
    "DateTo": "2026-10-31T23:59:59Z",
    "ReportMode": "by_categories",
    "IncludeSales": true, "IncludeReturns": true,
    "IncludeCash": true, "IncludeCredit": true, "IncludeInsurance": true,
    "IncludeHomeDelivery": true, "IncludeCallcenter": true, "IncludeWholeSales": true,
    "IncludePaid": true, "IncludeUnpaid": true
  }'

BranchLogins فاضية يعني كل فروعك، والنتيجة من كل الفروع بتيجي في JSON array واحدة. التقرير بيقرا فروع سلسلتك بس، أياً كان اللي مكتوب في الطلب.

Endpoints

Base URL: https://api.pharmafly.com

الطلببيرجع إيه
POST /api/loginToken صالح لمدة ساعة
POST /api/changePasswordتغيير كلمة السر
POST /v1/reports/productsالأصناف بالأسعار والأرصدة
POST /v1/reports/stockcurrentرصيد الصنف في فرع أو أكتر
POST /v1/reports/salesالمبيعات: بالفاتورة أو بالصنف أو بالأقسام
POST /v1/reports/salesprofitأرباح المبيعات لكل فاتورة أو صنف
POST /v1/reports/purchasesالمشتريات: بالفاتورة أو بالمورد أو بالصنف
POST /v1/reports/productsoperationsسجل حركة الأصناف المؤثرة على المخزون
POST /v1/reports/customersالعملاء: الكل، أو برقم العميل أو التليفون
POST /v1/reports/spendingsالمصروفات المدفوعة من الخزن
POST /v1/reports/branchesالفروع بأسمائها وتوقعات المبيعات

الأخطاء بترجع JSON بالشكل {"ErrorMessage":"..."} مع كود HTTP المناسب (400، 401، 404، 409، 500). التواريخ بصيغة RFC3339. اطلب منا المرجع الكامل لكل Endpoint ومجموعة Postman.

خادم MCP للمساعدات الذكية

خطوات الربط لـ Claude و ChatGPT و Gemini

نفس التقارير متاحة كأدوات MCP (Model Context Protocol) للقراءة بس، عشان أي مساعد ذكي أو تطبيق بيدعم MCP يقدر يسأل بيانات السلسلة مباشرة. كل أداة بتشغّل نفس الـ Endpoint بنفس القواعد والنتائج.

URL
https://api.pharmafly.com/mcp
Transport
Streamable HTTP, stateless, JSON responses
التوثيق
OAuth 2.1 مع PKCE وتسجيل تلقائي للتطبيق، بحساب فارمافلاي. الصلاحية reports:read بس.
Tokens
Access token لمدة ساعة، و Refresh token بيتجدد مع كل استخدام لحد 90 يوم.
الأدوات
products_report stock_current_report sales_report sales_profit_report purchases_report products_operations_report customers_report spendings_report branches_report

Claude Code

claude mcp add --transport http pharmafly https://api.pharmafly.com/mcp

Gemini CLI

ضيف السيرفر في ملف settings.json، وبعدها اكتب /mcp auth pharmafly عشان تسجّل دخول.

{
  "mcpServers": {
    "pharmafly": { "httpUrl": "https://api.pharmafly.com/mcp" }
  }
}

تطبيقات بتقبل رابط ثابت بس (Ollama، LM Studio…)

{
  "mcpServers": {
    "pharmafly": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.pharmafly.com/mcp"] }
  }
}

الأداة بترجع لحد 200 صف افتراضياً (maxRows لحد 2000)، ومعاها totalRows و truncated عشان المساعد يعرف لو النتيجة اتقصت.

جاهز تشغّل صيدليتك بذكاء؟

كلمنا ونحدد معاك النسخة المناسبة لصيدليتك.