Kenia

Konfiguracja

The following modules are installed automatically with the Kenyan localization:

Nazwa	Nazwa techniczna	Opis
Kenya - Accounting	l10n_ke	The base module to manage the chart of accounts and localization for Kenya
Kenya - Accounting Report	l10n_ke_reports	Accounting reports specific to the Kenyan localization
Kenya eTIMS EDI Integration	l10n_ke_edi_oscu	Base electronic Tax Invoice Management System (eTIMS) integration
Kenya ETIMS EDI Manufacturing Integration	l10n_ke_edi_oscu_mrp	Manufacturing-specific electronic Tax Invoice Management System (eTIMS) integration

Następujące moduły są opcjonalne. Zaleca się zainstalować je tylko wtedy, gdy spełniają konkretne wymagania biznesowe.

Nazwa	Nazwa techniczna	Opis
Kenya - Point of Sale	l10n_ke_edi_oscu_pos	Point of Sale-specific electronic Tax Invoice Management System (eTIMS) integration
Kenya Tremol Device EDI Integration	l10n_ke_edi_tremol	G03 Tremol control unit integration to report taxes to the Kenya Revenue Authority (KRA) through the Tax Invoice Management System (TIMS)

Zobacz także

Kenyan Payroll localization documentation

eTIMS

Kenijski Urząd Podatkowy (KRA) wdrożył elektroniczny system zarządzania fakturami podatkowymi (eTIMS) do poboru podatków.

Aby przesyłać dokumenty przez eTIMS, musisz użyć OSCU, która integruje się z istniejącym systemem fakturowania dla handlowców (TIS), takim jak ten dostarczony przez Odoo. OSCU służy do walidacji, szyfrowania, podpisywania, przesyłania i przechowywania faktur podatkowych.

Informacja

Upewnij się, że zainstalujesz moduły Kenya eTIMS EDI, aby w pełni korzystać z urządzenia OSCU.

Inicjalizacja urządzenia OSCU

OSCU musi być zainicjalizowane przed użyciem. W tym celu przejdź do Ustawienia ‣ Ustawienia ogólne, kliknij Aktualizuj informacje w sekcji Firmy i wprowadź swój NIP.

Aby zainicjalizować OSCU:

1. Przejdź do Ustawienia ‣ Ustawienia ogólne i przewiń w dół do sekcji Integracja z Kenya eTIMS.

2. Ustaw Tryb serwera eTIMS na Test w celu inicjalizacji.

3. Wprowadź Numer seryjny urządzenia i zaznacz dwa pola wyboru.

4. Kliknij Zainicjalizuj OSCU.

Informacja

Dostępne są trzy tryby serwera:

• Demo: Przeznaczony do celów demonstracyjnych; używa przykładowych danych i nie wymaga zainicjalizowanego OSCU;

• Test: Używany do testowania połączenia z eTIMS;

• Produkcja: Używany dla aktywnych baz danych gotowych do wysyłania danych.

Ważne

Jeśli Twoje urządzenie zostało już zainicjalizowane (np. przez inny system ERP), włącz Tryb dewelopera (tryb debugowania). Następnie w sekcji Integracja z Kenya eTIMS wprowadź ID jednostki w polu ID jednostki oraz klucz uzyskany podczas wcześniejszej inicjalizacji w polu Klucz CMC. Po zakończeniu kliknij Zapisz.

Po zainicjalizowaniu modułu OSCU dla każdej firmy w tej bazie danych z krajem ustawionym na Kenia generowany jest numer seryjny OSCU. Numer seryjny jest generowany na podstawie numeru VAT firmy (niezależnie od jego poprawności). Jest to unikalny i sekwencyjny numer seryjny rozpoczynający się od prefiksu ODOO, po którym następuje numer VAT firmy i sekwencja cyfr.

Rejestracja w eTIMS

Podatnicy muszą zarejestrować się i utworzyć konto w portalu KRA. Jeśli nie masz jeszcze konta:

1. Zarejestruj się, wprowadź swój PIN i sprawdź, czy wszystkie informacje są poprawne, w tym numer telefonu, adres e-mail i adres pocztowy. Popraw wszelkie błędy na stronie iTax.

2. OTP zostanie wysłane na podany numer telefonu. Odblokuj wiadomości promocyjne, jeśli go nie otrzymasz.

3. Prześlij dowód tożsamości właściciela firmy lub dowód tożsamości dyrektora (zgodnie z wykazem w iTax), wraz z wypełnionym i podpisanym formularzem zobowiązania.

4. Na konsoli eTIMS kliknij Wniosek o usługę u góry strony. Wybierz OSCU jako typ eTIMS, wprowadź Odoo KE LTD jako integratora zewnętrznego i wprowadź numer seryjny OSCU swojej firmy pobrany wcześniej.

