Kenya¶

Konfiguration¶

Installera 🇰🇪 Kenyan :ref:``fiscal-lokaliseringspaketet <fiscal_localizations/packages>` för att få alla funktioner i den kenyanska lokaliseringen.

eTIMS¶

Kenyas skattemyndighet (KRA) <https://www.kra.go.ke/>`_ har infört ett system för skatteuppbörd, eTIMS (Electronic Tax Invoice Management System) <https://www.kra.go.ke/online-services/etims>`_.

För att skicka dokument via eTIMS måste du använda en OSCU som integreras med det befintliga Trader Invoicing System (TIS), till exempel det som tillhandahålls av Odoo. OSCU används för att validera, kryptera, signera, överföra och lagra skattefakturor.

Observera

Se till att installera Kenya eTIMS EDI-modulerna för att använda OSCU-enheten fullt ut.

Initialisering av OSCU-enhet¶

OSCU måste initialiseras före användning. För att göra det, navigera till Inställningar ‣ Allmänna inställningar, klicka på Uppdatera Info i Företag sektionen, och ange ditt Skatte-ID.

För att initiera OSCU:

Gå till Inställningar ‣ Allmänna inställningar och bläddra ner till avsnittet Kenya eTIMS Integration.
Ställ in eTIMS Server Mode till Test för initialiseringen.
Ange enhetens Serialnummer och kryssa i de två kryssrutorna.
Klicka på Initialize OSCU.

Observera

Tre serverlägen finns tillgängliga:

Demo: Utformad för demo-ändamål; den använder låtsasdata och kräver inte en initialiserad OSCU;
Test: Används för att testa anslutningen till eTIMS;
Produktion: Används för live-databaser som är redo att skicka data.

Viktigt

Om din enhet redan har initialiserats (t.ex. via ett annat affärssystem) aktiverar du Utvecklarläge (felsökningsläge). I avsnittet Kenya eTIMS Integration anger du sedan enhetens ID i fältet Unit ID och den nyckel som erhållits genom en tidigare initialisering i fältet CMC Key. Klicka på Save när du är klar.

När OSCU-modulen har initialiserats, genereras ett OSCU-serienummer för varje företag i den databasen med dess country inställt på Kenya. Serienumret genereras baserat på företagets momsregistreringsnummer (oavsett om det är giltigt eller inte). Det är ett unikt och sekventiellt serienummer som börjar med prefixet ODOO följt av företagets VAT-nummer och en sekvens av siffror.

Registrera dig på eTIMS¶

Skattebetalare * måste * registrera sig och skapa ett konto på KRA-portalen. Om du inte har ett konto ännu:

Registrera dig, ange din PIN och kontrollera att all information är korrekt, inklusive ditt telefonnummer, din e-postadress och din postadress. Rätta till eventuella fel på iTax-sidan.
Ett OTP skickas till det telefonnummer som angetts. Avblockera reklammeddelanden om du inte får det.
Ladda upp företagsägarens ID eller direktörens ID (som anges på iTax), tillsammans med det ifyllda och undertecknade åtagandeformuläret .
På eTIMS instrumentpanel klickar du på Service request högst upp på sidan. Välj OSCU som eTIMS-typ, ange Odoo KE LTD som tredjepartsintegratör och ange ditt företags OSCU-serienummer som hämtades tidigare.

Observera

Godkännande av servicebegäran går vanligtvis snabbt. Om det dröjer kan du kontakta eTIMS-operatören eller KRA-kontoret.

Formulär för åtagande

Del 1: Fyll i skattebetalarens uppgifter.
Del 2: Fyll i företagsägarens * eller * direktörens information.
Del 3: Fyll i ditt unika serienummer som du hittar i Odoo.
Del 4: Kryssa i OSCU, ange Odoo KE LTD PIN PO52112956W, och ange den Odoo-version du använder (17.0 eller senare).
Del 5: Kryssa i de obligatoriska rutorna, ange ett datum och underteckna.

eTIMS-koder¶

Vanliga standardkoder hämtas automatiskt från KRA eTIMS API-servrar varannan dag. För att hämta dem manuellt, gör så här:

Aktivera Utvecklarläge (felsökningsläge).
Gå till :menuselection:`Inställningar –> Tekniska –> Automation: Scheduled Actions” och sök efter ”guilabel”: ”KE eTIMS: Hämta KRA standardkoder”.
Klicka på åtgärden i listan och klicka sedan på Kör manuellt för att hämta koderna.

Gå till :menuselection:``Accounting –> Configuration –> KE OSCU Codes` för att se den fullständiga listan över hämtade OSCU-koder.

UNSPSC-koder¶

KRA behöver UNSPSC-koder för att en produkt ska kunna registreras. UNSPSC-koder hämtas automatiskt från KRA:s eTIMS API-servrar varje dag. För att hämta dem manuellt, gör så här:

