درس ۲ — حساب ASP، و معنای حالت Verified
کلید بهتنهایی چیزی ارسال نمیکند. حسابی که در این درس میسازید همان هویتی است که اسناد شما زیر آن سفر خواهند کرد.
الزام. ارسال روی Peppol و گزارش دادههای مالیاتی به سازمان مالیات فدرال امارات (FTA) در گوشهٔ ۲ انجام میشود، بهدست ارائهدهندهای که وزارت دارایی امارات (MoF) آن را معتمد کرده است. اینکه اعتمادنامه چگونه به دست میآید، فهرست کوتاه ارائهدهندگان را چگونه بسازید و از آنان چه بپرسید، موضوع دورهٔ 3.1 است. این درس از لحظهای آغاز میشود که ارائهدهندهٔ انتخابیتان اعتبارنامهها را برایتان میفرستد.
مدل ذهنی. حساب ASP رکوردی در پایگاه دادهٔ شماست که یک اتصال را نگه میدارد، به یک ارائهدهنده، در یک محیط. «Generic REST ASP» همراه ماژول عرضه میشود، پس روزی که نخستین حساب را میسازید چیزی برای انتخابکردن هست و چیزی برای ساختن نیست. افزودن ارائهدهندهای دیگر در آینده یک مدل آداپتور تازه بههمراه یک ورودی در فهرست انتخاب است، بدون هیچ تغییری در کد اصلی — کار یک مجری فنی، یکبار برای همیشه، و دیگر در این دوره با آن روبهرو نمیشوید.
مسیر کلیک. حسابداری (Accounting) ← پیکربندی ← UAE E-Invoicing ← ASP Accounts ← جدید. فیلدهای زیر را پر کنید و بعد Test Connection را بزنید.
| فیلد | چه چیزی در آن میرود |
|---|---|
| Provider | آداپتوری که به کار میرود — «Generic REST ASP» همراه ماژول عرضه میشود |
| Environment | Sandbox یا Production، مطابق اعتبارنامههایی که برایتان صادر شده است |
| API Base URL | نقطهٔ پایانی که ارائهدهنده به شما داده است |
| Participant ID | هویت شما روی شبکهٔ Peppol |
| API Key و Secret و Client ID و Webhook Secret | اعتبارنامهها — فقط برای مدیران قابل مشاهده |
Verified حالتی است که نرمافزار میگذارد، نه حالتی که شما ادعا کنید. موفقبودن Test Connection حساب را به Verified تغییر میدهد. تا پیش از آن، آنچه دارید رکوردی است با مقداری متن و بدون هیچ نشانهای از اینکه در آن سو کسی پاسخ میدهد. این آزمون را همان روزی که اعتبارنامهها میرسند اجرا کنید، نه در هفتهٔ آغاز به کار، چون دو خطای رایج — نشانی پایهای که اشتباه تایپ شده، و اعتبارنامهای که برای محیط دیگری صادر شده — وقتی در سپتامبر پیدایشان کنید اصلاحی کوچکاند و وقتی در ژانویه پیدایشان کنید حادثه.
سپس شرکت را به آن اشاره دهید. به تنظیمات ← حسابداری ← تنظیمات عمومی ← بخش UAE E-Invoicing برگردید و حساب تأییدشده را بهعنوان Default ASP Account انتخاب کنید. یک سند میتواند حساب خودش را داشته باشد، اما پیشفرض سطح شرکت همان چیزی است که بقیهٔ اسناد از آن استفاده میکنند، و خالیگذاشتنش رایجترین دلیلی است که یک پایگاه دادهٔ درستپیکربندیشده باز هم ارسال نمیکند.
مثال عملی. Marina Ridge اعتبارنامههای Sandbox را از ارائهدهندهاش دریافت میکند. کارشناس حسابهای دریافتنی حساب را میسازد، Environment را روی Sandbox میگذارد و API Base URL و Participant ID را میچسباند. او اصلاً فیلدهای اعتبارنامه را نمیبیند، پس یک مدیر کلید و راز API را میچسباند. مدیر Test Connection را میزند، حساب با حالت Verified نمایش داده میشود و بهعنوان Default ASP Account در تنظیمات انتخاب میشود. تمام این کار یک نشست طول میکشد و چهار ماه پیش از آنکه لازم شود تمام میشود.
حالت خطا. ارسال با پیام «No ASP account is configured for company …» ناموفق میشود. این پیام دقیقاً همان را میگوید که نوشته است: نه سند و نه شرکت هیچ حسابی ندارند. حسابی بسازید، Test Connection را اجرا کنید تا Verified نشان دهد، و بعد آن را بهعنوان Default ASP Account در تنظیمات انتخاب کنید. همسایهٔ نزدیک این خطا ظاهر دیگری و علت دیگری دارد — صفحهای که اصلاً منوی ASP Accounts ندارد، یا فیلدهای اعتبارنامهای که بهسادگی حاضر نیستند. آن یک مسئلهٔ گروه دسترسی است نه مسئلهٔ پیکربندی، و درس ۷ به آن میپردازد.