Webhooks Certyneo : اتوماتیک‌سازی تراز حسابی در ERP

هنگامی‌که سندی از طریق Certyneo به صورت الکترونیکی امضا می‌شود، سپس چه اتفاقی در زنجیره حسابی شما می‌افتد؟ برای بیشتر شرکت‌ها، پاسخ هنوز هم اغلب این است: هیچ چیز خودکار نیست. یک همکار به صورت دستی فایل PDF امضا‌شده را دانلود می‌کند، آن را از طریق ایمیل به حسابدار تخصصی ارسال می‌کند، و سپس او آن را دوباره در نرم‌افزار مدیریت خود وارد می‌کند. این فرآیند قطعه‌شده منجر به خطاها، تأخیرها و از دست رفتن ردپایی می‌شود که با الزامات تراز حسابی قابل‌اعتماد سازگار نیست. وب‌هوک‌های Certyneo دقیقاً به این مسئله پاسخ می‌دهند: آن‌ها امکان فعال‌کردن خودکار اقدامات در سیستم‌های شخص ثالث خود را فراهم می‌کنند — ERP، نرم‌افزار حسابی، GED — به محض اینکه رویدادی در مورد امضا رخ دهد. این مقاله به تفصیل توضیح می‌دهد که چگونه این وب‌هوک‌ها را پیکربندی و استفاده کنید تا چرخه حسابی خود را از ابتدا تا انتها روان کنید.

وب‌هوک چیست و برای حسابی چرا ضروری است

اصل وب‌هوک به‌طور ساده توضیح داده‌شده

وب‌هوک یک مکانیسم اطلاع‌رسانی HTTP در زمان واقعی است: به جای اینکه به‌طور منظم از یک API درخواست کنید «آیا چیزی تغییر کرده است؟» (رویکردی به نام polling)، برنامه‌ارسال‌کننده — در اینجا Certyneo — درخواست HTTP POST را به آدرس URL انتخاب‌شده شما ارسال می‌کند به محض اینکه رویدادی مشخص رخ دهد. در حسابی، این به معنی آن است که در لحظه‌ای که سفارش خرید، قرارداد تامین‌کننده یا فیش هزینه به صورت الکترونیکی امضا می‌شود، ERP شما می‌تواند بلافاصله مطلع شود، بدون دخالت انسان.

بر خلاف صادر کردن ساده CSV یا گزارش ماهانه، وب‌هوک هم‌زمان‌سازی تقریباً در زمان واقعی را تضمین می‌کند. برای حسابدار تخصصی‌ای که بسته‌های ماهانه یا سه‌ماهه را مدیریت می‌کند، این دقت تعیین‌کننده است: اسناد توجیهی در سیستم از لحظه امضا در دسترس هستند، نه در پایان ماه با جمع‌آوری دشوار.

رویدادهای Certyneo که تراز حسابی را فعال می‌کنند

Certyneo انواع مختلفی از رویدادها را از طریق وب‌هوک‌ها قابل‌استفاده در زمینه حسابی ارائه می‌دهد:

• `envelope.completed` : تمام طرف‌ها سند را امضا کرده‌اند — این رویدادفعال‌کننده اصلی برای تزریق سند توجیهی در ERP شما است.
• `envelope.declined` : امضاکننده درخواست کرده است — برای هشدار دهی به بخش حسابی در مورد فاکتوری که مورد اعتراض است مفید است.
• `envelope.expired` : مهلت امضا منقضی شده است — امکان راه‌اندازی مجدد روش و جلوگیری از شکاف در حسابی را فراهم می‌کند.
• `signer.signed` : امضای جزئی یک طرف — برای قراردادهای چند امضاکننده مرتبط است (مثال: بند کرایه برای امضای مالک و کرایه‌گیر).

هر بار‌کار JSON ارسالی توسط Certyneo حاوی ابرداده‌های ضروری است: شناسه سند، مهرزمان واجد‌اعتبار، نام امضاکنندگان، URL امنتر برای دانلود PDF امضا‌شده و پیمایش حسابرسی. این داده‌های ساختارشده‌شده برای استفاده مستقیم توسط ERP یا نرم‌افزار حسابی قابل‌استفاده هستند.

