ترکیه

ماژول‌ها

ماژول‌های زیر به‌صورت خودکار همراه با بومی‌سازی ترکیه نصب می‌شوند:

نام	نام فنی	توضیحات
Türkiye - Accounting	l10n_tr	بستهٔ پایهٔ بومی‌سازی مالی ترکیه شامل دفتر حساب‌های ترکیه، مالیات‌ها، گزارش‌های مالی و موقعیت‌های مالی
Türkiye - Accounting Reports	l10n_tr_reports	گزارش‌دهی مالیات و سود و زیان مختص ترکیه.
Türkiye - e-Irsaliye (e-Dispatch)	l10n_tr_nilvera_edispatch	تولید و آپلود فایل‌های e-Dispatch را فعال می‌کند

علاوه بر این، برای استفاده از یکپارچه‌سازی Nilvera جهت مدیریت اسناد الکترونیکی، ماژول‌های زیر باید به‌صورت دستی نصب شوند:

نام	نام فنی	توضیحات
Türkiye - Nilvera	l10n_tr_nilvera	ماژول یکپارچه‌سازی که ارتباط با Nilvera و تولید فایل‌های e-Ledger را فعال می‌کند
Türkiye - Nilvera E-Invoice	l10n_tr_nilvera_einvoice	برای ارسال و دریافت فاکتورهای الکترونیکی سناریوی پایه به/از Nilvera.
Türkiye - Nilvera E-Invoice Extended	l10n_tr_nilvera_einvoice_extended	ماژول فاکتور الکترونیکی را ارتقا می‌دهد و پشتیبانی از انواع و سناریوهای متعدد فاکتور را فعال می‌کند

توجه

در برخی موارد، مانند هنگام ارتقا به یک نسخه با ماژول‌های اضافی، ممکن است ماژول‌ها به‌طور خودکار نصب نشوند. هر ماژول غایب می‌تواند به‌صورت دستی نصب شود.

همچنین ببینید

مستندات بومی‌سازی حقوق و دستمزد ترکیه

بررسی اجمالی بومی‌سازی

بستهٔ بومی‌سازی ترکیه از انطباق با مقررات مالی و حسابداری ترکیه اطمینان حاصل می‌کند. این بسته شامل ابزارهایی برای مدیریت مالیات‌ها، موقعیت‌های مالی، گزارش‌دهی و یک دفتر حساب‌های از پیش تعریف‌شده متناسب با استانداردهای ترکیه است.

بستهٔ بومی‌سازی ترکیه ویژگی‌های کلیدی زیر را برای اطمینان از انطباق با مقررات مالی و حسابداری محلی فراهم می‌کند:

• دفتر حساب‌ها: یک ساختار از پیش تعریف‌شده متناسب با استانداردهای حسابداری ترکیه

• مالیات‌ها: نرخ‌های مالیاتی از پیش پیکربندی‌شده، شامل مالیات بر ارزش افزودهٔ استاندارد و گزینه‌های نرخ صفر و معاف

• Fiscal positions (نگاشت مالیات و حساب): تنظیمات مالیاتی خودکار بر اساس وضعیت ثبت‌نام مشتری یا تأمین‌کننده

• راهکارهای اسناد الکترونیکی: یکپارچه‌سازی با Nilvera برای رعایت مقررات اسناد الکترونیکی

دفتر حساب‌ها

در دفتر حساب‌ها، حساب‌ها به‌صورت خودکار به مالیات‌های متناظر خود و فیلدهای پیش‌فرض حساب‌های پرداختنی و حساب‌های دریافتنی نگاشت می‌شوند.

توجه

دفتر حساب‌های ترکیه بر اساس حساب‌های 7/A ادارهٔ درآمد ترکیه (Gelir İdaresi Başkanlığı (GİB)) است که خط مبنایی از حساب‌های ضروری را فراهم می‌کند. حساب‌های 7/B بایگانی شده‌اند و در صورت نیاز می‌توان آن‌ها را از بایگانی خارج کرد.

مالیات‌ها

مالیات‌ها هنگام نصب بومی‌سازی ترکیه به‌صورت خودکار ایجاد و پیکربندی می‌شوند.

هشدار

