Saltar al contenido principal

Instalación de ERP Amerpsoft

Para comenzar una nueva instalación y configuración de Amerpsoft, se debe comenzar con la instalación de Idempiere. En la wiki oficial de idempiere se puede visitar l sitio Installing iDempiere.

En github podrá encontrar procedimientos de Instalación en diferentes plataformas, que complementan la publicada en la wiki. Instalación de Idempiere

Fuentes de Programas y Versiones​

Las fuentes del proyecto se encuentran en:

  • iDempiere (fuente): https://github.com/idempiere/idempiere
  • Localizaciones y plugins: https://github.com/luisamesty/Amerpsoft-iDempiere-lve/tree/release-12

Para la compilación se utilizan las siguientes herramientas y entornos:

  • Sistema operativo: Máquina Ubuntu 22.04
  • IDE: Eclipse
  • JDK: Java JDK 1.6.0_34
  • Base de datos: PostgreSQL 15

Para la elaboración de scripts de base de datos se utilizan:

  • DBeaver
  • PgAdmin3 for PostgresSQL

La nomenclatura AMERP se usa para los campos y tablas personalizados. Las tablas de demografía se construyen con el prefijo "C_", siguiendo el modelo de Adempiere.

Versión de iDempiere y Base de Datos​

Se utiliza la versión 12 de iDempiere (Release 12_2024-12-24) con la base de datos versión 20080428-1232.

Puedes descargar la versión compilada desde la página oficial:

  • https://idempiere.org/
  • https://idempiere.org/download/

También puedes clonar el repositorio para obtener las fuentes:

  • https://github.com/idempiere/idempiere

github-idempiere.png

Definiciones de Idiomas Soportados​

La versión 12 viene configurada por defecto con Inglés (en_US) y Español de Colombia (es_CO).

Para configurar el idioma Español de Venezuela (es_VE), se utilizan los plugins disponibles en GitHub. Idiomas

Puedes encontrar las instrucciones para instalar el paquete de idioma español en esta fuente. Idiomas Fuentes

iDempiere soporta múltiples idiomas. Para más información sobre paquetes de idiomas, consulta los siguientes enlaces:

  • Wiki iDempiere: https://wiki.idempiere.org/en/Install_german_language_Pack
  • Página de traducción: https://wiki.idempiere.org/en/Translations

Las localizaciones en español (ej. es_ES, es_VE, es_PY, es_CL) son similares, por lo que se clonan las traducciones existentes y se ajustan las diferencias.

Establecer el español es_VE como idioma del sistema:

  1. Iniciar sesión con el idioma del sistema en inglés.
  2. Ir al menú: /Administración del sistema/Reglas generales/Reglas del sistema/Idioma.
  3. En la ventana de idioma, localizar es_ES, es_VE, es_PY o tu idioma preferido (xx_XX).
  4. Marcar la opción "Idioma del sistema".
  5. Ejecutar el proceso de "Mantenimiento del idioma".

Crear la extensión de idioma para es_VE:

  • Descargar el script Create-language-from-es-CO-to-es-VE.sql del repositorio.
  • Ejecutar la consulta en una consola SQL (DBeaver para PostgreSQL). Puedes editar la consulta para tu idioma preferido.
  • Recuerda sincronizar la terminología.

Cambios manuales en algunas traducciones:

  • Traducir manualmente las etiquetas de regiones, municipios y parroquias en Diccionario/Mensajes de la aplicación.

    • Para Venezuela, cambiar a "Estado", "Municipio", "Parroquia".

  • Traducir manualmente el registro del idioma:

    • Ir a Administrador del sistema/Reglas generales/Reglas del sistema/Idioma.
    • Modificar el campo "Imprimir texto" y traducirlo (ej. Español (Venezuela) para es_VE).

Habilitar/deshabilitar idioma de inicio de sesión:

  • En el menú /Administrador del sistema/Reglas generales/Reglas del sistema/Idioma, ir al idioma específico (es_VE).
  • En el campo "Configuración regional de inicio de sesión", marcar "Inicio de sesión habilitado".

Instalación Demografía de Paises​

Visita Plugin Editor - Localización Extendida.

Allí encontrarás instrucciones para instalar el plugin, así como la demografía de Venezuela y otros países.

