肯亚¶

配置¶

以下模块会随肯尼亚本地化自动安装：

名称	技术名称	说明
肯尼亚 - 会计	`l10n_ke`	用于管理肯尼亚会计科目表和本地化的基础模块
肯尼亚 - 会计报表	`l10n_ke_reports`	肯尼亚本地化专用的会计报表
肯尼亚 eTIMS EDI 集成	`l10n_ke_edi_oscu`	基础电子税务发票管理系统（eTIMS）集成
肯尼亚 ETIMS EDI 制造集成	`l10n_ke_edi_oscu_mrp`	制造业专用的电子税务发票管理系统（eTIMS）集成

以下模块是可选的。建议仅当满足业务的特定需求时才安装它们。

名称	技术名称	说明
肯尼亚 - 销售点	`l10n_ke_edi_oscu_pos`	销售点专用的电子税务发票管理系统（eTIMS）集成
肯尼亚 Tremol 设备 EDI 集成	`l10n_ke_edi_tremol`	G03 Tremol 控制单元集成，通过税务发票管理系统（TIMS）向肯尼亚税务局（KRA）申报税款

eTIMS¶

肯尼亚税务局（KRA）已经实施了电子税务发票管理系统（eTIMS）来征税。

要通过 eTIMS 提交文件，您必须使用与现有的 交易发票系统（TIS） 整合的 OSCU （在线销售控制单元），例如 Odoo 提供的系统。OSCU 用于验证、加密、签署、传输和存储税务发票。

注解

请确保安装 肯尼亚 eTIMS EDI 模块以完全使用 OSCU 设备。

OSCU 设备初始化¶

使用前必须初始化 OSCU。要执行此操作，请进入设置‣常规设置，在公司部分点击更新信息，然后输入您的税号。

要初始化 OSCU：

转到设置 ‣ 一般设置并向下滚动到肯尼亚 eTIMS 整合部分。
将初始化时的 eTIMS 服务器模式设置为测试。
输入设备的序列号，并勾选两个复选框。
点击初始化 OSCU 。

注解

有三种服务器模式可用：

演示: 用于演示目的；使用模拟数据，不需要初始化 OSCU；
测试: 用于测试与 eTIMS 的连接；
正式运行: 用于准备发送数据的实时数据库。

重要

如果您的设备 已经初始化 （例如通过另一个 ERP），请启用开发者模式（调试模式）。然后，在肯尼亚 eTIMS 整合部分，在单位 ID 字段中输入设备 ID，并在 CMC 密钥字段中输入通过之前初始化获得的密钥。完成后点击保存。

一旦 OSCU 模块 被初始化，就会为数据库中的每家公司生成一个 OSCU 序列号，并将其 国家/地区 设置为肯尼亚。序列号根据公司的增值税号生成（无论其是否有效）。这是一个唯一顺序序列号，以 ODOO 前缀开头，然后是公司的 增值税号 和一串数字。

在 eTIMS 上注册¶

纳税人必须在 KRA 门户网站注册并创建账户。如果您还没有账户：

注册，并输入您的 PIN 并验证所有信息是否正确，包括您的电话号码、电子邮件地址和邮政地址。在 iTax 页面更正任何错误。
系统会向您提供的电话号码发送 OTP（一次性密码）。如果没有收到，请取消屏蔽促销信息。
上传 企业主 ID 或 董事 ID （如 iTax 上所列），以及已填写并签名的 承诺书 。
在 eTIMS 仪表板 上，点击页面顶部的服务请求。选择 OSCU 作为 eTIMS类型 ，输入 Odoo KE LTD 作为第三方整合商，并输入您公司之前检索到的 OSCU 序列号。

注解

服务申请审批通常很快。如果出现延误，请联系 eTIMS 运行部门或 KRA 办公室。

承诺书

第 1 部分：填写纳税人的信息。
第 2 部分：填写企业所有者或董事的信息。
第 3 部分：填写您在 Odoo 中找到的唯一序列号。
第 4 部分：勾选 OSCU，输入 Odoo KE LTD 的 PIN PO52112956W，并输入您正在使用的 Odoo 版本（17.0 或更高版本）。
第 5 部分：勾选必填项，输入日期并签名。

