موصلات الدفع من أنظمة ERP (CargoWise وJSON)

يمنح موصل الدفع من ERP نظامَك عنواناً واحداً يرسل إليه الفواتير. تخزّن عليا بوكس كل رسالة، وتحوّلها إلى فاتورة إلكترونية، وتتحقق منها وفق قواعد الإمارات، وتنشئ الفاتورة وترسلها، وتحتفظ بالرسالة لإعادة معالجتها بعد أي تصحيح. يوجد موصلان:

• CargoWise: يقرأ ملف UniversalTransaction XML الذي يرسله eAdaptor في CargoWise عند ترحيل فاتورة مبيعات أو إشعار دائن.
• JSON: للأنظمة الوسيطة التي تتعامل أصلاً بصيغة JSON لفواتير عليا بوكس وتريد السجل نفسه واكتشاف التكرار وإعادة المعالجة.

تجدهما في الموصلات ← موصلات الدفع من ERP. يستطيع المالكون والمديرون تغيير الإعدادات وإعادة معالجة الرسائل؛ وغيرهم يطّلع فقط.

أعطِ نظام ERP عنوانه

تعرض كل بطاقة نقطة النهاية التي تُضبط في نظام ERP. انسخها بالزر المجاور. يصادق نظام ERP بمفتاح API من عليا بوكس (API access في القائمة): إما بترويسة X-API-KEY، أو بمصادقة HTTP Basic بأي اسم مستخدم مع المفتاح ككلمة مرور، وهو ما يتيحه تبويب الإرسال في CargoWise. استخدم مفتاح اختبار أثناء التكامل؛ فالفواتير التي ينشئها مستندات اختبار لا تصل أبداً إلى مزود الخدمة الفعلي.

اضبط خريطة رموز الرسوم

انقر ضبط على البطاقة. يحتوي تبويب خريطة الرسوم على صف لكل رمز رسم كما يرسله نظام ERP:

رمز الرسم غير الموجود في الخريطة يُحلّ عبر تبويب رموز الضريبة (رمز الضريبة الخاص بنظام ERP، مثل Z أو S)، ثم قائمة عليا بوكس المدمجة لرموز الضريبة الشائعة، ثم الفئة الافتراضية. وعندما لا يحسم شيء، تفشل الرسالة ويُذكر رمز الرسم، فلا يمر رمز جديد في ERP بمعاملة ضريبية خاطئة. ننصح بإبقاء الفئة الافتراضية على "بلا".

تُعلَّم رموز الرسوم المكررة بالأحمر ولا يمكن حفظها.

اختر ما يحدث عند الاستلام

تبويب عند الاستلام:

• الإرسال عند الاستلام: عند التفعيل، تُنشأ الفاتورة وتُرسل إلى مزود الخدمة في خطوة واحدة. وعند الإيقاف، تُنشأ كمسودة محقَّقة ليرسلها أحد من عليا بوكس.
• الإقرار دائماً: عند التفعيل، تردّ نقطة النهاية بالنجاح حتى عند تعذّر معالجة الرسالة، فلا يدخل ناقل الدفع الذي يعيد المحاولة عند أي خطأ في حلقة. يبقى الفشل في السجل.
• رفض الرسائل الفعلية حتى الاعتماد: عند التفعيل، تُرفض الرسائل القادمة بمفتاح فعلي ما دامت الخريطة غير معتمدة. مستندات الاختبار تُقبل دائماً.
• حقول الرسالة المحفوظة كحقول مخصصة: تُخزَّن المهمة وبوليصة الشحن والفرع من الرسالة على الفاتورة كحقول مخصصة. عرّف المفاتيح نفسها في الإعدادات ← الحقول المخصصة لتُتحقق وتُعرض.
• تصميم PDF لهذه الفواتير: التصميم الذي تستخدمه فواتير الموصل؛ اختر تصميماً بتخطيط Logistics (لوجستي) لطباعة رقم العملية وبوليصة الشحن في لوحة الشحنة. ومن دون اختيار، يُطبق التصميم الافتراضي للمنشأة.

كيف قد تصل الرسائل

يقبل عنوان CargoWise ملف Universal XML بأي طريقة يضبط بها المُكامِل eAdaptor أو eAdaptor Next: كملف XML عادي، أو داخل غلاف SOAP، أو داخل JSON، أو مرمّزاً بـ base64، أو مضغوطاً. افتح رسالة في السجل لترى Received as (طريقة الوصول) وSender's message id (معرّف رسالة المُرسِل).

اعتمد الخريطة

تحدد خريطة الرسوم المعاملة الضريبية، فهي قرار ضريبي. في تبويب الاعتماد ينقر المستشار الذي راجع الخريطة اعتماد هذه الخريطة باسمي؛ فتعرض البطاقة من اعتمدها ومتى. يمسح سحب الاعتماد ذلك عندما تحتاج الخريطة إلى مراجعة جديدة، مثلاً بعد إضافة رموز رسوم جديدة.

تابع سجل الرسائل

يعرض الرسائل على البطاقة، أو سجل الرسائل فوق البطاقات، كل رسالة ونتيجتها:

افتح رسالة لترى السبب وملاحظات التحويل والرسالة الخام كما أرسلها ERP والفاتورة التي أنشأتها. بعد تصحيح خريطة الرسوم أو بيانات العميل، افتح الرسالة الفاشلة وانقر إعادة المعالجة الآن. الرسالة التي عولج مستندها منذ ذلك لا يمكن إعادة معالجتها، فلا تنشئ إعادة المعالجة تكراراً أبداً.

تُكتب كل نتيجة في سجل التدقيق، وتُطلق إشعارات الفواتير وخطافات الويب المعتادة كما لأي فاتورة.

تحقق من رسالة قبل أن يرسلها ERP

يستطيع المطورون تجربة رسالة عبر API (POST /invoices/validate?connector=cargowise): تُحوَّل وتُتحقق دون إنشاء أي شيء ويعود التقرير مع معاينة للفاتورة المحوّلة. انظر دليل المطورين "ERP intake".