گواتمالا

مقدمه

با بومی‌سازی گواتمالا، می‌توانید به مقام مالیاتی Superintendencia de Administración Tributaria (SAT) متصل شوید تا اسناد الکترونیکی با XML، fiscal folio و امضای الکترونیکی آن تولید کنید.

اسناد پشتیبانی‌شده عبارتند از:

  • FACT-Factura,

  • FCAM-Factura Cambiaria,

  • FPEQ-Factura de Pequeño Contribuyente,

  • NCRE-Credit Note,

  • NDEB-Debit Note,

  • NABN-Nota de Abono,

  • FCAP-Factura Cambiaria Pequeño Contribuyente,

  • FACT-Factura with Export Complement.

بومی‌سازی نیازمند یک حساب Infile است که به کاربران اجازه می‌دهد اسناد الکترونیکی را در Odoo تولید کنند. برای درخواست حساب Infile، Infile Registration Form را پر کنید.

واژه‌نامه

اصطلاحات زیر در سراسر بومی‌سازی گواتمالا استفاده می‌شوند:

  • SAT: Superintendencia de Administración Tributaria نهاد دولتی مسئول اجرای پرداخت‌های مالیاتی در گواتمالا است.

  • FEL: Factura Electrónica en Línea سیستم صدور فاکتور الکترونیکی است که توسط SAT در گواتمالا مقرر شده است که از کسب‌وکارها می‌خواهد اسناد الکترونیکی را در انطباق با مقررات محلی صادر و مدیریت کنند.

  • EDI: Electronic Data Interchange به ارسال اسناد الکترونیکی اشاره دارد.

  • Infile: سازمان شخص ثالثی است که تبادل اسناد الکترونیکی بین شرکت‌ها و دولت گواتمالا را تسهیل می‌کند.

  • UUID: Universally Unique Identifier یک کد حروف و عدد منحصربه‌فرد است که توسط SAT به هر سند الکترونیکی گواهی‌شده در سیستم FEL اختصاص داده می‌شود و برای قابلیت ردیابی و اعتبارسنجی رسمی استفاده می‌شود.

  • Phrases: نوع Phrases با Scenario Codes خاص در بومی‌سازی گواتمالا برای انطباق با الزامات SAT استفاده می‌شوند. آن‌ها باید بسته به رژیم صادرکننده، گیرنده و نوع عملیات اضافه شوند. این عبارات در اسناد XML و PDF استفاده می‌شوند.

  • Establishment Code: یک شناسه منحصربه‌فرد که توسط SAT به هر establishment کسب‌وکار اختصاص داده می‌شود و برای صدور فاکتور الکترونیکی الزامی است.

  • Quetzal: ارز رسمی گواتمالا که با نماد GTQ نشان داده می‌شود. این ارز پایه برای همه تراکنش‌های مالی در بومی‌سازی گواتمالا است.

پیکربندی

نصب ماژول‌ها

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

نام

نام فنی

توضیحات

Guatemala - Accounting

l10n_gt

بسته بومی‌سازی مالیاتی پیش‌فرض. ویژگی‌های حسابداری بومی‌سازی گواتمالا را اضافه می‌کند، که حداقل پیکربندی مورد نیاز برای یک شرکت برای فعالیت در گواتمالا را طبق دستورالعمل‌های SAT نشان می‌دهند. نصب ماژول به‌طور خودکار chart of accounts و مالیات‌ها را بارگذاری می‌کند.

Guatemala Accounting EDI

l10n_gt_edi

همه الزامات فنی و عملکردی برای تولید و اعتبارسنجی اسناد الکترونیکی را شامل می‌شود، بر اساس مستندات فنی منتشرشده توسط SAT. اسناد مجاز در بالا فهرست شده‌اند.

توجه

Odoo به‌طور خودکار ماژول پایه Guatemala - Accounting را زمانی که یک پایگاه داده با Guatemala به‌عنوان کشور انتخاب شده نصب می‌شود، نصب می‌کند. با این حال، برای فعال‌سازی صدور فاکتور الکترونیکی، ماژول Guatemala Accounting EDI (l10n_gt_edi) باید به‌صورت دستی نصب شود.

شرکت

