فارمافلاي كلاود برو · للمطورين
بيانات صيدلياتك في أنظمتك
واجهة برمجة (REST API) بصيغة JSON لتقارير كلاود برو، وخادم MCP للمساعدات الذكية. اربط لوحات المتابعة وبرامج الحسابات وأنظمة الشركة ببيانات المبيعات والأرباح والمشتريات والمخزون والعملاء والمصروفات، لكل فروع السلسلة.
البداية
- فعّل الوصولكلمنا ونفعّل الـ API لحساب كلاود برو بتاعك.
- سجّل دخولابعت اسم المستخدم وكلمة السر لـ /api/login وخد Token صالح لمدة ساعة.
- اطلب التقاريرابعت الـ 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/login | Token صالح لمدة ساعة |
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 للمساعدات الذكية
نفس التقارير متاحة كأدوات 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_reportstock_current_reportsales_reportsales_profit_reportpurchases_reportproducts_operations_reportcustomers_reportspendings_reportbranches_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 عشان المساعد يعرف لو النتيجة اتقصت.
جاهز تشغّل صيدليتك بذكاء؟
كلمنا ونحدد معاك النسخة المناسبة لصيدليتك.