از تعریف پروفایل و گواهی تا پیش‌نمایش، ارسال و پیگیری فاکتور — با مسیر امن sandbox پیش از ارسال واقعی.
«مودیان» ارتباط افرنده با کارپوشه‌ی مالیاتی سازمان امور مالیاتی است: فاکتورهای فروش و برگشت از فروش را به قالب مودیان تبدیل می‌کند، پیش از ارسال کمبودها را نشان می‌دهد، می‌فرستد و نتیجه‌ی پذیرش یا رد را پیگیری می‌کند.
اولین قدم. هر شرکت یک پروفایل فعال دارد؛ فعال‌کردن پروفایل تازه، پروفایل فعال قبلی همان شرکت را غیرفعال می‌کند.
| فیلد | توضیح |
|---|---|
| عنوان | اختیاری — برای تشخیص پروفایل‌ها |
| کد اقتصادی مؤدی | الزامی — در سربرگ هر فاکتور ارسالی (tins) گذاشته می‌شود |
| شناسه‌ی یکتای حافظه‌ی مالیاتی | الزامی — ۶ نویسه، از کارپوشه‌ی مودیان؛ پایه‌ی تولید شناسه‌ی مالیاتی فاکتور |
| آدرس API سازمان امور مالیاتی | برای محیط آزمایشی آدرس sandbox را بدهید |
| گواهی (.cer) و کلید خصوصی | فایل بدهید یا متن PEM/Base64 را جای‌گذاری کنید. کلید خصوصی فقط رمزنگاری‌شده روی سرور می‌ماند و بعد از ذخیره هرگز دوباره نمایش داده نمی‌شود؛ برای تغییر مقدار تازه بدهید و برای نگه‌داشتن خالی بگذارید |
| فعال | پروفایل فعال این شرکت |
| حالت ارسال | «فقط پیش‌نمایش» (پیش‌فرض) یا «ارسال به محیط آزمایشی (sandbox)» — sandbox را فقط وقتی بزنید که آدرس API مال محیط آزمایشی باشد |
دو نوع استعلام در تب «استعلام» هست:
| نوع | توضیح |
|---|---|
| استعلام مؤدی | با کد اقتصادی یک شخص یا شرکت — مثلاً قبل از ثبت خریدار |
| استعلام فاکتور | با شماره‌ی مرجع یا UID. تاریخ تقریبی فاکتور را انتخاب کنید؛ سامانه سه روز قبل و بعد آن را می‌گردد |
مودیان برای هر ردیف فاکتور کد رسمی واحد سنجش می‌خواهد. در تب «کد واحدها» برای هر واحد کالای شرکت (عدد، کیلوگرم، متر، …) یک‌بار کد سازمان مالیاتی را وارد و ذخیره کنید.
پیش‌نمایش هیچ چیزی نمی‌فرستد؛ فقط نشان می‌دهد چه چیزی به مودیان می‌رفت.
| راه | توضیح |
|---|---|
| تب «پیش‌نمایش فاکتور» در /moodian | شماره‌ی فاکتور (فروش یا برگشت) یا AutoNumber سند را بدهید |
| دکمه‌ی «مودیان» در فرم فاکتور | ابتدا سند را ذخیره کنید؛ همان فاکتور باز می‌شود. این دکمه فقط برای فاکتور فروش و برگشت از فروش رسمی است |
| مورد | توضیح |
|---|---|
| روش تسویه | نقد یا نسیه. از خود فاکتور معلوم نیست و پیش‌فرض «نقد» است؛ اگر فاکتور نسیه است قبل از ارسال عوضش کنید |
| جمع‌ها و مالیات | جمع‌های فاکتور و مالیات هر ردیف، همراه با شناسه‌ی مالیاتی |
| نوع | فروش یا برگشت از فروش، و راهنمای ارسال دوباره (irtaxid) برای اصلاح |
| فهرست کمبودها | خطا (ارسال را مسدود می‌کند) و هشدار؛ مثلاً کالای بدون شناسه‌ی کالا و خدمت، واحد بدون کد، خریدار بدون کد ملی، یا ردیفی که ارزش افزوده‌اش هنوز محاسبه نشده |
دکمه‌ی «ارسال به مودیان (sandbox)» فقط وقتی فعال است که فاکتور هیچ خطایی نداشته باشد و در پروفایل ارسال sandbox روشن باشد. در حالت «فقط پیش‌نمایش» پیام می‌گوید فاکتور بدون خطاست ولی ارسال خاموش است.
بعد از ارسال، سازمان مالیاتی فقط شماره‌ی مرجع می‌دهد و پذیرش یا رد نهایی بعداً معلوم می‌شود.
| تب | توضیح |
|---|---|
| وضعیت ارسال‌ها | وضعیت هر فاکتور ارسال‌شده: در انتظار / پذیرفته شد / رد شد، با چیپ پیگیری. سامانه خودکار و با فاصله‌ی فزاینده استعلام می‌کند؛ دکمه‌ی «بروزرسانی» همین لحظه می‌پرسد. اگر فاکتوری رد شد، نشانگر را روی وضعیت نگه دارید تا علت سازمان را ببینید؛ بعد از اصلاح فاکتور از «پیش‌نمایش فاکتور» دوباره بفرستید (همان شناسه‌ی مالیاتی) |
| گزارش ارسال و استعلام | هر ارسال یا استعلام با شناسه‌ی مالیاتی، شماره‌ی مرجع و نتیجه ثبت می‌شود. روی «ناموفق» نگه دارید تا علت دیده شود |
فقط مدیر سیستم می‌تواند، آن هم بعد از تست موفق روی sandbox.
| مرحله | توضیح |
|---|---|
| شواهد sandbox | تعداد فاکتورهای پذیرفته‌شده روی میزبانی غیر از سرور فعلی در برابر تعداد لازم نمایش داده می‌شود |
| شرط | تا وقتی شواهد کافی نباشد، دیالوگ علت را می‌گوید و ادامه نمی‌دهد |
| کد یک‌بارمصرف | وقتی شرایط برقرار است، کد تأیید را درخواست و وارد کنید |