برای تیم فناوری و ارزیاب فنی

مشخصات فنی ژرف‌بان

ژرف‌بان نرم‌افزار تحت وب است: در مرورگر رایانه و موبایل باز می‌شود، هر شرکت نصب و نشانی جداگانهٔ خودش را دارد و داده در PostgreSQL نگه داشته می‌شود. بسته‌های مالی حرفه‌ای و جامع API فقط‌خواندنی و وب‌هوک امضاشده دارند، گزارش‌ها به اکسل و PDF می‌روند، هر شب پشتیبان گرفته می‌شود و هر هفته بازیابی تمرین می‌شود. جزئیات هر کدام را پایین‌تر آورده‌ایم.

بازبینی‌شده در هر سطر از کد خود محصول خوانده شده است
زیرساخت

ژرف‌بان روی چه چیزی اجرا می‌شود؟

یک برنامهٔ وب با دو بخش، رابط کاربری و سرویس حسابداری، که برای هر شرکت جداگانه نصب می‌شود.

رابط کاربری
برنامهٔ وب React، راست‌به‌چپ و فارسی، بدون نصب روی رایانهٔ کاربر.
سرور
Node.js با Fastify، در دو سرویس جدا: رابط کاربری و حسابداری.
پایگاه داده
PostgreSQL نسخهٔ ۱۸.
جداسازی مشتری‌ها
هر شرکت نصب جداگانه با پایگاه داده و نشانی اختصاصی خودش دارد و کار روی یک نصب به نصب دیگری دست نمی‌زند.
محل نصب
نسخهٔ ابری، یا نصب روی سرور خود شرکت. شرایط نصب روی سرور شرکت را در صفحهٔ حسابداری ابری آورده‌ایم.
مرورگر و دستگاه

با چه مرورگر و دستگاهی کار می‌کند؟

با مرورگر. صفحه‌ها خودشان را با اندازهٔ نمایشگر رایانه و موبایل هماهنگ می‌کنند.

مرورگر
آزمون‌های خودکار مرورگر روی Chromium، موتور Chrome و Edge، اجرا می‌شوند. اگر سازمانتان مرورگر دیگری را استاندارد کرده، آن را در دمو امتحان کنید.
ورود
با شمارهٔ موبایل و کد پیامکی. کلید عبور (passkey) هم پشتیبانی می‌شود و افزودنش کد پیامکی تازه می‌خواهد.
افزونهٔ مرورگر
افزونهٔ Chrome ژرف‌بان برای کارپوشهٔ مودیان و سامانهٔ جامع تجارت. دربارهٔ افزونه
اپلیکیشن اندروید
«ژرف‌بان فروش» برای کارشناس فروش: ارسال تماس‌های ضبط‌شده و پیامک‌های کاری. فایل نصبی امضاشده از نشانی خود ژرف‌بان داده می‌شود، نه از Google Play. ضبط تماس فقط با گوشی سامسونگ کار می‌کند و آیفون پشتیبانی نمی‌شود.
API · بسته‌های مالی حرفه‌ای و جامع

API ژرف‌بان چه چیزی را می‌دهد؟

API نسخهٔ ۱ فقط می‌خواند و هیچ مسیری در آن چیزی ثبت نمی‌کند. هر کلید فقط به یک دفتر دسترسی دارد و دفتر از خود کلید خوانده می‌شود، نه از پارامتری که فراخواننده می‌فرستد. ثبت از راه API در نقشهٔ راه است.