eTIMS 代码¶

通用标准代码每两天从 KRA eTIMS API 服务器自动获取。如需手动获取，请按以下步骤操作：

启用开发者模式（调试模式）。
前往设置 ‣ 技术 ‣ 自动化：计划操作，并搜索 KE eTIMS: Fetch KRA standard codes。
点击列表中的操作，然后点击手动运行以获取代码。

前往会计 ‣ 配置 ‣ KE OSCU 代码，查看已获取的 OSCU 代码完整列表。

UNSPSC 代码¶

产品要完成注册，KRA 需要其 UNSPSC 代码。UNSPSC 代码每天会自动从 KRA eTIMS API 服务器拉取。如需手动拉取，请按以下步骤操作：

启用开发者模式（调试模式）。
前往设置 ‣ 技术 ‣ 自动化：计划操作，搜索 KE eTIMS: Fetch UNSPSC codes from eTIMS。
点击列表中的操作，然后点击手动运行以获取代码。

前往 产品表单，在会计选项卡中，点击 UNSPSC 类别字段查看已拉取的全部 UNSPSC 代码。

Notices¶

通知每天会自动从 KRA eTIMS API 服务器拉取。如需手动拉取，请按以下步骤操作：

启用开发者模式（调试模式）。
前往设置 ‣ 技术 ‣ 自动化：计划操作，搜索 KE eTIMS: Fetch KRA notices from eTIMS。
在列表中点击该操作，然后点击手动运行以拉取通知。

前往会计 ‣ 配置 ‣ KE OSCU 通知查看已拉取的完整通知列表。

多公司¶

联系分支 ID¶

要为联系人指定分支机构 ID，请访问联系人表单，转到会计选项卡，并在 eTIMS 分支机构代码字段中输入分支机构代码。

注解

默认情况下，联系人的分支 ID 设置为 OO 。

KRA 序列¶

重要

Odoo 发票序列和 KRA 序列不同。

在 Odoo 中，发票序号依赖于 母公司。母公司可以查看分支机构的发票，但分支机构无法查看母公司的发票或其他分支机构的发票。

KRA 需要每个分支独立的序列。因此，Odoo 会单独管理每个分支的序列。

示例

如果您有一家母公司和两个分支机构，发票序号将如下所示：

在 分支 1 上创建发票：INV/2024/00001；
在 支行 2 上创建发票：INV/2024/00002；
在 母公司 下创建发票：INV/2024/00003。

这就是 Odoo 如何管理序列以符合 KRA 规定：

在 分支 1 上创建发票：INV/2024/00001；
在 分支2 创建发票：INV/2024/00001；
在 母公司 下创建发票：INV/2024/00001。

集成令牌¶

要获取 eTIMS 的集成令牌，请向以下电子邮箱地址发送申请：etims@mail.odoo.com。

保险¶

对于 医疗服务提供者，您可以发送母公司和分支机构的保险信息并在 eTIMS 中更新。为此，前往会计 ‣ 配置 ‣ 设置，滚动到肯尼亚 eTIMS 集成区块，填写代码、名称和费率字段。完成后点击发送保险信息。

产品注册¶

KRA 要求在开展业务操作（如库存移动、BOM、客户发票等）之前先 注册产品。要注册产品，必须在产品表单上定义以下字段：

在常规信息选项卡中：
- 成本
- 销项税
在会计选项卡中：
- 包装单位
- 包装数量
- 原产国
- eTIMS 产品类型
- 适用保险
- UNSPSC 类别。

如果定义了上述要素，产品将在向 KRA 发送操作时自动注册。如果没有，屏幕顶部会有黄色横幅提醒您检查缺少的元素。

库存移动¶

所有 库存变动 必须发送至 KRA。如果是内部操作或库存调整，则不需要发票；因此，如果满足以下至少一个条件，Odoo 会自动发送发票：

该移动未设置联系人；
联系人是您的母公司或母公司的分支机构。

如果库存移动属于 外部作业 （例如发给不属于母公司及其分支机构的联系人），则库存移动将在发票发送至 eTIMS 之后自动发送。

注解

