Kenya¶
Cấu hình¶
Cài đặt gói bản địa hóa thuế của 🇰🇪 Kenya để có tất cả các tính năng của bản địa hóa Kenya.
eTIMS¶
Cơ quan Thuế Kenya (KRA) <https://www.kra.go.ke/> đã triển khai Hệ thống Quản lý Hóa đơn Thuế điện tử (eTIMS) <https://www.kra.go.ke/online-services/etims> để thu thuế.
Để gửi tài liệu qua eTIMS, bạn phải sử dụng OSCU tích hợp với Hệ thống Lập hóa đơn Thương nhân (TIS) hiện có, chẳng hạn như hệ thống do Odoo cung cấp. OSCU được sử dụng để xác thực, mã hóa, ký, truyền và lưu trữ hóa đơn thuế.
Ghi chú
Đảm bảo cài đặt các mô-đun Kenya eTIMS EDI để sử dụng thiết bị OSCU đầy đủ.
Khởi tạo thiết bị OSCU¶
OSCU phải được khởi tạo trước khi sử dụng. Để thực hiện, chuyển đến , nhấp Cập nhật Thông tin trong phần Công ty, và nhập Mã số Thuế của bạn.
Để khởi tạo OSCU:
Chuyển đến và cuộn xuống phần Tích hợp Kenya eTIMS.
Đặt Chế độ Máy chủ eTIMS thành Thử nghiệm cho việc khởi tạo.
Nhập Số Sê-ri của thiết bị và đánh dấu vào hai ô kiểm.
Nhấp Khởi tạo OSCU.
Ghi chú
Ba chế độ máy chủ có sẵn:
Demo: Được thiết kế cho mục đích demo; sử dụng dữ liệu giả lập và không yêu cầu OSCU đã được khởi tạo;
Thử nghiệm: Được sử dụng để kiểm tra kết nối với eTIMS;
Sản xuất: Được sử dụng cho cơ sở dữ liệu thực tế sẵn sàng gửi dữ liệu.
Quan trọng
Nếu thiết bị của bạn đã được khởi tạo (qua một ERP khác chẳng hạn), hãy bật Chế độ lập trình viên (chế độ gỡ lỗi). Sau đó, trong phần Tích hợp Kenya eTIMS, nhập ID của đơn vị vào trường ID Đơn vị và khóa thu được qua quá trình khởi tạo trước đó vào trường Khóa CMC. Nhấp Lưu khi hoàn tất.
Sau khi phân hệ OSCU được khởi tạo, một số sê-ri OSCU sẽ được tạo cho mỗi công ty trên cơ sở dữ liệu đó có quốc gia đặt là Kenya. Số sê-ri được tạo dựa trên mã số thuế GTGT của công ty (bất kể mã đó có hợp lệ hay không). Đây là số sê-ri duy nhất và tuần tự, bắt đầu bằng tiền tố ODOO theo sau là mã số thuế GTGT của công ty và một chuỗi số.
Đăng ký trên eTIMS¶
Người nộp thuế phải đăng ký và tạo tài khoản trên cổng thông tin KRA <https://etims.kra.go.ke/basic/login/indexLogin>. Nếu bạn chưa có tài khoản:
Đăng ký, nhập PIN của bạn và xác minh rằng mọi thông tin đều chính xác, bao gồm số điện thoại, địa chỉ email và địa chỉ bưu điện. Sửa bất kỳ lỗi nào trên trang iTax <https://itax.kra.go.ke/KRA-Portal/>.
OTP được gửi đến số điện thoại đã cung cấp. Bỏ chặn tin nhắn quảng cáo nếu bạn không nhận được.
Tải lên ID chủ doanh nghiệp hoặc ID giám đốc (như được liệt kê trên iTax), cùng với biểu mẫu cam kết đã điền đầy đủ và ký.
Trên bảng điều khiển eTIMS, nhấp vào Service request ở đầu trang. Chọn OSCU làm loại eTIMS, nhập
Odoo KE LTDlàm bên tích hợp thứ ba và nhập số sê-ri OSCU của công ty bạn đã lấy trước đó.
Ghi chú
Yêu cầu dịch vụ thường được phê duyệt nhanh chóng. Nếu có sự chậm trễ, hãy liên hệ với bộ phận vận hành eTIMS hoặc văn phòng KRA.
Biểu mẫu cam kết
Phần 1: Điền thông tin của người nộp thuế.
Phần 2: Điền thông tin của chủ doanh nghiệp hoặc giám đốc.
Phần 3: Điền số sê-ri duy nhất của bạn có trong Odoo.
Phần 4: Đánh dấu OSCU, nhập PIN Odoo KE LTD
PO52112956Wvà nhập phiên bản Odoo bạn đang sử dụng (17.0 trở lên).Phần 5: Đánh dấu các ô bắt buộc, nhập ngày tháng và ký tên.
Mã eTIMS¶
Các mã tiêu chuẩn phổ biến được tự động lấy từ máy chủ API eTIMS của KRA hai ngày một lần. Để lấy thủ công, thực hiện như sau:
Đi đến và tìm kiếm KE eTIMS: Fetch KRA standard codes.
Nhấp vào hành động trong danh sách, sau đó nhấp vào Chạy thủ công để lấy mã.
Đi đến để xem danh sách đầy đủ các mã OSCU đã lấy.
Mã UNSPSC¶
KRA cần mã UNSPSC để sản phẩm được đăng ký. Mã UNSPSC được tự động lấy từ máy chủ API eTIMS của KRA mỗi ngày. Để lấy thủ công, thực hiện như sau:
Đi đến và tìm kiếm KE eTIMS: Fetch UNSPSC codes from eTIMS.
Nhấp vào hành động trong danh sách, sau đó nhấp vào Chạy thủ công để lấy mã.
Đi đến biểu mẫu sản phẩm, và trong tab Kế toán, nhấp vào trường Danh mục UNSPSC để xem danh sách đầy đủ các mã UNSPSC đã lấy.
Thông báo¶
Thông báo được tự động lấy từ máy chủ API eTIMS của KRA mỗi ngày. Để lấy thủ công, thực hiện như sau:
Đi đến và tìm kiếm KE eTIMS: Fetch KRA notices from eTIMS.
Nhấp vào hành động trong danh sách, sau đó nhấp Chạy Thủ công để lấy thông báo.
Truy cập để xem danh sách đầy đủ các thông báo đã lấy.
Đa công ty¶
Xem thêm
Nếu bạn có nhiều công ty, bạn có thể tập trung và quản lý tất cả chúng trên một cơ sở dữ liệu Odoo duy nhất. KRA xác định và phân biệt công ty mẹ với các công ty con bằng cách sử dụng ID. Hơn nữa, các công ty con được phân loại là chi nhánh của công ty mẹ.
Để cấu hình ID của công ty, mở ứng dụng Cài đặt, nhấp Cập nhật Thông tin trong phần Công ty, và tìm kiếm trường Mã Chi nhánh eTIMS. Công ty mẹ có ID chi nhánh bằng 00 trong môi trường đa công ty. Các công ty không phải là công ty mẹ có ID chi nhánh khác 00 và được KRA chỉ định một ID.
Để lấy ID chi nhánh từ KRA cho các công ty không phải công ty mẹ của bạn, hãy đảm bảo công ty mẹ có Mã số Thuế Kenya và thiết bị OSCU đã được khởi tạo. Sau đó, truy cập tab Chi nhánh và nhấp Điền từ KRA.
Ghi chú
KRA coi mỗi nơi cung cấp là một chi nhánh riêng biệt (ID).
Thiết bị OSCU phải được khởi tạo độc lập cho từng chi nhánh.
ID chi nhánh liên hệ¶
Để gán ID chi nhánh cho một liên hệ, truy cập biểu mẫu liên hệ, vào tab Kế toán, và nhập mã chi nhánh vào trường Mã Chi nhánh eTIMS.
Ghi chú
Theo mặc định, ID chi nhánh của liên hệ được đặt là OO.
Số thứ tự KRA¶
Quan trọng
Số thứ tự hóa đơn Odoo và số thứ tự KRA là khác nhau.
Trong Odoo, số thứ tự hóa đơn phụ thuộc vào công ty mẹ. Công ty mẹ có thể xem hóa đơn của các chi nhánh, nhưng các chi nhánh không thể xem hóa đơn của công ty mẹ hoặc của các chi nhánh khác.
KRA cần số thứ tự độc lập cho mỗi chi nhánh. Do đó, Odoo quản lý số thứ tự riêng lẻ cho từng chi nhánh.
Example
Nếu bạn có một công ty mẹ với hai chi nhánh, số thứ tự hóa đơn sẽ như sau:
Creating an invoice on branch 1: INV/2024/00001;
Creating an invoice on branch 2: INV/2024/00002;
Tạo hóa đơn trên công ty mẹ: INV/2024/00003.
Đây là cách Odoo quản lý số thứ tự để tuân thủ các quy định của KRA:
Creating an invoice on branch 1: INV/2024/00001;
Creating an invoice on branch 2: INV/2024/00001;
Tạo hóa đơn trên công ty mẹ: INV/2024/00001.
Bảo hiểm¶
Đối với nhà cung cấp dịch vụ y tế, bạn có thể gửi thông tin bảo hiểm về công ty mẹ và chi nhánh và cập nhật nó trong eTIMS. Để làm điều này, truy cập , cuộn xuống phần Tích hợp Kenya eTIMS, và điền vào các trường Mã, Tên, và Tỷ lệ. Nhấp Gửi Chi tiết Bảo hiểm khi hoàn tất.
Đăng ký sản phẩm¶
KRA yêu cầu sản phẩm phải được đăng ký trước khi tiến hành các hoạt động kinh doanh (chẳng hạn như di chuyển kho, BOM, hóa đơn khách hàng, v.v.). Để đăng ký sản phẩm, các trường sau phải được xác định trên biểu mẫu sản phẩm:
In the General Information tab: Cost.
Trong tab Kế toán:
Packaging Unit;
Packaging Quantity;
Origin Country;
eTIMS Product Type;
Insurance Applicable;
Nếu các yếu tố trên được xác định, sản phẩm sẽ tự động được đăng ký khi gửi thao tác đến KRA. Nếu không, bạn sẽ được thông báo bằng biểu ngữ màu vàng ở đầu màn hình mời bạn kiểm tra các yếu tố còn thiếu.
Di chuyển kho¶
Tất cả di chuyển kho phải được gửi đến KRA. Chúng không yêu cầu hóa đơn nếu là hoạt động nội bộ hoặc điều chỉnh kho; do đó, Odoo tự động gửi chúng nếu đáp ứng ít nhất một trong các điều kiện sau:
Không có liên hệ nào được đặt cho lần di chuyển;
Liên hệ là công ty mẹ của bạn hoặc chi nhánh của công ty mẹ.
Nếu di chuyển kho là hoạt động bên ngoài (ví dụ: đến các liên hệ không thuộc công ty mẹ hoặc chi nhánh của công ty đó), di chuyển kho sẽ tự động được gửi sau khi hóa đơn được gửi đến eTIMS.
Ghi chú
Di chuyển kho phải được xác nhận trước khi gửi hóa đơn đến eTIMS.
(Các) sản phẩm phải được đăng ký để di chuyển kho được gửi đến eTIMS. Nếu sản phẩm chưa được đăng ký, biểu ngữ màu vàng sẽ nhắc đăng ký sản phẩm.
Mua hàng¶
Odoo tự động lấy hóa đơn nhà cung cấp mới từ eTIMS mỗi ngày. Bạn cần xác nhận các hóa đơn nhà cung cấp đã lấy và gửi xác nhận đến KRA. Để xác nhận hóa đơn nhà cung cấp, nó phải được liên kết với một hoặc nhiều dòng đơn đặt hàng mua đã xác nhận.
Trong trường hợp mua hàng (không phải nhập khẩu hải quan), các bước để liên kết dòng đơn đặt hàng mua với hóa đơn như sau:
Vào . Hóa đơn nhà cung cấp được lấy từ máy chủ KRA. Tệp JSON có sẵn trong chatter của hóa đơn nhà cung cấp nếu cần.
Odoo xem xét Mã số thuế (PIN) của nhà cung cấp (đối tác);
Nếu không xác định được, một liên hệ (đối tác) mới sẽ được tạo.
Nếu đã biết và mã chi nhánh giống nhau, Odoo sử dụng liên hệ đã biết.
Trong hóa đơn đã lấy từ KRA, chọn Sản phẩm. Mỗi hóa đơn nhà cung cấp phải có sản phẩm để được xác nhận và gửi đến eTIMS sau này.
Odoo kiểm tra các dòng đơn mua hàng hiện có khớp với (những) sản phẩm đã nhập ở bước trước và đối tác (nếu có). Nhấp vào trường Dòng đơn mua hàng và chọn (các) dòng đơn mua hàng liên quan chính xác khớp với sản phẩm. Số lượng trên hóa đơn phải giống với số lượng đã nhận được ghi trên đơn mua hàng.
Nếu không có dòng đơn đặt hàng mua nào phù hợp với các dòng của hóa đơn đã lấy, nhấp Tạo đơn đặt hàng mua và tạo đơn đặt hàng mua dựa trên (các) dòng chưa khớp. Xác thực di chuyển kho kết quả và Xác nhận hóa đơn.
Set a method in the eTIMS Payment Method field..
Sau khi hoàn thành tất cả các bước, nhấp Gửi đến eTIMS để gửi hóa đơn nhà cung cấp. Khi hóa đơn nhà cung cấp đã được xác nhận trên eTIMS, số hóa đơn KRA có thể được tìm thấy trong tab Chi tiết eTIMS.
Xuất hóa đơn¶
Ghi chú
KRA không chấp nhận bán hàng nếu sản phẩm không có trong kho.
Đây là quy trình bán hàng được khuyến nghị trong Odoo khi bán hàng:
Tạo một đơn bán hàng
Xác thực giao hàng.
Xác nhận hóa đơn.
Click Send and print, and then enable Send to eTIMS.
Click Send & print to send the invoice.
Sau khi hóa đơn được gửi và ký bởi KRA, các thông tin sau có thể được tìm thấy trên đó:
số hoá đơn KRA;
Mandatory KRA invoice fields, such as SCU information, date, SCU ID, receipt number, item count, internal date, and receipt signature;
The KRA tax table;
Mã QR KRA duy nhất cho hóa đơn đã ký.
Nhập¶
Mã nhập khẩu hải quan được lấy tự động từ máy chủ API eTIMS của KRA mỗi ngày. Để lấy thủ công, thực hiện như sau:
Vào và tìm kiếm KE eTIMS: Receive Customs Imports from the OSCU.
Nhấp vào hành động trong danh sách, sau đó nhấp vào Chạy thủ công để lấy mã.
Vào để xem các mã đã nhập.
Các bước sau là bắt buộc để gửi và có nhập khẩu hải quan được ký bởi KRA:
Vào ; Nhập khẩu hải quan được lấy tự động từ KRA.
Khớp mục đã nhập với một sản phẩm đã đăng ký hiện có trong trường Sản phẩm (hoặc tạo sản phẩm nếu không có sản phẩm liên quan nào tồn tại).
Đặt nhà cung cấp trong trường Đối tác.
Dựa trên đối tác, khớp mục đã nhập với đơn đặt hàng liên quan của nó (xem các bước mua hàng). Kho phải được điều chỉnh chính xác khi nhập khẩu hải quan được phê duyệt.
Nếu không có đơn đặt hàng liên quan nào tồn tại, hãy tạo một đơn và Xác nhận nó. Sau đó, xác nhận giao hàng bằng cách nhấp vào Nhận sản phẩm, rồi Xác thực trên đơn đặt hàng.
Nhấp vào Khớp và Phê duyệt hoặc Khớp và Từ chối, tùy thuộc vào tình trạng của hàng hóa.
Ghi chú
Tệp JSON nhận được từ KRA được đính kèm vào chatter của nhập khẩu hải quan.
ĐMNL¶
KRA yêu cầu tất cả các BOM phải được gửi cho họ. Để gửi BOM đến eTIMS, sản phẩm và các thành phần của nó phải được đăng ký. Để truy cập BOM của sản phẩm, nhấp vào sản phẩm và sau đó nhấp vào nút thông minh Danh mục vật tư.
Đảm bảo các trường bắt buộc của KRA được điền trong phần Chi tiết eTIMS của KRA của thẻ Kế toán trong biểu mẫu sản phẩm, và nhấp vào Gửi đến eTIMS. Việc gửi BOM thành công được xác nhận trong chatter, nơi bạn cũng có thể tìm thấy thông tin đã gửi trong tệp JSON đính kèm.
Giấy báo có¶
KRA không chấp nhận ghi giấy báo có có số lượng hoặc giá cao hơn hóa đơn ban đầu. Khi tạo giấy báo có, phải chỉ ra lý do KRA: Trong biểu mẫu giấy báo có, hãy chuyển đến tab Chi tiết eTIMS, chọn Lý do giấy báo có eTIMS, sau đó chọn số hóa đơn trong trường Đảo ngược của.