Informacja

Zatwierdzenia wniosków o usługę zazwyczaj przebiegają szybko. W przypadku opóźnienia skontaktuj się z działem operacyjnym eTIMS lub biurem KRA.

Formularz zobowiązania

• Część 1: Wypełnij informacje o podatniku.

• Część 2: Wypełnij informacje o właścicielu firmy lub dyrektorze.

• Część 3: Wpisz swój unikalny numer seryjny znajdujący się w Odoo.

• Część 4: Zaznacz OSCU, wpisz PIN Odoo KE LTD PO52112956W i wpisz używaną wersję Odoo (17.0 lub nowszą).

• Część 5: Zaznacz obowiązkowe pola, wpisz datę i podpisz.

Kody eTIMS

Typowe kody standardowe są automatycznie pobierane z serwerów API KRA eTIMS co dwa dni. Aby pobrać je ręcznie, wykonaj następujące kroki:

1. Włącz Tryb dewelopera (tryb debugowania).

2. Przejdź do Ustawienia ‣ Techniczne ‣ Automatyzacja: Zaplanowane akcje i wyszukaj KE eTIMS: Fetch KRA standard codes.

3. Kliknij akcję na liście, a następnie kliknij Uruchom ręcznie, aby pobrać kody.

Przejdź do Księgowość ‣ Konfiguracja ‣ KE OSCU Codes, aby wyświetlić pełną listę pobranych kodów OSCU.

Kody UNSPSC

KRA wymaga kodów UNSPSC, aby produkt mógł zostać zarejestrowany. Kody UNSPSC są automatycznie pobierane z serwerów API KRA eTIMS codziennie. Aby pobrać je ręcznie, wykonaj następujące kroki:

1. Włącz Tryb dewelopera (tryb debugowania).

2. Przejdź do Ustawienia ‣ Techniczne ‣ Automatyzacja: Zaplanowane akcje i wyszukaj KE eTIMS: Fetch UNSPSC codes from eTIMS.

3. Kliknij akcję na liście, a następnie kliknij Uruchom ręcznie, aby pobrać kody.

Przejdź do formularza produktu, a w zakładce Księgowość kliknij pole UNSPSC Category, aby wyświetlić pełną listę pobranych kodów UNSPSC.

Powiadomienia

Powiadomienia są automatycznie pobierane z serwerów API KRA eTIMS codziennie. Aby pobrać je ręcznie, wykonaj następujące kroki:

1. Włącz Tryb dewelopera (tryb debugowania).

2. Przejdź do Ustawienia ‣ Techniczne ‣ Automatyzacja: Zaplanowane akcje i wyszukaj KE eTIMS: Fetch KRA notices from eTIMS.

3. Kliknij akcję na liście, a następnie kliknij Uruchom ręcznie, aby pobrać powiadomienia.

Przejdź do Księgowość ‣ Konfiguracja ‣ Powiadomienia KE OSCU, aby wyświetlić pełną listę pobranych powiadomień.

Wielofirmowość

Zobacz także

Firmy

Jeśli masz wiele firm, możesz je wszystkie scentralizować i zarządzać nimi w jednej bazie danych Odoo. KRA identyfikuje i rozróżnia firmę nadrzędną od jej spółek zależnych za pomocą identyfikatorów. Ponadto spółki zależne są klasyfikowane jako oddziały firmy nadrzędnej.

Aby skonfigurować identyfikator firmy, otwórz aplikację Ustawienia, kliknij Zaktualizuj informacje w sekcji Firmy i wyszukaj pole Kod oddziału eTIMS. Firma nadrzędna ma identyfikator oddziału równy 00 w środowisku wielofirmowym. Firmy, które nie są firmą nadrzędną, mają identyfikator oddziału inny niż 00 i otrzymują identyfikator przydzielony przez KRA.

Aby pobrać identyfikator oddziału z KRA dla firm niebędących firmą nadrzędną, upewnij się, że firma nadrzędna ma kenijski NIP, a urządzenie OSCU zostało zainicjowane. Następnie przejdź do zakładki Oddziały i kliknij Pobierz z KRA.

Informacja

• KRA traktuje każde miejsce dostawy jako osobny oddział (identyfikator).

• Urządzenie OSCU musi być zainicjowane niezależnie dla każdego oddziału.

Identyfikator oddziału kontaktu

Aby przypisać identyfikator oddziału do kontaktu, przejdź do formularza kontaktu, przejdź do zakładki Księgowość i wprowadź kod oddziału w polu Kod oddziału eTIMS.

Informacja

Domyślnie identyfikatory oddziałów kontaktów są ustawione na OO.

Sekwencje KRA

Ważne

Sekwencje faktur Odoo i sekwencje KRA są różne.