A continuación, una breve explicación:

By the way, to unlock the full functionality of all Apps, enable Gemini Apps Activity.

Método A: Se parte de la base de datos Adempiere_pg.dmp de la versión 12. Sigue el procedimiento en el repositorio de GitHub para la instalación del plugin.

  • Plugin Editor - Ubicación Extendida: Este plugin de Amerpsoft extiende el campo de ubicación para incluir conceptos demográficos más allá de país, región y ciudad (ej. municipios y parroquias).
  • Para obtener más información, consulta los archivos DemografiaExtendida_amxeditor.pdf y la wiki de iDempiere sobre ubicación extendida.

Método B: Utilizar la base de datos idempiere12_src_baseVE.backup, que ya contiene la demografía completa:

  • Países (c_country)
  • Regiones de Países (c_community - NUEVA)
  • Estados o Provincias (c_region)
  • Ciudades (c_city)
  • Municipios (c_municipality - NUEVA)
  • Parroquias (c_parish - NUEVA)
  • Zonas Postales (c_zipcode - NUEVA)

La tabla c_location se ha modificado para incluir los campos c_municipality_id, c_parish_id y c_zipcode_id.

Consideración Adicional para los formatos de Direcciones:

  1. Definir la dirección por defecto de 'System':

    • Inicia sesión como el usuario 'System' (preferiblemente en inglés).
    • Ve a System -> Data -> Utilities -> Location.
    • Configura la dirección principal, especialmente la región y el país.

  2. Definir el orden de captura de los campos de las direcciones:

    • Ve al menú: System -> General Rules -> System Rules -> Country Region and Cities.
    • Modifica el campo 'Capture Sequence' para el idioma es_VE.
    • Se sugiere la siguiente secuencia: @CO@ @R@ @C@ @A1@ @A2@ @A3@ @A4@, @P@

Instalación Localización LCO​

Visita LCO - Retención.

Allí encontrarás instrucciones para instalar el plugin.

La localización LCO incorpora el manejo de retenciones. Para la versión 12, se debe instalar el plugin org.amerpsoft.lve.idempiere.lco.withholding_12.0.0.202503181013 utilizando la consola FENIX. Se agregaron los campos Documentno y Description a la tabla lco_invoicewithholding.

Procedimiento de instalación:

  1. Instalar el complemento JAR:

    • Utiliza la consola web de Apache Felix para instalar el archivo JAR.
    • Reinicia el servidor.
    • Recuerda: Actualizar el acceso a roles, sincronizar la terminología, verificar la secuencia y el paquete.

  2. Verificar el paquete:

    • Los archivos de paquete que deben estar actualizados y cargados son AMERPSOFT LCO Withholding (2Pack_7.1.1.zip) y AMERPSOFT LCO Withholding Windows (2Pack_7.1.2.zip).

  3. Agregar datos de retención (Venezuela):

    • Inicia sesión como GardenAdmin y utiliza el archivo de paquete AMERPSOFT LCO Withholding Data.zip.

  4. Crear y actualizar tipos de documentos:

    • Crea los tipos de documentos listados en el archivo AMERPSOFT_Document_Types.xls.
    • Actualiza los tipos de documentos existentes (Factura, nota de crédito, nota de débito).

  5. Crear secuencia para el tipo de documento incluido:

    • Verifica la secuencia de los documentos de retención.

  6. Importar archivos CSV:

    • Importa los archivos LCO_ISIC.csv y los archivos CSV para Tipo de contribuyente, Categorías de impuestos, y Tasas de impuestos.

  7. Ajustar la contabilidad por grupo:

    • Ajusta manualmente y ejecuta el comando de actualización de la base de datos.

  8. Configuración de reglas de retención:

    • Crea manualmente o importa las Categorías de retención, Tipos de retención, Cálculo de retención y Reglas de retención.

Una vez finalizado, el sistema estará configurado con las siguientes funcionalidades:

  • Tasas y categorías de impuestos
  • Categorías, tipos y reglas de retención
  • Ventanas de Factura de Proveedor y Cliente actualizadas
  • Ventanas de Retención de Factura (IVA y Municipal)
  • Ventana de Cheque de Devolución de Cliente