POS Service – Manual

El programa en mención se ha realizado con la finalidad de facilitar los procesos de

instalación, actualización y reversión del programa POS-Efact. Siendo estos puntos
tratados con una interfaz gráfica (GUI) o por consola/terminal, que permita, de manera
intuitiva, que el cliente/usuario pueda realizar dichos procesos sin dificultad alguna.

PUNTOS A TENER EN CUENTA

• Dado que los ejecutables solicitan/necesitan permisos de administrador es muy

probable que sea detectado como amenaza por los antivirus. En estos casos,
le recomendamos deshabilitar momentáneamente su antivirus y/o configurarlo
para que no se les considere como amenaza.
• Se requiere java 1.7.0 o superior instalado en su PC para poder ejecutar el
programa. En versiones java OpenJDK (Distribuciones Linux), solo es posible
ejecutar el programa en la versión 8.
• En caso de que la interfaz gráfica de usuario no pueda ejecutarse, podrá optar por
realizar los procesos respectivos a través de la consola de su sistema operativo.
• Completar los campos que requieren rutas específicas adecuadamente, tal como
se explica en los pasos (según el tipo de proceso) a detalle.
• Contar con conexión a internet; adicionalmente considerar que el tiempo que
tomará realizar los procesos respectivos dependerá gran parte de este punto.
• Cuando se actualiza el programa POS (Actualizar POS) se crea una carpeta
“Backup” dentro del directorio, la cual contendrá los archivos necesarios para que,
en caso se necesite, revertir la actualización (volver a la versión anterior).
• No se podrá revertir el programa POS (Restaurar POS) si no se ha actualizado
(con el mismo programa: Instalador POS) previamente.

• Si el JAVA 7 que tiene instalado (usa el módulo POS) es inferior al java

versión_u162, deberán de actualizar las políticas de seguridad de JAVA para que
el servicio funcione correctamente:
https://drive.google.com/drive/folders/166vbXt9EBRqKOmbZ_UMhz3G-4ATA_wfz
Para de verificar la versión con la cual está funcionando el POS, puede ingresar al
archivo “installService.bat”, en la cual se encuentra registrado la versión de JAVA
que el servicio esta utilizado

2|P ágin a
 USUARIOS CON JAVA OPEN JDK (Versión 8) - LINUX

El siguiente apartado cuenta con una serie de pasos a seguir, previos a la ejecución del
programa con GUI. Destacar que, estos solo deben seguirse en caso de que su equipo
cuente con la versión Open JDK 8 y su sistema operativo sea una distribución de
Linux.
Los pasos que se presentan a continuación son, básicamente, para la instalación de
JavaFX. Librería necesaria para ejecutar la GUI de programas java de escritorio.

• Abrir la terminal/consola de su sistema operativo

• Ejecutar el siguiente comando (pegarlo en consola y presionar “Enter”):
o sudo apt purge openjfx
• Ejecutar el siguiente comando (pegarlo en consola y presionar “Enter”):
o sudo apt install openjfx=8u161-b12-1ubuntu2 libopenjfx-jni=8u161-
b12-1ubuntu2 libopenjfx-java=8u161-b12-1ubuntu2
• Ejecutar el siguiente comando (pegarlo en consola y presionar “Enter”):
o sudo apt-mark hold openjfx libopenjfx-jni libopenjfx-java

De tener problemas con la instalación de la librería en mención, y contar con una version de
LinuxUbuntu superior a 18.04, seguir los siguientes pasos especificados en el documento:
https://drive.google.com/file/d/1RcUhWV-QGHha_RicDyk6aSvcx-j1eKwV/view?usp=sharing

3|P ágin a
 EJECUCIÓN DEL PROGRAMA

1. Dirigirse a la ruta donde descargó en archivo ZIP “POS_service-1.0” y descomprimirlo,

como resultado tendrá lo siguiente:

2. Sistema operativo: Windows

• Puede optar por usar uno u otro ejecutable:

o POS_service.exe : Solo debe dar doble click sobre el ejecutable para iniciar y
continuar con “Manejo del programa / paso a paso (GUI)”.

o POS_service.jar :

1. Abrir la consola (CMD) con permisos de administrador

2.