W Odoo sekwencje faktur zależą od firmy nadrzędnej. Firmy nadrzędne mogą przeglądać faktury oddziałów, ale oddziały nie mogą przeglądać faktur firmy nadrzędnej ani innych oddziałów.

KRA wymaga niezależnych sekwencji dla każdego oddziału. Dlatego Odoo zarządza sekwencjami indywidualnie dla każdego oddziału.

Example

Jeśli masz firmę nadrzędną z dwoma oddziałami, sekwencja faktur będzie następująca:

• Tworzenie faktury w oddziale 1: INV/2024/00001.

• Tworzenie faktury w oddziale 2: INV/2024/00002.

• Utworzenie faktury w firmie nadrzędnej: INV/2024/00003.

W ten sposób Odoo zarządza sekwencjami, aby być zgodnym z przepisami KRA:

• Tworzenie faktury w oddziale 1: INV/2024/00001.

• Tworzenie faktury w oddziale 2: INV/2024/00001.

• Utworzenie faktury w firmie nadrzędnej: INV/2024/00001.

Integration tokens

To obtain integration tokens for eTIMS, send a request to the following email address: etims@mail.odoo.com.

Ubezpieczenie

Dla dostawców usług zdrowotnych możesz wysłać informacje ubezpieczeniowe o firmach nadrzędnych i oddziałach oraz zaktualizować je w eTIMS. W tym celu przejdź do Księgowość ‣ Konfiguracja ‣ Ustawienia, przewiń do sekcji Integracja z Kenya eTIMS i wypełnij pola Kod, Nazwa i Stawka. Po zakończeniu kliknij Wyślij dane ubezpieczeniowe.

Rejestracja produktu

KRA wymaga, aby produkty były najpierw zarejestrowane przed rozpoczęciem operacji biznesowych (takich jak ruchy magazynowe, BOM, faktury dla klientów itp.). Aby produkt mógł zostać zarejestrowany, następujące pola muszą być zdefiniowane w formularzu produktu:

• W zakładce Informacje ogólne:

  • Koszt

  • Podatki sprzedaży

• W zakładce Księgowość:

  • Jednostka opakowania

  • Ilość w opakowaniu

  • Kraj pochodzenia

  • Typ produktu eTIMS

  • Ubezpieczenie stosowane

  • Kategoria UNSPSC

Jeśli powyższe elementy są zdefiniowane, produkt jest automatycznie rejestrowany podczas wysyłania operacji do KRA. Jeśli nie, zostaniesz powiadomiony żółtym banerem u góry ekranu, zapraszającym do sprawdzenia brakujących elementów.

Ruchy magazynowe

Wszystkie ruchy magazynowe muszą zostać wysłane do KRA. Nie wymagają one faktury, jeśli są operacjami wewnętrznymi lub korektami stanu magazynowego; dlatego Odoo automatycznie je wysyła, jeśli spełniony jest co najmniej jeden z następujących warunków:

1. Nie ustawiono kontaktu dla ruchu;

2. Kontakt jest Twoją firmą nadrzędną lub oddziałem firmy nadrzędnej.

Jeśli ruchy magazynowe są operacjami zewnętrznymi (np. do kontaktów, które nie są częścią firmy nadrzędnej lub jej oddziałów), ruchy magazynowe są automatycznie wysyłane po wysłaniu faktury do eTIMS.

Informacja

• Ruch magazynowy musi zostać potwierdzony przed wysłaniem faktury do eTIMS.

• Produkt(y) muszą być zarejestrowane, aby ruch magazynowy mógł zostać wysłany do eTIMS. Jeśli produkt nie został jeszcze zarejestrowany, żółty baner poprosi o rejestrację produktów.

Zakupy

Odoo automatycznie pobiera nowe faktury dostawców z eTIMS codziennie. Musisz potwierdzić pobrane faktury dostawców i wysłać potwierdzenie do KRA. Aby potwierdzić fakturę dostawcy, musi być ona powiązana z co najmniej jedną potwierdzoną linią zamówienia zakupu.

W przypadku zakupów (nie importów celnych), kroki powiązania linii zamówień zakupu z fakturami są następujące:

1. Przejdź do Księgowość ‣ Dostawcy ‣ Faktury. Faktura dostawcy jest pobierana z serwerów KRA. Plik JSON jest dostępny w chatterze faktury dostawcy, jeśli potrzeba.

2. Odoo sprawdza Numer identyfikacji podatkowej (PIN) dostawcy (partnera);

   • Jeśli jest nieznany, tworzony jest nowy kontakt (partner).

   • Jeśli jest znany i identyfikator oddziału jest taki sam, Odoo używa znanego kontaktu.

3. W pobranej fakturze z KRA wybierz Produkt. Każda faktura dostawcy musi zawierać produkt, aby mógł zostać potwierdzony i później wysłany do eTIMS.

