تتيح لك بيمو API ربط بيمو بأنظمة أخرى وسحب البيانات من بيمو تلقائيًا. وتُستخدم بشكل رئيسي للتكامل مع حلول ERP المخصّصة، وأتمتة إقفال نهاية الشهر، وتصدير بيانات المعاملات إلى الأدوات المحاسبية.
يوفّر بيمو واجهات REST API آمنة. يسحب نظام ERP أو النظام المحاسبي أو المنصة الداخلية لديك البيانات التي يحتاجها من بيمو؛ ولا يدفع بيمو البيانات إلى أنظمتك. ويظل بيمو وأنظمتك مستقلين تمامًا، دون قواعد بيانات مشتركة ودون وصول مباشر إلى الأنظمة.
قبل البدء
يجب أن تكون مشتركًا في خطة Enterprise لإنشاء مفاتيح API واستخدامها. إذا كنت على خطة Starter أو Premium، فاختر طلب الوصول إلى API (Request API access) في لوحة التحكم لبدء محادثة مع فريق بيمو حول الترقية.
يجب أن يكون دورك المسؤول الأعلى (Super Admin) أو مدير (Admin) أو محاسب داخلي (Internal accountant) أو محاسب خارجي (External accountant). على الويب فقط.
أضف حساب الدفع، واستورد الموردين، واستورد دليل الحسابات. راجع كيفية استيراد دليل الحسابات إلى بيمو وإضافة مورد.
ما الذي يمكنك سحبه من API
واجهة API للقراءة فقط وتعتمد التقسيم إلى صفحات باستخدام المؤشر (cursor)، وتضم خمس نقاط نهاية (endpoints): المعاملات، وطلبات التعويض، والبطاقات، والمستخدمون، والمؤسسات. وتحتاج كل نقطة نهاية إلى نطاق صلاحية (scope) خاص بها: transactions:read وreimbursements:read وcards:read وusers:read وorganizations:read.
لا تطبّق نقطتا نهاية المعاملات وطلبات التعويض أي عامل تصفية للحالة أو الموافقة افتراضيًا: إذ يُعاد كل سجل معاملة ومبلغ مسترد في المؤسسة، مرتّبًا حسب تاريخ الإنشاء من الأحدث إلى الأقدم. التصفية اختيارية، لذا تمرّر بنفسك عوامل التصفية للحالة وحالة الموافقة والنوع والبطاقة والتاريخ والبحث. وتقتصر النتائج دائمًا على ما يُسمح لدور المستخدم صاحب الرمز (token) المستخدم في الطلب برؤيته.
تشمل البيانات المتاحة معاملات البطاقات والنفقات، وأسماء التجار، ومراجع المعاملات، وأسماء حاملي البطاقات وعناوين بريدهم الإلكتروني، ومبالغ المعاملات وعملاتها، وحالة التصدير لكل سجل. كما تُرجع نقطة نهاية البطاقات حدود الإنفاق والمبلغ المُنفَق في هذه الفترة والمبلغ المتبقي. وتتوفّر مستندات الإيصالات عبر روابط تنزيل آمنة محدودة المدة. ولا تتوفّر الأرصدة الفورية عبر API.
نظرًا لأن روابط الإيصالات تنتهي صلاحيتها، نزّل ملفات الإيصالات واحفظها في بيئة التخزين الخاصة بك، وأشر إليها داخليًا حسب الحاجة.
الأمان
جميع الاتصالات عبر API مشفّرة. وتعتمد المصادقة على مفاتيح API محددة النطاق، ويمكن تدويرها.
الأنظمة المدعومة
يمكن لأي نظام قادر على استخدام واجهات RESTful API التكامل مع بيمو، بما في ذلك على سبيل المثال لا الحصر:
Microsoft Dynamics (Business Central، Finance & Operations)
Oracle NetSuite
SAP
Sage
أنظمة ERP مخصّصة أو داخلية
كيفية إنشاء مفتاح API
اختر المطوّرين (Developers) أسفل الشريط الجانبي. إذا لم يكن لديك أي مفاتيح بعد، فاختر ابدأ الآن (Get started).
اختر إنشاء مفتاح API (Create API key).
أضف اسمًا للمفتاح، مثل "Pemo Key"، ثم اختر إنشاء المفتاح (Create Key). لا يمكن تغيير الاسم لاحقًا.
انسخ مفتاح API المعروض على الشاشة.
مهم: لن ترى المفتاح إلا مرة واحدة، ولا يمكن إنشاؤه إلا مرة واحدة. انسخه واحفظه في مكان آمن. يظل المفتاح مدرجًا ضمن المطوّرين، مع تاريخ إنشائه وتاريخ انتهاء صلاحيته، لكن لا يمكنك عرض قيمته مرة أخرى.
تحديد البيانات كمُصدَّرة
بعد سحب المعاملات باستخدام API، يمكن لنظامك إرسال إشعار استلام إلى بيمو. وبعد الإشعار، تُحدَّد تلك المعاملات بحالة مُصدَّرة (Exported) داخل بيمو. أما ما يخزّنه النظام المحاسبي المتصل أو يعرضه فيحدّده ذلك النظام.
كيفية حذف مفتاح API
اختر المطوّرين أسفل الشريط الجانبي.
ابحث عن المفتاح، ثم افتح الإجراءات (Actions).
اختر حذف (Delete).
أكّد الحذف.
ملاحظة: بمجرد الحذف، يتوقف المفتاح عن العمل فورًا.