پیکربندی مرحله به‌مرحله وب‌هوک‌های Certyneo برای ERP

ایجاد و ثبت نقطه انتهایی وب‌هوک

پیکربندی وب‌هوک Certyneo از داشبورد، بخش تنظیمات > ادغام > وب‌هوک‌ها انجام می‌شود. مراحل کلیدی در اینجا قرار دارد:

1. تعریف URL مقصد: این نقطه انتهایی است که توسط ERP یا middleware ادغام شما قابل دسترسی است (مثال: نقطه انتهایی اختصاصی در 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 را فهرست می‌کند.

مدیریت رد کردن و راه‌اندازی مجدد خودکار

وب‌هوک می‌تواند اگر نقطه انتهایی شما به صورت موقت در دسترس نباشد ناموفق باشد. Certyneo یک سیاست تکرار نمایی را پیاده‌سازی می‌کند: در صورت عدم پاسخ HTTP 2xx، سیستم در بازه‌های فزاینده تکرار می‌کند (5 دقیقه، 30 دقیقه، 2 ساعت، 24 ساعت) در یک پنجره 72 ساعت. پس از آن، وب‌هوک به عنوان شکست علامت‌گذاری می‌شود و هشداری در داشبورد ارتقا داده می‌شود.

برای حسابی، این تناوب بسیار مهم است: سند توجیهی غیر دریافت‌شده در ERP می‌تواند منجر به شکاف در تراز شود. بنابراین توصیه می‌شود مکانیسم وب‌هوک را با شغل آشتی‌سازی روزانه تکمیل کنید که API Certyneo را برای فهرست‌کردن پاکت‌های تکمیل‌شده در 24 ساعت گذشته و تأیید حضور آن‌ها در سیستم حسابی استعلام می‌کند.

ادغام با ERP‌های اصلی و نرم‌افزارهای حسابی

اتصال بومی با Cegid، Sage و Pennylane

چندین ویرایشگر نرم‌افزار حسابی محبوب در فرانسه اتصال‌دهنده‌ها یا API های REST سازگار با وب‌هوک‌های Certyneo را پیشنهاد می‌دهند. در اینجا الگوهای ادغام رایج‌تر قرار دارد:

Cegid XRP Flex : یک API REST را نشان می‌دهد که اجازه ایجاد اسناد حسابی و ضمیمه کردن فایل‌ها را می‌دهد. وب‌هوک `envelope.completed` تماس POST را به سمت API Cegid برای ایجاد نوشتار و ضمیمه کردن PDF امضا‌شده به عنوان سند توجیهی دیجیتال فعال می‌کند.

Sage 100cloud / Sage 50 : رویکرد توصیه‌شده از طریق middleware سبک (اسکریپت Python یا Node.js که در سرور بدون ایستگاه میزبانی می‌شود) انجام می‌شود که وب‌هوک Certyneo را دریافت می‌کند، سند را از طریق URL امن دانلود می‌کند و آن را در پوشه واردات خودکار Sage قرار می‌دهد.

Pennylane : راه‌حل بومی ابری که API آن مستقیماً اسناد را با ابرداده‌های حسابی خود می‌پذیرد. ادغام وب‌هوک-Pennylane به‌ویژه برای کابینت‌های متخصص حسابی که اسناد چند کلاینت را متمرکز می‌کنند مناسب است — موردی که ما در بخش سناریوها به تفصیل بیان می‌کنیم.

برای تیم‌هایی که راه‌حل‌های مختلف را ارزیابی می‌کنند پیش از مهاجرت به Certyneo، مقایسه راه‌حل‌های امضای الکترونیکی نمای تفصیلی توانایی‌های ادغام براساس پلتفرم ارائه می‌دهد.

استفاده از iPaaS مانند Make یا n8n برای غیرتوسعه‌دهندگان

اگر سازمان شما تیم فنی اختصاصی ندارد، پلتفرم‌های خودکارسازی بدون کد/کم‌کد (Make، n8n، Zapier) جایگزین موثری را تشکیل می‌دهند. اصل ساده است:

1. یک سناریو را با تریگر وب‌هوک بر روی Make یا n8n ایجاد کنید — URL تولیدشده به عنوان نقطه انتهایی Certyneo استفاده می‌شود.
2. اقدامات زیر را پیکربندی کنید: دانلود سند امضا‌شده، تجزیه ابرداده‌ها، ارسال به Google Drive / SharePoint، ایجاد ردیف در صفحه‌گسترش نوبت‌های سپاری شده، اطلاع‌رسانی Slack به مسئول حسابی.
3. به‌صورت اختیاری، تماس API را به سمت نرم‌افزار حسابی خود برای ایجاد نوشتار فعال کنید.

این رویکرد امکان رسیدن به سطح بالایی از خودکارسازی را در کمتر از یک روز فراهم می‌کند، بدون نوشتن یک خط کد. این به‌ویژه برای شرکت‌های کوچک‌ و متوسط یا برای حسابداران متخصصی که می‌خواهند جمع‌آوری اسناد را برای کلاینت‌های خود خودکار کنند بدون جذب توسعه‌دهنده مرتبط است.

رویکردهای بهترین برای امنیت و حسابرسی وب‌هوک‌های حسابی

تأیید امضاهای HMAC و ایمن‌سازی نقاط انتهایی

در زمینه حسابی، قابل‌اعتماد بودن داده‌های دریافت‌شده از طریق وب‌هوک بسیار حیاتی است. اگر مهاجم بتواند رویدادهای نادرست `envelope.completed` را تزریق کند، می‌تواند حسابی شما را خراب کند. سه اقدام امنیتی ضروری است:

• تأیید HMAC-SHA256 : هر درخواست Certyneo شامل سر `X-Certyneo-Signature` است. نقطه انتهایی شما باید امضا را با کلید راز خود دوباره محاسبه کند و مقایسه کند — هر درخواست که امضا با آن مطابقت ندارد را رد کنید.
• اعتبار‌سنجی طرح JSON : پیش از هرگونه پردازش، ساختار و انواع بار‌کار دریافت‌شده را اعتبار‌سنجی کنید. فیلد `montant_ht` با مقدار `null` یا منفی باید هشدار را فعال کند، نه نوشتار حسابی نادرست.
• ثبت‌نام غیرقابل‌تغییر : هر بار‌کار دریافت‌شده را در لاگی مهرزمان‌شده و غیرقابل‌اصلاح برای حداقل 10 سال نگهداری کنید، مطابق بر الزام‌های حفاظت از اسناد حسابی (ماده L123-22 از کد تجارت).

ردپایی و پیمایش حسابرسی برای حسابدار متخصص

یکی از مزایای اصلی رویکرد وب‌هوک پیمایش انجام‌شده درانتها است که تولید می‌کند. Certyneo برای هر سند امضا‌شده پیمایش حسابرسی (audit trail) مطابق با الزام‌های eIDAS تولید می‌کند که شامل مهرزمان واجد‌اعتبار، آدرس‌های IP امضاکنندگان و گواهی‌های استفاده‌شده است.

با ترکیب این پیمایش حسابرسی به بار‌کار وب‌هوک، ERP شما نه تنها می‌تواند سند توجیهی اما ثبات قانونی آن را ذخیره کند. برای کمیسر حسابی‌ها یا حسابدار متخصص، این لایه دوگانه — سند + ثبات — به‌طور قابل‌ملاحظه‌ای تأیید‌های حسابرسی یا بازبینی را ساده می‌کند. امضای الکترونیکی در شرکت سطوح امضا و ارزش ثبات آن‌ها را در زمینه‌های تجاری متفاوت توضیح می‌دهد.

برای محاسبه بازگشت سرمایه‌گذاری این خودکارسازی پیش از شروع، ماشین‌حساب ROI Certyneo امکان تخمین دقیق سود زمانی و هزینه براساس حجم اسناد امضا‌شده شما را فراهم می‌کند.

چارچوب قانونی قابل اجرا برای وب‌هوک‌ها و حسابی دیجیتال

خودکارسازی زنجیره حسابی از طریق وب‌هوک‌های امضای الکترونیکی در چارچوب نظارتی دقیقی جای می‌گیرد که باید تسلط داشت.

مقررات eIDAS شماره 910/2014 (و بازنگری eIDAS 2.0 آن) : مقرره اروپایی در مورد شناسایی الکترونیکی و خدمات اعتماد ارزش قانونی امضای الکترونیکی را تأسیس می‌کند. ماده 25 مقرر می‌دارد که امضای الکترونیکی نمی‌تواند تنها به خاطر اینکه به شکل الکترونیکی ارائه می‌شود از اثرات قانونی آن محروم شود. امضاهای واجد‌اعتبار (QES) از یک فرض قابل‌اعتماد معادل با امضای دستی بهره می‌برند. برای اسناد حسابی، سطح امضای مناسب به ماهیت سند بستگی دارد: فاکتوری ساده می‌تواند از امضای پیشرفته (AES) استفاده کند، در حالی‌که قرارداد کرایه‌ای یا اقدام الکترونیکی یادداشتی نیاز به امضای واجد‌اعتبار دارد.

کد مدنی، مواد 1366 و 1367 : ماده 1366 نوشتار الکترونیکی را به عنوان مدرک معادل با نوشتار روی کاغذ، تحت شرط اینکه شناسایی شخصی را که از آن ناشی می‌شود بتوان به‌طور صحیح انجام داد و به‌گونه‌ای ایجاد و نگهداری شود که صحت آن را تضمین کند، به رسمیت می‌شناسد. ماده 1367 امضای الکترونیکی را به عنوان استفاده از روشی قابل‌اعتماد برای شناسایی که ارتباط با عملی را تضمین می‌کند که برای آن معنی دارد تعریف می‌کند. وب‌هوک Certyneo، با انتقال پیمایش حسابرسی با هر سند امضا‌شده، به این الزام شناسایی و صحت انطباق دارد.

ماده L123-22 از کد تجارت : اسناد حسابی و اسناد توجیهی باید برای ده سال نگهداری شوند. اسنادی که از طریق وب‌هوک دریافت‌شده و در ERP ذخیره می‌شوند باید به نیتی برای نگهداری مطابق باشند، از جمله عدم‌تغییرپذیری و خوانایی طولانی‌مدت قالب‌ها (PDF/A توصیه‌شده توسط استاندارد ISO 19005).

RGPD شماره 2016/679 : بار‌کارهای وب‌هوک حاوی داده‌های شخصی هستند (نام امضاکنندگان، آدرس‌های ایمیل، مهرزمان‌های مرتبط با افراد). نقطه انتهایی و 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 شرکت کلاینت را مدیریت می‌کند. قبل از ادغام وب‌هوک‌های Certyneo، هر سند امضا‌شده به صورت دستی توسط مدیر پرونده جمع‌آوری می‌شد، براساس یک قاعده نام‌گذاری تغییر نام می‌یافت، سپس در پوشه کلاینت نرم‌افزار تولید حسابی قرار داده می‌شد. این روند حدود 15 تا 20 دقیقه در هر سند، یعنی چند ساعت در هفته در دوره تراز را نشان می‌دهد.

پس از پیکربندی وب‌هوک `envelope.completed` که به ابزار GED خود از طریق Make متصل است، کابینت کل این زنجیره را خودکار کرده است: به محض امضا، PDF امضا‌شده به‌طور خودکار در پوشه کلاینت متناسب با نام صحیح فایل طبقه‌بندی می‌شود، اطلاع‌رسانی به مدیر مسئول ارسال می‌شود، و یک ردیف در جدول نوبت‌های پیمایش‌شده ایجاد می‌شود. بهره برد زمانی تخمین‌شده در مقدار 70 تا 80 درصد در این وظیفه، یعنی حدود 6 تا 8 ساعت بازیافتی در هفته در دوره تراز — عددی مطابق با معیار‌های منتشرشده توسط نظام حسابداران متخصص در گزارش‌های خود درباره تغییر دیجیتالی کابینت‌ها.

سناریو 2: یک شرکت تولیدی متو