Webhooks Certyneo : automatiser le bilan comptable en ERP

عندما يتم التوقيع على مستند إلكترونياً عبر Certyneo، ماذا يحدث بعد ذلك في سلسلة حسابك؟ بالنسبة لمعظم الشركات، الإجابة هي في كثير من الأحيان: لا شيء تلقائي. يقوم أحد الموظفين بتنزيل ملف PDF الموقع يدويًا، ويرسله عبر البريد الإلكتروني إلى محاسبك، الذي يأدخله مرة أخرى في برنامج الإدارة الخاص به. تولد هذه العملية المجزأة أخطاء وتأخيرات وفقدان المتابعة غير متوافق مع متطلبات بيان حسابي موثوق. تعالج webhooks Certyneo هذه المشكلة بالضبط: فهي تسمح بتشغيل الإجراءات تلقائياً في أنظمتك الخارجية — ERP وبرامج محاسبية وGED — بمجرد حدوث حدث توقيع. تشرح هذه المقالة بالتفصيل كيفية تكوين واستخدام هذه webhooks لتسهيل دورة الحسابات من البداية إلى النهاية.

ما هو webhook ولماذا يكون ضروريًا للحسابات

شرح مبسط لمبدأ webhook

webhook هو آلية إخطار HTTP في الوقت الفعلي: بدلاً من أن تطلب بشكل منتظم من API "هل حدث شيء ما؟" (النهج المسمى polling)، يقوم التطبيق المرسل — هنا Certyneo — بإرسال طلب HTTP POST إلى عنوان URL تختاره بمجرد حدوث حدث محدد. في المحاسبة، هذا يعني أنه في اللحظة التي يتم فيها التوقيع على أمر شراء أو عقد موردين أو ملاحظة مصاريف إلكترونياً، يمكن إخطار ERP الخاص بك فوراً، دون تدخل بشري.

على عكس ملف CSV بسيط أو تقرير شهري، يضمن webhook مزامنة شبه الوقت الفعلي للبيانات. بالنسبة لمحاسب يدير عمليات إغلاق شهرية أو ربع سنوية، هذه الدقة حاسمة: تكون القطع المبررة متاحة في النظام فور توقيعها، وليس في نهاية الشهر أثناء فترة تصحيح شاقة.

أحداث Certyneo التي تشغل البيانات المحاسبية

يعرض Certyneo عدة أنواع من الأحداث عبر webhooks، قابلة للاستخدام مباشرة في السياق المحاسبي:

• `envelope.completed`: وقعت جميع الأطراف على المستند — هذا هو المشغل الرئيسي لحقن قطعة مبررة في ERP الخاص بك.
• `envelope.declined`: رفض الموقّع — مفيد لتنبيه الخدمة المحاسبية من فاتورة مطعونة.
• `envelope.expired`: انتهت مهلة التوقيع — يسمح بإعادة تشغيل الإجراء وتجنب فجوة في الحسابات.
• `signer.signed`: توقيع جزئي من أحد الأطراف — ذو صلة بالعقود متعددة التوقيع (على سبيل المثال: عقد الإيجار التجاري الذي يتطلب توقيع المالك والمستأجر).

يحتوي كل payload JSON الذي أرسله Certyneo على البيانات الوصفية الضرورية: معرّف المستند والطابع الزمني المؤهل واسم الموقّعين وعنوان URL الآمن لتنزيل PDF الموقع ومسار التدقيق. هذه البيانات المنظمة قابلة للاستخدام المباشر من قبل ERP أو برنامج محاسبي.

خطوات التكوين لـ webhooks Certyneo لـ ERP

إنشاء وتسجيل نقطة نهاية webhook

يتم تكوين webhook Certyneo من لوحة المعلومات، قسم الإعدادات > التكاملات > Webhooks. فيما يلي الخطوات الأساسية:

