土耳其¶
模块¶
安装土耳其本地化时会自动安装以下模块：
名称 |
技术名称 |
描述 |
|---|---|---|
土耳其 - 会计 |
|
基础的土耳其 财务本地化套装，包含土耳其科目表、税项、财务报告和财政状况 |
土耳其 - 会计报告 |
|
土耳其专用的税务及损益报告。 |
土耳其 - e-Irsaliye (e-Dispatch) |
|
支持生成并上传电子运单文件 |
此外，必须手动 安装 以下模块，才能使用 Nilvera 集成 管理电子文档：
名称 |
技术名称 |
描述 |
|---|---|---|
土耳其 - Nilvera |
|
集成模块，用于与 Nilvera 通信并生成电子分类账文件 |
土耳其 - Nilvera 电子发票 |
|
用于向 Nilvera 发送和从 Nilvera 接收基本场景的电子发票。 |
注解
在某些情况下，例如升级到带有额外模块的版本时，可能会出现模块未自动安装的情况。任何缺失的模块都可以手动 安装 。
另请参阅
本地化概述¶
土耳其本地化套装确保符合土耳其的财税和会计法规。它包含用于管理税项、财政状况、报告的工具，以及专为土耳其标准定制的预定义科目表。
为确保符合当地财税和会计法规，土耳其本地化套装提供以下主要功能：
科目表：专为土耳其会计准则定制的预定义结构
税：预配置的税率，包括标准增值税、零税率和免税选项
财政状况（税项和科目映射） ：基于客户或供应商注册状态的自动税务调整
电子文档解决方案：与 Nilvera 集成，以满足电子文档法规
科目表¶
在 科目表 中，账户会自动映射到相应的税项以及默认的应付账款和应收账款字段。
注解
土耳其科目表基于土耳其税务局（Gelir İdaresi Başkanlığı (GİB)）的 7/A 账户，其中提供了必要账户的基础。7/B 账户已归档，如有需要可以取消归档。
税¶
安装土耳其本地化后，税项 会自动创建并配置。
警告
请勿删除税项，因为它们用于电子发票和电子存档发票。不过，可以创建新的税项，例如用于数据库中尚不存在的 预扣税原因 。
电子文档解决方案¶
土耳其本地化确保符合 GİB 对电子发票、电子存档、电子运单和电子分类账流程的要求。
通过 Nilvera 集成，Odoo 可按照 GİB 的电子文档标准自动传输、接收和管理电子文档。Nilvera 集成的主要功能包括：
保存已传输的 XML 和 PDF 版本以供审计
公司和联系人¶
在启用土耳其本地化之前，请确保公司联系人记录中已正确配置以下信息：
重要
要访问所有这些字段，请前往联系人应用中的公司联系人记录，或者前往 ，移除 Customer Invoices 筛选器，然后选择该公司的联系人记录。这与通过常规设置访问公司记录本身不同。
Company Name：必须与 GİB 登记信息一致
Turkish Tax Office：登记的税务局
Tax ID：VKN/TCKN — 公司为 10 位数字，个人为 11 位数字
Address：完整的法定地址
Country：登记的国家/地区
Tags：将 Mersis 编号作为标签输入，并将 Category 设置为 MERSISNO
eInvoice format：Türkiye (UBL TR 1.2)
eInvoice Alias：从 Nilvera 获取
eDispatch Alias：从 Nilvera 获取
注解
eInvoice format 会根据联系人所在国家/地区自动设置。要编辑此字段，请启用 开发者模式 以显示该字段，然后手动调整。
只有当公司的 Nilvera Status 为 E-Invoice 后，eInvoice Alias 和 eDispatch Alias 字段才会显示。
对于每个客户和供应商：
确保已配置 Address、City、State、Country、Tax ID 和 eInvoice format 。
如果业务伙伴未注册电子发票，Odoo 会自动默认使用电子存档。
创建税项¶
创建例外原因¶
如需创建其他例外原因，请按以下步骤操作：
启用 开发者模式，并前往 。
点击 New 按钮。
输入与 Nilvera 文档 中值一致的 Reason 和 Reason Code 。
选择相应的代码类型：
Withholding 用于预扣税原因
Exception 用于免税原因
Export exception 用于出口例外原因
Export registration 用于出口登记原因
对于 Withholding 原因，请输入相应的百分比。
创建预扣税¶
前往 。
先点击 New 按钮创建基础税。
将 税款计算 设为 Percentage，并设置此类税项所显示的 Withholding Tax Reason 字段。
填写表单中其他必填字段（Tax Name、Tax Type、Amount 等）。
创建其他税项，将 税款计算 设为 Group of Taxes 。这些税组应由前几步创建的基础税和其他百分比税组成。
小技巧
WH 20% 税项即为该配置的示例。如需使用其他预扣原因，请复制基础税、更新原因，并在复制的税组中替换旧的基础税。
Nilvera 集成¶
Odoo 与 Nilvera（经 GİB 批准的电子文档中介）集成，以管理电子发票、电子存档、电子运单和电子分类账流程。
该集成负责：
以符合 GİB 要求的格式生成 XML 数据
安全传输至 Nilvera
在 Odoo 内同步文档和状态。
支持的文档类型¶
电子发票
基本场景
销售
预扣税
已登记出口
免税
退货
预扣税退货
公众场景
销售
预扣税
免税
出口场景
商业场景 - 销售 - 预扣税 - 已登记出口 - 免税
电子存档发票
销售
预扣税
已登记出口
免税
退货
预扣税退货
电子发货单
注解
退货发票只能通过贷记单发送。
配置¶
Nilvera 文档 提供了访问沙盒和生成 API 凭证的说明。
要将 Nilvera 集成配置到您的数据库中，请按以下步骤操作：
确保 Türkiye - Nilvera 模块已 安装 。
前往 ，向下滚动到 Türkiye Electronic Integrations 部分。
配置：
Nilvera API 凭证 （在 Nilvera 中生成）
收到的发票日记账 （即 采购）
要配置客户联系人记录以便能够通过 Nilvera 向其发送电子发票，请按以下步骤操作：
前往 。
移除 客户发票 筛选器（如有必要），然后选择要通过 Nilvera 联系的业务伙伴。
打开 会计 选项卡，然后点击 Nilvera Status 旁的 验证 。
通过 Nilvera 发送电子发票¶
电子发票/电子归档发票是一种经政府批准的数字化发票系统，用于取代传统的纸质发票，使企业能够以电子方式开具、传输和存储符合土耳其税务法规的发票。电子发票适用于已在 GİB 注册的客户，而电子归档发票可发送给未在 GİB 注册的客户，从而确保开票方即使与外国客户交易或采用 B2C 业务流程时也能遵守政府法规。
要发送电子发票/电子归档发票，请按以下步骤操作：
通过 Nilvera 接收电子发票¶
更新 Nilvera 状态¶
要更新 Odoo 中发票的 Nilvera Status，请按以下步骤操作：
打开 会计仪表板 。
点击 销售 日记账。
点击 （操作）图标，然后点击 Refresh e-Invoices Status 。此操作会更新每张发票上的 Nilvera Status 字段。
获取电子发票 PDF¶
获取电子发票 PDF 有两种方法：
从发票列表视图：
前往 。
选择一张或多张发票。
点击 Fetch Nilvera PDF
在发票表单视图中：当 Nilvera Status 为 Successful 时，点击 Fetch Nilvera PDF 按钮。
接收采购电子发票¶
要获取在 Nilvera 中生成并由贵公司接收的电子发票：
打开 会计仪表板 。
点击 采购 日记账。
点击 （操作）图标，然后点击 获取电子发票 。收到的电子发票将以 草稿 状态创建为供应商账单。
获取在 Odoo 中生成的账单 PDF¶
对于在 Odoo 中创建的供应商账单，PDF 的获取方式与客户发票相同：
前往 。
选择一张或多张供应商账单。
点击 Fetch Nilvera PDF 按钮。
生成电子分类账¶
电子分类账是一种电子系统，使企业能够以数字方式存储会计记录并向政府提交，以满足税务和监管合规要求。在 Odoo 中，用户可以将电子分类账生成为压缩的 CSV 文件，并通过 Nilvera 集成无缝申报公司记录。
前往 。
点击 （操作）图标。
点击 生成电子分类账 生成文件并将其下载到您的计算机。
管理电子发货单文件¶
生成电子发货单文件¶
电子发货单是一种取代传统纸质送货单的电子文档，使企业能够以数字方式开具、传输和跟踪在途货物的运输详情。在 Odoo 中，用户可以将电子发货单文档生成为 XML 并通过 Nilvera 集成上传，确保交货操作合规且可追溯。
前往 。
打开现有的交货单或创建新交货单。
选择 送货地址 后，在出现的 e-Dispatch 选项卡中填写必要信息。
交货单验证后，点击出现的 Send GİB e-Dispatch (XML) 按钮以发送 XML 文件。若只想生成文件而不发送，请点击 （操作） 图标，然后点击 Generate GIB e-Dispatch (XML) 。
下载附加到交货单的生成文件，并将其上传到 Nilvera 进行处理。
上传电子发货单文件¶
从 Nilvera 下载收到的电子发货单 XML。
前往 。
点击 Upload e-Receipt (XML) 按钮并选择下载的文件。
管理电子收据文件¶
可以使用 XML 文件从相应的 订单收货 更新库存移动。操作如下：
打开 库存 应用，然后前往 。
打开收货单，点击 e-Dispatch 选项卡，然后在 e-Dispatch XML 字段中选择与该订单收货对应的 XML。接着点击 Update from GIB e-Dispatch (XML) 以： - 根据 XML 文件中存储的库存移动更新您的库存。 - 使用 产品、承运商、送货单 等信息更新 操作 和 e-Dispatch 选项卡。 - 在聊天记录中记录相应的电子收据 PDF 文件。
注解
系统每 12 小时通过 CRON 自动获取 XML 收据。
强制性合规信息¶
以下规则对土耳其本地化集成的所有用户均为强制要求。遵守这些要求对于通过 Nilvera 经由 GİB 签发的电子文档的法律效力至关重要。
文档编号结构¶
所有生成的发票和发货单文档都必须遵循特定的编号结构：三个字母数字字符 + 文档年份 + 流水号 。
Example
INV/2025/00001
编号必须唯一、连续且不间断。每个文档都必须具有不同的标识符。
文件一经提交，即使返回错误，也不能再使用相同的序列号；必须创建一个新文档。
电子发货单编号结构¶
要访问电子发货单编号结构，请前往 ，然后选择与 交货单 类型匹配的操作。
可以设置任意字母数字的 序列前缀 。系统仅使用该前缀的最后三个字符。前缀必须至少包含三个字符；任何更短的前缀都会被系统自动拒绝。
Example
在序列 WH/OUT/948224 中，系统只会发送 224 。
小技巧
您可以前往 预览序列。序列配置完成后，顶部的横幅会显示预览：
流水号间隔¶
如果跳过了某个序列号，则必须在 7 天内补开之前缺失的编号。
Example
如果 INV/2025/00002 在 INV/2025/00001 之前开具，则 INV/2025/00001 必须在 7 天内开具。
任何序列号都不得在该期限之后仍未开具。
折扣规则¶
不能开具全局折扣（作为单独发票行显示的折扣）。所有折扣都必须在发票的产品行层级应用。
电子分类账合规¶
首张开具的发票必须代表该会计期间的期初余额。此后所有发票都必须遵循连续编号规则。
Example
INV/2025/00001, INV/2025/00002, INV/2025/00003, etc.
必须在整个电子分类账中持续保持连续编号，以确保数据完整性和合规性。
Nilvera 电子发票订阅¶
注解
土耳其电子发票法规定，每张发票在表头层级只能有一个日期范围，而不是每个单独行项目。因此，具有不同订阅日期范围的项目不能混在同一张发票上。不过，带有订阅日期范围的项目可以与完全没有日期范围的项目混在一起。
如果发票是从 订阅 应用中的订阅订单生成的，则在表头层级使用订阅订单的日期作为发票日期。
各行的订阅日期必须一致。
管理商业发票¶
商业发票场景在 会计 应用中管理：开出的发票通过 ，收到的供应商账单通过 。
开出的商业发票¶
在草稿（未过账）发票上，从 Invoice Scenario 字段中选择场景，并在 Is 字段中指定类型。根据所选内容，免税原因 字段可能变为可用。如适用，请输入免税原因。
商业场景发票一经确认并发送，其 Nilvera Status 会变为 Waiting 。随后客户必须在其端接受或拒绝该发票。
如果客户拒绝该发票，拒绝原因会记录在发票的聊天记录中。
注解
如果接收方在收到发票后的 8 天 内未接受或拒绝，GİB 会自动接受该发票。
已接受的发票会显示两种状态之一： - 已接受 ：由客户手动接受。 - 自动接受 ：根据 8 天规则由 GİB 自动确认。
收到的商业账单¶
系统会自动从 Nilvera 获取收到的商业账单，并在 Odoo 中创建相应的草稿账单。
获取的账单顶部会显示一个状态横幅，其中包含 接受 或 拒绝 选项：
接受：验证该账单。
拒绝：打开一个需要填写拒绝原因的弹出窗口。点击 继续 后，拒绝响应会发送至 Nilvera。 此操作无法撤销。