نشانی پایه
نشانی اختصاصی شرکت شما، به‌علاوهٔ /fin/api/v1
احراز هویت
سرآیند Authorization: Bearer zbk_…. کلید نامعتبر، باطل‌شده یا منقضی یک پیام یکسان می‌گیرد تا چیزی دربارهٔ کلید لو نرود.
کلید
فقط مدیر سیستم، از داخل خود ژرف‌بان، کلید می‌سازد و هیچ کلیدی نمی‌تواند کلید دیگری بسازد. کلید فقط یک بار نمایش داده می‌شود، تاریخ انقضای اختیاری دارد، باطل‌شدنی است و آخرین استفاده‌اش ثبت می‌شود.
صفحه‌بندی
پارامترهای limit و offset؛ هر صفحه پیش‌فرض ۵۰ و حداکثر ۲۰۰ ردیف.
مسیرچه می‌دهد
/whoamiکلید و دفتری که به آن دسترسی دارد؛ اولین فراخوانی برای آزمودن راه‌اندازی
/fiscal-yearsسال‌های مالی همان دفتر
/accountsسرفصل حساب‌ها، با انتخاب سطح
/partiesطرف‌حساب‌ها، با جستجو
/vouchersاسناد، با فیلتر سال مالی و وضعیت دائمی یا موقت
/vouchers/:idیک سند با ردیف‌هایش
/reports/trial-balanceتراز آزمایشی
/reports/by-classگزارش گروه‌های حساب
وب‌هوک · بسته‌های مالی حرفه‌ای و جامع

وب‌هوک‌ها چطور کار می‌کنند و چطور اصالتشان را بسنجیم؟

برای هر مقصد رویدادها را انتخاب می‌کنید. ارسال هیچ‌وقت ثبت سند را معطل نمی‌کند: رویداد در صف می‌نشیند و جدا ارسال می‌شود.

رویدادکی ارسال می‌شود
voucher.createdثبت سند
voucher.postedدائمی‌شدن سند
sales_invoice.issuedصدور فاکتور فروش
cheque.createdثبت چک
cheque.status_changedتغییر وضعیت چک
statement.postedثبت صورت‌وضعیت
payment_order.approvedتأیید دستور پرداخت
بدنه
JSON با سه فیلد event، company_id و data.
سرآیندها
x-zharfban-event، x-zharfban-timestamp و x-zharfban-signature.
امضا
HMAC با الگوریتم SHA-256 و کلید امضای همان مقصد، روی زمان ارسال و بدنه با هم. چون زمان جزو متن امضاشده است، ارسالی را که مدتی بعد دوباره فرستاده شود می‌توانید رد کنید.
تلاش دوباره
اگر مقصد پاسخ موفق ندهد، ارسال تا ۶ بار انجام می‌شود: بار اول و ۵ بار دوباره، به فاصلهٔ ۵، ۱۵، ۶۰، ۲۴۰، ۷۲۰ دقیقه. پس از آخرین شکست، ارسال رها و مقصد غیرفعال می‌شود تا نشانی‌اش بررسی و دوباره فعال شود. هر تلاش حداکثر ۱۰ ثانیه منتظر پاسخ می‌ماند.
ایمنی مقصد
تغییر مسیر (redirect) دنبال نمی‌شود و نشانی مقصد پیش از هر تلاش دوباره بررسی می‌شود تا به نشانی داخلی شبکه نرسد.
دفتر تحویل
وضعیت هر ارسال، یعنی تحویل‌شده، در صف یا رهاشده، همراه تعداد تلاش‌ها و آخرین پاسخ مقصد.
قالب‌های خروجی

از ژرف‌بان چه خروجی‌هایی می‌گیرید؟

فایل‌هایی که سامانه‌ها و بانک‌ها می‌پذیرند، با همان قالب آن‌ها، و گزارش‌هایی که در اکسل هم قابل جمع و فیلترند.

قالبچه چیزی
اکسلگزارش‌های مالی، با مبلغ به‌صورت عدد واقعی در سلول، واحد ریال در سرستون، برگهٔ راست‌به‌چپ، فیلتر خودکار و ردیف جمع با فرمول
چاپ و PDFهر گزارش از نوار ابزار خودش چاپ می‌شود و از پنجرهٔ چاپ مرورگر به PDF ذخیره می‌شود
اکسل یا CSVفایل سامانهٔ دفاتر تجاری الکترونیکی برای بازهٔ ماهانه یا سه‌ماهه؛ برای مبلغ‌های بسیار بزرگ CSV پیشنهاد می‌شود تا هیچ رقمی گم نشود
DBFلیست بیمهٔ تأمین اجتماعی هر کارگاه و ماه، جفت فایل DSKKAR00 و DSKWOR00
متنفایل‌های WP و WH مالیات حقوق
اکسل بانکفایل «Records» انتقال گروهی بانک ملی از دستور پرداخت گروهی
JSONهر چه API فقط‌خواندنی می‌دهد: حساب‌ها، طرف‌حساب‌ها، اسناد و تراز