1. تحديد عنوان URL الوجهة: هذه نقطة النهاية التي يتم الكشف عنها بواسطة ERP الخاص بك أو أداة تكامل البرامج الوسيطة الخاصة بك (على سبيل المثال: نقطة نهاية مخصصة في SAP أو Sage أو Cegid أو أداة iPaaS مثل n8n أو Make أو Zapier).
2. تحديد الأحداث المراد الاستماع إليها: لبيان حسابي، امنح الأولوية على الأقل لـ `envelope.completed` و `envelope.declined`.
3. تكوين سر توقيع HMAC: يوقّع Certyneo كل حمولة بمفتاح سري تحدده. يجب أن تتحقق نقطة النهاية من هذه التوقيع لضمان أصالة الإخطارات — خطوة الأمان غير القابلة للتفاوض.
4. الاختبار باستخدام وضع المحاكاة: يسمح Certyneo بإرسال حمولة اختبار دون إنشاء مستند حقيقي. تحقق من أن نقطة النهاية تستجيب بشكل صحيح مع HTTP 200.

ربط بيانات الحمولة بالخطة المحاسبية الخاصة بك

بمجرد أن تكون نقطة النهاية تعمل، يجب ربط حقول حمولة Certyneo بالحقول المتوقعة من قبل ERP الخاص بك. فيما يلي مثال على منطق الربط لعقد موردين:

```json { "event": "envelope.completed", "envelope_id": "env_01HX...", "completed_at": "2026-05-26T14:32:00Z", "document_url": "https://app.certyneo.com/documents/signed/...", "metadata": { "type": "contrat_fournisseur", "montant_ht": 12500, "compte_comptable": "607", "fournisseur_id": "F-2891" } } ```

حقل `metadata` قابل للتكوين بحرية عند إنشاء الحمولة عبر API Certyneo. هذا هو المفتاح لإثراء كل توقيع بالبيانات الأساسية اللازمة للمحاسبة التلقائية: رقم الحساب ومركز التكلفة والسنة المالية وما إلى ذلك. لتعميق إمكانيات التكامل التقنية، استشر مركز مساعدة Certyneo الذي يحتوي على جميع وثائق API.

إدارة الرفض والإعادة التلقائية

قد يفشل webhook إذا كانت نقطة النهاية الخاصة بك غير متاحة مؤقتًا. ينفذ Certyneo سياسة إعادة محاولة أسية: في حالة عدم وجود استجابة HTTP 2xx، يعيد النظام محاولة الإرسال على فترات متزايدة (5 دقائق و30 دقيقة و2 ساعة و24 ساعة) على مدى 72 ساعة. بعد ذلك، يتم وضع علامة على webhook كفشل وتظهر تنبيه في لوحة المعلومات.

بالنسبة للحسابات، هذه المرونة حاسمة: قد تؤدي قطعة مبررة غير مستقبلة في ERP إلى عدم التطابق في البيان. لذلك يوصى بإكمال آلية webhook بـ وظيفة المصالحة اليومية التي تستعلم API Certyneo لتسرد الحمولات المكتملة في آخر 24 ساعة والتحقق من وجودها في النظام المحاسبي.

التكامل مع برامج ERP والبرامج المحاسبية الرئيسية

الاتصال الأصلي مع Cegid و Sage و Pennylane

تقدم عدة ناشري برامج محاسبية شهيرة في فرنسا موصلات أو واجهات برمجة تطبيقات REST متوافقة مع webhooks Certyneo. فيما يلي أنماط التكامل الأكثر شيوعًا:

Cegid XRP Flex: يكشف عن API REST يسمح بإنشاء أجزاء محاسبية وربط الملفات. يقوم webhook `envelope.completed` بتشغيل استدعاء POST نحو Cegid API لإنشاء الإدخال وإرفاق PDF الموقع كمستند مبرر رقمي.

Sage 100cloud / Sage 50: النهج الموصى به يمر عبر برامج وسيطة خفيفة (نص Python أو Node.js مستضاف بدون خادم) يستقبل webhook Certyneo وينزل المستند عبر عنوان URL الآمن وينسخه إلى مجلد الاستيراد التلقائي لـ Sage.