Aktivera Utvecklarläge (felsökningsläge).
Gå till :menuselection:`Inställningar –> Tekniska –> Automation: Scheduled Actions” och sök efter ”guilabel”: ”KE eTIMS: Hämta UNSPSC-koder från eTIMS”.
Klicka på åtgärden i listan och klicka sedan på Kör manuellt för att hämta koderna.

Gå till produktformuläret och klicka på fältet Accounting i fliken UNSPSC Category för att se den fullständiga listan över hämtade UNSPSC-koder.

Meddelanden¶

Aviseringarna hämtas automatiskt från KRA eTIMS API-servrar varje dag. För att hämta dem manuellt, gör så här:

Aktivera Utvecklarläge (felsökningsläge).
Gå till :menuselection:`Inställningar –> Tekniska –> Automation: Scheduled Actions” och sök efter ”guilabel”: ”KE eTIMS: Hämta KRA-meddelanden från eTIMS”.
Klicka på åtgärden i listan och klicka sedan på Kör manuellt för att hämta meddelandena.

Gå till Accounting ‣ Configuration ‣ KE OSCU Notices för att se den kompletta listan över hämtade notiser.

Flerbolag¶

Se även

../../allmänt/företag

If you have multiple companies, you can centralize and manage them all on a single Odoo database. The KRA identifies and differentiates the parent company from its subsidiaries by using IDs. Furthermore, subsidiaries are classified as branches of the parent company.

To configure the company’s ID, open the Settings app, click Update Info in the Companies section, and search for the eTIMS Branch Code field. The parent company has a branch ID equal to 00 in a multi-company environment. Companies that are not the parent company have a branch ID other than 00 and are assigned an ID by the KRA.

To fetch the branch ID from the KRA for your non-parent companies, ensure the parent company has a Kenyan Tax ID and the OSCU device has been initialized. Then, go to the Branches tab and click Populate from KRA.

Observera

KRA betraktar varje leveransställe som en separat bransch (ID).
Enheten OSCU måste initialiseras oberoende av för varje gren.

ID för kontaktfilial¶

För att tilldela ett filial-ID till en kontakt öppnar du kontaktformuläret, går till fliken Accounting och anger filialkoden i fältet eTIMS Branch Code.

Observera

Som standard är kontaktpersonernas filial-ID inställt på OO.

KRA-sekvenser¶

Viktigt

Odoo fakturasekvenser och KRA-sekvenser är olika.

In Odoo, invoice sequences depend on the parent company. Parent companies can see the invoices of branches, but branches cannot see the parent company’s invoices or those of other branches.

KRA behöver oberoende sekvenser per filial. Därför hanterar Odoo sekvenser individuellt per filial.

Example

If you have a parent company with two branches, the invoice sequence would be the following:

Skapar en faktura på filial 1: INV/2024/00001;
Skapar en faktura på filial 2: INV/2024/00002;
Creating an invoice on the parent company: INV/2024/00003.

Så här hanterar Odoo sekvenser för att följa KRA-reglerna:

Skapar en faktura på filial 1: INV/2024/00001;
Skapar en faktura på filial 2: INV/2024/00001;
Creating an invoice on the parent company: INV/2024/00001.

Försäkring¶

For health service providers, you can send insurance information about the parent and branch companies and update it in eTIMS. To do so, go to Accounting ‣ Configuration ‣ Settings, scroll to the Kenya eTIMS Integration section, and fill in the Code, Name, and Rate fields. Click Send Insurance Details when done.

Produktregistrering¶

KRA kräver att produkter registreras först innan affärsverksamhet kan utföras (t.ex. lagerrörelser, BOM, kundfakturor etc.). För att en produkt ska kunna registreras måste följande fält definieras på produktformuläret:

På fliken General Information: Cost.
På fliken Redovisning:
- Förpackningsenhet;
- Förpackningsantal;
- Origin Country;
- eTIMS Produkttyp;
- Försäkring tillämplig;
- UNSPSC Kategori.

Om ovanstående element är definierade registreras produkten automatiskt samtidigt som operationen skickas till KRA. Om så inte är fallet visas en gul banner högst upp på skärmen som uppmanar dig att kontrollera de saknade uppgifterna.

Aktierörelser¶

Alla lagerrörelser måste skickas till KRA. De kräver inte en faktura om de är interna operationer eller lagerjusteringar; därför skickar Odoo dem automatiskt om minst ett av följande villkor är uppfyllda:

Ingen kontakt är satt för flytten;
The contact is your parent company or a branch of the parent company.

If the stock moves are external operations (e.g., to contacts that are not part of the parent company or its branches), the stock moves are automatically sent after the invoice is sent to eTIMS.

Observera

Lagerflytten måste bekräftas innan fakturan skickas till eTIMS.
Produkten/produkterna måste vara registrerade för att lagerflytten ska skickas till eTIMS. Om produkten inte har registrerats ännu kommer en gul banner att uppmana till registrering av produkten.

Inköp¶

Odoo hämtar automatiskt nya leverantörsfakturor från eTIMS varje dag. Du måste bekräfta de hämtade leverantörsfakturorna och skicka bekräftelsen till KRA. För att bekräfta en leverantörsfaktura måste den vara kopplad till en eller flera bekräftade inköpsorderrader.

