درس ۲ — سه کنش زمانبندیشده
الزام، شما را هم صادرکننده میکند و هم دریافتکننده، و وضعیت آنچه صادر کردهاید باید از جایی برگردد. این یعنی سه حرکت جداگانه، و ماژول برای هرکدام یک کنش زمانبندیشدهٔ مستقل گذاشته است.
هر سه بهصورت پیشفرض خاموش عرضه میشوند و مدیری پس از زندهشدن حساب ASP آنها را روشن میکند. جایشان هم یکی است: تنظیمات ← فنی ← کنشهای زمانبندیشده (Settings → Technical → Scheduled Actions).
| کنش زمانبندیشده | جهت | چه چیزی را جابهجا میکند | اگر خاموش بماند چه میبینید |
|---|---|---|---|
| E-Invoice: dispatch outbox | خروجی | اسناد صفشده را به ASP | اسناد تولید و اعتبارسنجی میشوند و هرگز بیرون نمیروند |
| UAE E-Invoice: Poll ASP/FTA status | وضعیت ورودی | نتیجهٔ ASP و FTA را روی سند شما | اسناد در Sent میمانند؛ هیچچیز هرگز تسویهشده خوانده نمیشود |
| UAE E-Invoice: Fetch inbound documents | اسناد ورودی | صورتحسابهای الکترونیکی تأمینکنندگان را به صورتحساب خرید پیشنویس | هیچ صورتحساب خرید ورودی نمیرسد |
سطر میانی را با دقت بخوانید، چون همان است که مردم را غافلگیر میکند. ارسال و نتیجه، دو کار متفاوتاند که دو کنش متفاوت انجامشان میدهند. ماژول شما گوشهٔ ۱ از مدل پنجگوشه است: سند را تحویل میدهد و بعد منتظر میماند تا خبرش کنند. تا وقتی کنش استعلام نپرسد و پاسخ نگیرد، هیچچیز در سامانهٔ شما نمیداند که سازمان مالیات فدرال (FTA) فاکتوری را تسویه کرده است.
نتیجهاش یک وضعیت نیمهپیکربندیشدهٔ قابل تشخیص است. فقط توزیعکننده را روشن کنید؛ همهچیز کار میکند تا جایی که دیگر کار نمیکند: 400 سند طی دو هفته بیرون میروند و همهشان در Sent مینشینند. گزارش وضعیت نشان میدهد ستون در حال ارسال هفتهبههفته بالا میرود و ستون گزارششده روی صفر ثابت مانده است. این دقیقاً شبیه ارائهدهندهای است که پاسخ نمیدهد. اما در واقع کلیدی است که کسی روشنش نکرده. درس ۵ آزمون دو دقیقهای جداکردن این دو را به شما میدهد، ولی دانستن اینکه چنین وضعی وجود دارد نیمی از راه است.
اسناد ورودی مسیر دومی هم دارند. راهنما میگوید وقتی کرون ورودی یا وبهوک اختیاری سندی دریافت میکند این اتفاق میافتد — راز وبهوک یکی از فیلدهای اعتبارنامه روی حساب ASP است و فقط برای مدیران دیده میشود. راهنما پیکربندی وبهوک را فراتر از همان فیلد مستند نکرده است، پس اگر ارائهدهندهتان تحویل فوری ارائه میدهد، ترتیبش را با او توافق کنید و کنش زمانبندیشده را همان سازوکاری بدانید که خودتان میتوانید راستیآزمایی کنید.
شکل شکست در بخش عیبیابی خود راهنما مستند شده، تقریباً با همان جملهای که مشتریان گزارش میدهند: اسناد در «Sent» میمانند و صورتحسابهای خرید ورودی هرگز نمیرسند. هر دو نشانه یک علت دارند. این دو کنش خاموش عرضه میشوند؛ پس از زندهشدن حساب ASP، از مدیری بخواهید UAE E-Invoice: Poll ASP/FTA status و UAE E-Invoice: Fetch inbound documents را از تنظیمات ← فنی ← کنشهای زمانبندیشده (Settings → Technical → Scheduled Actions) روشن کند. هر سه را همان بعدازظهر روشن کنید و صبح روز بعد بررسی کنید که ستون «گزارششده» به حرکت افتاده باشد.
ایدهٔ ماندگار این درس: سه کلید، سه نشانهٔ شکست. چیزی ارسال نمیشود، چیزی بهروز نمیشود، چیزی نمیرسد — هرکدام نام کنش زمانبندیشدهٔ خودش را فریاد میزند.