Pennylane: حل أصلي للسحابة الذي يقبل API مباشرة مستندات مع البيانات الوصفية المحاسبية. التكامل webhook-Pennylane مناسب بشكل خاص لمكاتب المحاسبين الخبراء التي تركز على المستندات من عملاء متعددين — حالة استخدام نفصلها في قسم السيناريوهات.

بالنسبة للفرق التي تقيم حلول مختلفة قبل الهجرة إلى Certyneo، فإن مقارنة حلول التوقيع الإلكتروني توفر عرضًا مفصلاً لقدرات التكامل حسب المنصة.

استخدام iPaaS مثل Make أو n8n للمستخدمين غير المطورين

إذا كانت مؤسستك لا تمتلك فريق تقني مخصص، فإن منصات الأتمتة التي لا تتطلب أكواد / منخفضة الأكواد (Make و n8n و Zapier) تشكل بديلاً فعالاً. المبدأ بسيط:

1. أنشئ سيناريو بـ تشغيل webhook على Make أو n8n — يخدم عنوان URL المُنشأ كنقطة نهاية Certyneo.
2. قم بتكوين الإجراءات التالية: تنزيل المستند الموقع وتحليل البيانات الوصفية وإرسال إلى Google Drive / SharePoint وإنشاء صف في جدول تتبع الإخطارات والتنبيهات إلى مسؤول الحسابات على Slack.
3. اختياريًا، قم بتشغيل استدعاء API نحو برنامج الحسابات الخاص بك لإنشاء الإدخال.

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

أفضل الممارسات الأمنية والتدقيق لـ webhooks المحاسبية

التحقق من التوقيعات HMAC وتأمين نقاط النهاية

في السياق المحاسبي، موثوقية البيانات المستقبلة عبر webhook حاسمة. يمكن للمهاجم الذي يتمكن من حقن أحداث كاذبة `envelope.completed` أن يفسد الحسابات الخاصة بك. تفرض ثلاث تدابير أمان:

• التحقق من HMAC-SHA256: يتضمن كل طلب Certyneo رأس `X-Certyneo-Signature`. يجب أن تعيد نقطة النهاية حساب التوقيع باستخدام مفتاحك السري والمقارنة — رفض أي طلب لا يتطابق التوقيع.
• التحقق من مخطط JSON: قبل أي معالجة، تحقق من هيكل وأنواع الحمولة المستقبلة. يجب أن يؤدي حقل `montant_ht` بقيمة `null` أو سالبة إلى تنبيه وليس إدخال محاسبة خاطئ.
• التسجيل غير القابل للتعديل: احفظ كل حمولة مستقبلة في سجل مؤرخ وغير قابل للتعديل لمدة 10 سنوات على الأقل، وفقاً لالتزامات الاحتفاظ بالقطع المحاسبية (المادة L123-22 من قانون التجارة).

المتابعة وسجل التدقيق للمحاسب الخبير

أحد الفوائد الرئيسية للنهج webhook هو المتابعة من البداية إلى النهاية التي ينتجها. ينتج Certyneo لكل مستند موقع مسار تدقيق (audit trail) يتوافق مع متطلبات eIDAS، بما في ذلك الطابع الزمني المؤهل وعناوين IP للموقّعين والشهادات المستخدمة.

بربط مسار التدقيق هذا بحمولة webhook، يمكن لـ ERP الخاص بك تخزين ليس فقط القطعة المبررة ولكن أيضًا إثبات صحتها القانونية. بالنسبة لمدقق حسابات أو خبير محاسبة، هذه الطبقة المزدوجة — مستند + إثبات — يبسط بشكل كبير التحقق أثناء تدقيق أو مراجعة. تفصّل التوقيع الإلكتروني في الشركة مستويات التوقيع وقيمتها الثبوتية في سياقات عمل مختلفة.

لحساب العائد على الاستثمار لهذه الأتمتة قبل أن تبدأ، فإن آلة حاسبة ROI Certyneo تسمح لك بتقدير الفوائد والتكاليف بدقة حسب حجم المستندات الموقعة.