مالیات‌ها را حذف نکنید، زیرا برای فاکتورهای الکترونیکی و فاکتورهای e-archive استفاده می‌شوند. بااین‌حال، می‌توان مالیات‌های جدیدی تولید کرد، مانند مالیات برای دلایل مالیات تکلیفی که هنوز در پایگاه داده وجود ندارند.

راهکارهای اسناد الکترونیکی

بومی‌سازی ترکیه از انطباق با الزامات GİB برای فرایندهای e-invoice، e-archive، e-dispatch و e-ledger اطمینان حاصل می‌کند.

از طریق یکپارچه‌سازی Nilvera، Odoo امکان ارسال، دریافت و مدیریت خودکار اسناد الکترونیکی را مطابق با استانداردهای اسناد الکترونیکی GİB فراهم می‌کند. کارکردهای اصلی یکپارچه‌سازی Nilvera عبارت‌اند از:

• ایجاد و اعتبارسنجی e-archiveها و فاکتورهای الکترونیکی مستقیماً از Odoo

• دریافت و پردازش پاسخ‌ها از Nilvera/GİB

• ذخیرهٔ نسخه‌های XML و PDF ارسال‌شده برای حسابرسی

• ایجاد و آپلود XML مربوط به e-dispatch به و از Nilvera

شرکت و مخاطبین

پیش از فعال‌سازی بومی‌سازی ترکیه، اطمینان حاصل کنید که اطلاعات زیر به‌درستی در رکورد مخاطب شرکت شما پیکربندی شده است:

مهم

برای دسترسی به تمام این فیلدها، به رکورد مخاطب شرکت در اپلیکیشن مخاطبین بروید یا با رفتن به حسابداری ↤ مشتریان ↤ مشتریان، حذف فیلتر فاکتورهای فروش و انتخاب رکورد مخاطب شرکت این کار را انجام دهید. این با دسترسی به خود رکورد شرکت از طریق تنظیمات عمومی متفاوت است.

• نام شرکت: باید با ثبت GİB مطابقت داشته باشد

• Turkish Tax Office: ادارهٔ مالیاتی ثبت‌شده

• شناسه مالیاتی: VKN/TCKN - ۱۰ رقم برای شرکت‌ها، ۱۱ رقم برای اشخاص

• نشانی: آدرس قانونی کامل

• کشور: کشور ثبت‌شده

• برچسب‌ها: شمارهٔ Mersis را به‌عنوان یک برچسب وارد کنید و دسته‌بندی را روی MERSISNO تنظیم کنید.

• فرمت فاکتور الکترونیکی: Türkiye (UBL TR 1.2)

• مستعار: نام مستعار دریافت‌شده از Nilvera

توجه

• فرمت فاکتور الکترونیکی به‌صورت خودکار بر اساس کشور مخاطب تنظیم می‌شود. برای ویرایش این فیلد، developer mode را فعال کنید تا فیلد نمایش داده شود و سپس آن را به‌صورت دستی تنظیم کنید.

• فیلد مستعار تنها زمانی قابل‌مشاهده است که Nilvera Status شرکت برابر با E-Invoice باشد.

برای هر مشتری و فروشنده:

• اطمینان حاصل کنید که نشانی، شهر، وضعیت، کشور، شناسه مالیاتی و فرمت فاکتور الکترونیکی پیکربندی شده‌اند.

• اگر شریک برای صدور فاکتور الکترونیکی ثبت نشده باشد، Odoo به‌صورت خودکار e-Archive را به‌عنوان پیش‌فرض انتخاب می‌کند.

ایجاد مالیات

ایجاد دلایل استثنا

برای ایجاد دلایل استثنای اضافی، این مراحل را دنبال کنید:

1. developer mode را فعال کنید و به حسابداری ↤ پیکربندی ↤ GIB Codes بروید.

2. روی دکمهٔ جدید کلیک کنید.

3. یک علت و یک کد دلیل وارد کنید که با مقادیر موجود در مستندات Nilvera مطابقت داشته باشند.

4. نوع کد متناظر را انتخاب کنید:

   • Withholding برای دلایل مالیات تکلیفی

   • استثناء برای دلایل معافیت مالیاتی

   • Export exception برای دلایل استثنای صادرات

   • Export registration برای دلایل ثبت‌شده برای صادرات