3. Ejecutar el siguiente comando (pegarlo en consola y presionar “Enter”):

• cd (ruta donde está ubicado el jar)
• En este caso sería: cd C:\Users\SoporteEfact\Download\POS

4. Ejecutar el siguiente comando (pegarlo en consola y presionar “Enter”):

• java -jar POS_service.jar

5. Continuar con “Manejo del programa / paso a paso (GUI)”

4|P ágin a
2. Sistema operativo: Linux

• Solo puede ejecutar el archivo jar:

o POS_service.jar :
1. Abrir la terminal desde la ubicación del jar

2. Ejecutar el siguiente comando (pegarlo en terminal y presionar “Enter”):

• java -jar POS_service.jar

3. Continuar con “Manejo del programa / paso a paso (GUI)”

o POS_service_OnlyTerminal.jar :
1. Abrir la terminal desde la ubicación del jar

2. Ejecutar el siguiente comando (pegarlo en terminal y presionar “Enter”):

• java -jar POS_service_OnlyTerminal.jar

3. Continuar con “Manejo del programa / paso a paso (POR CONSOLA)”

5|P ágin a
 MANEJO DEL PROGRAMA / PASO A PASO (GUI)

En esta ventana se debe seleccionar el

idioma:
• English
• Spanish

2
En esta ventana debe seleccionar qué
proceso desea realizar:
• Instalar POS: Instalar el programa
en su equipo.
• Actualizar POS: Realizar una
actualización del programa.
• Restaurar POS: Revertir una
actualización realizada previamente.

6|P ágin a
Instalación (Install POS)

A
3 • Seleccionar la ruta donde se desea descargar/instalar el
programa.

B
• El java instalado debe contar con una versión igual o superior
a 1.7.0.
A
• Distro Linux: Seleccionar la ruta de Java instalado (directorio
raíz).
• S.O Windows: Seleccionar la ruta de Java instalado (jvm.dll).
B o En S.O Windows el java instalado debe ser la versión
de 32 bits

C • Seleccionar el nombre personalizado que tendrá el programa

(directorio)
• En S.O Windows se aplica que, el nombre del programa será
igual al nombre del servicio.

D
D
• Seleccionar el tipo de archivo que maneja
• Si selecciona CSV: Debe seleccionar el tipo de separador
que emplea para estructurar sus documentos.

E E
• Seleccionar los parámetros que desea aplicar:
o Txt digest value : Código de barras como archivo TXT
o Txt barCode : Código de barras como archivo PNG

F
F

• Seleccionar esta opción para aplicar los

cambios necesarios en función a las nuevas
exigencias actualmente vigentes, de SUNAT

En cuanto al campo B , es sumamente importante seleccionar

correctamente la ruta del directorio/archivo java indicado:
▪ Distro Linux: Directorio raíz de java (por convención “JAVA_HOME”).
▪ Windows: Archivo “jvm.dll”.

7|P ágin a
 4

• En esta ventana debe leer

detenidamente los términos y
condiciones que acepta al instalar
el programa en su equipo.
• Si está conforme, seleccionar la
opción “Acepto los términos y
condiciones”.
• Presionar el botón “Posterior”
para proceder con el inicio de los
procesos de descarga e
instalación del programa

5
2 • En esta ventana se le informará
qué procesos se están realizando.
• Debe esperar a que los procesos
culminen (barra completa).
• Una vez que los procesos
culminen se mostrará un mensaje
de finalización que indica que se
ha instalado satisfactoriamente el
programa en su equipo.

6
2

• Esta ventana le informará que

la instalación concluyo
satisfactoriamente.

8|P ágin a
 Actualización (Update POS)

o Asegúrese de mover el ejecutable dentro de

la carpeta del programa POS que desea actualizar

• Seleccionar el tipo de archivo que maneja

3
• Si selecciona CSV: Debe seleccionar el tipo
de separador que emplea para estructurar
sus documentos.

B
A
• Seleccionar los parámetros que desea aplicar:
o Solución de errores:
Actualiza la estructura a nivel de código
(corrigiendo errores presentados).
o Transformador de archivos:
Actualiza los archivos necesarios para
B transformar correctamente su archivo CSV;
destacar que, estos dependen de la
validación de campos que SUNAT requiera.