برای پیکربندی اطلاعات شرکت خود، اپلیکیشن Settings را باز کنید، به بخش Companies اسکرول کنید، روی Update Info کلیک کنید و موارد زیر را پیکربندی کنید:

  • نام شرکت

  • Address، شامل Street، City، State، ZIP و Country

  • Tax ID: شماره شناسایی برای نوع مودی مالیاتی انتخاب‌شده را وارد کنید.

  • VAT Affiliation: VAT affiliation برای شرکت را انتخاب کنید، که نوع رژیمی است که شرکت به آن تعلق دارد.

  • Legal Name: نام قانونی شرکت که در اسناد XML و PDF استفاده می‌شود.

  • Establishment Code: بخش لازمی از XML هنگام ایجاد یک سند الکترونیکی است. اگر این فیلد تنظیم نشود، همه اسناد الکترونیکی رد خواهند شد.

    برای یافتن Establishment Code در حساب SAT خود، به FEL ↤ Administración de Establecimientos بروید. فهرست establishment های ثبت‌شده به همراه کدهای متناظر آن‌ها نمایش داده می‌شود.

مهم

پس از پیکربندی شرکت در تنظیمات پایگاه داده، به فرم مخاطب شرکت بروید و بررسی کنید که Type Identification Number به NIT تنظیم شده است.

اعتبارنامه‌های صدور فاکتور الکترونیکی

در گواتمالا، صدور فاکتور الکترونیکی برای بیشتر کسب‌وکارها اجباری است. Odoo با ارائه‌دهنده مجاز، Infile، متصل می‌شود تا اسناد الکترونیکی را برای اعتبارسنجی به SAT تولید و ارسال کند.

پیش از صدور اسناد الکترونیکی، باید Odoo را پیکربندی کنید و به Infile متصل کنید تا اطمینان حاصل شود که به‌درستی اعتبارسنجی شده و یک UUID رسمی به آن‌ها اختصاص داده می‌شود.

Infile

یک قرارداد سرویس مستقیماً با Infile امضا کنید. سپس Infile اعتبارنامه‌های لازم را برای وارد کردن در Odoo فراهم می‌کند.

توجه

برای ایجاد یک حساب Infile و بهره‌مندی از تخفیف ۸٪ که برای مشتریان Odoo در دسترس است، Infile Registration Form را پر کنید. یک نماینده Infile با شما تماس خواهد گرفت تا به شما در تکمیل فرآیند onboarding و امضای قرارداد سرویس کمک کند.

Odoo

در Odoo، پس از تکمیل فرآیند Infile، به Accounting ↤ Configuration ↤ Settings بروید، به بخش Guatemalan Localization اسکرول کنید، سپس این مراحل را دنبال کنید:

  1. محیط Infile Web Services را انتخاب کنید، یا Test یا Production.

  2. Infile Credentials را وارد کنید:

    • Infile WS Username or Prefix

    • Infile Token

    • Infile Key

  3. روی ذخیره کلیک کنید.

توجه

Infile Credentials توسط Infile ارائه می‌شوند و برای هر دو محیط test و production الزامی هستند. اگر در دسترس نباشند، با پشتیبانی Infile تماس بگیرید.

نکته

محیط demo فقط برای آزمایش است و اسناد قانونی، کلیدهای UUID یا fiscal folios تولید نمی‌کند. هیچ حساب یا اعتبارنامه Infile برای استفاده از محیط demo نیاز نیست.

چند ارزی

نرخ ارز رسمی در گواتمالا توسط Bank of Guatemala ارائه می‌شود. Odoo می‌تواند مستقیماً به سرویس‌های آن متصل شود و نرخ ارز را به‌صورت خودکار یا دستی دریافت کند.

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

چند ارزی

داده‌های اصلی

دفتر حساب‌ها

chart of accounts به‌طور پیش‌فرض به‌عنوان بخشی از مجموعه داده‌های گنجانده‌شده در ماژول بومی‌سازی نصب می‌شود، حساب‌ها به‌طور خودکار در مالیات‌ها، accounts payable پیش‌فرض و accounts receivable پیش‌فرض mapped می‌شوند.

حساب‌ها می‌توانند بر اساس نیازهای شرکت اضافه یا حذف شوند.

مخاطبین

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

  • نام شرکت

  • Address، شامل Street، City، State، ZIP و Country

  • Identification Number:

    • Type: یک نوع شناسایی انتخاب کنید.

    • Number: برای تأیید یک فاکتور الکترونیکی الزامی است.

توجه

برای گنجاندن خودکار یک phrase خاص در XML و PDF هر فاکتور الکترونیکی برای یک مخاطب، آن را در فیلد Phrases در تب Sales & purchase فرم مخاطب انتخاب کنید.

