ابر کلاینتا · REST حسابفا · بدون عامل ویندوز
یکپارچگی با حسابداری ابری حسابفا
یکبار در فروش ثبت کنید؛ همان سند در حسابفا ساخته شود.
کلاینتا ابری است و حسابفا هم ابری است. بدون پل، فروشنده دو بار تایپ میکند، مانده را نمیبیند و فاکتور CRM سند مالی نیست. اتصال بازارچه این شکاف را پر میکند: کالا و طرفحساب از حسابداری میآید، فاکتور صادرشده به حسابفا میرود، و اعتبار و موجودی روی پروندهٔ مشتری دیده میشود.
این صفحه نحوهٔ کار اتصال را میگوید، نه جایگزینکردن راهنمای داخل محصول. راهاندازی را صاحب کسبوکار حسابفا و ادمین مرکز با هم انجام میدهند. فروشنده فقط نتیجه را روی فاکتور و کارت مالی میبیند. دیدار، CRM24 و ویتایگر هم همین پل را فروختهاند چون تقاضا از اصطکاک فنی قویتر است.
مدل اتصال
همگامسازی کامل حسابداری نیست. API حسابفا برای CRM و فروشگاه ساخته شده: شخص، کالا، فاکتور فروش، رسید و موجودی. دفتر کل و سامانهٔ مؤدیان در این اتصال نیستند و کلاینتا هم ادعایشان را نمیکند. سامانهٔ مؤدیان داخل خود حسابفا کار میکند.
از حسابفا به کلاینتا
کالا و خدمات فعال با کد، قیمت فروش و موجودی همگام میشوند. ماندهٔ حساب و سقف اعتبار روی شخص یا سازمان خوانده میشود. قیمت حسابفا منبع حقیقت است.
از کلاینتا به حسابفا
شخص حقیقی یا سازمان حقوقی به Contact حسابفا وصل یا ساخته میشود. فقط سند صادرشده ارسال میشود. پیشفاکتور پیشنویس میشود؛ فاکتور تأییدشده.
بدون اتصال
دیدار اتصال حسابفا را رایگان اعلام کرد، CRM24 آن را یکباره میفروشد و ویتایگر حسابفا را کنار سپیدار و هلو در ماژول مالی گذاشته. درد یکی است: فروش در CRM، حسابداری در حسابفا، و هیچ پلی در وسط — در حالی که هر دو از قبل روی اینترنتاند.
حسابفا روی اینترنت است. اگر کلاینتا اصطکاک سپیدار را اینجا تکرار کند، به دیدار میبازد. اتصال باید در کمتر از نیمساعت بالا بیاید وگرنه «بعداً» میماند.
اگر تطبیق دستی و اکسل باشد، فاکتور با کالای نامعتبر رد میشود. کلاینتا کالا را از API میکشد تا کد منبع حقیقت حسابفا بماند.
حقیقی و حقوقی فیلد اجباری دارند. اتصال قبل از سند، شخص یا سازمان را به Contact حسابفا نگاشت میکند.
در ایران فاکتور فروش مسئولیت دارد. محصول درست نقش دارد: فروشنده پیشفاکتور، مالی یا ادمین فاکتور رسمی.
خیلی از مشتریان حسابفا ووکامرس دارند. حسابفا فقط یک نشانی هوک میدهد. اگر کلاینتا هوک را بیخبر بردارد، سینک فروشگاه میمیرد.
قابلیتهای اتصال
مانده، اعتبار، وضعیت اتصال و دکمهٔ ارسال همانجا است که فروشنده کار میکند؛ نه در یک پنل جدا برای IT.
اگر ثبت فاکتور مانده را از اعتبار حسابفا جلو بزند، سند ساخته نمیشود. مالی بعد از واقعه تازه خبردار نمیشود.
کالا و خدمات فعال وارد کاتالوگ مرکز میشوند. کالای جدید را حسابدار در حسابفا میسازد و دوباره همگام میکند.
حسابفا موجودیت جدا برای پیشفاکتور ندارد. پیشفاکتور کلاینتا فاکتور فروش با وضعیت پیشنویس میشود؛ فاکتور رسمی تأییدشده.
میتوانید بگذارید فقط ادمین مرکز فاکتور رسمی بفرستد، یا هر کسی که در کلاینتا فاکتور صادر میکند.
تغییرات با getChanges خوانده میشود تا با ووکامرس نجنگد. هوک زنده فقط اگر خودتان جایگزینی را تأیید کنید.
بازارچه
ادمین مرکز از بازارچه حسابفا را میافزاید. عضو عادی این دکمه را ندارد. بعد از افزودن، هنوز وصل نیستید؛ فقط ابزار روی مرکز فعال است تا کلید API و توکن ورود را بچسبانید.
فاکتور
فاکتور را در کلاینتا میسازید، اقلام همگامشده را کنترل میکنید و صادر میکنید. بعد از ارسال، شمارهٔ حسابفا روی سند میماند و ویرایش از CRM بسته میشود.
معامله
حسابفا موجودیت معامله ندارد. برد کلاینتا فروش را جلو میبرد؛ وقتی فرصت برنده شد، فاکتور از روی همان اقلام ساخته و در صورت تنظیم ارسال میشود.
گزارش فروش
مغایرت گزارش معمولاً از دو کاتالوگ و دو مشتری است، نه از کمبود نمودار. اتصال این منبع را یکی میکند تا قیف کلاینتا و فاکتور حسابفا از یک اقلام حرف بزنند.
راهاندازی در یک نگاه
فروشنده بهتنهایی معمولاً به تنظیمات مالی حسابفا دسترسی ندارد. این ترتیب همان چیزی است که راهنمای داخل محصول با جزئیات بیشتر میگوید. اگر کسبوکار فعال باشد، معمولاً ۱۵ تا ۳۰ دقیقه طول میکشد.
با کاربر صاحب کسبوکار وارد حسابفا شوید، تنظیمات مالی و صفحهٔ API را باز کنید و مطمئن شوید API روشن است. اگر خاموش باشد کلاینتا خطای «API خاموش است» میدهد.
هر دو را از همان صفحه کپی کنید. توکن ورود جای نام کاربری و رمز است. رمز صاحب کسبوکار را در کلاینتا وارد نکنید.
ادمین مرکز حسابفا را از بازارچه اضافه میکند. تا ابزار اضافه نشود تب اتصال دیده نمیشود.
کلید و توکن را در تب اتصال بچسبانید. اگر نام سال مالی آمد، به کسبوکار درست وصل شدهاید. اشتراک منقضی را اینجا میبینید، نه بهصورت «API خراب است».
ارز، حواله انبار و نقش صادرکننده را با حسابدار هماهنگ کنید، بعد کالا را همگام کنید. حالا ارسال فاکتور معنا دارد.
معماری
سرور کلاینتا مستقیم POST میزند به REST حسابفا. این همان دلیلی است که استقرار نسبت به سپیدار نصبی سادهتر است. کلیدها فقط بکاند، رمزنگاریشده. همگام زنده با پولینگ getChanges است؛ هوک شتابدهندهٔ اختیاری است.
صف کار همگام، فاکتور صادرشده و کلیدهای رمزنگاریشده. رمز عبور صاحب کسبوکار ذخیره نمیشود.
همهٔ متدها POST و JSON. سقف ۲۴۰ درخواست در دقیقه. شناسهٔ یکتا جلوی ثبت دوباره ظرف ۲۴ ساعت را میگیرد.
سال مالی، Contact، Item، Invoice. سامانهٔ مؤدیان و دفتر کل اینجا میمانند.
اگر پیام آمد که هوک تغییرات قبلاً برای سیستم دیگری است، تیک جایگزینی را نزنید مگر بخواهید ووکامرس یا آن سیستم قطع شود. پولینگ کلاینتا بدون هوک هم کار میکند.
کار روزانه
کارت حسابفا روی فاکتور صادرشده دکمهٔ ارسال میگذارد. اگر کالا نگاشت نشده باشد، مشتری نباشد یا اعتبار پر شود، پیام واضح است. بعد از موفقیت، فاکتور در CRM قفل میماند.
صداقت محصول
چه کسی چه کار میکند
API را روشن میکند و کلید و توکن را از تنظیمات مالی میسازد. بدون اینها فرم کلاینتا خطا میدهد. کالاهای جدید را هم او در حسابفا میسازد.
افزودن ابزار، چسباندن کلیدها، تنظیم نقش ارسال فاکتور و همگام اول کالا. عضو عادی مرکز این کارها را ندارد.
بعد از اتصال، فقط کلاینتا. پیشفاکتور میسازد، مانده را میبیند و اگر نقش اجازه بدهد فاکتور صادر میکند. حسابفا روی میز او نیست.
پرسشهای پرتکرار
حسابفا REST ابری روی api.hesabfa.com دارد. کلاینتا با کلید API و توکن ورود مستقیم به آن وصل میشود. کالا و مانده خوانده میشوند؛ پیشفاکتور صادرشده بهصورت پیشنویس و فاکتور صادرشده بهصورت تأییدشده نوشته میشوند.
خیر. حسابفا روی اینترنت است. سرور کلاینتا از ابر به API حسابفا وصل میشود. این فرق اصلی با سپیدار نصبی است.
در حسابفا با کاربر صاحب کسبوکار به تنظیمات، تنظیمات مالی، صفحهٔ API بروید. apiKey برای همان کسبوکار یکتاست و loginToken جای رمز است. مستندات رسمی: hesabfa.com/help/api.
معمولاً یکی از اینهاست: فاکتور هنوز پیشنویس است، ردیف به کالای همگامشده وصل نیست، مشتری نگاشت نشده، اعتبار پر است، API خاموش است، کسبوکار منقضی است، یا سقف ۲۴۰ درخواست پر شده. پیام خطا در کلاینتا همان علت را میگوید.
خیر. بعد از ارسال، فاکتور رسمی در CRM قفل است. اصلاح و ابطال در حسابفا است. حذف در کلاینتا سند حسابفا را برنمیدارد. این محدودیت عمدی است تا مالی صاحب سند بماند.
API حسابفا ساخت کالا دارد، اما در این نسخه کلاینتا این کار را نمیکند تا حسابدار صاحب کد و موجودی بماند. حسابدار کالا را در حسابفا تعریف میکند و کلاینتا همگام میکند.
هوک تغییرات حسابفا فقط یک URL است. کلاینتا بهصورت پیشفرض با پولینگ کار میکند. تیک جایگزینی هوک را نزنید مگر با فروشگاه هماهنگ کرده باشید.
ذخیره نمیشود. فقط کلید API و توکن ورود روی سرور کلاینتا، بهصورت رمزنگاریشده، نگه داشته میشوند. در مرورگر دوباره نشان داده نمیشوند. برای تعویض کسبوکار باید دوباره وصل شوید.
آزمایش ۱۴روزه را باز کنید، حسابفا را از بازارچه اضافه کنید و با صاحب کسبوکار کلیدها را بچسبانید. راهنمای مرحلهبهمرحله داخل خود محصول است.