الإطار القانوني المطبق على webhooks والحسابات الرقمية

يندرج أتمتة السلسلة المحاسبية عبر webhooks التوقيع الإلكتروني في إطار تنظيمي دقيق يجب فهمه.

لائحة eIDAS n°910/2014 (ومراجعة eIDAS 2.0): تؤسس لائحة الاتحاد الأوروبي بشأن التعريف الإلكتروني وخدمات الثقة القيمة القانونية للتوقيعات الإلكترونية. تنص المادة 25 على أنه لا يمكن رفض آثار التوقيع الإلكتروني القانونية فقط لأنه يتخذ شكلاً إلكترونياً. تستفيد التوقيعات المؤهلة (QES) من افتراض موثوقية مكافئ للتوقيع بخط اليد. بالنسبة للقطع المحاسبية، يعتمد مستوى التوقيع المناسب على طبيعة المستند: قد تستخدم الفاتورة البسيطة توقيعًا متقدمًا (AES)، بينما يتطلب عقد تمويل عقار أو عقد إلكتروني موثق توقيعًا مؤهلاً.

قانون مدني، مواد 1366 و1367: تعترف المادة 1366 بالوثيقة الإلكترونية كدليل بنفس درجة الوثيقة على الورق، شريطة أن يكون من الممكن تحديد الشخص الذي تصدر عنه بشكل صحيح وأن يتم تأسيسها وحفظها بطريقة تضمن سلامتها. تحدد المادة 1367 التوقيع الإلكتروني على أنه استخدام إجراء موثوق للتعريف يضمن الربط مع العمل الذي يُلحق به. يفي webhook Certyneo، بنقل مسار التدقيق مع كل مستند موقع، بهذا الشرط للتعريف والسلامة.

المادة L123-22 من قانون التجارة: يجب الاحتفاظ بالمستندات المحاسبية والقطع المبررة لمدة عشر سنوات. يجب أن تخضع المستندات المستقبلة عبر webhook والمخزنة في ERP لسياسة الاحتفاظ المتوافقة، بما في ذلك عدم التعديل والقابلية للقراءة على المدى الطويل للتنسيقات (PDF/A موصى به بموجب معيار ISO 19005).

RGPD n°2016/679: تحتوي payloads webhook على بيانات شخصية (أسماء الموقّعين وعناوين البريد الإلكتروني والطوابع الزمنية المرتبطة بالأفراد). نقطة النهاية و ERP الخاص بك مستقبلات لهذه البيانات — أنت مسؤول معالجة أو مسؤول مشترك حسب الشروط التعاقدية مع Certyneo. يجب تسمية DPA (Data Processing Agreement). يجب تقليل البيانات المرسلة إلى الحد الأدنى الضروري للغاية المحاسبية.

توجيه NIS2 (2022/2555): بالنسبة للشركات التي تقع في نطاق NIS2 (مشغلو الخدمات الأساسية والكيانات المهمة)، يشكل أمان واجهات API والويبهوكس تدبير أمان شبكة إلزامي. يفرض التحقق من HMAC والتشفير TLS 1.3 على الأقل وتسجيل الوصول.

معيار ETSI EN 319 132: يحدد تنسيق XAdES للتوقيعات الإلكترونية المتقدمة. تحترم التوقيعات التي ينتجها Certyneo معايير ETSI هذه، مما يضمن توافقها مع أنظمة الأرشفة ذات القيمة الثبوتية المتوافقة مع إطار الأمان العام الفرنسي (RGS).

حالات الاستخدام الملموسة

حالة 1: مكتب خبرة محاسبية يدير 40 ملف عميل