5. برای دلایل Withholding، درصد متناظر را وارد کنید.

ایجاد مالیات‌های تکلیفی

1. به حسابداری ↤ پیکربندی ↤ مالیات ها بروید.

2. ابتدا برای ایجاد مالیات پایه، روی دکمهٔ جدید کلیک کنید.

3. محاسبهٔ مالیات را روی درصد تنظیم کنید و فیلد Withholding Tax Reason را که برای مالیات‌های این نوع ظاهر می‌شود، تعیین کنید.

4. سایر فیلدهای الزامی فرم (نام مالیات، نوع مالیات، مقدار و غیره) را تکمیل کنید.

5. مالیات‌های اضافی با محاسبهٔ مالیات تنظیم‌شده روی گروه مالیاتها ایجاد کنید. این مالیات‌های گروهی باید از مالیات پایهٔ ایجادشده در مراحل قبل و مالیات‌های درصدی اضافی تشکیل شوند.

نکته

مالیات WH 20% این پیکربندی را نشان می‌دهد. برای استفاده از یک دلیل کسر متفاوت، مالیات پایه را تکثیر کنید، دلیل را به‌روزرسانی کنید و مالیات پایهٔ قدیمی را در مالیات‌های گروهی تکثیرشده جایگزین کنید.

یکپارچه‌سازی Nilvera

Odoo با Nilvera، یک واسطهٔ اسناد الکترونیکی تأییدشده توسط GİB، یکپارچه می‌شود تا فرایندهای e-invoice، e-archive، e-dispatch و e-ledger را مدیریت کند.

این یکپارچه‌سازی موارد زیر را مدیریت می‌کند:

• تولید دادهٔ XML در قالبی سازگار با GİB

• ارسال امن به Nilvera

• همگام‌سازی اسناد و وضعیت‌ها در داخل Odoo.

انواع اسناد پشتیبانی‌شده

• e-Invoice

  • سناریوی پایه و سناریوی عمومی

    • فروش

    • کسر

    • ثبت‌شده برای صادرات

    • معاف از مالیات

  • سناریوی صادرات

• فاکتور e-Archive

  • فروش

  • کسر

  • ثبت‌شده برای صادرات

  • معاف از مالیات

• یادداشت e-Dispatch

پیکربندی

مستندات Nilvera دستورالعمل‌هایی برای دسترسی به sandbox و تولید اعتبارنامه‌های API ارائه می‌دهد.

برای پیکربندی یکپارچه‌سازی Nilvera با پایگاه دادهٔ خود، این مراحل را دنبال کنید:

1. اطمینان حاصل کنید که ماژول Türkiye - Nilvera نصب شده است.

2. به حسابداری ↤ پیکربندی ↤ تنظیمات بروید و به بخش Türkiye Electronic Integrations اسکرول کنید.

3. پیکربندی کنید:

   • Nilvera API credentials (تولیدشده در Nilvera)

   • دفتر روزنامه فاکتورهای ورودی (یعنی خریدها)

برای پیکربندی رکوردهای مخاطب مشتری به‌منظور توانایی ارسال فاکتورهای الکترونیکی به آن‌ها از طریق Nilvera، این مراحل را دنبال کنید:

1. به حسابداری ↤ مشتریان ↤ مشتریان بروید.

2. فیلتر فاکتورهای فروش را (در صورت لزوم) حذف کنید و شریکی را که می‌خواهید از طریق Nilvera با او ارتباط برقرار کنید انتخاب کنید.

3. تب حسابداری را باز کنید و روی تأیید در کنار Nilvera Status کلیک کنید.

ارسال فاکتورهای الکترونیکی از طریق Nilvera

e-Invoice/e-Archive یک سیستم فاکتور دیجیتال تأییدشده توسط دولت است که جایگزین فاکتورهای کاغذی سنتی می‌شود و به کسب‌وکارها امکان می‌دهد فاکتورها را به‌صورت الکترونیکی و در انطباق با مقررات مالیاتی ترکیه صادر، ارسال و ذخیره کنند. درحالی‌که e-Invoiceها برای مشتریانی هستند که در GİB ثبت شده‌اند، e-Archiveها را می‌توان برای مشتریانی که در GİB ثبت نشده‌اند ارسال کرد و این اطمینان را می‌دهد که ارسال‌کنندگان حتی در تعامل با مشتریان خارجی یا گردش‌کارهای B2C نیز می‌توانند با مقررات دولتی منطبق باشند.

