Manual de usuario del sistema. Formato de los ficheros de envío y

PROYECTO TIRANT
INDET
Ayuda sobre el servicio
telemático para la solicitud de
información de deudas
tributarias con la Generalitat
Valenciana.
PROYECTO TIRANT
INDET
INDICE
1
INTRODUCCIÓN........................................................................................................................................ 3
2
REQUISITOS ............................................................................................................................................... 4
3
ENVÍO DE PETICIONES........................................................................................................................... 5
4
CONSULTA Y RECEPCIÓN DE RESULTADOS................................................................................... 8
ANEXO I: FORMATO DE LOS FICHEROS ................................................................................................. 11
DISEÑO DEL REGISTRO DEL FICHERO DE PETICIÓN DE INFORMACIÓN.................................................................. 11
FORMATO DEL FICHERO DE ENTRADA UNA VEZ REGISTRADO............................................................................. 11
DISEÑO DEL FICHERO DE RECEPCIÓN DEL RESULTADO ....................................................................................... 13
EJEMPLOS .......................................................................................................................................................... 15
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 2
PROYECTO TIRANT
INDET
1 INTRODUCCIÓN
Periódicamente, varios organismos públicos necesitan conocer la situación de
determinados contribuyentes respectos a sus deudas tributarias con la GVA. Este servicio
presente aportar un mecanismo que permita obtener esta información de manera telemática.
Para ello, el usuario designado por el organismo, que previamente habrá obtenido las
autorizaciones pertinentes, enviará, a través de una pagina web, un fichero donde se indicarán
los contribuyentes de los cuales se desea información y el sistema de “Solicitud de
información de deudas tributarias de la GVA”, devolverá otro fichero con el resultado.
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 3
PROYECTO TIRANT
INDET
2 REQUISITOS
Para la utilización de este servicio es requisito imprescindible haber realizado los trámites
necesarios para obtener autorización de la Dirección General de Tributos. Para conocer el
procedimiento de autorización véase AYUDA en la misma página web en la que se ha
obtenido este manual.
Pueden testearse y consultarse los requisitos para acceso a la aplicación desde el submenú del
csi de la aplicación, opción “Software de Descarga. Requisitos”
Además, el usuario debe disponer de Certificado Digital de Firma Electrónica expedido por la
GVA. Para obtenerlo, debe solicitarlo en el correspondiente servicio de su conselleria.
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 4
PROYECTO TIRANT
INDET
3 ENVÍO DE PETICIONES
El envío de peticiones se realiza mediante un fichero de texto (ver ANEXO I), donde se
almacenan todos los contribuyentes de los cuales se desea obtener su situación respecto a sus
deudas tributarias con la GVA. El envío será tratado de modo desasistido por el sistema y se
generará un fichero de respuestas.
Para el correcto envío de las peticiones es conveniente seguir las instrucciones
detalladamente.
En este escenario, el usuario dispone de certificado FEA-GVA para acceso al sistema.
Una vez situados en el portal funcionarial, se seleccionará la opción “Aplicaciones Corporativas”,
aplicación INDET (Información de Deudas Tributarias).
Una vez situados en el menú en el que hemos encontrado este manual, debemos tener
accesible o localizado el Certificado Electrónico contra el que se ha expedido la acreditación.
El primer paso para poder enviar peticiones es identificarse como usuario del sistema
mediante certificado FEA-GVA
Para ello, una vez situados en la pantalla correspondiente a la aplicación, seleccionaremos la
opción de “Acceso” del submenú inferior correspondiente al csi (el submenú superior se
corresponde con el de la Autoridad Funcional), que nos dará acceso a la pantalla de validación
de usuario.
En este punto, dado que el acceso solo va a ser posible a través de certificado, se
deberá pulsar el botón de “Certificado” y, se accederá a la pantalla de acceso con certificado.
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 5
PROYECTO TIRANT
INDET
Aquí se debe seleccionar donde se tiene almacenado el certificado. Existen dos
posibilidades, Tarjeta o Fichero. En caso de tener el certificado en una tarjeta electrónica hay
que seleccionar el tipo de certificado “Tarjeta”, en caso de tenerlo almacenado en otro
dispositivo (disquete, disco duro, usb...), se deberá seleccionar “Fichero”. Si se selecciona
esta opción, se activará el botón
que permitirá explorar las unidades de
almacenamiento del ordenador y determinar donde se encuentra el certificado. En cualquiera
de los dos casos, una vez el sistema identifique donde está el certificado, se deberá introducir
1
el pin o contraseña del certificado seleccionado y pulsar el botón
Una vez identificado en el sistema, aparecerá un nuevo menú, donde se puede
seleccionar las siguientes opciones:
Envió de ficheros
Consulta/descarga de envíos
Cerrar sesión
La opción “Envío de ficheros”, es la que permitirá enviar un fichero con las
solicitudes de información de deudas tributarias con la GVA. (Ver formato de fichero en
ANEXO I).
1
La utilización del sistema de autenticación por certificado digital puede originar que sea
necesario que el navegador descargue algunas librerías de código adicionales. Esto se hará de
forma automática solicitando conformidad del usuario.
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 6
PROYECTO TIRANT
INDET
En el desplegable “Tipo de fichero”, se deberá elegir el tipo de fichero que se va a enviar. Los
tipos de fichero que se ofrecen son aquellos a los que el usuario está autorizado. En este caso,
se deberá seleccionar el tipo “Información de deudas tribut.”. En la casilla etiquetada con la
palabra “Fichero”, se deberá indicar el nombre y ruta del fichero que se desea enviar. Se puede
utilizar el botón
para buscar el fichero en el disco.
La tercera casilla, etiquetada con “Descripción” es de libre uso y su finalidad es la de que el
usuario pueda escribir un texto asociado al fichero que va a enviar que le proporcione
información adicional para su mejor identificación en posteriores consultas.
Solo queda seleccionar el tipo y el certificado electrónico con el que se desea sea firmada el
fichero de solicitudes.
Una vez rellenados los campos, hay que pulsar el botón
para su procesado posterior.
y el fichero será enviado
Por último, si el envío ha sido correcto, se le mostrará una pantalla que indica el éxito de la
operación. Dicha pantalla además contendrá datos relativos a la fecha y hora de entrada en
el sistema.
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 7
PROYECTO TIRANT
INDET
4 CONSULTA Y RECEPCIÓN DE RESULTADOS
Una vez realizados los envíos de petición de información, se puede consultar el estado del
envío y, al mismo tiempo, descargar el resultado de la petición. De hecho, el procedimiento
habitual de uso de este servicio será:
Realizar un envío de solicitudes de información
Consultar si el envío ha sido recibido correctamente.
Descargar, si procede, el resultado de fichero enviado junto con los datos del registro
de entrada
Consultar, transcurrido un tiempo prudencial, si el proceso ha concluido.
Descargar el resultado.
Para acceder a esta opción hay que seleccionar “Consulta/Descarga”, del menú que hay a la
izquierda de la pantalla.
La pantalla que aparece presentará una tabla donde se pueden ver los envíos realizados, el
estado en el que están y, por último, permitirá descargar los resultados.
Los datos que aparecen de cada uno de los envíos son los siguientes:
Nombre fichero: Es el nombre que el usuario indicó cuando realizó la operación de
envío.
Descripción: Se corresponde con la descripción que se indicó cuando se realizó el
proceso de envío de peticiones.
Tipo: Indica el tipo y formato del fichero. En el caso del servicio de Información de
Deudas Tributarias, el tipo de fichero será INDET..
Fecha: Indica la fecha y la hora en la que ha sido realizado el envío del fichero de
solicitud de información.
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 8
PROYECTO TIRANT
INDET
Ident: Indica el identificador único del envío.
Estado: Indica el estado en el que se encuentra el fichero. Los valores que pueden
aparecer son:
•
Procesando: Indica que se están realizando todas fases del proceso.
•
Aceptado: Indica que después de realizar todo el proceso el fichero ha sido
aceptado.
•
Rechazado: Indica que después de realizar todo el proceso, el fichero ha sido
rechazado.
Fase: Indica la fase de procesamiento por la que está el fichero. Los valores que puede
tomar son:
•
Recepción: Indica que se ha completado la recepción del fichero en el servidor.
•
Revisión: Indica que se ha validado el formato del fichero enviado.
•
Registro Ent.: Indica que el fichero se ha registrado automáticamente en el registro
de entrada (MASTIN).
•
Envío a Aplic.: Indica que el fichero ha sido remitido a la aplicación interna que
procesará la petición realizada.
•
Generando Resultado: Indica que la aplicación interna está procesando el fichero y
generando el resultado solicitado.
•
Pendt. Registro Sal.: Indica que el resultado está pendiente de registrarse
telemáticamente en el registro de salida (MASTIN).
•
Proceso terminado: Indica que el proceso se ha completado.
Usuario: Indica el usuario que ha solicitado la operación.
Primer
: Esta columna se utiliza para descargar el fichero de entrada junto con los
datos correspondientes al registro de entrada. (Ver formato del fichero en el ANEXO I).
Tomará tres valores diferentes.
•
Sin ningún icono: Indica que los procesos anteriores al registro de entrada, no han
finalizado.
•
: Indica que ha ocurrido un error y en alguna de las fases previas al registro de
entrada. Situando el cursor encima de este icono y haciendo “Clic”, se podrá
visualizar el fichero o descargarlo y almacenarlo en el disco local.
•
: Indica que el fichero ha sido aceptado y registrado de entrada. Situando el
cursor encima de este icono y haciendo “Clic”, se podrá visualizar el fichero o
descargarlo y almacenarlo en el disco local.
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 9
PROYECTO TIRANT
INDET
Segundo
: Esta columna se utiliza para descargar el fichero de resultados. Los
valores que puede tomar son los mismos que los de la columna anterior. El formato del
fichero de resultado (ver ANEXO I), estará formado por una parte donde se incluye el
contenido completo del fichero de solicitudes junto con él su correspondiente registro de
entrada, una segunda parte donde se indican los datos del registro de salida y por último
una tercera parte donde se incluye el resultado del proceso.
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 10
PROYECTO TIRANT
INDET
ANEXO I: Formato de los ficheros
El servicio de “Solicitud de información de deudas tributarias con la GVA”, con el fin de
facilitar la adaptación de las distintas aplicaciones informáticas que hagan uso de él, utiliza un
formato de ficheros de envío y recepción equivalente al que utiliza la AEAT.
Este formato de ficheros, se compone de tres partes, el fichero de petición de información y el
fichero petición de información registrado y el fichero de recepción del resultado.
DISEÑO DEL REGISTRO DEL FICHERO DE PETICIÓN DE INFORMACIÓN
Número
Pos.
Long.
1
1
9
Alfanúm. NIF
2
10
50
Alfanúm. Nombre
Razón
3
60
21
Alfanúm Sin contenido
4
81
20
Alfanúm Opcional
TOTAL
Tipo
Descripción
Validació
n
Contenido
Obligatorio NIF del interesado
o Obligatorio Nombre o Razón Social
del interesado
Reservado
100
FORMATO DEL FICHERO DE ENTRADA UNA VEZ REGISTRADO.
El formato del fichero una vez ha sido aceptado, validado y registrado, es un formato basado
en XML y se corresponde con el siguiente esquema:
<?xml version = "1.0" encoding = "ISO-8859-1"?>
<xsd:schema xmlns:xsd = "http://www.w3.org/2001/XMLSchema"
elementFormDefault = "qualified">
<xsd:element name = "NOTI_ENTRADA">
<xsd:complexType>
<xsd:sequence>
<xsd:element name = "ID_ENVIO">
<xsd:simpleType>
<xsd:restriction base = "xsd:positiveInteger">
<xsd:totalDigits value = "16"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name = "NUM_REG_ENTRADA">
<xsd:simpleType>
<xsd:restriction base = "xsd:positiveInteger">
<xsd:totalDigits value = "6"/>
</xsd:restriction>
</xsd:simpleType>
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 11
PROYECTO TIRANT
INDET
</xsd:element>
<xsd:element name = "DIA_ENTRADA">
<xsd:simpleType>
<xsd:restriction base = "xsd:positiveInteger">
<xsd:totalDigits value = "2"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name = "MES_ENTRADA">
<xsd:simpleType>
<xsd:restriction base = "xsd:positiveInteger">
<xsd:totalDigits value = "2"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name = "ANYO_ENTRADA">
<xsd:simpleType>
<xsd:restriction base = "xsd:positiveInteger">
<xsd:totalDigits value = "4"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name = "HORA_ENTRADA" type = "xsd:time"/>
<xsd:element name = "ENVIO" type = "xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Que gráficamente sería:
Como se puede observar, a los datos suministrados en el envío, se le han añadido los datos
correspondientes al registro de entrada. El formato de los datos que se encuentran dentro de
los tags <ENVIO>, </ENVIO>, se corresponde con el especificado en el punto “Diseño del
registro del fichero de petición de información”. .
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 12
PROYECTO TIRANT
INDET
DISEÑO DEL FICHERO DE RECEPCIÓN DEL RESULTADO
El fichero de recepción está formado por dos partes. En la primera, se identifica la
petición realizada junto con los valores del registro de entrada de esta. En la segunda parte, se
muestran los datos del registro de salida junto con el resultado del proceso.
El formato del fichero de resultado se basa en un XML con el siguiente esquema:
<?xml version="1.0" encoding="ISO-8859-1"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<xsd:include schemaLocation="INDETIN.xsd"/>
<xsd:element name="NOTI_SALIDA">
<xsd:complexType>
<xsd:sequence>
<xsd:element ref="NOTI_ENTRADA" minOccurs="0"/>
<xsd:element name="NUM_REG_SALIDA">
<xsd:simpleType>
<xsd:restriction base="xsd:positiveInteger">
<xsd:totalDigits value="6"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="DIA_SALIDA">
<xsd:simpleType>
<xsd:restriction base="xsd:positiveInteger">
<xsd:totalDigits value="2"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="MES_SALIDA">
<xsd:simpleType>
<xsd:restriction base="xsd:positiveInteger">
<xsd:totalDigits value="2"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="ANYO_SALIDA">
<xsd:simpleType>
<xsd:restriction base="xsd:positiveInteger">
<xsd:totalDigits value="4"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="HORA_SALIDA" type="xsd:time"/>
<xsd:element name="ESTADO" type="xsd:string"/>
<xsd:element name="RESULTADO" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Gráficamente se representaría como:
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 13
PROYECTO TIRANT
INDET
El resultado a la petición realizada se encuentra en el tag <![CDATA[resultado según formato de
fichero]]>, dentro de <RESULTADO>, </RESULTADO>. La información aquí contenida se
corresponde con el siguiente formato de registro:
Número
Pos.
Long.
1
1
9
Alfanúm. NIF
2
10
50
Alfanúm. Nombre
Razón
3
60
1
Alfanúm
Código IDENT
Identificación del interesado
4
61
1
Alfanúm
Código CERT
Sentido del certificado
5
62
1
Alfanúm
Código
Negativo
Motivo certificado negativo
6
63
7
Alfanúm
Sin contenido
7
70
20
Alfanúm
Datos propios
Reservado
8
90
11
Alfanúm
Referencia
Identificador de certificado
TOTAL
Tipo
Descripción
Contenido
NIF del interesado
o Nombre o
interesado
Razón
Social
del
100
Los códigos que pueden darse son los siguientes:
Código IDENT
0: Interesado identificado
2: Interesado no identificado
4: Problemas técnicos
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 14
PROYECTO TIRANT
Código CERT
P: Positivo – No existe deuda
N: Negativo – Existe deuda
Código Negativo
B: Negativo porque incumple Deudas
INDET
La manera de evaluar el resultado parte de verificar el código IDENT. Si este es distinto de
cero, el resto de códigos no deben ser evaluados. En el caso de que el código CERT sea P
(Positivo), tampoco ha de evaluarse el código NEGATIVO.
El nombre o razón social que se incluye en el formato del registro de resultado es el obtenido
al comparar el NIF y el Nombre del fichero de entrada con los datos de la Base de Datos
Corporativa y puede que difiera del suministrado en la solicitud.
EJEMPLOS
En este punto, se proporcionan algunos ejemplos de los formatos anteriores.
Ejemplo de “fichero de petición de información”
11111111HCONTRIBUYENTE1
22222222JCONTRIBUYENTE2
Ejemplo del fichero de entrada una vez registrado.
<?xml version = '1.0' encoding = 'ISO-8859-1'?>
<NOTI_ENTRADA
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="indetIN.xsd">
<ID_ENVIO>180</ID_ENVIO>
<NUM_REG_ENTRADA>335</NUM_REG_ENTRADA>
<DIA_ENTRADA>6</DIA_ENTRADA>
<MES_ENTRADA>5</MES_ENTRADA>
<ANYO_ENTRADA>2003</ANYO_ENTRADA>
<HORA_ENTRADA>14:37:02</HORA_ENTRADA>
<ENVIO>
<![CDATA[11111111HCONTRIBUYENTE1
22222222JCONTRIBUYENTE2]]>
</ENVIO>
</NOTI_ENTRADA>
Ejemplo del fichero de recepción del resultado
<?xml version = '1.0' encoding = 'ISO-8859-1'?>
<NOTI_SALIDA
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance
xsi:noNamespaceSchemaLocation="indetOUT.xsd">
<NOTI_ENTRADA
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 15
PROYECTO TIRANT
xsi:noNamespaceSchemaLocation="indetIN.xsd">
<ID_ENVIO>180</ID_ENVIO>
<NUM_REG_ENTRADA>335</NUM_REG_ENTRADA>
<DIA_ENTRADA>6</DIA_ENTRADA>
<MES_ENTRADA>5</MES_ENTRADA>
<ANYO_ENTRADA>2003</ANYO_ENTRADA>
<HORA_ENTRADA>14:37:02</HORA_ENTRADA>
<ENVIO>
<![CDATA[11111111HCONTRIBUYENTE1
22222222JCONTRIBUYENTE2]]>
</ENVIO>
</NOTI_ENTRADA>
<NUM_REG_SALIDA>980</NUM_REG_SALIDA>
<DIA_SALIDA>6</DIA_SALIDA>
<MES_SALIDA>5</MES_SALIDA>
<ANYO_SALIDA>2003</ANYO_SALIDA>
<HORA_SALIDA>14:44:36</HORA_SALIDA>
<ESTADO>Aceptado</ESTADO>
<RESULTADO>
<![CDATA[11111111HCONTRIBUYENTE1
22222222JCONTRIBUYENTE2
0NB
</RESULTADO>
</NOTI_SALIDA>
INDET
2NB
]]>
Para conseguir extraer los datos resultado de la petición cursada, la zona a evaluar sería la
siguiente y el formato de estos datos sería el indicado en el diseño del formato del registro del
fichero de resultados.
<RESULTADO>
<![CDATA[
resultado según formato de fichero
]]>
</RESULTADO>
Archivo Ayuda sobre informacion de deudas con la GVA_v7 .doc
Página 16