فهرست کامل سامانه‌هایی که ژرف‌بان به آن‌ها وصل می‌شود در صفحهٔ اتصال‌ها آمده است.

پشتیبان و بازیابی

پشتیبان‌گیری و بازیابی چطور انجام می‌شود؟

پشتیبانی که هیچ‌وقت بازیابی نشده، فقط یک امید است. برای همین بازیابی هم مثل پشتیبان‌گیری خودکار است.

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

اگر از ژرف‌بان برویم، داده‌مان چه می‌شود؟

حذف خودکار در کار نیست: با پایان یا توقف اشتراک، نصب فقط از دسترس خارج می‌شود. راه بیرون بردن داده هم از روز اول در دسترس است.

توقف، نه حذف
وقتی اشتراکی تمام یا متوقف می‌شود، نصب فقط از دسترس خارج می‌شود. پایگاه داده، فایل‌های پیوست و نسخهٔ نرم‌افزار دست‌نخورده می‌مانند و ادامهٔ کار فوری است.
حذف
حذف دفاتر یک شرکت هیچ‌وقت خودکار نیست و با یک فرمان هم انجام نمی‌شود؛ کاری عمدی و دستی است، با پشتیبانِ تازه در دست.
بیرون بردن داده
گزارش‌ها به اکسل، فایل دفاتر الکترونیکی هر دوره و API فقط‌خواندنی برای حساب‌ها، طرف‌حساب‌ها، اسناد و تراز.
در قرارداد
شکل و زمان تحویل کامل داده هنگام پایان قرارداد را در قرارداد بنویسید و پیش از امضا، یک خروجی واقعی را در دمو امتحان کنید.
دو راه شروع

جلسهٔ فنی بخواهید

در دموی آنلاین، API و وب‌هوک را در تنظیمات و خروجی اکسل را روی گزارش‌ها ببینید. برای پرسش‌های تیم فناوری، همراه دموی مالی یک جلسهٔ فنی هم بخواهید.

پیام واتساپ را در ساعات کاری و ایمیل را حداکثر ظرف یک روز کاری جواب می‌دهیم · تماس: ۰۹۰۱ ۲۲۲ ۲۰۸۰

دستیار ژرف‌بان

راهنمای امکانات، قیمت‌ها و دمو

از کجا شروع کنیم؟

بگویید شرکتتان به چه نیاز دارد یا یکی از موضوع‌ها را انتخاب کنید.

موضوع‌های راهنما

پشت صحنه

این‌جا را پیدا کردید.

صفحه‌ها
۹۱۷ صفحه در نقشهٔ سایت
آخرین به‌روزرسانی
۱ آذر ۱۴۰۵، ساعت ۱۱:۲۸ به وقت تهران، نسخهٔ ab4b027
حروف
«استعداد»، طراحی امین عابدی. نمای نرم‌افزار با «وزیرمتن»، طراحی صابر راستی‌کردار.
قاعدهٔ نوشتن
از خودمان تعریف نمی‌کنیم. کار را نشان می‌دهیم.
چیزهای کوچک
  • هر جمع مبلغ در کارت‌های قیمت، زیرش به حروف هم نوشته شده است، مثل روی چک.
  • اگر صفحه‌کلیدتان روی انگلیسی مانده باشد، دستیار متن فارسی‌ای را که منظورتان بوده پیشنهاد می‌کند.
  • پایین صفحه، روزهای آخر مهلت لیست بیمه، ارزش افزوده و سال مالی را به وقت تهران یادآوری می‌کنیم.
  • هر صفحه برای چاپ مرتب می‌شود، با نشانی صفحه، تاریخ چاپ و شمارهٔ صفحه.
  • نشانی اشتباه به سندی می‌رسد که تراز نیست.
رمز این پنجره
روی هر صفحه «ژرف» را تایپ کنید.

ایرادی دیدید، هر قدر کوچک؟ به sales@zharfban.com بنویسید.