برای ارسال یک e-Invoice/e-Archive، این مراحل را دنبال کنید:

1. اطمینان حاصل کنید که ماژول‌های Türkiye - Nilvera E-Invoice و Türkiye - Nilvera E-Invoice Extended نصب شده‌اند.

2. هنگام ایجاد یک فاکتور مشتری، پس از انتخاب یک مشتری،

   • اگر Nilvera Status مشتری برابر با e-Archive باشد، دو فیلد ظاهر می‌شوند:

     • Is GIB Export: برای فاکتورهای صادرات محصول به شرکای خارج از ترکیه استفاده می‌شود

     • Invoice Type: نوع فاکتور را تعیین می‌کند

   • اگر Nilvera Status مشتری برابر با e-Invoice باشد، فیلد Invoice Scenario ظاهر می‌شود: سناریوی فاکتوری را که قرار است به GİB ارسال شود انتخاب کنید.

3. فاکتور را ارسال کنید و اطمینان حاصل کنید که by Nilvera برای صدور یک فاکتور الکترونیکی انتخاب شده است.

دریافت فاکتورهای الکترونیکی از طریق Nilvera

به‌روزرسانی وضعیت Nilvera

برای به‌روزرسانی Nilvera Status فاکتورها در Odoo، این مراحل را دنبال کنید:

1. Accounting Dashboard را باز کنید.

2. روی ژورنال فروش کلیک کنید.

3. روی آیکن (عملیات) کلیک کنید، سپس روی Refresh e-Invoices Status کلیک کنید. این عمل فیلد Nilvera Status را روی هر فاکتور به‌روزرسانی می‌کند.

واکشی PDFهای فاکتور الکترونیکی

دو روش برای واکشی PDFهای فاکتورهای الکترونیکی وجود دارد:

1. از نمای فهرست فاکتور:

   1. به حسابداری ↤ مشتریان ↤ فاکتورها بروید.

   2. یک یا چند فاکتور را انتخاب کنید.

   3. روی Fetch Nilvera PDF کلیک کنید

2. از نمای فرم فاکتور: هنگامی که Nilvera Status برابر با Successful شد، روی دکمهٔ Fetch Nilvera PDF کلیک کنید.

دریافت فاکتورهای الکترونیکی خرید

برای واکشی فاکتورهای الکترونیکی تولیدشده در Nilvera و دریافت‌شده توسط شرکت شما:

1. Accounting Dashboard را باز کنید.

2. روی ژورنال خرید کلیک کنید.

3. روی آیکن (عملیات) کلیک کنید، سپس روی Fetch e-invoices کلیک کنید. فاکتورهای الکترونیکی دریافت‌شده به‌صورت صورتحساب‌های فروشنده در وضعیت پیش‌نویس ایجاد می‌شوند.

واکشی PDFهای صورتحساب‌های تولیدشده در Odoo

برای صورتحساب‌های فروشنده که در Odoo ایجاد شده‌اند، بازیابی PDF به همان روش فاکتورهای مشتری کار می‌کند:

1. به حسابداری ↤ فروشندگان ↤ صورتحساب بروید.

2. یک یا چند صورتحساب فروشنده را انتخاب کنید.

3. روی دکمهٔ Fetch Nilvera PDF کلیک کنید.

تولید e-Ledger

e-Ledger یک سیستم الکترونیکی است که به کسب‌وکارها امکان می‌دهد سوابق حسابداری خود را به‌صورت دیجیتال ذخیره کرده و برای انطباق مالیاتی و قانونی به دولت ارسال کنند. در Odoo، کاربران می‌توانند e-Ledger را به‌صورت یک فایل CSV فشرده تولید کرده و سوابق شرکت را به‌صورت یکپارچه از طریق یکپارچه‌سازی Nilvera گزارش کنند.

1. به حسابداری ↤ گزارش ↤ دفتر کل بروید.

