PSDelivery
 Release status: estable | |
|---|---|
|
Implementación |
Aplicación residente |
|
Descripción |
App de comunicaciones |
|
Autor(es) |
Patricia Arrambide (original), - Marcos Ricco (mantenimiento) - Francisco Louzan (Mantenimiento) |
|
Ultima Versión |
3.8.13 (2016-03-03) (Win) Sitel Cliente versionado |
|
Licencia |
No necesita licencia |
|
Download |
PSDelivery Instalador Completo |
Sumario
PSDelivery Cliente
PSDelivery es la pieza de software que permite comunicarse ya sea con un Servidor Berkana o a un Servidor GEBO para enviar la transacción que se desea validar y permite recibir la respuesta de validación en el momento. La función de PSDelivery Cliente es encriptar los archivos y establecer la comunicación que se monta sobre TCP/IP por Internet.
PSDelivery
Funcionamiento
El Cliente PSDelivery escucha permanentemente en un directorio o carpeta (Directorio de trabajo), en el cual la aplicación de carga de datos dejará los archivos que se envían para ser validados. Una vez que los archivos son enviados al Financiador, el Cliente PSDelivery se queda a la espera de una respuesta, la cual, al momento de llegar, es entregada a la aplicación del prestador y la muestra y/o imprime.
IPs y Puertos
La comunicación con el validador la realiza el Cliente PSDelivery por Internet e intentará conectarse con:
IP 200.47.62.201 (data center)
IP 190.15.198.197 (data center de contingencia)
Y los puertos:
TCP 8315 u 8316
El uso de los puertos es solo saliente, por lo que no es necesario que el firewall tenga abierto ningún puerto entrante.
Configuración
La configuración de PSDelivery es mediante el archivo config.json, el cual tiene el siguiente formato:
Ejemplo de config.json:
{"intercambio":"C:\\estandar\\tx","empresas":[{"codigo":"36","cuit":"30550194283","nombre":"ServeSalud - OS Personal de Direc. Ind. Cervecera y Maltera"},{"codigo":"26","cuit":"30654855168","nombre":"SWISS Medical S.A."},{"codigo":"11","cuit":"30546741253","nombre":"OSDE"}],"url":"https:\/\/psd.cloud.itcsoluciones.ar\/psdeliveryrest\/do","licencias":["CPKCP8K0","PRUEBA00"]}
Detalle de Configuración (config.json)
La configuración de PSDelivery, en comparación con la de su antecesor Sitel Cliente, es "libre" en cuanto a los parámetros de Empresa y/o Actividad, como así también de URL/IP y su respectivo Puerto, ya que se pueden modificar manualmente los parámetros con los que deseamos trabajar.
intercambio: corresponde al "Directorio de Trabajo", es decir, donde se crearán los directorios "Terminales", lugar donde la aplicación de carga de datos dejará los archivos pertenecientes a la Transacción. Desde ese directorio, PSDelivery tomará los archivos y en ese mismo directorio es donde dejará la respuesta. Siempre se debe posicionar en el directorio que contiene a los subdirectorios TermXX o termXX. Si la unidad donde se encuentra esta estructura de directorios es un servidor de red, se deberá seleccionar la misma. Opera con la metodología "TX", la que permite un manejo más ágil en instalaciones donde hay muchas terminales. Con esta metodología, en lugar de crear una carpeta fija para cada terminal de trabajo, es posible crear terminales con nombres aleatorios, indicar en el directorio TX el nombre de la terminal creada y destruir la terminal aleatoria al terminal. De esta manera no hay que mantener un árbol de terminales.
empresas: en este campo se agregan los datos de las empresa que se utilizarán. Como se ve en el ejemplo, los datos de cada Empresa van entre "llaves" y cada dato se separa por "comas". ejemplo: "empresas":[{"codigo":"36","cuit":"30550194283","nombre":"ServeSalud"},{"codigo":"26","cuit":"30654855168","nombre":"SWISS"},{"codigo":"11","cuit":"30546741253","nombre":"OSDE"}]
url: en este campo se coloca la URL/IP a la que se apunta la transacción.
licencias: aquí se colocan la o las Licencias que se deseen, según el lugar de atención (Usuario) requiera.
Archivo de LOG
El archivo de log de PSDelivery es psdelivery.log y se encuentra dentro del directorio de la Aplicación.
Iniciar PSDelivery
Para poner en ejecución a PSDelivery, debemos correr el script "psdelivery.sh", que se encuentra en el directorio de la Aplicación. De esta manera, se levanta con los parámetros configurados previamente en "config.json" y deja su log en "psdelivery.log".
Hacer una transacción con PSDelivery
Para realizar una Transacción utilizando PSDelivery, se debe colocar el set de archivos en el directorio "upload" de una determinada Terminal y luego el archivo cuyo nombre se corresponde con el de la Terminal en cuestión, en el Directorio "tx". Esto es el "método TX".
Transacción copiando un archivo:
- Crear los archivos _svl.0 y cualquier otro que requiera el formato y copiarlos en un directorio upload por ejemplo /home/operador/terms/termZy3UiD/upload/
- Crear un archivo llamado termZy3UiD (para el ejemplo) y lo copia en el directorio tx, para el ejemplo, /home/operador/terms/tx/
- Poolea el directorio /home/operador/terms/termZy3UiD/ hasta encontrar el archivo estado.rsp (que indicará el resultado de la transacción a nivel de comunicación).
- Aplicación procesa la respuesta del directorio download y elimina los archivos estado.rsp y existentes en el directorio download
La estructura de directorio tiene que tener la siguiente forma:
sitel-+--tx | +--term01 | | | +--upload | +--download | +--term02 | | | +--upload | +--download ...
Supongamos que esta estructura se encuentra en /var/samba/sitel. Los directorios de las terminales y sus carpetas pueden crearse dinámicamente, es decir, ser creados y destruidos en cada transacción por la aplicación cliente (esto evita tener que hacer un mantenimiento del mismo generando un directorio para cada terminal). El mecanismo para hacer una transacción es el siguiente:
- La aplicación cliente crea los archivos propios de la transacción en el directorio de "upload" correspondiente a la terminal. Por ejemplo:
/var/samba/sitel/term01/upload/_svl.1
/var/samba/sitel/term01/upload/_svl.2 - La aplicación cliente crea el archivo _svl.0 en el directorio de "upload" correspondiente a la terminal. Por ejemplo:
/var/samba/sitel/term01/upload/_svl.0 - La aplicación cliente dispara la transacción creando en el directorio tx un archivo (no importa su contenido, puede estar vacío) cuyo nombre sea el nombre del directorio de la terminal. En este ejemplo:
/var/samba/sitel/tx/term01 - La aplicación cliente espera el resultado de la transacción, esperando a que aparezca el archivo estado.rsp en el directorio de la terminal. Por ejemplo:
/var/samba/sitel/term01/estado.rsp - Cuando aparezca el archivo estado.rsp la transacción ha finalizado. Los archivos de respuesta (en caso de haber sido exitosa la comunicación) estarán en el directorio de "download" correspondiente a la terminal. Por ejemplo: /var/samba/sitel/term01/download/.
Para más detalles sobre la espera del archivo estado.rsp y la forma de interpretar el contenido del archivo estado.rsp consultar aquí.
Bajar PSDelivery
- PSDelivery.zip Contenedor de PSDelivery