När det gäller inköp (inte tullimport) är stegen för att koppla samman inköpsorderrader med fakturor följande:

Gå till :menyval:`Redovisning --> Leverantörer --> Fakturor`. Leverantörsfakturan hämtas från KRA:s servrar. JSON-filen finns tillgänglig i chattern för leverantörsfakturan om det behövs.
Odoo tittar på leverantörens (partnerns) Tax ID (PIN);
- Om den är okänd skapas en ny kontakt (partner).
- Om den är känd och filial-ID:t är detsamma använder Odoo den kända kontakten.
I den hämtade fakturan från KRA, välj Product. Varje leverantörsfaktura måste innehålla en produkt för att senare kunna bekräftas och skickas till eTIMS.
Odoo kontrollerar befintliga inköpsorderrader som matchar den eller de produkter som angavs i föregående steg och partnern (om någon). Klicka på fältet Purchase Order Line och välj rätt relaterad inköpsorderrad som matchar produkten/produkterna. Kvantiteterna på fakturan måste vara samma som de mottagna kvantiteterna som anges på inköpsordern.

Om ingen befintlig inköpsorderrad matchar raderna i den hämtade fakturan klickar du på Create Purchase Order och skapar en inköpsorder baserat på den eller de rader som inte matchar. Validate den resulterande lagerflytten och Confirm fakturan.
Ange en metod i fältet eTIMS Payment Method…
När alla steg är slutförda klickar du på Send to eTIMS för att skicka leverantörsfakturan. När leverantörsfakturan har bekräftats i eTIMS finns KRA-fakturanumret på fliken eTIMS Details.

Fakturering¶

Observera

KRA accepterar inte försäljning om produkten inte finns i lager.

Detta är det rådgivna försäljningsflödet i Odoo vid försäljning:

Skapa en försäljningsorder.
Validera leveransen.
Konfirmera fakturan.
Klicka på Sänd och skriv ut och aktivera sedan Sänd till eTIMS.
Klicka på Sänd & skriv ut för att skicka fakturan.

När fakturan har skickats och undertecknats av KRA, kan följande information finnas på den:

KRA fakturanummer;
Obligatoriska fält för KRA-fakturor, t.ex. SCU-information, datum, SCU-id, kvittonummer, varuantal, internt datum och kvittosignatur;
KRA skattetabell;
En unik KRA QR-kod för den undertecknade fakturan.

Import¶

Tullens importkoder hämtas automatiskt från KRA eTIMS API-servrar varje dag. För att hämta dem manuellt, gör så här:

Aktivera Utvecklarläge (felsökningsläge).
Gå till Inställningar ‣ Tekniska ‣ Automation: Schemalagda åtgärder och sök efter KE eTIMS: Ta emot tullinförsel från OSCU.
Klicka på åtgärden i listan och klicka sedan på Kör manuellt för att hämta koderna.

Gå till :menuselection:`Redovisning –> Leverantörer –> Tullimport för att se de importerade koderna.

Följande steg krävs för att skicka och få customs import signerad av KRA:

Gå till :menyval:`Redovisning --> Leverantörer --> Tullinförsel`; Tullinförseln hämtas automatiskt från KRA.
Matcha den importerade artikeln med en befintlig registrerad produkt i fältet Product (eller skapa en produkt om det inte finns någon relaterad produkt).
Ange en leverantör i fältet Partner.
Baserat på partnern, matcha den importerade artikeln med dess relaterade inköpsorder (se inköpssteg). Lagret måste justeras korrekt när tullimporten godkänns.

Om det inte finns någon relaterad inköpsorder skapar du en och Confirm den. Bekräfta sedan leveransen genom att klicka på Receive Products och sedan på Validate på inköpsordern.
Klicka på Matcha och godkänna eller Matcha och avvisa, beroende på varans situation.

Observera

JSON-filen som tas emot från KRA bifogas till tullimportens chatt.

BOM¶

KRA kräver att alla stycklistor skickas till dem. För att skicka stycklistor till eTIMS måste produkten och dess komponenter vara registrerade. För att komma åt en produkts BOM klickar du på produkten och sedan på den smarta knappen Bill of Materials.

Kontrollera att KRA:s obligatoriska fält är ifyllda i avsnittet KRA eTIMS details på fliken Accounting i produktformuläret och klicka på Send to eTIMS. Den lyckade sändningen av stycklistan bekräftas i chattmeddelandet, där du också kan hitta den skickade informationen i en bifogad JSON-fil.

Kreditnotor¶

KRA accepterar inte kreditfakturor med kvantiteter eller priser som är högre än den ursprungliga fakturan. När du skapar en kreditfaktura måste en KRA-orsak anges: I kreditfakturaformuläret går du till fliken eTIMS Details, väljer eTIMS Credit Note Reason och väljer sedan fakturanumret i fältet Reversal of.

Edit on GitHub