2. روی آیکن (عملیات) کلیک کنید.

3. روی Generate e-Ledger کلیک کنید تا فایل تولید شده و در رایانهٔ شما دانلود شود.

مدیریت فایل‌های e-Dispatch

تولید فایل‌های e-Dispatch

e-Dispatch یک سند الکترونیکی است که جایگزین یادداشت‌های تحویل کاغذی سنتی می‌شود و به کسب‌وکارها امکان می‌دهد جزئیات محموله را برای کالاهای در حال حمل به‌صورت دیجیتال صادر، ارسال و ردیابی کنند. در Odoo، کاربران می‌توانند اسناد e-Dispatch را به‌صورت XML تولید کرده و از طریق یکپارچه‌سازی Nilvera آپلود کنند و از عملیات تحویل منطبق و قابل‌ردیابی اطمینان حاصل کنند.

1. به انبار ↤ عملیات ↤ تحویل‌ها بروید.

2. یک سفارش تحویل موجود را باز کنید یا یک سفارش جدید ایجاد کنید.

3. هنگامی که یک آدرس تحویل انتخاب شد، اطلاعات لازم را در تب e-Dispatch که ظاهر می‌شود تکمیل کنید.

4. #. Once the delivery order is validated, click the Generate GİB e-Dispatch (XML) button that appears to generate the XML file.

5. فایل تولیدشدهٔ پیوست‌شده به سفارش تحویل را دانلود کنید و آن را برای پردازش به Nilvera آپلود کنید.

آپلود فایل‌های e-Dispatch

1. XML مربوط به e-Dispatch دریافت‌شده را از Nilvera دانلود کنید.

2. به انبار ↤ عملیات ↤ رسیدها بروید.

3. روی دکمهٔ Upload e-Receipt (XML) کلیک کنید و فایل دانلودشده را انتخاب کنید.

اطلاعات انطباق الزامی

قواعد زیر برای همهٔ کاربران یکپارچه‌سازی بومی‌سازی ترکیه الزامی هستند. انطباق با این الزامات برای اعتبار قانونی اسناد الکترونیکی صادرشده از طریق GİB و توسط Nilvera ضروری است.

ساختار شماره‌گذاری اسناد

• تمام فاکتورها و اسناد ارسال تولیدشده باید از یک ساختار شماره‌گذاری مشخص پیروی کنند: three alphanumeric characters + document year + sequential number.

  Example

  INV/2025/00001

• شماره‌گذاری باید منحصربه‌فرد، متوالی و پیوسته باشد. هر سند باید یک شناسهٔ متمایز داشته باشد.

• هنگامی که یک فایل ارسال شد، حتی اگر خطایی برگرداند، نمی‌توان از همان شمارهٔ توالی استفاده کرد؛ باید یک سند جدید ایجاد شود.

همچنین ببینید

• توالی فاکتور

• توالی صورتحساب فروشنده

شکاف‌های شمارهٔ متوالی

• اگر یک شمارهٔ توالی نادیده گرفته شود، شماره‌های جاافتادهٔ قبلی باید ظرف ۷ روز صادر شوند.

  Example

  اگر INV/2025/00002 پیش از INV/2025/00001 صادر شود، INV/2025/00001 باید ظرف ۷ روز صادر شود.

• هیچ شمارهٔ توالی نمی‌تواند پس از این بازه صادرنشده باقی بماند.

قواعد تخفیف

• تخفیف‌های سراسری (تخفیف‌هایی که به‌صورت یک سطر فاکتور جداگانه نمایش داده می‌شوند) قابل صدور نیستند.

• تمام تخفیف‌ها باید در سطح سطر محصول درون فاکتور اعمال شوند.

انطباق e-Ledger

• اولین فاکتور صادرشده باید نمایانگر مانده افتتاحیه برای دورهٔ حسابداری باشد.

• تمام فاکتورهای بعدی باید از الگوی شماره‌گذاری متوالی پیروی کنند:

  Example

  INV/2025/00001، INV/2025/00002، INV/2025/00003 و غیره.

• شماره‌گذاری متوالی باید به‌طور یکپارچه در سراسر e-Ledger حفظ شود تا یکپارچگی داده‌ها و انطباق تضمین شود.