在向 eTIMS 系统发送发票之前，必须确认库存移动。
产品必须已注册才能将库存移动发送到 eTIMS。如果产品尚未注册，黄色横幅将提示产品注册。

采购管理¶

Odoo 每天自动从 eTIMS 获取新的供应商账单。您需要确认获取的供应商账单，并将确认信息发送给 KRA。要确认供应商账单，该账单必须与一个或多个已确认的采购订单项目相关联。

在采购（非海关进口）的情况下，将采购订单项目与账单联系起来的步骤如下：

进入会计 ‣ 供应商 ‣ 订单。从 KRA 服务器获取供应商账单。如有需要，可在供应商账单的聊天记录中查看 JSON 文件。
Odoo 会查看供应商（合作伙伴）的税号 (PIN)；
- 如果未知，则将创建新的联系人（合作伙伴）。
- 如果已知联系人和分支 ID 相同，Odoo 将使用已知联系人。
在从 KRA 获取的账单中，选择产品。每个供应商账单必须包含一个产品，以便稍后确认并发送到 eTIMS。
Odoo 会检查与上一步输入的产品和合作伙伴（如有）相匹配的现有订购单项目。点击采购订单行字段，选择与产品相匹配的相关采购订单。账单上的数量必须与采购订单上显示的收货数量相同。

如果没有现有采购订单行与获取的账单行匹配，请点击创建采购订单并根据未匹配的行创建采购订单。验证生成的库存移动和确认账单。
在 eTIMS 付款方式字段中设置一种方法。
完成所有步骤后，点击发送至 eTIMS 发送供应商账单。供应商账单在 eTIMS 上确认后，可在 eTIMS 详情选项卡中找到 KRA 发票编号 。

发票¶

注解

如果产品没有库存，KRA 不接受销售。

这是 Odoo 中 建议的销售流程 ：

创建 销售订单 。
验证发货。
确认发票。
点击发送，然后启用发送到 eTIMS。
点击发送以发送发票。

发票寄出并经 KRA 签名后，可在发票上找到以下信息：

KRA 发票号码；
必须填写的 KRA 发票字段，如 SCU 信息、日期、SCU ID、收据编号、项目计数、内部日期 和 收据签名；
The KRA 税表;
签名发票的唯一 KRA QR 码 。

导入¶

海关进口代码每天自动从 KRA eTIMS API 服务器获取。要手动获取，请按以下步骤操作：

启用开发者模式（调试模式）。
转到设置 ‣ 技术 ‣ 自动化：计划行动并搜索 KE eTIMS：从 OSCU 接收海关进口信息。
点击列表中的操作，然后点击手动运行以获取代码。

进入会计 ‣ 供应商 ‣ 海关进口查看进口代码。

发送 海关进口 并由 KRA 签收需要以下步骤：

转到会计 ‣ 供应商 ‣ 海关进口; 从 KRA 自动获取海关进口信息。
将导入项目与产品字段中现有的注册产品相匹配（如果不存在相关产品，则创建一个产品）。
在合作伙伴字段中设置供应商。
根据合作伙伴，将进口项目与其相关采购订单进行匹配（请参阅采购步骤）。海关进口批准后，必须正确调整库存。

如果没有相关采购订单，请创建一个并确认。然后，点击采购订单上的接收产品，再点击验证，确认交货。
根据货物情况，点击匹配并批准或匹配和拒绝。

注解

从 KRA 收到的 JSON 文件附在海关进口的沟通栏中。

物料清单（BOM）¶

KRA 要求将所有 BOM 发送给他们。要向 eTIMS 发送物料清单，产品及其组件必须已注册。要访问产品的物料清单，请点击产品，然后点击物料清单智能按钮。

确保在产品表单的会计标签的 KRA eTIMS details 部分填写了 KRA 必填字段，然后点击发送至 eTIMS 。BOM 的成功发送将在聊天中确认，您还可以在附加的 JSON 文件中找到已发送的信息。

红冲发票¶

KRA 不接受数量或价格高于初始发票的贷项凭证。创建贷项凭证时，必须注明原因：在贷项凭证表单中，转到 eTIMS 详情标签页，选择 eTIMS 贷项凭证原因，然后在冲销字段中选择发票号码。