Thổ Nhĩ Kỳ

Mô đun

Các mô-đun sau được cài đặt tự động cùng với bản địa hoá tiếng Thổ Nhĩ Kỳ:

Tên

Tên kỹ thuật

Mô tả

Türkiye - Accounting

l10n_tr

Base Turkish fiscal localization package đầy đủ bảng tài khoản Thổ Nhĩ Kỳ, thuế, báo cáo tài chính và vị thế thuế

Türkiye - Accounting Reports

l10n_tr_reports

Báo cáo thuế và lợi nhuận, lỗ dành riêng cho Türkiye

Türkiye - e-Irsaliye (e-Dispatch)

l10n_tr_nilvera_edispatch

Cho phép tạo và tải lên các tệp e-Dispatch

Ngoài ra, các mô-đun sau phải được installed thủ công để sử dụng tích hợp Nilvera cho việc quản lý tài liệu điện tử:

Tên

Tên kỹ thuật

Mô tả

Türkiye - Nilvera

l10n_tr_nilvera

Mô-đun tích hợp cho phép giao tiếp với Nilvera và tạo các tệp e-Ledger

Türkiye - Nilvera E-Invoice

l10n_tr_nilvera_einvoice

Đối với việc gửi và nhận hoá đơn điện tử trong kịch bản cơ bản đến/từ Nilvera

Türkiye - Nilvera E-Invoice Extended

l10n_tr_nilvera_einvoice_extended

Nâng cao mô-đun hóa đơn điện tử, cho phép hỗ trợ nhiều loại hóa đơn và các kịch bản

Ghi chú

Trong một số trường hợp, chẳng hạn khi nâng cấp lên phiên bản có các mô-đun bổ sung, có thể các mô-đun không được cài đặt tự động. Bất kỳ mô-đun nào còn thiếu có thể được cài đặt thủ công installed

Tổng quan bản địa hoá

Gói bản địa hoá cho Thổ Nhĩ Kỳ đảm bảo tuân thủ các quy định tài chính và kế toán của Thổ Nhĩ Kỳ. Nó bao gồm các công cụ quản lý thuế, vị thế thuế, báo cáo và hệ thống tài khoản định sẵn được điều chỉnh theo tiêu chuẩn của Thổ Nhĩ Kỳ.

Gói bản địa hoá Thổ Nhĩ Kỳ cung cấp các tính năng chính sau để đảm bảo tuân thủ các quy định tài chính và kế toán địa phương:

Hệ thống tài khoản

Trong chart of accounts, các tài khoản được tự động ánh xạ tới các loại thuế tương ứng và các trường mặc định cho tài khoản phải trả và tài khoản phải thu.

Ghi chú

Bảng hệ thống tài khoản Türkiye dựa trên tài khoản 7/A của Cục Thuế Thổ Nhĩ Kỳ (Gelir İdaresi Başkanlığı (GİB)), cung cấp nền tảng cho các tài khoản cần thiết. Tài khoản 7/B được lưu trữ và có thể khôi phục nếu cần.

Thuế

Taxes được tạo và cấu hình tự động khi cài đặt bản địa hoá Thổ Nhĩ Kỳ.

Cảnh báo

Không xóa thuế, vì chúng được sử dụng cho e-invoice và e-archive invoices. Tuy nhiên, có thể tạo ra các thuế mới, chẳng hạn cho withholding tax reasons mà chưa tồn tại trong cơ sở dữ liệu.

Giải pháp tài liệu điện tử

Bản địa hoá tiếng Thổ Nhĩ Kỳ đảm bảo tuân thủ các yêu cầu của GİB đối với các quy trình hóa đơn điện tử, lưu trữ điện tử, chuyển phát điện tử và sổ cái điện tử.

Thông qua tích hợp Nilvera, Odoo cho phép truyền tải, tiếp nhận và quản lý tự động các tài liệu điện tử phù hợp với chuẩn tài liệu điện tử của GİB. Các chức năng chính của tích hợp Nilvera bao gồm:

Công ty và liên hệ

Trước khi kích hoạt bản địa hóa Türkiye, hãy đảm bảo các thông tin sau được cấu hình đúng trong hồ sơ liên hệ của công ty bạn:

Quan trọng

