خروجی JSON و HTML فاکتور، برای برنامه‌نویسان و کارهای اتوماسیون

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

چرا PDF و عکس برای کارهای برنامه‌نویسی کافی نیست؟

PDF برای چشم انسان ساخته شده، نه برای کد. اگر بخواهی از یک فایل PDF مبلغ نهایی یا فهرست اقلام را استخراج کنی، باید سراغ ابزارهای پیچیده استخراج متن بروی که همیشه هم دقیق کار نمی‌کنند، مخصوصا برای متن فارسی. عکس PNG وضعش از این هم بدتر است، چون اصلا متن قابل‌انتخاب ندارد. وقتی داده فاکتور را به‌جای این دو، به‌صورت یک ساختار مشخص (مثل JSON) داشته باشی، هر برنامه یا اسکریپتی می‌تواند مستقیم آن را بخواند، بدون حدس زدن.

خروجی JSON فاکتور دقیقا چیست؟

در فاکتورباکس می‌توانی از یک فاکتور تکمیل‌شده، خروجی JSON بگیری. این خروجی همان اطلاعات فاکتور، یعنی مشخصات فروشنده و خریدار، فهرست کالا/خدمت با تعداد و قیمت هر ردیف، تخفیف‌ها، مالیات و مبلغ نهایی را در قالب یک ساختار داده منظم برمی‌گرداند. این یعنی به‌جای خواندن یک تصویر یا فایل چاپی، یک فایل متنی ساختاریافته داری که هر زبان برنامه‌نویسی (جاوااسکریپت، پایتون، هر چیز دیگر) به‌راحتی می‌تواند بخواندش.

چه کسانی از خروجی JSON فاکتور استفاده می‌کنند؟

• برنامه‌نویسانی که می‌خواهند فاکتورهای صادرشده را در یک دیتابیس یا سیستم داخلی ذخیره کنند
• کسانی که می‌خواهند چند فاکتور را با اسکریپت جمع بزنند یا گزارش ماهانه بسازند
• توسعه‌دهندگانی که می‌خواهند فاکتور را در یک اپلیکیشن یا سایت دیگر دوباره نمایش دهند
• کسانی که می‌خواهند فاکتور را به یک ابزار هوش مصنوعی بدهند تا خلاصه یا تحلیلش کند

خروجی HTML فاکتور؛ برای نمایش، نه فقط چاپ

کنار JSON، فاکتور باکس خروجی HTML هم می‌دهد؛ یعنی همان فاکتور به‌صورت یک صفحه وب کامل با چیدمان درست، فونت فارسی و راست‌چین آماده. این خروجی برای جایی مناسب است که می‌خواهی فاکتور را مستقیم در یک صفحه دیگر (مثلا پنل مدیریت داخلی یا سایت شرکت) نشان بدهی، بدون اینکه دوباره از صفر طراحی‌اش کنی. برخلاف PDF که یک فایل بسته است، فایل HTML را می‌شود با کد ویرایش کرد یا در قالب یک ایمیل و صفحه دیگر جاسازی کرد.

یک مثال عددی؛ اتوماسیون گزارش فروش ماهانه

فرض کن یک فروشگاه در یک ماه ۶۰ فاکتور با مجموع فروش ۱۸۰,۰۰۰,۰۰۰ تومان صادر کرده. اگر بخواهی این ۶۰ فاکتور را دستی از روی PDF یا عکس جمع بزنی، ساعت‌ها وقت می‌برد و جای خطا هم زیاد است. اما اگر از همان اول خروجی JSON هر فاکتور را نگه داشته باشی، یک اسکریپت ساده می‌تواند در چند ثانیه مجموع فروش، پرفروش‌ترین کالا، و میانگین مبلغ هر فاکتور را محاسبه کند؛ کاری که به‌صورت دستی شاید یک بعدازظهر کامل وقت بگیرد.

چطور خروجی JSON یا HTML بگیریم؟

