Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Estándar:
Manual de Usuario de las aplicaciones VAN.
1. OBJETIVO
2. ALCANCE
3. ABREVIATURAS
Para utilizar los servicios de la VAN los usuarios (Auxiliares de la Función Pública,
entidades gubernamentales entre otros) deben cumplir los siguientes requisitos.
· Presentar copia del Certificado emitido por parte del Ministerio de Hacienda del
software utilizado para la generación de mensajes, al Departamento de
Registro con la finalidad de activar los derechos de transmisión y asignar el
casillero correspondiente.
· Conexión a Internet, la aplicación debe tener libre acceso al Web service de los
servidores del Tica, cuya dirección es
https://www.hacienda.go.cr/vanlistenerz/listener.asmx . Por los puertos 80:80
y 443.
http://www.hacienda.go.cr/Msib21/Espanol/TICA/tc_Manuales+VAN.htm
Paso No. 3 Una vez que usted completo el paso anterior usted es un usuario
valido y podrá ver la siguiente ventana y seguir los siguientes pasos para poder
utilizar la VAN
1 : Usuario autenticado
2. Haga click en Utilice
sus servicios.
Paso No. 4. Para poder usar el servicio de la VAN, primeramente debe activar
dicho servicio para ello debe hacer click en el menú de opciones “Utilice sus
servicios”.
Debe aprobarse el
servicio de Van de
Hacienda, marchando
el la lista de chequeo.
Haga click
en Inicio ,
para volver a
la pagina de
Inicio.
Ir al final
de la
pagina
principal
.
Hacer doble
click en el logo
de TICA.
Paso No. 9 En esta pagina se muestran las opcines de la van , debe ingresar a
la opción de Registro para registrarse.
Ingresar a
Registro
Descargar el
verificador.
Paso No. 11 Al hacer click sobre esta opción se desplegara una ventana donde
podrá descargar un instalador.
Click sobre el botón SAVE esto guardara el instalador localmente (en su maquina).
2. Descomprima el archivo
Se debe
seleccionar la
opción de
Registro Van.
2. Click sobre el
botón Firmar.
3. Se desplegara una ventana con todos
los certificados disponibles, debe
seleccionar uno de la lista y click en el
botón Aceptar.
Paso No. 17 Luego de haber realizado dicha operación, el texto será cargado en
el cuadro de texto, como se ve en la siguiente imagen.
Luego de
pegado el
texto hacer
cliek en
validar
Paso No. 20 Después de haber pegado el texto, haga click en el botón Validar, si
las credenciales proporcionadas son correctas se le mostrara la siguiente ventana.
Debe mostrar
· El casillero asignado.
· El usuario para la van
· Los tipos de Archivo permitidos.
Paso No. 21 Después obtenido el usuario que nos va a servir para la transmisión,
procedemos a instalar el cliente de la van 2.3.
Esta instalación se recomienda hacerla con todas las opciones que vienen pre-
configuradas en el paquete de instalación.
http://www.hacienda.go.cr/Msib21/Espanol/TICA/tc_VAN.htm
6- Configuración de la VAN.
Paso No. 1 .Cuando se instala la aplicación VAN se crea un acceso directo para
crear la estructura de directorios. El usuario deberá crear los directorios
Paso No. 1 .El instalador de la VAN crea el acceso directo: Cliente, VAN, Pki del
Ministerio de Hacienda,
Paso No. 2 El Usuario deberá proceder activarlo realizando los siguientes pasos:
ir a la opción inicio, seleccionar todos los programas y seleccionar Cliente, VAN,
Pki del Ministerio de Hacienda con esto se inicializar la aplicación.
Paso No. 5 El usuario debe activar la opción Ver log de eventos, y le aparece la
siguiente pantalla.
Paso No. 8. El usuario debe seleccionar la opción Cambiar y aparece una nueva
ventana con los Certificados Activados en el Token .
La configuración del certificado lo deberá hacer una vez; ya que esto quedara
guardado internamente en la aplicación y al iniciarla ella usara estos valores
predefinidos. Si se requiere firmar con otro usuario, se deberá seleccionar el otro
certificado que viene en el token; el cual será ahora el nuevo activado.
El usuario deberá realizar los siguientes pasos para la configuración del cliente de
la VAN.
Paso No. 1 seleccione la pestaña Cliente VAN y verifique el tipo de conexión que
esta usando para conectarse con el TICA
Ejemplo:
1) La aplicación del cliente pone los archivos a enviar en el directorio Out del
módulo correspondiente, desde donde el cliente lo detecta y procederá a firmarlo.
El cliente en el log nos indica que hay archivos por firmar y pide el Password de el
Token .
Una vez introducido el Password la aplicación firma los archivos y los pasa a la
carpeta OUT-SIGNATURE del módulo en donde empieza el proceso de envío ,
primero registrando el archivo y luego enviándolo.
Una vez que el archivo se ha enviado la aplicación nos indica que el archivo
XXXX.XXX se ha enviado correctamente.
Esto nos asegura el envío del archivo al tica, y nos queda esperar la respuesta del
tica.
RECEPCION DE RESPUESTA
Para la recepción de una respuesta es suficiente con que el cliente este abierto y
el proceso automáticamente detectará si hay respuestas pendientes en nuestro
casillero e intentará descargarlas, luego de descargarlas correctamente y verificar
la firma de las mismas se depositarán en la carpeta IN del modulo
correspondiente.
Errores Comunes
• Situación 1:
– Errores enviando los diversos tipos de archivo.
• Solución:
· Se debe recordar que para cada tipo de archivo según sea el proceso
que se realice en el TIC@ , existe un modulo , que los archivos se
deben enviar desde la carpeta OUT , de ese modulo , desde allí se
tomará se firmará y se pondrá en la carpeta OUT-SIGNATURE , desde
ahí se enviarán por medio de la van hacia el TIC@ , se debe revisar que
los archivos desaparezcan de esta carpeta y la en el Log de eventos del
cliente de van aparezca el mensaje :
“El archivo C:\TIC@\CG\OUT_SIGNATURE\0001-
ARCHIVO04_EML.CG se ha enviado correctamente”;
· Todo archivo enviado al TIC@ debe cumplir con el estándar, antes del
nombre del archivo debe tener el prefijo “0001-“Esto le dice a la VAN
que el archivo debe entregarse al TIC@, si no contiene este prefijo el
archivo nunca será enviado.
· Los archivos de imágenes además del prefijo deberán contener el
numero de cedula de la empresa y cumplir con Standard de resolución
establecido por ejemplo :
0001-J310105646545618DJUML80042005_EML.TIF
• Situación 2:
Error Registrando Archivo.
• Solución:
Se debe verificar las comunicaciones de la empresa ya que esto nos indica
que no se esta viendo el Web Service del TIC@
https://www.hacienda.go.cr/vanlistenerz/listener.asmx .. Utilizando los
puertos 80 y 443.
El cliente de Van del TIC@ , debe poder acceder directamente este Web
service , sin embargo si la conexión a Internet es compartida para ello se
requiere de un ISA Server o un Proxy Server, estos podrían estar
bloqueando el acceso del cliente al sitio de hacienda , también los pixs,
firewall, antivirus, zone alarm , entre otros podrían bloquear este acceso .
Debido a la gran diversidad de topologías existentes esto debe ser revisado
por el personal especializado que da mantenimiento a la red de la empresa
en cuestión.
En la versión 2.1 del cliente del pki, se ubicó un botón cuya funcionalidad es
probar la conexión, esta mediante un mensaje nos dirá si existe
comunicación con el Web Service o si el usuario es incorrecto, entre otras
cosas.
• Situación 3:
Error obteniendo archivos pendientes de descarga. Error = Error de
la solicitud con el código de estado HTTP 401: Unauthorized..
• Solución:
– Este error nos indica que el usuario no esta autorizado, debe
chequearse el usuario , esto puede hacerse ingresando desde el
Internet Explorer a la dirección
http://www.hacienda.go.cr/vanlistener/listener.asmx; ahí se debe
digitar en la primera ventana el dominio seguido del usuario
(HDAINET\USR_xxxxxxxxxxxxxxx), en la segunda ventana el
password . Si ambos están bien entonces se debe mostrar la página
del Web service si no, No estará disponible.
• Situación 4:
Error Registrando Archivo.
– Error obteniendo archivos pendientes de descarga. Error = Error de
la solicitud con el código de estado HTTP 401: Unauthorized..
• Solución:
Este Error se genera a partir de que la aplicación no puede ver
el Web service y a la vez no se puede loguear o descargar los
archivos pendientes , Se debe verificar las comunicaciones de
la empresa ya que esto nos indica que no se esta viendo el
Web Service del TIC@
https://www.hacienda.go.cr/vanlistenerz/listener.asmx
El cliente de Van del TIC@ , debe poder acceder directamente este Web
service , sin embargo si la conexión a Internet es compartida para ello se
requiere de un ISA Server o un Proxy Server, estos podrían estar
bloqueando el acceso del cliente al sitio de hacienda , también los pixs,
firewall, antivirus, zone alarm , entre otros podrían bloquear este acceso .
Debido a la gran diversidad de topologías existentes esto debe ser revisado
por el personal especializado que da mantenimiento a la red de la empresa
en cuestión.
En la versión 2.1 del cliente del pki, se ubicó un botón cuya funcionalidad es
probar la conexión, esta mediante un mensaje nos dirá si existe
comunicación con el Web Service o si el usuario es incorrecto, entre otras
cosas.
• Situación 5:
No se reciben respuestas por parte del TIC@.
• Solución:
Este Error puede tener varias causas, sin embargo debemos
asegurarnos de;
1. Que el archivo se haya enviado al TIC@, se debe ver en el Log
de eventos en el listado de envíos (V2.1), el mensaje “El archivo
C:\TIC@\CG\OUT_SIGNATURE\0001-ARCHIVO04_EML.CG se
ha enviado correctamente”; También el archivo debe haber
desaparecido de la carpeta OUT-SIGNATURE del modulo
correspondiente.
2. Que las respuestas no se estén descargando y hayan pasado
desapercibidas, debemos revisar la carpeta IN del modulo
correspondiente, y asegurarnos que la respuesta no hay llegado.
3. Que otro funcionario de nuestra propia empresa no haya
descargado las respuestas, En el TIC@ existe un único casillero
por empresa esto implica que si hay dos usuarios conectados a
la VAN, ambos están viendo el mismo casillero y si hay una
respuesta pendiente de descarga, esta será descargada por el
primer usuario que se apodere de esta, aunque este no sea
quien envío el mensaje original y este en una ubicación distinta.
4. Que las respuestas estén llegando a otro casillero , esto se
produce cuando dentro del XML, se ha escrito otro casillero de
respuesta que no es el que nos corresponde , entonces la
respuesta se dirigirá automáticamente a otro casillero del TIC@.
5. Caída en las comunicaciones, esto podría impedir la recepción
de respuestas, no precisamente estas tienen que estar
totalmente caídas, sino pueden estar funcionando con un muy
bajo rendimiento el cual no permite la descarga correcta de los
archivos, hasta que esta se restablezca o muestre un pico alto.
(Esto sucede especialmente a los usuarios de conexiones
conmutadas de baja velocidad).
Si se han verificado estos cinco puntos y no se reciben respuestas,
entonces debemos comunicarnos al callcenter del Ministerio de
hacienda y poner un incidente, para que el caso sea revisado por los
encargados.
Se adicionó al cliente normal una casilla de chequeo que habilita el usar la van
alterna, esto deshabilita la van automática y pasamos al modo manual.
Al activar esta cuadro de chequeo, nos desaparecen las pestañas que
corresponden a la van automática.
Luego ingresamos a la van alterna con el botón que indica van alterna.
Archivos pendientes
de envío en este
directorio
Paso 1:
Paso 2:
Se debe dar click en el botón “Preparar paquete para el envío” , esto nos creará un
paquete de envío que será el que enviemos al portal, este paquete contiene todos
los archivos que seleccionamos.
Ingresar
Seleccionar esta
opción.
Debemos hacer click en el botón examinar y nos aparecerá una ventana del
explorador de Windows donde debemos buscar la ruta
“C:\Tica\VANALTERNA\Para enviar al Portal\” y seleccionar el paquete que
creamos anteriormente para enviarlo al portal.
En el ejemplo nos muestra que el paquete contenía dos archivos y el status para
cada uno de ellos, en este caso nos dice que ambos fueron cargados
exitosamente, si existiera algún error en uno de ellos nos indicaría cual es el error.
Paso 1
Paso 2
Esta nos dice que el proceso fue exitoso, que si deseamos eliminar el paquete
original, (Si elegimos sí se elimina el paquete; pero los archivos ya están en sus
respectivos módulos donde se guardan las respuestas.)