Để truy cập tất cả các trường này, hãy vào hồ sơ liên hệ của công ty trong ứng dụng Contacts hoặc bằng cách vào Accounting ‣ Customers ‣ Customers, bỏ bộ lọc Customer Invoices, và chọn hồ sơ liên hệ của công ty. Điều này khác với việc truy cập trực tiếp vào hồ sơ công ty thông qua cài đặt chung.

  • Company Name: Must match the GİB registration

  • Turkish Tax Office: Cơ quan thuế đã đăng ký

  • Tax ID: VKN/TCKN - 10 chữ số cho doanh nghiệp, 11 cho cá nhân

  • Address: Địa chỉ pháp lý đầy đủ

  • Country: Quốc gia đã đăng ký

  • Tags: Nhập số Mersis làm thẻ và đặt Category thành MERSISNO.

  • eInvoice format: Türkiye (UBL TR 1.2)

  • Alias: Biệt danh được lấy từ Nilvera

Ghi chú

  • Định dạng eInvoice format được thiết lập tự động dựa trên quốc gia của liên hệ. Để chỉnh sửa trường này, bật developer mode để hiển thị trường và sau đó điều chỉnh thủ công.

  • Trường Alias chỉ hiển thị khi trạng thái Nilvera Status của công ty là E-Invoice

Đối với mỗi khách hàng và nhà cung cấp:

  • Đảm bảo rằng Address, City, State, Country, Tax IDeInvoice format đã được cấu hình.

  • Nếu đối tác không đăng ký e-invoicing, Odoo sẽ tự động mặc định là e-Archive.

Tạo thuế

Tạo lý do ngoại lệ

Để tạo các lý do ngoại lệ bổ sung, hãy làm theo các bước sau:

  1. Bật developer mode và điều hướng đến Accounting ‣ Configuration ‣ GIB Codes

  2. Nhấn nút New

  3. Nhập một Reason và một Reason Code khớp với các giá trị trong Nilvera's documentation

  4. Chọn loại mã tương ứng:

    • Withholding vì các lý do thuế khấu trừ

    • Exception vì lý do được miễn thuế

    • Export exception cho các lý do xuất ngoại lệ

    • Export registration for export-registered reasons

  5. Đối với các lý do Withholding, nhập tỷ lệ phần trăm tương ứng.

Tạo thuế khấu trừ

  1. Đi tới Accounting ‣ Configuration ‣ Taxes

  2. Nhấn nút New để tạo thuế cơ bản đầu tiên

  3. Đặt Tax Computation thành Percentage, và đặt trường Withholding Tax Reason xuất hiện cho các thuế thuộc loại này.

  4. Hoàn thành các trường bắt buộc khác của biểu mẫu (Tax Name, Tax Type, Amount, v.v.).

  5. Tạo các thuế bổ sung với Tax Computation được đặt thành Group of Taxes. Các thuế nhóm này nên được cấu thành từ thuế cơ bản đã tạo ở các bước trước và các thuế phần trăm bổ sung.

Mẹo

Thuế WH 20% minh họa cấu hình này. Để sử dụng lý do khấu trừ khác, sao chép thuế cơ bản, cập nhật lý do và thay thế thuế cơ bản cũ trong các nhóm thuế đã sao chép.

tích hợp Nilvera

Odoo tích hợp với Nilvera, một trung gian tài liệu điện tử được GİB phê duyệt, để quản lý quy trình hóa đơn điện tử, lưu trữ điện tử, giao dịch điện tử và sổ cái điện tử.

Tích hợp xử lý:

  • Tạo dữ liệu XML theo định dạng tuân thủ GİB

  • truyền tải bảo mật tới Nilvera

  • đồng bộ tài liệu và trạng thái trong Odoo.

Các loại tài liệu được hỗ trợ

  • Hóa đơn điện tử

    • Kịch bản cơ bản và kịch bản công khai

      • Bán hàng

      • Khấu trừ

      • Đã đăng ký xuất khẩu

      • Miễn thuế

    • Xuất kịch bản

  • Hóa đơn lưu trữ điện tử

    • Bán hàng

    • Khấu trừ

    • Đã đăng ký xuất khẩu

    • Miễn thuế

  • Phiếu giao hàng điện tử

Cấu hình

Tài liệu Nilvera documentation cung cấp hướng dẫn để truy cập sandbox và tạo thông tin xác thực API.