بعد از تکمیل فاکتور در ادیتور، از منوی خروجی، کنار گزینه‌های PDF و PNG، گزینه JSON و HTML هم قابل انتخاب است. با انتخاب هر کدام، فایل مربوطه دانلود می‌شود و آماده استفاده در برنامه یا اسکریپت خودت است. نیازی به تنظیمات اضافه یا اتصال به سرور دیگری نیست؛ همان داده‌ای که در فاکتور وارد کرده‌ای، فقط در قالب دیگری خروجی گرفته می‌شود.

• برای پردازش خودکار و اسکریپت، JSON را انتخاب کن
• برای نمایش فاکتور در یک صفحه وب یا سیستم داخلی، HTML را انتخاب کن
• اگر همزمان به هر دو نیاز داری (هم پردازش، هم نمایش)، می‌توانی هر دو خروجی را جدا بگیری
• برای ارسال نهایی به مشتری، همچنان PDF یا PNG گزینه مناسب‌تری است، نه JSON یا HTML

ترکیب با مسیر هوش مصنوعی؛ از دو طرف

نکته جالب این است که مسیر هوش مصنوعی فاکتورباکس هم دقیقا در همین راستا کار می‌کند، فقط برعکس؛ به‌جای گرفتن داده از فاکتور، داده را به فاکتور می‌دهد. یعنی می‌توانی فهرست کالا را به فارسی ساده به یک مدل مثل ChatGPT یا Gemini بدهی و از آن یک خروجی متنی یا JSON بگیری که در فاکتورباکس چسبانده می‌شود و فاکتور را خودکار پر می‌کند. جزئیات این مسیر در راهنمای فاکتور با هوش مصنوعی و مقایسه جمینای و دیپ‌سیک برای فاکتور آمده. یعنی JSON هم می‌تواند ورودی فاکتور باشد، هم خروجی آن، بسته به اینکه در کدام مرحله از کارت هستی.

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

یک نکته مهم را فراموش نکن: خروجی JSON و HTML فاکتورباکس برای استفاده شخصی و داخلی خودت طراحی شده‌اند، نه به‌عنوان یک API رسمی یا سرویس ابری متصل به سرور. یعنی هر بار باید خودت فایل را دانلود و در سیستم یا اسکریپت خودت استفاده کنی؛ اتصال خودکار و زنده بین فاکتورباکس و نرم‌افزار دیگرت وجود ندارد. برای پروژه‌های بزرگ‌تر با نیاز به همگام‌سازی زنده، باید همچنان راه‌حل اختصاصی خودت را بسازی، ولی برای گزارش‌گیری دوره‌ای و پردازش دسته‌ای فاکتورها، همین خروجی‌ها کاملا کافی است.

اشتباهات رایج در استفاده از خروجی JSON و HTML

• استفاده از خروجی JSON به‌جای PDF برای ارسال مستقیم به مشتری نهایی
• فراموش کردن اینکه ساختار JSON با هر به‌روزرسانی فاکتورساز ممکن است کمی تغییر کند
• باز نکردن فایل HTML قبل از استفاده، برای اطمینان از درست بودن چیدمان راست‌چین
• ذخیره نکردن خروجی JSON فاکتورهای مهم، و مجبور شدن به گرفتن دوباره‌شان بعدا

جمع‌بندی

اگر برنامه‌نویس هستی یا می‌خواهی فاکتورها را در یک سیستم دیگر پردازش یا نمایش بدهی، خروجی JSON و HTML دقیقا همان چیزی است که به آن نیاز داری، بدون درگیر شدن با استخراج متن از PDF یا عکس. کافی است بعد از تکمیل فاکتور در فاکتور باکس، فرمت مناسب کارت را از منوی خروجی انتخاب کنی. برای امتحان کردنش، یک فاکتور بساز و خروجی JSON آن را دانلود کن یا برای آشنایی بیشتر با ابزار، از صفحه اصلی فاکتورباکس شروع کن.