Kenia¶
Configuración¶
Instale el paquete de localización fiscal de Kenia 🇰🇪 para obtener todas las funciones contables predeterminadas de la localización de kenia.
eTIMS¶
La Kenya Revenue Authority (KRA) (Agencia de Ingresos de Kenia) implementó el electronic Tax Invoice Management System (Sistema de gestión de facturas fiscales en línea, por sus siglas en inglés) para la recolección de impuestos.
Para enviar documentos a través de eTIMS, debe usar una OSCU, como el que brinda Odoo. La OSCU debe usarse para validar, encriptar, asignar, transitar y alojar facturas impositivas.
Nota
Asegúrese de instalar los módulos Kenia eTIMS EDI para poder usar el dispositivo OSCU.
Instalación del dispositivo OSCU¶
Debe instalar OSCU antes de usuarlo. Para hacerlo, vaya a Actualizar información en la sección Empresas e ingrese su número de identificación fiscal.
, haga clic enPara inicializar el dispositivo OSCU:
Vaya a Integración eTIMS de Kenia.
y diríjase a la secciónConfigure el eTIMS Server Mode (modo de servidor eTIMS) como Test (prueba) para la inicialización.
Escriba el número de serie del dispositivo y seleccione ambas casillas.
Haga clic en Iniciar OSCU.
Nota
Hay tres modos de servidor disponibles:
Demo: hecho para demostraciones, usa datos de prueba y no requiere un dispositivo OSCU inicializado.
Test (prueba): se usa para probar la conexión a eTIMS.
Production (producción): se usa para bases de datos que ya están listos para enviar datos.
Importante
Si ya inicializó su dispositivo (por ejemplo, con otro ERP), habilite el Modo de desarrollador (modo de depuración). Después, en la sección Integración eTIMS de Kenia, escriba el ID de la unidad en el campo ID de la unidad y la clave que le proporcionaron durante la inicialización anterior en el campo Clave CMC Key. Haga clic en Guardar cuando haya terminado.
Una vez que haya inicializado el módulo OSCU, se generará un número de serie OSCU para todas las empresas en esa base de datos que tengan Kenia como país configurado. El número de serie se genera con el número de identificación fiscal de la empresa (independientemente de su validez). Este número de serie es único y secuencial, comienza con el prefijo ODOO
seguido del número fiscal de la empresa y una secuencia de números.
Registro en eTIMS¶
Los contribuyentes deben registrarse y crear una cuenta en el portal de la KRA. Siga estos pasos si aún no tiene una:
Inicie sesión, escriba su NIP y verifique que toda la información es correcta, como su número de teléfono, dirección de correo y domicilio. En caso de que haya errores, corríjalos en la página de iTax.
Recibirá una contraseña de un solo uso en el número telefónico que proporcionó. Si no la recibe deberá desbloquear los mensajes publicitarios.
Suba el ID del propietario de la empresa o el ID del director (tal como aparece en iTax), también suba el formulario de compromiso y cumplimiento completado y firmado.
En el tablero de eTIMS, haga clic en Solicitud de servicio que se encuentra en la parte superior de la página. Seleccione OSCU como tipo de eTIMS, escriba
Odoo KE LTD
como el integrador externo y escriba el número de serie OSCU de su empresa.
Nota
Las aprobaciones de solicitudes de servicio suelen ser rápidas. En caso de que haya alguna demora, comuníquese con el área de operaciones de eTIMS o la oficina de la KRA.
Formulario de compromiso y cumplimiento
Parte 1: Complete la información del contribuyente.
Parte 2: Complete la información del propietario de la empresa o del director.
Parte 3: Complete el número de serie único que le proporcionó Odoo.
Parte 4: Seleccione OSCU, escriba el NIP
PO52112956W
para Odoo KE LTD y escriba la versión de Odoo que está utilizando (de 17.0 en adelante).Parte 5: Seleccione las casillas obligatorias, escriba la fecha y firme el documento.
Códigos de eTIMS¶
Los códigos comunes estándar se obtienen de forma automática desde los servidores KRA eTIMS API cada dos días. Para obtenerlos de forma manual, haga lo siguiente:
Habilite el Modo de desarrollador (modo de depuración).
Vaya a KE eTIMS: Fetch KRA standard codes (obtener códigos estandar KRA).
y busqueHaga clic en la acción de la lista y después en Ejecutar de forma manual para obtener los códigos.
Vaya a
para ver la lista completa de los códigos OSCU obtenidos.Códigos UNSPSC¶
Para regustrar un producto con KRA necesita tener códigos UNSPSC. Estos códigos se obtienen de forma automática todos los días de los servidores KRA eTIMS API. Para obtenerlos de forma manual, haga lo siguiente:
Habilite el Modo de desarrollador (modo de depuración).
Vaya a KE eTIMS: Fetch UNSPSC codes from eTIMS (obtener códigos UNSPSC de eTIMS).
y busqueHaga clic en la acción de la lista y después en Ejecutar de forma manual para obtener los códigos.
Vaya al formulario del producto y abra la pestaña Contabilidad. Haga clic en el campo Categoría UNSPSC para ver la lista completa de los códigos UNSPSC obtenidos.
Notificaciones¶
Las notificaciones se obtienen de forma automática desde los servidores KRA eTIMS API cada día. Para obtenerlos de forma manual, haga lo siguiente:
Habilite el Modo de desarrollador (modo de depuración).
Vaya a KE eTIMS: Fetch KRA notices from eTIMS (obtener notificaciones KRA de eTIMS).
y busqueHaga clic en la acción de la lista y después en Ejecutar de forma manual para obtener las notificaciones.
Vaya a
para ver la lista completa de los avisos OSCU obtenidos.Multiempresa¶
Ver también
Si tiene varias empresas en Odoo puede centralizar y gestionarlas todas en una sola base de datos. La KRA identifica y distingue entre la empresa principal y sus subsidiarias con IDs y las últimas se clasifican como sucursales.
Vaya a la aplicación Ajustes para configurar el ID de la empresa. Haga clic en Actualizar información en la sección Empresas y busque el campo Código de sucursal eTIMS. El ID de la empresa principal es igual a 00
en un entorno multiempresa y las empresas que no son la empresa principal tienen un ID distinto a 00
que les asignó la KRA.
Para agregar una subsidiaria, vaya a la pestaña subsidiarias en los ajustes de la empresa y haga clic en Agregar una línea.
Para obtener el **ID de sucursal de KRA para sus empresas no principales, asegúrese de que su empresa principal tenga un Número de identificación fiscal y que el dispositivo se ha inicializado. Después, vaya a la pestaña Sucursales y haga clic en Llenar desde KRA.
Nota
La KR considera cada lugar de abastecimiento como una sucursal separada (ID).
El dispositivo OSCU puede inicializarse de manera independiente para cada sucursal.
ID de sucursal para un contacto¶
Para atribuirle un ID de sucursal a un contacto, acceda al formulario de contacto, vaya a la pestaña Contabilidad e ingrese el código de sucursal en el campo código de surcursal eTIMS.
Nota
De forma predeterminada, los ID de las sucursales de los contactos serán OO
.
Secuencias KRA¶
Importante
Las secuencias de facturación de Odoo y KRA son diferentes
En Odoo, las secuencias de las facturas dependen de la empresa principal. Las empresas principales pueden ver las facturas de sucursales, pero las sucursales no pueden ver facturas de la empresa principal o de otras sucursales.
KRA necesita secuencias independientes por sucursal. Por lo tanto, Odoo gestiona las secuencias de forma individual por sucursal.
Example
Si tiene una empresa principal con dos sucursales, la secuencia de la factura debería ser la siguiente:
Crear una factura en sucursal 1: INV/2024/00001;
Crear una factura en sucursal 2: INV/2024/00002;
Crear una factura en la empresa principal: INV/2024/00003.
Así es como Odoo gestiona las secuencias para cumplir con las normas KRA:
Crear una factura en sucursal 1: INV/2024/00001;
Crear una factura en sucursal 2: INV/2024/00001;
Crear una factura en la empresa principal: INV/2024/00001.
Seguro¶
Para proveedores de servicios sanitarios, puede enviar la información de seguros relacionados con la empresa principal y sus sucursales y actualizarla en eTIMS. Vaya a Integración con eTIMS de Kenia y luego complete los campos Código, Nombre y Tasa. Haga clic en Enviar información sobre el seguro al terminar.
, busque la secciónRegistrar productos¶
KRA requiere que se registren los productos antes de comenzar las operaciones empresariales (como movimientos de inventario, lista de materiales, facturas de clientes, entre otras). Para registrar un producto, debe llenar los siguientes campos en el formulario del producto:
En la pestaña Información general: costo.
En la pestaña Contabilidad:
Unidad de empaquetado;
Cantidad de empaquetado;
País de origen;
Tipo de producto eTIMS;
Seguro aplicable;
Si definió los elementos anteriores, el producto se registrará de forma automática al enviar la operación a la KRA. De lo contrario, recibirá una alerta amarilla en la parte superior de la pantalla que le pedirá revisar los elementos faltantes.
Movimientos de inventario¶
Todos los movimientos de inventario se deben enviar a KRA. No requieren factura si son operaciones internas o ajustes de inventario, por lo tanto, Odoo enviará al menos una si se cumple una o más de las siguientes condiciones:
No hay contacto configurado para el movimiento;
El contacto es su empresa principal o una sucursal de la empresa principal.
Si los movimientos de existencia son operaciones externas (por ejemplo, contactos que no son parte de la empresa principal o sus subsidiarias), los movimientos de inventario se configuran de forma automática después de que se envíe la factura a eTIMS.
Nota
El movimiento de inventario debe confirmarse antes de enviar la factura a eTIMS.
Los productos deben registrarse para que el movimiento de inventario se envíe a eTIMS. Si el producto no se ha registrado, aparecerá una advertencia para pedirle que registre el producto.
Compras¶
Odoo obtendrá de forma automática nuevas facturas de proveedor de eTIMS cada día. Necesita confirmar las facturas de proveedor obtenidas y enviar una confirmación a KRA. Para confirmar una factura de proveedor, debe vincularse a una o varias líneas de orden de compra confirmadas.
En caso de compras (no importaciones de aduanas), los pasos para vincular las líneas de la orden de compra con las facturas son:
Vaya a
. La factura de proveedor se obtendrá de los servidores KRA. El archivo JSON está disponible en el chatter de la factura del proveedor si se necesita.Odoo busca el número de identificación fiscal (PIN) del provedor (contacto).
Si es desconocido, se creará un nuevo contacto.
Se conoce y el ID de la sucursal es el mismo, Odoo usará el contacto conocido.
En la factura obtenida de la KRA, seleccione el Producto. Cada factura de vendedor debe contener un producto por confirmar y enviar al eTIMS más tarde.
Odoo revisa las líneas de orden de compra existentes que coinciden con el producto(s) ingresado en el paso anterior y el contacto (si existe). Haga clic en el campo Línea de orden de compra, y seleccione la(s) línea(s) de orden de compra correcta(s) que coincida(n) con el(los) producto(s). Las cantidades de la factura deben coincidir con las cantidades recibidas indicadas en el pedido de compra.
Si ninguna línea del pedido de compra existente coincide con las líneas de la factura obtenida, haga clic en Crear orden de compra y cree una orden de compra basada en la(s) línea(s) no coincidente(s). Valide el movimiento de existencias resultante y Confirme la factura.
Configure un método en el campo método de pago eTIMS.
Una vez completados todos los pasos, haga clic en Send to eTIMS (enviar a eTIMS) para enviar la factura del proveedor. Una vez confirmada la factura de proveedor en eTIMS, podrá encontrar el número de factura KRA en la pestaña eTIMS Details (detalles eTIMS).
Facturación¶
Nota
KRA no acepta ventas si el producto no está en existencias.
Este es el flujo de ventas recomendado en Odoo:
Crear una orden de venta
Valide la entrega.
Confirmar la factura.
Haga clic en Enviar e imprimir, y luego active Enviar a eTIMS.
Haga clic en Enviar e imprimir enviar la factura.
Una vez que se ha enviado la factura y que la KRA se firmó, la información puede encontrarse en:
Número de factura KRA,
Campos obligatorios de KRA, como información SCU, fecha, ID SCU, número de recibo, conteo de artículo, fecha interna y firma del destinatario;
La tabla de impuestos de KRA;
Un código KRA único para la factura firmada.
Importaciones¶
Los códigos de aduana se obtienen de forma automática desde los servidores KRA eTIMS API cada día. Para obtenerlos de forma manual, haga lo siguiente:
Habilite el Modo de desarrollador (modo de depuración).
Vaya a KE eTIMS: Receive Customs Imports from the OSCU (recibir aduana de OSCU).
y busqueHaga clic en la acción de la lista y después en Ejecutar de forma manual para obtener los códigos.
Vaya a
para ver los códigos de importación.Debe seguir los siguientes pasos para enviar y tener importación de aduana firmada por KRA:
Vaya a
. La información de aduana se obtiene directamente de KRA.Vincule el articulo importado con un producto registrado existente en el campo Producto (o cree un producto si no existe uno relacionado).
Configure un proveedor en el campo contacto.
Según el contacto, vincule el artículo importado con su orden de compra relacionada (vea pasos de compra). El inventario se debe ajustar de forma correcta cuando se aprueba una importación.
Si no existe una orden de compra relacionada, cree una y confírmela. Después, confirme la entrega haciendo clic en Recibir productos y después valídelos en la orden de compra.
Haga clic en Vincular y aprobar o en Vincular y rechazar, dependiendo de la situación de los bienes.
Nota
El archivo JSON que recibirá de KRA estará adjunto al chatter de aduana.
Lista de materiales¶
La KRA requiere que se les envíe todas las listas de materiales. Para enviar listas de materiales a eTIMS, el producto y sus componentes deben estar registrados. Para acceder a la lista de materiales del producto, haga clic en él y después en el botón inteligente lista de materiales.
Asegúrese de que los campos requeridos por la KRA de la sección Detalles de KRA eTIMS en la pestaña Contabilidad del formulario del producto estén completos y después haga clic en Enviar a eTIMS. El envío correcto de la lista de materiales se confirmará en el chatter, donde también encontrará la información que envió en un archivo JSON adjunto.
Notas de crédito¶
La KRA no acepta notas de crédito con cantidades o precios superiores a los de la factura inicial. Al crear una nota de crédito debe indicar un motivo de KRA: en el formulario correspondiente, vaya a la pestaña Detalles de eTIMS, seleccione Motivo de la nota de crédito de eTIMS y después seleccione el número de factura en el campo Reversión de.