يدير مكتب خبرة محاسبية مكون من حوالي عشرة زملاء رسائل التفويض والتفويضات SEPA والحسابات السنوية لـ 40 شركة عميل. قبل تكامل webhooks Certyneo، كان كل مستند موقع يتم استرجاعه يدويًا من قبل مدير ملف، وإعادة تسميته وفقًا لاتفاقية التسمية، ثم إيداعه في مجلد العميل في برنامج الإنتاج المحاسبي. يمثل هذا الإجراء حوالي 15 إلى 20 دقيقة لكل مستند، أو عدة ساعات أسبوعياً في فترة الإغلاق.

بعد تكوين webhook `envelope.completed` متصل بأداة GED الخاصة بهم عبر Make، قام المكتب بأتمتة هذه السلسلة بالكامل: بمجرد التوقيع، يتم تنزيل PDF الموقع تلقائياً وتصنيفه في مجلد العميل المناسب باسم الملف الصحيح ويتم إرسال إخطار إلى مدير الملف المعني وإنشاء صف في جدول تتبع القطع المستقبلة. يُقدّر الفائد الزمني بحوالي 70 إلى 80 ٪ من هذه المهمة، أي حوالي 6 إلى 8 ساعات تُسترجع أسبوعياً في فترة البيان — رقم متسق مع المعايير المنشورة من قبل نقابة المحاسبين الخبراء في تقاريرها عن التحول الرقمي للمكاتب.

حالة 2: شركة صناعية صغيرة متوسطة مع ERP Sage و 300 عقد موردين سنويًا

تُوقّع شركة صناعية صغيرة متوسطة حوالي 300 عقد موردين سنويًا (أوامر إطارية وتعديلات واتفاقيات سرية). يجب أن يتم ربط كل عقد موقع بملف موردين في Sage 100cloud وأرشفته كمستند مبرر للالتزام. بدون أتمتة، كان فريق الشراء ينقل العقود الموقعة عبر البريد الإلكتروني إلى الخدمة المحاسبية بتأخير متوسط قدره 3 إلى 5 أيام عمل.

بعد نشر برنامج وسيط Node.js يستقبل webhooks Certyneo ويستدعي Sage API، انخفض تأخير الربط إلى بضع ثوانٍ. يتم الآن حساب الالتزامات خارج الميزانية في الوقت الفعلي، مما سمح بتحسين موثوقية الحالات الوسيطة المقدمة للمدير المالي. تم تنفيذ المشروع في أقل من أسبوعين من قبل مطور داخلي، بالاستناد إلى وثائق webhook في مركز مساعدة Certyneo.

حالة 3: مجموعة شركات تدير تدفقات داخل الشركة المعقدة

تستخدم مجموعة مكونة من حوالي عشر شركات فرعية Certyneo للتوقيع على اتفاقيات الخزينة بين الشركات وعقود الخدمات بين المجموعات. تفرض المحاسبة الموحدة أن توقع كل اتفاقية في نفس الوقت في نظام الشركة الفرعية المرسلة والشركة الفرعية المستقبلة، بنفس معرّف المستند لتسهيل حذف التدفقات المتبادلة.

بتكوين webhook فريد يخطر بالتوازي نقاط نهاية الشركتين الفرعيتين المعنيتين (المحددة عبر بيانات وصفية للحمولة)، قضت المجموعة على الفروقات المدمجة المرتبطة بالقطع المفقودة أو المشار إليها بشكل خاطئ. انخفض الوقت المستغرق لإغلاق المجموعة بمتوسط يومين، وهو ربح كبير لإدارة مالية للمجموعة تغلق ربع سنوياً. بالنسبة للفرق التي تفكر في الهجرة من حل آخر، يمكنها استشارة دليل الهجرة إلى Certyneo لتقييم الجدوى التقنية.

الخلاصة

تمثل webhooks Certyneo رافعة أتمتة قوية لأي جهة فاعلة تسعى إلى دمج التوقيع الإلكتروني في قلب عملية حسابية. بالقضاء على الخطوات اليدوية بين توقيع مستند وتسجيله في ERP أو برنامج محاسبي، فإنها تقلل التأخيرات والأخطاء والأخطاء الإملائية وأخطاء المراجع المفقودة أثناء بيان أو تدقيق. سواء كان مكت