4. Odoo sprawdza istniejące linie zamówień zakupu pasujące do produktów wprowadzonych w poprzednim kroku i partnera (jeśli istnieje). Kliknij pole Linia zamówienia zakupu i wybierz prawidłowe powiązane linie zamówienia zakupu pasujące do produktów. Ilości na fakturze muszą być takie same jak ilości odebrane wskazane w zamówieniu zakupu.

   Jeśli żadna istniejąca linia zamówienia zakupu nie pasuje do linii pobranego rachunku, kliknij Utwórz zamówienie zakupu i utwórz zamówienie zakupu na podstawie niedopasowanej linii (linii). Zatwierdź wynikowy ruch magazynowy i Potwierdź rachunek.

5. Ustaw metodę w polu Metoda płatności eTIMS.

6. Po zakończeniu wszystkich kroków kliknij Wyślij do eTIMS, aby wysłać rachunek dostawcy. Gdy rachunek dostawcy zostanie potwierdzony w eTIMS, numer faktury KRA można znaleźć w karcie Szczegóły eTIMS.

Fakturowanie

Informacja

KRA nie akceptuje sprzedaży, jeśli produktu nie ma w magazynie.

Jest to zalecany przepływ sprzedaży w Odoo podczas sprzedawania:

1. Utwórz zamówienie sprzedaży.

2. Zatwierdź dostawę.

3. Potwierdź fakturę.

4. Kliknij Wyślij, a następnie włącz Wyślij do eTIMS.

5. Kliknij Wyślij, aby wysłać fakturę.

Po wysłaniu i podpisaniu faktury przez KRA, można na niej znaleźć następujące informacje:

• Numer faktury KRA

• Obowiązkowe pola faktury KRA, takie jak informacje SCU, data, identyfikator SCU, numer paragonu, liczba pozycji, data wewnętrzna i podpis paragonu.

• Tabela podatków KRA

• Unikalny kod QR KRA dla podpisanej faktury.

Importy

Kody importów celnych są automatycznie pobierane z serwerów API KRA eTIMS codziennie. Aby pobrać je ręcznie, postępuj następująco:

1. Włącz Tryb dewelopera (tryb debugowania).

2. Przejdź do Ustawienia ‣ Techniczne ‣ Automatyzacja: Zaplanowane akcje i wyszukaj KE eTIMS: Receive Customs Imports from the OSCU.

3. Kliknij akcję na liście, a następnie kliknij Uruchom ręcznie, aby pobrać kody.

Przejdź do Księgowość ‣ Dostawcy ‣ Importy celne, aby wyświetlić zaimportowane kody.

Następujące kroki są wymagane do wysłania i podpisania importów celnych przez KRA:

1. Przejdź do Księgowość ‣ Dostawcy ‣ Importy celne; Import celny jest automatycznie pobierany z KRA.

2. Dopasuj zaimportowany element do istniejącego zarejestrowanego produktu w polu Produkt (lub utwórz produkt, jeśli nie istnieje powiązany produkt).

3. Ustaw dostawcę w polu Partner.

4. Na podstawie partnera dopasuj zaimportowany element do powiązanego zamówienia zakupu (zobacz kroki zakupu). Stan magazynowy musi być poprawnie dostosowany, gdy import celny zostanie zatwierdzony.

   Jeśli nie istnieje powiązane zamówienie zakupu, utwórz je i Potwierdź je. Następnie potwierdź dostawę, klikając Odbierz produkty, a następnie Zatwierdź w zamówieniu zakupu.

5. Kliknij Dopasuj i zatwierdź lub Dopasuj i odrzuć, w zależności od sytuacji towarów.

Informacja

Plik JSON otrzymany od KRA jest załączony do chatteru importu celnego.

BOM

KRA wymaga wysłania wszystkich BOM-ów. Aby wysłać BOM-y do eTIMS, produkt i jego komponenty muszą być zarejestrowane. Aby uzyskać dostęp do BOM-u produktu, kliknij na produkt, a następnie kliknij przycisk inteligentny Zestawienie materiałowe.

Upewnij się, że wymagane pola KRA są wypełnione w sekcji Szczegóły KRA eTIMS w zakładce Księgowość w formularzu produktu, i kliknij Wyślij do eTIMS. Pomyślne wysłanie BOM-u zostanie potwierdzone w chatterze, gdzie możesz również znaleźć wysłane informacje w załączonym pliku JSON.

Noty kredytowe

KRA nie akceptuje faktur korygujących z ilościami lub cenami wyższymi niż pierwotna faktura. Podczas tworzenia faktury korygującej należy wskazać powód KRA: W formularzu faktury korygującej przejdź do zakładki Szczegóły eTIMS, wybierz Powód faktury korygującej eTIMS, a następnie wybierz numer faktury w polu Stornowanie.