C C
• Seleccionar esta opción para aplicar los
cambios necesarios en función a las nuevas
exigencias actualmente vigentes, de SUNAT

3.1

• Si se escoge un separador diferente al

instalado previamente, se mostrará esta
ventana para la confirmación de la
elección.

9|P ágin a
4

• En esta ventana debe leer

detenidamente los términos y
condiciones que acepta al
actualizar el programa en su
equipo.
• Si está conforme, seleccionar la
opción “Acepto los términos y
condiciones”.
• Presionar el botón “Posterior”
para proceder con el inicio de los
procesos de descarga e
instalación del programa
•

5
• En esta ventana se le informará
qué procesos se están realizando.
• Debe esperar a que los procesos
culminen (barra completa).
• Una vez que los procesos
culminen se mostrará un mensaje
de finalización que indica que se
ha actualizado satisfactoriamente
el programa en su equipo.

10 | P á g i n a
6 6

• Esta ventana le informará que • Esta ventana le informará que

la actualización concluyo se descargó con anterioridad la
satisfactoriamente. última versión, por lo cual no se
actualizó el servicio.

11 | P á g i n a
Reversión (Rollback POS)

o Asegúrese de mover el ejecutable dentro de

la carpeta del programa POS que desea actualizar

• Seleccionar los parámetros que desea

aplicar:
o Solucion de errores:
Recupera los archivos con extensión “.jar”
A de la versión anterior instalada
o Transformador de archivos:
Recupera la carpeta “src” de la versión
anterior instalada.

3.1

• Si en la carpeta “Backup” se encuentra

una misma versión con distintos
separadores, se le solicitará indicar qué
versión desea recuperar

12 | P á g i n a
4
4

• En esta ventana debe leer

detenidamente los términos y
condiciones que acepta al
restaurar el programa en su
equipo.
• Si está conforme, seleccionar la
opción “Acepto los términos y
condiciones”.
• Presionar el botón “Posterior”
para proceder con el inicio de los
procesos de descarga e
instalación del programa
•

5
• En esta ventana se le informará
qué procesos se están realizando.
• Debe esperar a que los procesos
culminen (barra completa).
• Una vez que los procesos
culminen se mostrará un mensaje
de finalización que indica que se
ha revertido satisfactoriamente el
programa en su equipo.

13 | P á g i n a
6 6

• Esta ventana le informará que • Esta ventana le informará que no se

la restauración concluyo encontró una versión anterior en la
satisfactoriamente. carpeta Backup, por lo cual no se
restauró el servicio.

14 | P á g i n a
 MANEJO DEL PROGRAMA / PASO A PASO (POR
CONSOLA)
• Asegúrese de mover el JAR en la ruta especificada:
o Instalación: Moverlo a donde desea instalar el programa
o Actualización: Moverlo dentro de la carpeta del programa POS que desea actualizar
o Restauración: Moverlo dentro de la carpeta del programa POS que desea restaurar

• Tras la ejecución de “POS_service.jar” se le consultara el lenguaje.

Deberá digitar S para Español, E para Ingles.

• Luego deberá indicar el proceso que desea realizar:

o Instalar POS: Digitar “1” y presionar “Enter”
▪ Instalar el programa en su equipo.
o Actualizar POS: Digitar “2” y presionar “Enter”
▪ Realizar una actualización del programa.
o Restaurar POS: Digitar “3” y presionar “Enter”
▪ Revertir una actualización realizada previamente.

15 | P á g i n a
 Instalación (Instalar POS)

PASO N° 1:

• El java instalado debe contar con una

versión igual o superior a 1.7.0.
• Distro Linux: Seleccionar la ruta de Java
instalado (directorio raíz).
• S.O Windows: Seleccionar la ruta de
Java instalado (jvm.dll).
o En S.O Windows el java instalado
debe ser la versión de 32 bits

Recuerde que este campo es sumamente importante indicar

correctamente la ruta del directorio/archivo java indicado:
▪ Distro Linux: Directorio raíz de java (por convención
“JAVA_HOME”).
▪ Windows: Archivo “jvm.dll”.

PASO N° 2:

• Indique el tipo de archivos que manejan:

o CSV: Digitar “1” y presionar “Enter”
o XML: Digitar “2” y presionar “Enter”
o JSON: Digitar “3” y presionar “Enter”

PASO N° 2.1: Si indicó ‘Tipo de archivos CSV’

• Indique el tipo de separador que utilizan para

estructurar sus documentos CSV:
o Coma: Digitar “c” y presionar “Enter”
o Palote/Barra vertical: Digitar “p” y
presionar “Enter”

16 | P á g i n a
PASO N° 3:

• Digite el nombre personalizado que tendrá el

programa (directorio) y luego presione “Enter”
• En S.O Windows se aplica que, el nombre del
programa sea igual al nombre del servicio.

PASO N° 4:

• Indique si desea aplicar el siguiente parámetro

“Txt digest value”:
o Sí: Digitar “Y” y presionar “Enter”
o No: Digitar “N” y presionar “Enter”

PASO N° 5:

• Indique si desea aplicar el siguiente parámetro

“Txt barCode”:
o Sí: Digitar “Y” y presionar “Enter”
o No: Digitar “N” y presionar “Enter”

PASO N° 6:

• Tras haber indicado los parámetros anteriores,

el proceso de instalación comenzará y, le
informará de los procesos en ejecución y al
culminar estos.

17 | P á g i n a
 Actualización (Update POS)

PASO N° 1:

• Indique el tipo de archivos que manejan:

o CSV: Digitar “1” y presionar “Enter”
o XML: Digitar “2” y presionar “Enter”
o JSON: Digitar “3” y presionar “Enter”

PASO N° 1.1: Si indicó ‘Tipo de archivos CSV’

• Indique el tipo de separador que utilizan

para estructurar sus documentos CSV:
o Coma: Digitar “c” y presionar “Enter”
o Palote/Barra vertical: Digitar “p” y
presionar “Enter”

PASO N° 1.1.1: Tipo de separador diferente

Si en el paso anterior (1.1) indicó un tipo de separador

diferente al que tiene configurado actualmente en su programa
POS, le aparecerá el mensaje mostrado.
o Para continuar:
Digitar “Y” y presionar “Enter”
o Para volver a elegir otro separador:
Digitar “N” y presionar “Enter”

18 | P á g i n a
PASO N° 2:

• Indique si desea aplicar el siguiente parámetro

“Bug updates”: Actualiza la estructura a nivel
de código (corrigiendo errores presentados).
o Sí: Digitar “Y” y presionar “Enter”
o No: Digitar “N” y presionar “Enter”

PASO N° 3:

• Indique si desea aplicar el siguiente parámetro

“File transformer”: Actualiza los archivos
necesarios para transformar correctamente su
archivo CSV; destacar que, estos dependen de
la validación de campos que SUNAT requiera.
o Sí: Digitar “Y” y presionar “Enter”
o No: Digitar “N” y presionar “Enter”

PASO N° 4:

• Tras haber indicado los parámetros anteriores, el

proceso de instalación comenzará y, le informará
de los procesos en ejecución y al culminar estos.

19 | P á g i n a
 Reversión (Rollback POS)

PASO N° 1:

• Indique si desea aplicar el siguiente parámetro

“Bug updates”: Recupera los archivos con
extensión “.jar” de la versión anterior instalada.
o Sí: Digitar “Y” y presionar “Enter”
o No: Digitar “N” y presionar “Enter”

PASO N° 2:

• Indique si desea aplicar el siguiente

parámetro “File transformer”: Recupera la
carpeta “src” de la versión anterior instalada.
o Sí: Digitar “Y” y presionar “Enter”
o No: Digitar “N” y presionar “Enter”

PASO N° 2.1: Si cuenta con más de una versión

con diferente separador

• Si en la carpeta “Backup” se encuentra una

misma versión con distintos separadores, se le
solicitará indicar qué versión desea recuperar:
o Coma: Digitar “c” y presionar “Enter”
o Palote/Barra vertical: Digitar “p” y
presionar “Enter”

20 | P á g i n a
PASO N° 3:

• Tras haber indicado los parámetros anteriores,

el proceso de instalación comenzará y, le
informará de los procesos en ejecución y al
culminar estos.

21 | P á g i n a