土耳其¶
模块¶
以下模块会自动安装土耳其语本地化版本：
名称 |
技术名称 |
描述 |
|---|---|---|
Türkiye - Accounting |
|
基础土耳其语 fiscal localization package 包含土耳其会计科目表、税收、财务报告和财务状况 |
Türkiye - Accounting Reports |
|
土耳其特定的税务和损益报告。 |
Türkiye - e-Irsaliye (e-Dispatch) |
|
启用电子调度文件的生成和上传 |
此外，以下模块必须手动 installed 才能使用 尼尔维拉整合 管理电子文档：
名称 |
技术名称 |
描述 |
|---|---|---|
Türkiye - Nilvera |
|
集成模块可与 Nilvera 进行通信并生成电子账本文件 |
Türkiye - Nilvera E-Invoice |
|
用于向/从 Nilvera 发送和接收基本场景电子发票。 |
Türkiye - Nilvera E-Invoice Extended |
|
增强电子发票模块，支持多种发票类型和场景 |
注解
在某些情况下，例如升级到带有附加模块的版本时，模块可能不会自动安装。任何缺失的模块都可以手动 installed。
本地化概述¶
土耳其本地化包确保遵守土耳其财务和会计法规。它包括用于管理税收、财政状况、报告和根据土耳其标准定制的预定义科目表的工具。
土耳其本地化包提供以下主要功能，以确保遵守当地财务和会计法规：
科目表：根据土耳其会计标准定制的预定义结构
税：预先配置的税率，包括标准增值税、零税率和免税选项
财政状况（税项和科目映射）：根据客户或供应商注册状态自动进行税务调整
电子文档解决方案：与 Nilvera 集成以满足电子文档法规
科目表¶
在 chart of accounts 中，科目会自动映射到相应的税费以及默认应付账款和应收账款字段。
注解
土耳其会计科目表以土耳其税务局 (Gelir Idaresi Başkanlığı’s (GıB)) 7/A 账户为基础，该账户提供了必要账户的基准。 7/B 帐户已存档，并且可以根据需要取消存档。
税¶
安装土耳其语本地化版本时，会自动创建和配置 Taxes。
警告
不要删除税费，因为它们用于电子发票和电子存档发票。但是，可以生成新的税费，例如数据库中尚不存在的 withholding tax reasons。
电子文档解决方案¶
土耳其本地化确保符合 GİB 对电子发票、电子存档、电子调度和电子分类帐流程的要求。
通过 Nilvera 集成，Odoo 能够按照 GİB 的电子文档标准自动传输、接收和管理电子文档。 Nilvera 集成的主要功能包括：
公司及联系方式¶
在激活土耳其本地化之前，请确保在您公司的联系人记录中正确配置以下信息：
重要
要访问所有这些字段，请转到“联系人”应用程序中的公司联系人记录，或者转到 ，删除 Customer Invoices 筛选器，然后选择公司的联系人记录。这与通过常规设置访问公司记录本身不同。
Company Name：必须与 GİB 注册匹配
Turkish Tax Office：注册税务局
Tax ID：VKN/TCKN - 公司 10 位数字，个人 11 位
Address：完整的法定地址
Country：注册国家/地区
Tags：输入 Mersis 编号作为标签，并将 Category 设置为 MERSISNO。
eInvoice format：土耳其 (UBL TR 1.2)
Alias：从 Nilvera 获取的别名
注解
eInvoice format 根据联系人所在国家/地区自动设置。要编辑此字段，请启用 developer mode 显示该字段，然后手动调整它。
仅当公司的 Nilvera Status 为 E-Invoice 时，Alias 字段才可见。
对于每个客户和供应商：
确保配置了 Address、City、State、Country、Tax ID 和 eInvoice format。
如果合作伙伴未注册电子发票，Odoo 将自动默认为电子存档。
税收创造¶
创建异常原因¶
要创建其他异常原因，请按照下列步骤操作：
启用 developer mode 并导航至 。
单击 New 按钮。
输入与 Nilvera’s documentation 中的值匹配的 Reason 和 Reason Code。
选择对应的代码类型：
Withholding 因预扣税原因
Exception 出于免税原因
Export exception 出于出口例外原因
Export registration 出于出口注册原因
对于 Withholding 原因，请输入相应的百分比。
创建预扣税¶
导航至 。
单击 New 按钮首先创建基本税。
将 Tax Computation 设置为 Percentage，并设置针对此类税金显示的 Withholding Tax Reason 字段。
填写表格的其他必填字段（Tax Name、Tax Type、Amount 等）。
创建附加税，并将 Tax Computation 设置为 Group of Taxes。这些团体税应由前面步骤中创建的基本税和附加百分比税组成。
小技巧
WH 20% 税说明了这种配置。要使用不同的预扣税原因，请复制基本税，更新原因，然后替换重复的集团税中的旧基本税。
尼尔维拉整合¶
Odoo 与 Nilvera（一家 GİB 批准的电子文档中介机构）集成，以管理电子发票、电子存档、电子调度和电子分类账流程。
集成处理：
以 GİB 兼容格式生成 XML 数据
安全传输到 Nilvera
Odoo 内的文档和状态同步。
支持的文档类型¶
电子发票
基础场景和公共场景
销售
预扣税
已注册出口
免税
出口场景
电子存档发票
销售
预扣税
已注册出口
免税
电子调度单
配置¶
Nilvera documentation 提供访问沙箱和生成 API 凭证的说明。
要配置 Nilvera 与数据库的集成，请执行以下步骤：
确保 Türkiye - Nilvera 模块是 installed。
导航到 并滚动到 Türkiye Electronic Integrations 部分。
配置：
:guilabel:`Nilvera API credentials`（在 Nilvera 中生成）
Incoming Invoices Journal`（即 :guilabel:`Purchases）
要配置您的客户联系记录以便能够通过 Nilvera 向他们发送电子发票，请按照以下步骤操作：
导航至 。
删除 Customer Invoices 过滤器（如有必要），然后选择要通过 Nilvera 联系的合作伙伴。
打开 Accounting 选项卡，然后单击 Nilvera Status 旁边的 Verify。
通过 Nilvera 发送电子发票¶
电子发票/电子存档是政府批准的数字发票系统，可取代传统的纸质发票，允许企业按照土耳其税务法规以电子方式开具、传输和存储发票。虽然电子发票适用于在 GİB 注册的客户，但电子档案可以发送给未在 GİB 注册的客户，确保发送者即使在与外国客户或 B2C 工作流程打交道时也能遵守政府法规。
要发送电子发票/电子档案，请按照以下步骤操作：
确保 Türkiye - Nilvera E-Invoice 和 Türkiye - Nilvera E-Invoice Extended 模块是 installed。
当:ref:`creating a customer invoice <accounting/invoice/creation>`时，选择:guilabel:`Customer`后，
如果客户的 Nilvera Status 是 e-Archive，则会出现两个字段：
Is GIB Export：用于向土耳其境外合作伙伴提供产品出口发票
Invoice Type：确定发票类型
如果客户的:guilabel:
Nilvera Status`为:guilabel:`e-Invoice，则会出现:guilabel:`Invoice Scenario`字段：选择要发送到|GİB|的发票场景。
Send 发票，并确保选择 by Nilvera 来开具电子发票。
通过 Nilvera 接收电子发票¶
更新 Nilvera 状态¶
要在 Odoo 中更新发票的 Nilvera Status，请按照以下步骤操作：
打开 Accounting Dashboard。
单击 Sales 日记帐。
单击 (Actions) 图标，然后单击 Refresh e-Invoices Status。此操作会更新每张发票上的 Nilvera Status 字段。
获取电子发票 PDF¶
有两种方法获取电子发票的 PDF：
从发票列表查看：
转到:menuselection:
Accounting --> Customers --> Invoices。选择一张或多张发票。
单击 Fetch Nilvera PDF
从发票表单视图中：一旦 Nilvera Status 为 Successful，请单击 Fetch Nilvera PDF 按钮。
接收采购电子发票¶
要获取在 Nilvera 中生成并由贵公司收到的电子发票：
打开 Accounting Dashboard。
单击 Purchase 日记帐。
单击 (Actions) 图标，然后单击 Fetch e-invoices。收到的电子发票将创建为 Draft 状态的供应商账单。
获取 Odoo 中生成的帐单 PDF¶
对于在 Odoo 中创建的供应商账单，PDF 检索的工作方式与客户发票相同：
转到:menuselection:
Accounting --> Vendors --> Bills。选择一张或多张供应商账单。
单击 Fetch Nilvera PDF 按钮。
生成电子账本¶
电子账本是一种电子系统，使企业能够以数字方式存储并向政府提交其会计记录，以确保税务和监管合规性。在 Odoo 中，用户可以将电子账本生成为压缩的 CSV 文件，并通过 Nilvera 集成无缝报告公司记录。
导航至 。
单击:icon:
fa-cog(Actions) 图标。单击 Generate e-Ledger 生成文件并将其下载到您的计算机。
管理电子调度文件¶
生成电子调度文件¶
电子调度是一种电子文档，取代了传统的纸质交货单，允许企业以数字方式发出、传输和跟踪运输途中货物的装运详细信息。在 Odoo 中，用户可以生成 XML 格式的电子调度文档，并通过 Nilvera 集成上传它们，确保交付操作合规且可追踪。
导航至 。
打开现有交货单或创建新交货单。
选择 Delivery Address 后，请在出现的 e-Dispatch 选项卡中填写必要的信息。
#.验证交货订单后，单击出现的 Generate GİB e-Dispatch (XML) 按钮以生成 XML 文件。
下载交货单附带的生成文件并将其上传到 Nilvera 进行处理。
上传电子调度文件¶
下载从 Nilvera 收到的电子调度 XML。
导航至 。
单击 Upload e-Receipt (XML) 按钮并选择下载的文件。
强制性合规信息¶
以下规则对于 Türkiye 本地化集成的所有用户都是强制性的。遵守这些要求对于通过 Nilvera GİB 签发的电子文件的法律有效性至关重要。
文档编号结构¶
所有生成的发票和发货单据必须遵循特定的编号结构：
three alphanumeric characters+document year+sequential number。Example
INV/2025/00001
编号必须是唯一的、连续的且连续的。每个文档必须有一个独特的标识符。
文件一旦提交，即使返回错误，也不能使用相同的序列号；必须创建一个新文档。
序号间隙¶
如果序列号被跳过，之前缺失的序列号必须在 7 天内发出。
Example
如果 INV/2025/00002 在 INV/2025/00001 之前签发，则 INV/2025/00001 必须在 7 天内签发。
超过此期限后，任何序列号都不能保持未发布状态。
折扣规则¶
无法发放全局折扣（折扣显示为单独的发票行）。
所有折扣必须应用于发票内的产品线级别。
电子账本合规性¶
第一张发票必须代表会计期间的期初余额。
所有后续发票必须遵循顺序编号模式：
Example
INV/2025/00001、INV/2025/00002、INV/2025/00003 等
整个电子账本中必须保持一致的顺序编号，以确保数据完整性和合规性。