Kenia¶
Configuratie¶
Installeer het 🇰🇪 Keniaanse fiscale localisatiepakket om alle functies van de Keniaanse lokalisatie te krijgen.
eTIMS¶
De Kenya Revenue Authority (KRA) heeft het electronic Tax Invoice Management System (eTIMS) geïmplementeerd voor belastinginning.
Om documenten via eTIMS in te dienen, moet je een OSCU gebruiken die integreert met het bestaande Trader Invoicing System (TIS), zoals die van Odoo. De OSCU wordt gebruikt om belastingfacturen te valideren, versleutelen, ondertekenen, verzenden en opslaan.
Notitie
Zorg ervoor dat je de Kenya eTIMS EDI-modules installeert om het OSCU-apparaat volledig te gebruiken.
Initialisatie OSCU-apparaat¶
De OSCU moet vóór gebruik worden geïnitialiseerd. Ga hiervoor naar , klik op Info bijwerken in het gedeelte Bedrijven en voer je Btw-nummer in.
Om de OSCU te initialiseren:
Ga naar en scroll naar beneden naar het gedeelte Kenya eTIMS-integratie.
Stel de eTIMS-servermodus in op Test voor de initialisatie.
Voer het Serienummer van het apparaat in en vink de twee selectievakjes aan.
Klik op OSCU initialiseren.
Notitie
Er zijn drie servermodi beschikbaar:
Demo: ontworpen voor demonstratiedoeleinden; gebruikt mockgegevens en vereist geen geïnitialiseerde OSCU;
Test: gebruikt om de verbinding met eTIMS te testen;
Productie: gebruikt voor live databases die klaar zijn om gegevens te verzenden.
Belangrijk
Als je apparaat al is geïnitialiseerd (bijvoorbeeld via een andere ERP), schakel dan de Ontwikkelaarsmodus (debugmodus) in. Voer vervolgens in het gedeelte Kenya eTIMS-integratie het ID van de eenheid in het veld Eenheid-ID in en de sleutel die is verkregen via een eerdere initialisatie in het veld CMC-sleutel. Klik op Opslaan wanneer je klaar bent.
Zodra de OSCU-module is geïnitialiseerd, wordt voor elk bedrijf op die database met het land ingesteld op Kenia een OSCU-serienummer gegenereerd. Het serienummer wordt gegenereerd op basis van het btw-nummer van het bedrijf (ongeacht de geldigheid). Het is een uniek en opeenvolgend serienummer dat begint met het voorvoegsel ODOO, gevolgd door het btw-nummer van het bedrijf en een reeks nummers.
Registreren op eTIMS¶
Belastingbetalers moeten zich aanmelden en een rekening aanmaken op het KRA-portaal. Als je nog geen rekening hebt:
Meld je aan, voer je PIN in en controleer of alle informatie correct is, inclusief je telefoonnummer, e-mailadres en postadres. Corrigeer eventuele fouten op de iTax-pagina.
Een OTP wordt naar het opgegeven telefoonnummer gestuurd. Deblokkeer promotieberichten als je deze niet ontvangt.
Upload het ID van de bedrijfseigenaar of directeur-ID (zoals vermeld op iTax), samen met het ingevulde en ondertekende toezeggingsformulier.
Klik op het eTIMS-dashboard op Service request bovenaan de pagina. Selecteer OSCU als het eTIMS-type, voer
Odoo KE LTDin als externe integrator en voer het OSCU-serienummer van je bedrijf in dat je eerder hebt opgehaald.
Notitie
Goedkeuringen van serviceverzoeken gaan meestal snel. Als er vertraging is, neem dan contact op met de eTIMS-bewerking of het KRA-kantoor.
Verbintenisformulier
Deel 1: Vul de gegevens van de belastingplichtige in.
Deel 2: Vul de gegevens in van de bedrijfseigenaar of directeur.
Deel 3: Vul je unieke serienummer in dat je in Odoo vindt.
Deel 4: Vink OSCU aan, voer Odoo KE LTD PIN
PO52112956Win en voer de Odoo-versie in die je gebruikt (17.0 of later).Deel 5: Vink de verplichte vakjes aan, voer een datum in en onderteken.
eTIMS-codes¶
Veelvoorkomende standaardcodes worden automatisch elke twee dagen opgehaald van de KRA eTIMS API-servers. Ga als volgt te werk om ze handmatig op te halen:
Schakel de Ontwikkelaarsmodus (debugmodus) in.
Ga naar en zoek naar KE eTIMS: Fetch KRA standard codes.
Klik op de actie in de lijst en klik vervolgens op Handmatig uitvoeren om de codes op te halen.
Ga naar om de volledige lijst met opgehaalde OSCU-codes te bekijken.
UNSPSC-codes¶
De KRA heeft UNSPSC-codes nodig om een product te registreren. UNSPSC-codes worden automatisch elke dag opgehaald van de KRA eTIMS API-servers. Ga als volgt te werk om ze handmatig op te halen:
Schakel de Ontwikkelaarsmodus (debugmodus) in.
Ga naar en zoek naar KE eTIMS: Fetch UNSPSC codes from eTIMS.
Klik op de actie in de lijst en klik vervolgens op Handmatig uitvoeren om de codes op te halen.
Ga naar het productformulier en klik in het tabblad Boekhouding op het veld UNSPSC-categorie om de volledige lijst met opgehaalde UNSPSC-codes te bekijken.
Kennisgevingen¶
Meldingen worden automatisch elke dag opgehaald van de KRA eTIMS API-servers. Om ze handmatig op te halen, ga je als volgt te werk:
Schakel de Ontwikkelaarsmodus (debugmodus) in.
Ga naar en zoek naar KE eTIMS: KRA-meldingen ophalen van eTIMS.
Klik op de actie in de lijst en klik vervolgens op Handmatig uitvoeren om de meldingen op te halen.
Ga naar om de volledige lijst met opgehaalde meldingen te bekijken.
Meerdere bedrijven¶
Zie ook
Als je meerdere bedrijven hebt, kun je ze allemaal centraliseren en beheren op één Odoo-database. De KRA identificeert en onderscheidt het moederbedrijf van zijn dochterondernemingen door middel van ID’s. Bovendien worden dochterondernemingen geclassificeerd als filialen van het moederbedrijf.
Om het ID van het bedrijf te configureren, open je de app Instellingen, klik je op Info bijwerken in de sectie Bedrijven en zoek je naar het veld eTIMS-filiaalcode. Het moederbedrijf heeft een filiaal-ID gelijk aan 00 in een omgeving met meerdere bedrijven. Bedrijven die niet het moederbedrijf zijn, hebben een filiaal-ID anders dan 00 en krijgen een ID toegewezen door de KRA.
Om het filiaal-ID van de KRA op te halen voor je niet-moederbedrijven, zorg je ervoor dat het moederbedrijf een Keniaans Belasting-ID heeft en dat het OSCU-apparaat is geïnitialiseerd. Ga vervolgens naar het tabblad Filialen en klik op Invullen vanuit KRA.
Notitie
De KRA beschouwt elke plaats van levering als een apart filiaal (ID).
Het OSCU-apparaat moet onafhankelijk worden geïnitialiseerd voor elk filiaal.
Contactfiliaal-ID¶
Om een filiaal-ID toe te wijzen aan een contact, open je het contactformulier, ga je naar het tabblad Boekhouding en voer je de filiaalcode in het veld eTIMS-filiaalcode in.
Notitie
Standaard zijn de filiaal-ID’s van contacten ingesteld op OO.
KRA-volgordes¶
Belangrijk
Odoo-factuurvolgordes en KRA-volgordes zijn verschillend.
In Odoo zijn factuurvolgordes afhankelijk van het moederbedrijf. Moederbedrijven kunnen de facturen van filialen zien, maar filialen kunnen de facturen van het moederbedrijf of die van andere filialen niet zien.
De KRA heeft onafhankelijke volgordes per filiaal nodig. Daarom beheert Odoo volgordes individueel per filiaal.
Example
Als je een moederbedrijf hebt met twee filialen, zou de factuurvolgorde als volgt zijn:
Maak een factuur aan op vestiging 1: INV/2024/00001;
Maak een factuur aan op vestiging 2: INV/2024/00002;
Een factuur maken op het moederbedrijf: INV/2024/00003.
Zo beheert Odoo volgordes om te voldoen aan de KRA-regelgeving:
Maak een factuur aan op vestiging 1: INV/2024/00001;
Maak een factuur aan op vestiging 2: INV/2024/00001;
Het aanmaken van een verkoopfactuur op het moederbedrijf: INV/2024/00001.
Verzekering¶
Voor zorgverleners kun je verzekeringsinformatie over het moeder- en filialen verzenden en bijwerken in eTIMS. Ga hiervoor naar , scrol naar de sectie Kenya eTIMS Integration en vul de velden Code, Naam en Tarief in. Klik op Verzekeringsgegevens verzenden wanneer je klaar bent.
Productregistratie¶
De KRA vereist dat producten eerst worden geregistreerd voordat zakelijke activiteiten worden uitgevoerd (zoals voorraadverplaatsingen, stuklijst, verkoopfacturen, etc.). Om een product te registreren moeten de volgende velden worden gedefinieerd op het productformulier:
In het tabblad Algemene informatie: Kosten.
In het tabblad Boekhouding:
Verpakkingseenheid;
Verpakkingshoeveelheid;
Land van herkomst;
eTIMS-producttype;
Verzekering van toepassing;
Als de bovenstaande elementen zijn gedefinieerd, wordt het product automatisch geregistreerd bij het verzenden van de activiteit naar de KRA. Zo niet, dan krijg je een gele banner bovenaan het scherm te zien die je uitnodigt om de ontbrekende elementen te controleren.
Voorraadverplaatsingen¶
Alle voorraadverplaatsingen moeten naar de KRA worden verzonden. Ze vereisen geen factuur als het interne activiteiten of voorraadcorrecties zijn; daarom verstuurt Odoo ze automatisch als ten minste een van de volgende voorwaarden is voldaan:
Er is geen contact ingesteld voor de verplaatsing;
Het contact is jouw moederbedrijf of een filiaal van het moederbedrijf.
Als de voorraadverplaatsingen externe activiteiten zijn (bv. naar contacten die geen deel uitmaken van het moederbedrijf of zijn filialen), worden de voorraadverplaatsingen automatisch verzonden nadat de factuur naar eTIMS is verzonden.
Notitie
De voorraadverplaatsing moet zijn bevestigd voordat de factuur naar eTIMS wordt verzonden.
Het product of de producten moeten geregistreerd zijn voordat de voorraadverplaatsing naar eTIMS kan worden verzonden. Als het product nog niet is geregistreerd, wordt een gele banner weergegeven met de vraag om het product te registreren.
Inkoop¶
Odoo haalt elke dag automatisch nieuwe leveranciersfacturen op uit eTIMS. Je moet de opgehaalde leveranciersfacturen bevestigen en de bevestiging naar de KRA verzenden. Om een leveranciersfactuur te bevestigen, moet deze gekoppeld zijn aan een of meer bevestigde inkooporderregel(s).
In het geval van inkopen (geen douane-importen) zijn de stappen om inkooporderregels te koppelen aan leveranciersfacturen als volgt:
Ga naar . De leveranciersfactuur wordt opgehaald van de KRA-servers. Het JSON-bestand is indien nodig beschikbaar in de chatter van de leveranciersfactuur.
Odoo kijkt naar het Btw-nummer (PIN) van de leverancier (partner);
Als het onbekend is, wordt een nieuw contact (partner) aangemaakt.
Als het bekend is en het filiaal-ID hetzelfde is, gebruikt Odoo het bekende contact.
Selecteer in de opgehaalde leveranciersfactuur van de KRA het Product. Elke leveranciersfactuur moet een product bevatten om later bevestigd en verzonden te kunnen worden naar eTIMS.
Odoo controleert bestaande inkooporderregels die overeenkomen met het product of de producten die in de vorige stap zijn ingevoerd en de relatie (indien aanwezig). Klik op het veld Inkooporderregel en selecteer de juiste gerelateerde inkooporderregel(s) die overeenkomen met het product of de producten. De hoeveelheden op de leveranciersfactuur moeten hetzelfde zijn als de ontvangen hoeveelheden die op de inkooporder staan vermeld.
Als geen enkele bestaande inkooporderregel overeenkomt met de regels van de opgehaalde leveranciersfactuur, klik dan op Inkooporder aanmaken en maak een inkooporder aan op basis van de niet-overeenkomende regel(s). Valideer de resulterende voorraadverplaatsing en Bevestig de leveranciersfactuur.
Stel een methode in het veld eTIMS-betaalmethode in.
Zodra alle stappen zijn voltooid, klik je op Verzenden naar eTIMS om de leveranciersfactuur te verzenden. Wanneer de leveranciersfactuur is bevestigd op eTIMS, is het KRA-factuurnummer te vinden in het tabblad eTIMS-details.
Facturatie¶
Notitie
De KRA accepteert geen verkopen als het product niet op voorraad is.
Dit is de geadviseerde verkoopstroom in Odoo bij verkopen:
Maak een verkooporder aan.
Valideer de levering.
Bevestig de factuur.
Klik op Verzenden en schakel vervolgens Naar eTIMS verzenden in.
Klik op Verzenden om de factuur te versturen.
Zodra de factuur is verzonden en ondertekend door de KRA, is de volgende informatie erop te vinden:
KRA-factuurnummer;
Verplichte KRA-factuurvelden, zoals SCU-informatie, datum, SCU-ID, bonnenummer, aantal items, interne datum en bonhandtekening;
De KRA-btw-tabel;
Een unieke KRA QR-code voor de ondertekende factuur.
Invoer¶
Douane-invoercodes worden elke dag automatisch opgehaald van de KRA eTIMS API-servers. Ga als volgt te werk om ze handmatig op te halen:
Schakel de Ontwikkelaarsmodus (debugmodus) in.
Ga naar en zoek naar KE eTIMS: Ontvang douane-invoer van de OSCU.
Klik op de actie in de lijst en klik vervolgens op Handmatig uitvoeren om de codes op te halen.
Ga naar om de geïmporteerde codes te bekijken.
De volgende stappen zijn vereist om douane-invoer te verzenden en door de KRA te laten ondertekenen:
Ga naar ; De douane-invoer wordt automatisch opgehaald van de KRA.
Koppel het geïmporteerde artikel aan een bestaand geregistreerd product in het veld Product (of maak een product aan als er geen gerelateerd product bestaat).
Stel een leverancier in het veld Relatie in.
Koppel het geïmporteerde artikel op basis van de partner aan de bijbehorende inkooporder (zie inkoopstappen). De voorraad moet correct worden aangepast wanneer de douane-invoer is goedgekeurd.
Als er geen gerelateerde inkooporder bestaat, maak er dan een aan en Bevestig deze. Bevestig vervolgens de levering door op Producten ontvangen te klikken en daarna op Valideren op de inkooporder.
Klik op Koppelen en goedkeuren of Koppelen en afwijzen, afhankelijk van de situatie van de goederen.
Notitie
Het JSON-bestand dat van de KRA is ontvangen, is bijgevoegd aan de chatter van de douane-invoer.
Stuklijst¶
De KRA vereist dat alle stuklijsten naar hen worden verzonden. Om stuklijsten naar eTIMS te verzenden, moeten het product en de onderdelen geregistreerd zijn. Klik op het product om de stuklijst van een product te openen en klik vervolgens op de slimme knop Stuklijst.
Zorg ervoor dat de verplichte velden van de KRA zijn ingevuld in de sectie KRA eTIMS details van het tabblad Boekhouding in het productformulier en klik op Versturen naar eTIMS. Het succesvol versturen van de stuklijst wordt bevestigd in de chatter, waar je ook de verzonden informatie kunt vinden in een bijgevoegd JSON-bestand.
Creditfacturen¶
De KRA accepteert geen creditfacturen met hogere hoeveelheden of prijzen dan de oorspronkelijke factuur. Wanneer je een creditfactuur aanmaakt, moet een KRA-reden worden aangegeven: ga in het creditfactuurformulier naar het tabblad eTIMS Details, selecteer de eTIMS Creditfactuur Reden en selecteer vervolgens het factuurnummer in het veld Terugboeking van.