مالیات‌ها

به‌عنوان بخشی از ماژول بومی‌سازی گواتمالا، مالیات‌ها به‌طور خودکار با پیکربندی و حساب‌های مالی مرتبط آن‌ها ایجاد می‌شوند.

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

پس از پیکربندی موفقیت‌آمیز پایگاه داده، اسناد الکترونیکی می‌توانند ایجاد و ارسال شوند.

پس از اعتبارسنجی فاکتورهای مشتری، آن‌ها می‌توانند به‌صورت الکترونیکی از طریق Infile به SAT ارسال شوند، به شرطی که فیلدهای زیر تکمیل شوند:

  • Customer: اطلاعات مشتری را تایپ کنید.

  • GT Document Type: نوع سندی را که می‌خواهید ایجاد کنید انتخاب کنید، یعنی FACT - Factura Electrónica یا FCAM - Factura Cambiara. به‌طور پیش‌فرض، نوع سند به FACT تنظیم شده است.

  • Due date: برای محاسبه اینکه آیا فاکتور هم‌اکنون یا بعداً سررسید است.

  • Journal: ژورنال فروش را انتخاب کنید.

  • Products: محصول(ات) را با مالیات‌های صحیح مشخص کنید.

وقتی انجام شد، روی تایید کلیک کنید.

توجه

اگر باید یک phrase خاص بر اساس تراکنش اضافه کنید، به تب Other Info بروید و phrase متناظر را در GT Phrases اضافه کنید. این phrase ها در اسناد XML و PDF استفاده می‌شوند.

توجه

اگر باید یک addendum به فاکتور اضافه کنید، می‌توانید این کار را در فیلد Terms and Conditions انجام دهید. addendum در سند XML گنجانده می‌شود و می‌تواند برای ارائه اطلاعات اضافی یا یادداشت‌های مربوط به فاکتور استفاده شود.

پس از تأیید فاکتور، Send را کلیک کنید. در wizard که ظاهر می‌شود، اطمینان حاصل کنید چک‌باکس‌های Send to SAT و by Email را فعال کنید تا XML از طریق سرویس وب Infile به SAT و فاکتور اعتبارسنجی‌شده به ایمیل مشتری ارسال شود، سپس Send را کلیک کنید. سپس موارد زیر رخ می‌دهد:

  • سند XML ایجاد می‌شود.

  • UUID تولید می‌شود.

  • XML به‌صورت همزمان توسط Infile پردازش می‌شود.

    • اگر پذیرفته شود، فایل در چتر نمایش داده می‌شود و ایمیل به مشتری با فایل‌های متناظر pdf و xml ارسال می‌شود.

    • اگر فایل دارای خطا باشد، یک پیام هشدار دلیل(ها) را نمایش می‌دهد و ایمیل ارسال نمی‌شود.

اسناد EDI موجود در چتر.

سپس تب SAT موارد زیر را نمایش می‌دهد:

  • Datetime: Timestamp ثبت‌شده ایجاد XML.

  • GT Status: نتیجه وضعیت به‌دست‌آمده در پاسخ SAT. اگر فایل دارای خطا باشد، یک پیام هشدار دلیل(ها) را نمایش می‌دهد و ایمیل ارسال نمی‌شود.

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

  • Download Certificate: برای دانلود فایل XML ارسال‌شده، حتی اگر نتیجه SAT رد شده باشد.

رکورد سند EDI در دسترس در تب SAT.

Debit notes و credit notes

برای ارسال یک debit یا credit note به Infile، ابتدا debit یا credit note را ایجاد کنید.

سپس در پنجره Send، Send to SAT (Guatemalan EDI) را کلیک کنید تا برای اعتبارسنجی real-time ارسال شود. پس از اعتبارسنجی موفق، QR code از Infile در PDF آن debit یا credit note جاسازی می‌شود.

Export invoices

فاکتورهای صادراتی باید شرایط زیر را برآورده کنند:

  • Identification type مشتری باید VAT، Passport یا Foreign ID باشد.

  • فیلدهای زیر باید در تب Other Info فاکتور مشتری، در بخش Accounting تعریف شوند:

    • Incoterm

    • GT Phrases: Type 4 Code 1

    • Consignatory Company

  • همه خطوط فاکتور باید مالیات‌های تنظیم‌شده روی ۰٪ را شامل شوند.

داده‌های اصلی فاکتورهای صادراتی.