肯尼亚¶

配置¶

安装 🇰🇪 肯尼亚 财务本地化包以获取肯尼亚本地化的所有功能。

eTIMS¶

肯尼亚税务局 (KRA) 已实施电子税务发票管理系统 (eTIMS) 用于税收征管。

要通过 eTIMS 提交文件，您必须使用与现有 Trader Invoicing System (TIS) 集成的 OSCU，例如 Odoo 提供的 OSCU。OSCU 用于验证、加密、签名、传输和存储税务发票。

注解

请确保安装 肯尼亚 eTIMS EDI 模块以充分利用 OSCU 设备。

OSCU 设备初始化¶

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

初始化 OSCU：

转到设置 ‣ 通用设置并向下滚动到肯尼亚 eTIMS 集成部分。
将 eTIMS 服务器模式设置为测试以进行初始化。
输入设备的序列号并勾选两个复选框。
点击初始化 OSCU。

注解

有三种服务器模式可用：

Demo: 专为演示目的设计；它使用模拟数据，不需要初始化 OSCU；
Test: 用于测试与 eTIMS 的连接；
生产: 用于已准备好发送数据的实时数据库。

重要

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

一旦 OSCU 模块 被初始化，系统会为数据库中每个国家设置为肯尼亚的公司生成一个 OSCU 序列号。该序列号是基于公司的增值税号生成的（无论其是否有效）。它是一个唯一的、顺序的序列号，以 ODOO 为前缀，后跟公司的 增值税号 和一串数字。

在 eTIMS 上注册¶

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

注册，输入您的 PIN，并确认所有信息正确无误，包括您的电话号码、电子邮件地址和邮政地址。在 iTax 页面上更正任何错误。
一条 OTP 已发送至提供的手机号码。如果您未收到，请解除促销信息的屏蔽。
上传 企业主身份证 或 董事身份证**（如iTax上所列），以及填写并签署的 **承诺书 。
在 eTIMS 仪表板 上，点击页面顶部的服务请求。选择 OSCU 作为 eTIMS 类型，输入 Odoo KE LTD 作为第三方集成商，并输入您公司之前获取的 OSCU 序列号。

注解

服务请求的审批通常很快。如果出现延迟，请联系 eTIMS 运营部门或 KRA 办公室。

承诺书

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

eTIMS 代码¶

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

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

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

UNSPSC 代码¶

KRA 需要 UNSPSC 代码来注册产品。UNSPSC 代码每天自动从 KRA eTIMS API 服务器获取。要手动获取它们，请按以下步骤操作：

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

转到 产品表单，在会计选项卡中，点击 UNSPSC 类别字段以查看获取的 UNSPSC 代码的完整列表。

通知¶

通知每天都会自动从 KRA eTIMS API 服务器获取。要手动获取它们，请按照以下步骤操作：

启用开发者模式（调试模式）。
转到设置 ‣ 技术 ‣ 自动化：计划动作并搜索 KE eTIMS：从 eTIMS 获取 KRA 通知。
点击列表中的操作，然后点击手动运行以获取通知。

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

多公司¶

另请参阅

公司

如果您有多个公司，您可以在一个 Odoo 数据库中集中管理它们。KRA 通过使用 ID 来识别和区分主公司及其 子公司。此外，子公司被分类为主公司的 分支机构。

要配置公司的 ID，请打开设置应用，在公司部分点击更新信息，并搜索 eTIMS 分支机构代码字段。在多公司环境中，主公司 的分支机构 ID 等于 00。非主公司的分支机构 ID 不为 00，并由 KRA 分配一个 ID。

要添加分支机构，请转到 公司设置 中的分支机构标签页，然后点击添加一行。

要从 KRA 获取非主公司的 分支 ID，请确保主公司拥有肯尼亚的税号，并且 OSCU 设备已初始化。然后，转到分支选项卡并点击从 KRA 填充。

注解

KRA 将每个 供应地 视为一个独立的分支机构（ID）。
OSCU 设备必须为每个分支独立初始化。

联系分支 ID¶

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

注解

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

KRA sequences¶

重要

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

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

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

Example

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

在 branch 1 上创建发票：INV/2024/00001;
在 branch 2 上创建发票：INV/2024/00002；
在 主公司 上创建发票：INV/2024/00003。

这是 Odoo 如何管理序列以符合 KRA 法规的方式：

在 branch 1 上创建发票：INV/2024/00001;
在 branch 2 上创建发票：INV/2024/00001；
在 主公司 上创建发票：INV/2024/00001。

保险¶

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

产品注册¶

KRA 要求 产品必须先注册，然后才能进行业务操作（如库存移动、BOM（物料清单）、客户发票等）。要注册产品，必须在产品表单上定义以下字段：

在常规信息选项卡中：成本。
在会计选项卡中：
- 包装单位;
- 包装数量;
- Origin Country;
- eTIMS Product Type;
- 保险适用;
- 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 中 建议的销售流程：

创建一个 销售订单。
验证交货。
确认 the invoice.
点击发送并打印，然后启用发送到 eTIMS。
点击 Send & print 发送发票。

发票发送并由 KRA 签署后，可以在其上找到以下信息：

KRA 发票编号；
强制性 KRA 发票字段，例如 SCU 信息、日期、SCU ID、收据编号、商品数量、内部日期 和 收据签名；
KRA 税务表；
一个唯一的 KRA 二维码 用于已签名的发票。

导入¶

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

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

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

以下步骤是发送并让 海关进口 由 KRA 签署所必需的：

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

如果没有相关的采购订单存在，请创建一个并点击确认。然后，通过点击接收产品来确认交货，接着在采购订单上点击验证。
点击匹配并批准或匹配并拒绝，具体取决于货物的状况。

注解

从 KRA 收到的 JSON 文件已附加到海关导入的 chatter 中。

BOM¶

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

确保在产品的会计选项卡中的 KRA eTIMS 详情部分填写了 KRA 的必填字段，然后点击发送至 eTIMS。BOM 成功发送的确认信息会在 chatter 中显示，您还可以在附带的 JSON 文件中找到已发送的信息。

贷记单¶

KRA 不接受数量或价格高于原始发票的贷项通知单。创建贷项通知单时，必须指明 KRA 原因：在贷项通知单表单中，转到 eTIMS 详情选项卡，选择 eTIMS 贷项通知单原因，然后在冲销字段中选择发票编号。

Edit on GitHub