Để cấu hình tích hợp Nilvera với cơ sở dữ liệu của bạn, làm theo các bước sau:

  1. Đảm bảo mô-đun Türkiye - Nilvera được installed

  2. Đi tới Accounting ‣ Configuration ‣ Settings và cuộn xuống phần Türkiye Electronic Integrations

  3. Cấu hình:

    • Nilvera API credentials (generated in Nilvera)

    • Incoming Invoices Journal (tức là Purchases)

Để cấu hình danh sách liên hệ khách hàng của bạn để có thể gửi hoá đơn điện tử qua Nilvera, hãy thực hiện các bước sau:

  1. Đi tới Accounting ‣ Customers ‣ Customers

  2. Xóa bộ lọc Customer Invoices (nếu cần), và chọn đối tác để liên hệ qua Nilvera.

  3. Mở tab Accounting và nhấp vào Verify bên cạnh Nilvera Status

Gửi hóa đơn điện tử qua Nilvera

e-Invoice/e-Archive là hệ thống hóa đơn điện tử được chính phủ phê duyệt, thay thế cho hóa đơn giấy truyền thống, cho phép doanh nghiệp phát hành, truyền và lưu trữ hóa đơn một cách điện tử tuân thủ quy định thuế của Thổ Nhĩ Kỳ. Trong khi e-Invoices dành cho khách hàng đã đăng ký với GİB, e-Archives có thể được gửi tới khách hàng chưa đăng ký với GİB, đảm bảo người gửi tuân thủ quy định của chính phủ ngay cả khi làm việc với khách hàng nước ngoài hoặc quy trình B2C.

Để gửi e-Invoice/e-Archive, làm theo các bước sau:

  1. Đảm bảo các mô-đun Türkiye - Nilvera E-InvoiceTürkiye - Nilvera E-Invoice Extended đã được installed.

  2. Khi creating a customer invoice, sau khi chọn Customer,

    • nếu Nilvera Status của khách hàng là e-Archive, sẽ xuất hiện hai trường:

      • Is GIB Export: được sử dụng cho các hóa đơn xuất khẩu sản phẩm tới đối tác bên ngoài Thổ Nhĩ Kỳ

      • Invoice Type: xác định loại hóa đơn

    • nếu Nilvera Status của khách hàng là e-Invoice, trường Invoice Scenario sẽ xuất hiện: Chọn kịch bản hoá đơn sẽ được gửi tới GİB.

  3. Send hóa đơn, và đảm bảo by Nilvera được chọn để phát hành hoá đơn điện tử.

Nhận hóa đơn điện tử qua Nilvera

Cập nhật trạng thái Nilvera

To update the Nilvera Status of invoices in Odoo, follow these steps:

  1. Open the Accounting Dashboard.

  2. Nhấn vào sổ nhật ký Sales.

  3. Nhấn vào biểu tượng (Actions), rồi nhấn Refresh e-Invoices Status. Hành động này sẽ cập nhật trường Nilvera Status trên mỗi hoá đơn.

Lấy PDF hoá đơn điện tử

Có hai cách để lấy PDF của hóa đơn điện tử:

  1. Từ chế độ xem danh sách Hóa đơn:

    1. Đi tới Accounting ‣ Customers ‣ Invoices.

    2. Chọn một hoặc nhiều hóa đơn.

    3. Nhấn Fetch Nilvera PDF

  2. Từ giao diện biểu mẫu hoá đơn: Khi Nilvera StatusSuccessful, nhấn nút Fetch Nilvera PDF

Nhận hóa đơn điện tử mua hàng

Để lấy hoá đơn điện tử được tạo trong Nilvera và nhận được bởi công ty của bạn:

  1. Open the Accounting Dashboard.

  2. Nhấn vào sổ nhật ký Purchase

  3. Nhấn vào biểu tượng (Actions), rồi nhấn Fetch e-invoices. Các hóa đơn điện tử nhận được được tạo thành hoá đơn mua hàng ở trạng thái Draft.

Lấy PDF của các hóa đơn được tạo trong Odoo

Đối với các hóa đơn mua hàng được tạo trong Odoo, việc lấy PDF hoạt động tương tự như với hóa đơn bán hàng:

  1. Đi tới Accounting ‣ Vendors ‣ Bills

  2. Chọn một hoặc nhiều hóa đơn mua hàng.

  3. Nhấn nút Fetch Nilvera PDF.

