التكاملات وواجهة API
يتصل OptiRoutes بالأنظمة التي تشغّلونها بالفعل. تدخل الطلبات من ملف Excel أو CSV، أو من FTP أو SFTP، أو عبر Files API آمنة؛ وتعود إشعارات التسليم الموقّعة وتصديرات المسارات والتقارير بالطريقة نفسها. وتقدّم واجهة API للتقارير بياناتكم لأدوات ذكاء الأعمال (BI)، وتستقبل عناوين ويب تقارير التسليم وتصديرات المسارات فور حدوثها.
آخر تحديث:
ما التكاملات التي يوفّرها OptiRoutes؟
| الحاجة | كيف يلبّيها OptiRoutes |
|---|---|
| تحميل طلبات اليوم | رفع Excel أو CSV، والتحميل التلقائي من FTP أو SFTP أو Files API، بصيغة CSV أو JSON أو TXT بعرض ثابت. |
| جمع إثباتات التسليم الموقّعة | استدعاءات Files API لكل يوم أو لكل طلب، أو ملف ZIP واحد لكل يوم؛ ونسخ بالبريد الإلكتروني. |
| إرسال المسارات إلى نظامكم | تصدير المسارات بصيغة CSV أو XLSX أو XML أو JSON أو TXT، إلى ملف، أو إلى FTP الخاص بكم، أو إلى مجلد الشركة، أو إلى عنوان ويب. |
| التقارير إلى BI أو إلى نظام ERP | واجهة API للتقارير: الطلبات، والمسارات، والسائقون، والعملاء، وPOD، وملخص يومي للتسليمات. |
| التفاعل مع كل تسليم | عنوان لتقارير التسليم يستقبل كل تقرير فور إعداده. |
| الدفع مقابل الخدمة | Stripe Checkout لشحن الرصيد المسبق الدفع والشحن التلقائي. |
تحميل الطلبات من ملف أو FTP أو SFTP
أبسط تكامل هو الملف الذي يصدّره نظامكم بالفعل. في شاشة الطلبات، يقرأ زر تحميل التسليمات ملف Excel أو CSV؛ وتطابقون كل حقل في النظام — العنوان، واسم العميل، ورقم الطلب، والكمية وغيرها — مع اسم العمود لديكم مرة واحدة، فيُحمَّل كل ملف لاحق بالطريقة نفسها. ولملف TXT بعرض ثابت تحدّدون مواضع الأحرف بدلًا من أسماء الأعمدة. ويمكن تخطي صفوف بكلمة مميّزة في الملاحظات، ويمكن لكلمة مميّزة ثانية أن تستبدل العنوان، وتقرّرون ما إذا كان رقم الطلب الموجود يُحدَّث أو يُضاف كطلب جديد.
لإخراج العمل اليدوي من المعادلة، اختاروا طريقة تحميل تلقائي في الإعدادات:
- خادم الملفات في OptiRoutes — يضع نظامكم الملف اليومي، المسمّى بالتاريخ، في مجلد شركتكم على خادم FTP أو على خادم SFTP المشفّر.
- خادم FTP الخاص بكم — يتصل OptiRoutes بالمستخدم الذي تعطونه إياه ويحمّل الملف المسمّى بتاريخ اليوم، أو الملف الأحدث تحديثًا.
- الاستيراد والتصدير التلقائيان — تُحمَّل الطلبات تلقائيًا وتُخطَّط المسارات أيضًا، دون الحاجة إلى أي نقرة.
- Files API — يرفع برنامجكم ملف الطلبات عبر HTTPS، كما هو موضّح أدناه.
في شاشة العملاء، يُنشئ ملف Excel أو CSV يتضمن رقم العميل واسمه وعنوانه ووقت التوقف ووقتَي الفتح والإغلاق العملاءَ أو يحدّثهم مع نوافذ وقتهم.
Files API: الطلبات تدخل، وإثباتات التسليم والتقارير تخرج
لكل شركة في OptiRoutes مجلد ملفات خاص بها: الطلبات التي تحمّلها، وإشعارات التسليم الموقّعة مع صورها وتواقيعها، وتصديرات المسارات، وتقارير نهاية اليوم. وتتيح Files API لأنظمتكم قراءة هذا المجلد والكتابة فيه مباشرة عبر HTTPS، دون خادم FTP في الوسط. ويبدّل مدير الشركة بين FTP وواجهة API في الإعدادات ← API والملفات وينشئ المفاتيح هناك — دون الحاجة إلى طلب من الدعم، والشركات الجديدة تبدأ على واجهة API.
| المجلد | ما الذي يحتويه | من يكتب فيه |
|---|---|---|
| orders_files/ | ملف الطلبات اليومي، وتصديرات المسارات. | أنتم (الطلبات)، وOptiRoutes (التصديرات) |
| pod/YYYY/MM/DD/ | إثباتات التسليم الموقّعة لذلك اليوم: ملف PDF الموقّع، والتوقيع، والصور. | OptiRoutes |
| pod/ | إشعارات التسليم الأصلية المراد توقيعها في تطبيق السائق، ملف PDF واحد لكل رقم طلب. | أنتم |
| reports/YYYY/MM/ | تقارير نهاية اليوم والمرتجعات. | OptiRoutes |
| podBaseFile/ | النموذج الأساسي لإثبات التسليم. | أنتم |
| inbox/ | مجلد حر للملفات التي تريدون تسليمها. | أنتم |
تغطي الاستدعاءات التحقق من المفتاح، وعرض محتوى مجلد، والتنزيل، والرفع (حتى 50 MB للملف)، وحذف الملفات التي رفعتموها، وعرض ملفات POD ليوم ما حسب الطلب والنوع، وتنزيل كل ملفات POD ليوم ما كملف ZIP واحد. ويتضمن الدليل أمثلة برمجية بلغات Python وC# وNode.js، وسكربت PowerShell يُبقي مجلدًا على خادمكم متزامنًا مع مجلد الشركة — فيستطيع الفريق المعتاد على FTP مواصلة العمل بالطريقة نفسها. اقرأوه في دليل Files API.
كيف تُؤمَّن مفاتيح API؟
- أقل الصلاحيات — يحصل كل مفتاح على الصلاحيات التي يحتاجها فقط: إثباتات التسليم الموقّعة فقط، أو قراءة كل الملفات، أو رفع الطلبات وملفات صندوق الوارد.
- العناوين المسموح بها — يمكن قصر المفتاح على عناوين IP الثابتة لخادمكم.
- الانتهاء والتدوير — يمكن أن تنتهي صلاحية المفتاح بعد عدد من الأيام؛ أنشئوا مفتاحًا جديدًا، وبدّلوا إليه، ثم ألغوا القديم دون أي توقف.
- الإلغاء الفوري — يتوقف المفتاح الملغى عن العمل خلال 30 ثانية.
- التدقيق — يُسجَّل كل استدعاء مع الوقت والعنوان والملف والاستجابة، ويُعرض على المدير.
- تخزين آمن — لا يحتفظ OptiRoutes إلا ببصمة SHA-256 لكل مفتاح؛ والاتصالات عبر HTTPS مع TLS 1.2 أو أحدث، ولا يصل المفتاح إلا إلى مجلد شركته.
الحدود: 300 طلب في الدقيقة لكل مفتاح، و50 MB للملف، و20 مفتاحًا نشطًا لكل شركة، وما يصل إلى 5,000 عنصر في عرض محتوى مجلد واحد.
واجهة API للتقارير والدفع
لأدوات التقارير وموصّلات ERP، تقدّم واجهة API منفصلة على api-users.optiroutes.com بيانات شركتكم كتقارير وتستقبل البيانات المدفوعة إليها. عنوان واحد ورمز وصول واحد، يُصدرهما OptiRoutes لشركتكم، يغطيان كل الاستدعاءات. وتتيح لكم صفحة التوثيق لصق رمز الوصول لرؤية التقارير المتاحة لكم ومطابقة الأعمدة في حسابكم: اقرأوا توثيق API.
| التقرير | ما الذي يُرجعه |
|---|---|
| orders | الطلبات والتسليمات، مع المسار والسائق. |
| routes | المسارات، مع السائق وعدد المحطات. |
| drivers | بيانات السائقين. |
| customers | بيانات العملاء وعناوينهم. |
| pod | توثيق التسليم. |
| delivery-summary | ملخص يومي حسب الحالة. |
ويعمل استدعاءان للدفع في الاتجاه المعاكس: دفع الطلبات يكتب ملف طلبات اليوم ويبدأ التحميل التلقائي، ودفع السائقين والخطوط والمركبات يستبدل الأسطول بأكمله، مثل ملف الأسطول. ولأن قائمة السائقين المدفوعة تُعدّ الأسطول الكامل، أرسلوا دائمًا كل السائقين، لا التغييرات فقط.
تصدير المسارات وخطافات الويب
يكتب تصدير المسارات المسارات المحدَّدة بصيغة CSV أو XLSX أو XML أو JSON أو TXT بعرض ثابت. ويحدّد جدول الأعمدة الحقول التي تخرج وتحت أي عنوان، ويمكن إضافة الأعمدة الأصلية من ملف طلباتكم، ومع إدارة الأصناف يعرض ملف ثانٍ كل صنف. ويمكن أن تذهب التصديرات إلى حاسوبكم، أو إلى خادم FTP الخاص بكم، أو إلى مجلد الشركة، ومع JSON يمكن أيضًا إرسال التصدير إلى عنوان ويب؛ وإذا فشل الإرسال، يحاول النظام مرة أخرى.
لكل تسليم فور حدوثه، املأوا عنوان تقارير التسليم في إعدادات تطبيق السائق: فيُرسل كل تقرير تسليم يعدّه السائقون إليه أيضًا، فيتحدّث نظام آخر لديكم تلقائيًا.
البريد الإلكتروني والمدفوعات والخرائط والمراسلة
- البريد الإلكتروني — تُرسل إشعارات التسليم الموقّعة من حساب Gmail الخاص بكم بكلمة مرور تطبيق من Google؛ وتذهب التقارير مثل تقرير المنصات لنهاية اليوم إلى بريد التقارير لديكم؛ ويتلقى العملاء الذين دفعوا إيصالات، والسائقون تأكيدات إيداع من الصندوق.
- المدفوعات — تُدفع عمليات شحن الرصيد عبر صفحة دفع آمنة من Stripe، مع بطاقة محفوظة اختياريًا للشحن التلقائي.
- العناوين والخرائط — تُختار العناوين من اقتراحات Google ويُتحقق منها على الخريطة قبل التخطيط.
- الملاحة — يسلّم تطبيق السائق كل محطة إلى Waze، أو إلى Apple Maps على iPhone، بالعنوان أو بالإحداثيات الدقيقة.
- SMS وWhatsApp — رسائل الوصول وروابط التتبع إلى العملاء، والتنبيهات إلى المديرين، والخطوط إلى المقاولين، وصور المسارات إلى السائقين عبر WhatsApp.
تخطّطون لتكامل مع نظام ERP أو نظام المستودع لديكم؟ أخبرونا بما تحتاجون إلى ربطه.
تجربة مجانية لمدة 3 أيام · حتى 50 عنوانًا يوميًا · دون بطاقة ائتمان
الأسئلة الشائعة
هل يستطيع OptiRoutes تحميل الطلبات تلقائيًا من نظام ERP لدينا؟
نعم. يمكن لنظام ERP لديكم وضع ملف يومي على خادم FTP أو SFTP في OptiRoutes، أو على خادم FTP الخاص بكم، أو رفعه عبر Files API، فيحمّله OptiRoutes تلقائيًا.
كيف ندخل إثباتات التسليم الموقّعة إلى نظامنا؟
عبر Files API: اعرضوا ملفات POD ليوم ما ونزّلوها، أو نزّلوها جميعًا كملف ZIP واحد. وتُرسل نسخة أيضًا بالبريد الإلكتروني وفق قواعد التوجيه لديكم.
من يُنشئ مفاتيح API لـ Files API؟
مدير الشركة، في الإعدادات، API والملفات. للمفاتيح صلاحيات، وعناوين مسموح بها وانتهاء صلاحية اختياريان، ويمكن إلغاؤها في أي وقت.
هل توجد واجهة API للتقارير؟
نعم. تُرجع واجهة API للتقارير الطلبات، والمسارات، والسائقين، والعملاء، وPOD، وملخصًا يوميًا للتسليمات، برمز وصول يُصدره OptiRoutes.
بأي صيغ ملفات يمكننا تصدير المسارات؟
CSV وXLSX وXML وJSON وTXT بعرض ثابت، بالأعمدة والعناوين التي تختارونها.
ابدأوا التجربة المجانية — 3 أيام، دون بطاقة
تجربة مجانية لمدة 3 أيام · حتى 50 عنوانًا يوميًا · دون بطاقة ائتمان