Kenya¶
Configurazione¶
Installa il pacchetto di localizzazione fiscale per il 🇰🇪 Kenya per ottenere tutte le funzionalità della localizzazione.
eTIMS¶
L”Autorità delle Entrate del Kenya (KRA) ha implementato il Sistema elettronico di gestione delle fatture fiscali (eTIMS) per la riscossione delle imposte.
Per inviare documenti tramite eTIMS, è necessario utilizzare un OSCU che si integra con il Sistema di fatturazione commerciale (TIS) esistente, come quello fornito da Odoo. L’OSCU viene utilizzato per convalidare, crittografare, firmare, trasmettere e archiviare le fatture fiscali.
Nota
Assicurarsi di installare i moduli Kenya eTIMS EDI per utilizzare completamente il dispositivo OSCU.
Inizializzazione del dispositivo OSCU¶
L’OSCU deve essere inizializzato prima dell’uso. Per farlo, andare in , fare clic su Aggiorna informazioni nella sezione Aziende e inserire il proprio Codice fiscale.
Per inizializzare l’OSCU:
Andare in e scorrere verso il basso fino alla sezione Integrazione Kenya eTIMS.
Impostare la Modalità server eTIMS su Test per l’inizializzazione.
Inserire il Numero di serie del dispositivo e spuntare le due caselle di controllo.
Fare clic su Inizializza OSCU.
Nota
Sono disponibili tre modalità server:
Demo: progettata per scopi dimostrativi; utilizza dati di esempio e non richiede un OSCU inizializzato;
Test: utilizzata per testare la connessione a eTIMS;
Produzione: utilizzata per database live pronti per inviare dati.
Importante
Se il tuo dispositivo è già stato inizializzato (tramite un altro ERP, ad esempio), abilita Modalità sviluppatore (modalità di debug). Quindi, nella sezione Integrazione Kenya eTIMS, inserisci l’ID dell’unità nel campo ID unità e la chiave ottenuta tramite una precedente inizializzazione nel campo Chiave CMC. Fai clic su Salva al termine.
Una volta che il modulo OSCU è stato inizializzato, viene generato un numero di serie OSCU per ciascuna azienda su quel database con il paese impostato su Kenya. Il numero di serie viene generato in base al numero di partita IVA dell’azienda (indipendentemente dalla sua validità). Si tratta di un numero di serie unico e sequenziale che inizia con il prefisso ODOO seguito dal numero di partita IVA dell’azienda e da una sequenza di numeri.
Registrazione su eTIMS¶
I contribuenti devono registrarsi e creare un account sul portale KRA. Se non hai ancora un account:
Registrati, inserisci il tuo PIN e verifica che tutte le informazioni siano corrette, inclusi numero di telefono, indirizzo email e indirizzo postale. Correggi eventuali errori sulla pagina iTax.
Un OTP viene inviato al numero di telefono fornito. Sblocca i messaggi promozionali se non lo ricevi.
Carica l”ID del proprietario dell’attività o l”ID del direttore (come elencato su iTax), insieme al modulo di impegno compilato e firmato.
Sulla dashboard di eTIMS, fai clic su Richiesta di servizio nella parte superiore della pagina. Seleziona OSCU come tipo eTIMS, inserisci
Odoo KE LTDcome integratore di terze parti e inserisci il numero di serie OSCU della tua azienda recuperato in precedenza.
Nota
Le approvazioni delle richieste di servizio sono solitamente rapide. In caso di ritardo, contatta l’ufficio operativo eTIMS o l’ufficio KRA.
Modulo di impegno
Parte 1: compila le informazioni del contribuente.
Parte 2: compila le informazioni del proprietario dell’attività o del direttore.
Parte 3: compila il tuo numero di serie univoco trovato in Odoo.
Parte 4: spunta OSCU, inserisci il PIN di Odoo KE LTD
PO52112956We inserisci la versione di Odoo che stai utilizzando (17.0 o successive).Parte 5: spunta le caselle obbligatorie, inserisci una data e firma.
Codici eTIMS¶
I codici standard comuni vengono automaticamente recuperati dai server API KRA eTIMS ogni due giorni. Per recuperarli manualmente, procedi come segue:
Vai su e cerca KE eTIMS: recupera codici standard KRA.
Fai clic sull’azione nell’elenco, quindi fai clic su Esegui manualmente per recuperare i codici.
Vai a per visualizzare l’elenco completo dei codici OSCU recuperati.
Codici UNSPSC¶
Il KRA richiede codici UNSPSC affinché un prodotto possa essere registrato. I codici UNSPSC vengono automaticamente recuperati dai server API KRA eTIMS ogni giorno. Per recuperarli manualmente, procedi come segue:
Vai a e cerca KE eTIMS: Recupera codici UNSPSC da eTIMS.
Fai clic sull’azione nell’elenco, quindi fai clic su Esegui manualmente per recuperare i codici.
Vai al modulo prodotto e nella scheda Contabilità, fai clic sul campo Categoria UNSPSC per visualizzare l’elenco completo dei codici UNSPSC recuperati.
Avvisi¶
Gli avvisi vengono automaticamente recuperati dai server API KRA eTIMS ogni giorno. Per recuperarli manualmente, procedi come segue:
Vai a e cerca KE eTIMS: Recupera avvisi KRA da eTIMS.
Fai clic sull’azione nell’elenco, quindi fai clic su Esegui manualmente per recuperare gli avvisi.
Vai a per visualizzare l’elenco completo degli avvisi recuperati.
Aziende multiple¶
Vedi anche
Se hai più aziende, puoi centralizzarle e gestirle tutte su un unico database Odoo. Il KRA identifica e distingue l’azienda principale dalle sue filiali utilizzando degli ID. Inoltre, le filiali sono classificate come branch dell’azienda principale.
Per configurare l’ID dell’azienda, apri l’app Impostazioni, fai clic su Aggiorna informazioni nella sezione Aziende e cerca il campo Codice branch eTIMS. L”azienda principale ha un ID branch uguale a 00 in un ambiente multi-azienda. Le aziende che non sono l’azienda principale hanno un ID branch diverso da 00 e ricevono un ID assegnato dal KRA.
Per recuperare l”ID branch dal KRA per le tue aziende non principali, assicurati che l’azienda principale abbia un Codice fiscale keniota e che il dispositivo OSCU sia stato inizializzato. Quindi, vai alla scheda Branch e fai clic su Popola da KRA.
Nota
Il KRA considera ogni luogo di fornitura come un branch separato (ID).
Il dispositivo OSCU deve essere inizializzato indipendentemente per ogni branch.
ID branch del contatto¶
Per attribuire un ID branch a un contatto, accedi al modulo contatto, vai alla scheda Contabilità e inserisci il codice branch nel campo Codice branch eTIMS.
Nota
Per impostazione predefinita, gli ID branch dei contatti sono impostati su OO.
Sequenze KRA¶
Importante
Le sequenze delle fatture di Odoo e le sequenze KRA sono diverse.
In Odoo, le sequenze delle fatture dipendono dalla società madre. Le società madri possono vedere le fatture delle filiali, ma le filiali non possono vedere le fatture della società madre o quelle di altre filiali.
Il KRA necessita di sequenze indipendenti per ogni filiale. Pertanto, Odoo gestisce le sequenze individualmente per ciascuna filiale.
Example
Se si dispone di una società madre con due filiali, la sequenza delle fatture sarebbe la seguente:
Creazione di una fattura sul ramo 1: INV/2024/00001;
Creazione di una fattura sul ramo 2: INV/2024/00002;
Creazione di una fattura nella società madre: INV/2024/00003.
Questo è il modo in cui Odoo gestisce le sequenze per essere conforme alle normative KRA:
Creazione di una fattura sul ramo 1: INV/2024/00001;
Creazione di una fattura sul ramo 2: INV/2024/00001;
Creazione di una fattura nella società madre: INV/2024/00001.
Assicurazione¶
Per i fornitori di servizi sanitari, è possibile inviare informazioni assicurative relative alle società madri e alle filiali e aggiornarle in eTIMS. Per farlo, andare su , scorrere fino alla sezione Integrazione Kenya eTIMS e compilare i campi Codice, Nome e Tariffa. Fare clic su Invia dettagli assicurativi al termine.
Registrazione del prodotto¶
Il KRA richiede che i prodotti siano registrati prima di condurre operazioni commerciali (come movimenti di magazzino, DdM, fatture clienti, ecc.). Affinché un prodotto possa essere registrato, i seguenti campi devono essere definiti nella scheda del prodotto:
Nella scheda Informazioni generali: Costo.
Nella scheda Contabilità:
Unità di imballaggio;
Quantità di imballaggio;
Paese di origine;
Tipo di prodotto eTIMS;
Assicurazione applicabile;
Se gli elementi sopra indicati sono definiti, il prodotto viene automaticamente registrato durante l’invio dell’operazione al KRA. In caso contrario, verrà visualizzato un banner giallo nella parte superiore dello schermo che invita a controllare gli elementi mancanti.
Movimenti di magazzino¶
Tutti i movimenti di magazzino devono essere inviati al KRA. Non richiedono una fattura se si tratta di operazioni interne o rettifiche di magazzino; pertanto, Odoo li invia automaticamente se è soddisfatta almeno una delle seguenti condizioni:
Non è impostato alcun contatto per il movimento;
Il contatto è la società madre o una filiale della società madre.
Se i movimenti di magazzino sono operazioni esterne (ad esempio, verso contatti che non fanno parte della società madre o delle sue filiali), i movimenti di magazzino vengono inviati automaticamente dopo l’invio della fattura a eTIMS.
Nota
Il movimento di magazzino deve essere confermato prima di inviare la fattura a eTIMS.
I prodotti devono essere registrati affinché il movimento di magazzino possa essere inviato a eTIMS. Se il prodotto non è ancora stato registrato, un banner giallo richiederà la registrazione dei prodotti.
Acquisti¶
Odoo recupera automaticamente le nuove fatture fornitore da eTIMS ogni giorno. È necessario confermare le fatture fornitore recuperate e inviare la conferma al KRA. Per confermare una fattura fornitore, questa deve essere collegata a una o più righe d’ordine di acquisto confermate.
Nel caso di acquisti (non importazioni doganali), i passaggi per collegare le righe d’ordine di acquisto con le fatture sono i seguenti:
Vai su . La fattura fornitore viene recuperata dai server KRA. Il file JSON è disponibile nel chatter della fattura fornitore, se necessario.
Odoo verifica il Partita IVA (PIN) del fornitore (partner);
Se è sconosciuto, viene creato un nuovo contatto (partner).
Se è conosciuto e l’ID della filiale è lo stesso, Odoo utilizza il contatto conosciuto.
Nella fattura recuperata dal KRA, seleziona il Prodotto. Ogni fattura fornitore deve contenere un prodotto per essere confermata e inviata a eTIMS in seguito.
Odoo verifica le righe d’ordine di acquisto esistenti corrispondenti ai prodotti inseriti nel passaggio precedente e al partner (se presente). Fai clic sul campo Riga ordine di acquisto e seleziona le righe d’ordine di acquisto correlate corrette corrispondenti ai prodotti. Le quantità sulla fattura devono essere le stesse delle quantità ricevute indicate sull’ordine di acquisto.
Se nessuna riga d’ordine di acquisto esistente corrisponde alle righe della fattura recuperata, fai clic su Crea ordine di acquisto e crea un ordine di acquisto basato sulle righe non corrispondenti. Valida il movimento di magazzino risultante e Conferma la fattura.
Impostare un metodo nel campo Metodo di pagamento eTIMS..
Una volta completati tutti i passaggi, fai clic su Invia a eTIMS per inviare la fattura fornitore. Quando la fattura fornitore è stata confermata su eTIMS, il numero di fattura KRA può essere trovato nella scheda Dettagli eTIMS.
Fatturazione¶
Nota
Il KRA non accetta vendite se il prodotto non è in stock.
Questo è il flusso di vendita consigliato in Odoo quando si vende:
Crea un ordine di vendita.
Valida la consegna.
Conferma la fattura.
Click Send and print, and then enable Send to eTIMS.
Click Send & print to send the invoice.
Una volta che la fattura è stata inviata e firmata dal KRA, le seguenti informazioni possono essere trovate su di essa:
Numero fattura KRA;
Campi fattura KRA obbligatori, come informazioni SCU, data, ID SCU, numero ricevuta, conteggio articoli, data interna e firma ricevuta;
La tabella fiscale KRA;
Un codice QR KRA univoco per la fattura firmata.
Importazioni¶
I codici di importazione doganale vengono recuperati automaticamente dai server API eTIMS del KRA ogni giorno. Per recuperarli manualmente, procedi come segue:
Andare in e cercare KE eTIMS: Receive Customs Imports from the OSCU.
Fai clic sull’azione nell’elenco, quindi fai clic su Esegui manualmente per recuperare i codici.
Andare in per visualizzare i codici importati.
I seguenti passaggi sono necessari per inviare e fare firmare le importazioni doganali dalla KRA:
Andare in ; L’importazione doganale viene recuperata automaticamente dalla KRA.
Abbinare l’articolo importato con un prodotto registrato esistente nel campo Prodotto (o creare un prodotto se non esiste un prodotto correlato).
Impostare un fornitore nel campo Partner.
In base al partner, abbinare l’articolo importato con il relativo ordine di acquisto (vedere passaggi di acquisto). Lo stock deve essere correttamente adeguato quando l’importazione doganale viene approvata.
Se non esiste un ordine di acquisto correlato, crearne uno e Confermarlo. Quindi, confermare la consegna facendo clic su Ricevi prodotti, poi Convalida sull’ordine di acquisto.
Fare clic su Abbina e approva o Abbina e rifiuta, a seconda della situazione della merce.
Nota
Il file JSON ricevuto dalla KRA è allegato al chatter dell’importazione doganale.
Distinta base¶
La KRA richiede che tutte le distinte base vengano inviate. Per inviare le distinte base a eTIMS, il prodotto e i suoi componenti devono essere registrati. Per accedere alla distinta base di un prodotto, fare clic sul prodotto e poi fare clic sul pulsante smart Distinta base.
Assicurarsi che i campi richiesti dalla KRA siano compilati nella sezione Dettagli KRA eTIMS della scheda Contabilità nel modulo prodotto, e fare clic su Invia a eTIMS. L’invio riuscito della distinta base è confermato nel chatter, dove è possibile trovare anche le informazioni inviate in un file JSON allegato.
Note di credito¶
La KRA non accetta note di carta di credito con quantità o prezzi superiori alla fattura iniziale. Quando si crea una nota di carta di credito, deve essere indicato un motivo KRA: Nel modulo della nota di carta di credito, andare alla scheda Dettagli eTIMS, selezionare il Motivo nota di credito eTIMS, quindi selezionare il numero di fattura nel campo Storno di.