Tạo sổ cái điện tử

e-Ledger là một hệ thống điện tử cho phép doanh nghiệp lưu trữ và nộp hồ sơ kế toán của mình cho chính phủ dưới dạng số để tuân thủ thuế và quy định. Trong Odoo, người dùng có thể tạo e-Ledger dưới dạng tệp CSV nén và báo cáo hồ sơ công ty một cách liền mạch thông qua tích hợp Nilvera.

  1. Đi tới Accounting ‣ Reporting ‣ General Ledger.

  2. Nhấp vào biểu tượng (Actions).

  3. Nhấn Generate e-Ledger để tạo tệp và tải xuống máy tính của bạn.

Quản lý tệp e-Dispatch

Tạo tệp e-Dispatch

e-Dispatch là tài liệu điện tử thay thế các phiếu giao hàng giấy truyền thống, cho phép doanh nghiệp phát hành, truyền tải và theo dõi chi tiết lô hàng cho hàng hoá đang trong quá trình vận chuyển một cách số hóa. Trong Odoo, người dùng có thể tạo tài liệu e-Dispatch dưới dạng XML và tải lên thông qua tích hợp Nilvera, đảm bảo hoạt động giao hàng tuân thủ và có thể truy xuất.

  1. Đi tới Inventory ‣ Operations ‣ Deliveries.

  2. Mở đơn giao hàng hiện có hoặc tạo một đơn mới.

  3. Khi một Delivery Address được chọn, điền thông tin cần thiết vào tab e-Dispatch xuất hiện.

  4. Sau khi đơn giao hàng được xác nhận, nhấn nút Generate GİB e-Dispatch (XML) xuất hiện để tạo tệp XML.

  5. Tải xuống tệp được tạo đính kèm trong phiếu xuất kho và tải lên Nilvera để xử lý.

Tải lên tệp e-Dispatch

  1. Tải xuống e-Dispatch XML đã nhận từ Nilvera

  2. Đi tới Inventory ‣ Operations ‣ Receipts

  3. Nhấn nút Upload e-Receipt (XML) và chọn tệp đã tải xuống.

Thông tin tuân thủ bắt buộc

Các quy tắc sau là bắt buộc đối với tất cả người dùng của tích hợp địa phương hoá Türkiye. Tuân thủ các yêu cầu này là cần thiết để đảm bảo tính pháp lý của các tài liệu điện tử được phát hành qua GİB qua Nilvera.

Cấu trúc đánh số tài liệu

  • Tất cả các hóa đơn và tài liệu xuất kho được tạo ra phải tuân theo một cấu trúc đánh số cụ thể: three alphanumeric characters + document year + sequential number.

    Example

    INV/2025/00001

  • Số thứ tự phải là duy nhất, tuần tự và liên tục. Mỗi tài liệu phải có một định danh riêng.

  • Sau khi tệp đã được gửi, ngay cả khi nó trả về lỗi, không thể sử dụng lại cùng một số thứ tự; phải tạo một tài liệu mới.

Khoảng trống số thứ tự

  • Nếu một số trong dãy bị bỏ qua, các số còn thiếu trước đó phải được cấp trong vòng 7 ngày.

    Example

    Nếu INV/2025/00002 được phát hành trước INV/2025/00001, INV/2025/00001 phải được phát hành trong vòng 7 ngày.

  • Không được để số thứ tự chưa phát hành vượt quá thời gian này.

Quy tắc chiết khấu

  • Giảm giá toàn cục (giảm giá được hiển thị như một dòng riêng trên hóa đơn) không thể phát hành.

  • Tất cả chiết khấu phải được áp dụng ở mức dòng sản phẩm trong hoá đơn.

Tuân thủ sổ cái điện tử

  • Hóa đơn đầu tiên được phát hành phải phản ánh số dư đầu kỳ cho kỳ kế toán.

  • Tất cả các hoá đơn tiếp theo phải tuân theo quy tắc đánh số tuần tự:

    Example

    INV/2025/00001, INV/2025/00002, INV/2025/00003, etc.

  • Số thứ tự liên tiếp phải được duy trì một cách nhất quán trên e-Ledger để đảm bảo tính toàn vẹn dữ liệu và tuân thủ.