Carga masiva de documentación de gastos con índice XML Abril 2018

Transcripción

1 Carga masiva de documentación de gastos con índice XML Abril / 14 ADI

2 FUNCIONAMIENTO GENERAL El proceso de carga masiva de documentación de gastos se basa en un archivo comprimido.zip que en su raíz contiene un índice en formato XML. Cuando se ejecuta la funcionalidad se realizan las validaciones del fichero (formato, tamaño, que contenga el índice#). Una vez validado el fichero comprimido, se descomprime y se realizan las validaciones del esquema XSD sobre el fichero XML añadido para comprobar que el formato del mismo sea correcto y que los datos introducidos sobre los gastos sean válidos comprobando en BBDD su existencia y que los documentos aportados puedan ser insertados en la misma. Tanto el formato del fichero comprimido (.zip) como del XML del índice para la entrada de los gastos se expone a continuación en este mismo documento. Salida: La salida se podrá ver en la misma opción de la carga masiva y se permitirá aceptar o rechazar dicha carga. CÓDIGOS DE CONCEPTOS Y SUBCONCEPTOS Para realizar una carga de gastos masiva es importante detallar los códigos de conceptos y subconceptos para cada uno de los gastos. En la página de ayuda de la aplicación, junto a este documento existe otro enlace denominado Listado de códigos de conceptos y subconceptos. En dicho documento se encuentra la lista de todos los conceptos/subconceptos de gastos configurados por convocatoria junto con los códigos correspondiente a su concepto (ctpcon) y subconcepto (ctpsco). Es imprescindible utilizar dichos códigos para poder realizar la carga masiva. DESCRIPCIÓN FICHERO ENTRADA (.zip) El fichero que sirve como entrada para el proceso de carga masiva de documentos se trata de una estructura de ficheros comprimida en formato.zip en la que en su raíz debe contener el archivo indice.xml (fichero XML de carga) y una serie de carpetas y ficheros con los documentos (en formato PDF de 1MB como tamaño máximo) para realizar la carga masiva insertándolos en la base de datos. A continuación se muestra un ejemplo de fichero válido: 2 / 14 ADI

3 DESCRIPCIÓN ÍNDICE XML El fichero para el índice de la carga masiva en formato XML debe estar formado por una serie de etiquetas para definir los distintos elementos que definen cada entrada de un documento de gasto a cargar. El formato del XML para la entrada de gastos se expone en el ANEXO I de este documento. A continuación se detalla la información de cada etiqueta para cada tipo de gasto: 3 / 14 ADI

4 4 / 14 ADI Nº Nombre Descripción Validaciones 1 numfactura 2 tipodocumento 3 documento Datos de los documentos asociados a FACTURAS Número de la factura a la que se desea añadir el documento Tipo de documento identificativo del proveedor: CIF, NIF, NIE u OTROS Documento identificativo del proveedor. 4 fecfactura Fecha de emisión de la factura 5 ctpcon 6 Ctpsco 7 tipodocumentogasto 8 rutadocumento 1 mesperiodo 2 anioperiodo 3 mesperiodohasta 4 anioperiodohasta 5 tipodocumento 6 documento 7 ctpcon 8 Ctpsco 9 tipodocumentogasto 10 rutadocumento Código del concepto financiable según resolución Código del subconcepto financiable según resolución Tipo del documento de gasto: JUS_GAS, JUS_PAG o DGAS1 Ruta donde se encuentra el fichero PDF del documento de gasto dentro del.zip de entrada Tabla de valores 2 Con formato dd/mm/aaaa Consultar documento sobre Conceptos y Subconceptos Consultar documento sobre Conceptos y Subconceptos Tabla de valores 3 Datos de los documentos asociados a GASTOS DE PERSONAL Mes asociado al gasto de personal Año asociado al gasto de personal Mes Hasta asociado al gasto personal de atrasos o pagas extra. Año Hasta asociado al gasto personal de atrasos o pagas extra. Tipo de documento identificativo del trabajador: NIF, NIE o Pasaporte Número de documento del trabajador Código del concepto financiable según resolución Código del subconcepto financiable según resolución Tipo del documento de gasto: JUS_GAS o JUS_PAG Ruta donde se encuentra el fichero PDF del documento de gasto dentro del.zip de entrada Valor numérico Valor numérico Opcional Valor numérico Opcional Valor numérico Tabla de valores 1 Los NIF y NIE se escribirán son su letra y sin guiones ni blancos Consultar documento sobre Conceptos y Subconceptos Consultar documento sobre Conceptos y Subconceptos Tabla de valores 4 Datos de los documentos asociados a OTROS JUSTIFICANTES 1 numotrogasto Número del gasto 2 tipodocumento 3 documento 4 fecotrogasto Tipo de documento identificativo del proveedor: CIF, NIF, NIE u OTROS Documento identificativo del proveedor. Fecha de emisión del justificante Tabla de valores 2 Con formato dd/mm/aaaa

5 5 / 14 ADI 5 Ctpcon 6 ctpsco 7 tipodocumentogasto 8 rutadocumento Código del concepto financiable según resolución Código del subconcepto financiable según resolución Tipo del documento de gasto: JUS_GAS o JUS_PAG Ruta donde se encuentra el fichero PDF del documento de gasto dentro del.zip de entrada Consultar documento sobre Conceptos y Subconceptos Consultar documento sobre Conceptos y Subconceptos Tabla de valores 4 TABLA 1. TIPOS DE DOCUMENTO Valor F E P Descripción NIF NIE Pasaporte TABLA 2. TIPOS DE DOCUMENTO PROVEEDOR Valor C F E V Descripción CIF NIF NIE Otros TABLA 3. TIPOS DE DOCUMENTO DE GASTOS FACTURAS Valor Descripción JUS_GAS Justificante del Gasto JUS_PAG Justificante del Pago DGAS1 Documentación factura sin contrato TABLA 4. TIPOS DE DOCUMENTO DE GASTOS Valor Descripción JUS_GAS Justificante del Gasto JUS_PAG Justificante del Pago

6 6 / 14 ADI ANEXO 1 XSD Comentarios previos respecto al XML: - El tag cargamasiva es fijo y en principio debe ser así: <cargamasiva xmlns=" xmlns:xsi=" xsi:schemalocation=" djgh"> - El fichero que se genere para realizar la carga masiva de documentos deberá tener formato y extensión xml. El esquema XSD es: <xsd:schema xmlns:xsd=" targetnamespace=" xmlns=" elementformdefault="qualified"> <xsd:element name="cargamasiva" type="cargamasiva" /> <xsd:complextype name="cargamasiva"> Conjunto de definiciones para el fichero de carga masiva <xsd:element name="cabecera" type="cabecera" minoccurs="0" maxoccurs="1"/> <xsd:element name="listaayudaeconomica" type="listaayudaeconomica" /> <!-- Datos generales de la carga --> <xsd:complextype name="cabecera"> Cabecera de información con comentario adicional sobre el contenido del fichero <xsd:element name="comentario" type="xsd:string" /> <!-- Ayudas cuyos datos económicos van a ser incluidos en la carga --> <xsd:complextype name="listaayudaeconomica"> <xsd:element name="ayudaeconomica" type="ayudaeconomica" minoccurs="1" maxoccurs="unbounded"> <xsd:complextype name="ayudaeconomica"> Información económica de la ayuda

7 7 / 14 ADI <!-- Referencia de la ayuda (identificador único) --> <xsd:element name="referencia" type="xsd:string" maxoccurs="1" minoccurs="1" /> <xsd:element name="listafacturas" type="listafacturastipo"> <xsd:element name="listagastopersonal" type="listagastopersonaltipo"> <xsd:element name="listaotrogasto" type="listaotrogastotipo"> <xsd:complextype name="listafacturastipo"> <xsd:element name="factura" type="factura" minoccurs="0" maxoccurs="unbounded"> <xsd:complextype name="listagastopersonaltipo"> <xsd:element name="gastopersonal" type="gastopersonal" minoccurs="0" maxoccurs="unbounded"> <xsd:complextype name="listaotrogastotipo"> <xsd:element name="otrogasto" type="otrogasto" minoccurs="0" maxoccurs="unbounded"> <!-- Definición de una Factura --> <xsd:complextype name="factura"> Definición de una Factura <xsd:element name="numfactura" minoccurs="1" maxoccurs="1" type="textmax40type"> Número de Factura <!-- Tipo Documento Proveedor -->

8 8 / 14 ADI <xsd:element name="tipodocumento" minoccurs="1" maxoccurs="1" type="tiposdocumentoproveedor"> <!-- CIF/NIF Proveedor --> <xsd:element name="documento" minoccurs="1" maxoccurs="1" type="textmax20type"> CIF/NIF <xsd:element name="fecfactura" minoccurs="1" maxoccurs="1" type="fecha"> Fecha factura <xsd:element name="ctpcon" minoccurs="1" maxoccurs="1" type="xsd:int"> <xsd:element name="ctpsco" minoccurs="1" maxoccurs="1" type="xsd:int"> <!-- Tipo Documento Gasto --> <xsd:element name="tipodocumentogasto" minoccurs="1" maxoccurs="1" type="tiposdocumentogastofactura"> <xsd:element name="rutadocumento" minoccurs="1" maxoccurs="1" type="textmax2500type"> <!-- Definición de un Gasto de Personal --> <xsd:complextype name="gastopersonal"> Definición de un Gasto de personal <xsd:element name="mesperiodo" minoccurs="1" maxoccurs="1" type="meses"> <xsd:element name="anioperiodo" minoccurs="1" maxoccurs="1" type="aniosgastopersonal"> <xsd:element name="mesperiodohasta" minoccurs="0" maxoccurs="1" type="textmax25type"> <xsd:element name="anioperiodohasta" minoccurs="0" maxoccurs="1" type="textmax25type"> <!-- Tipo Documento Personal --> <xsd:element name="tipodocumento" minoccurs="1" maxoccurs="1" type="tiposdocumento">

9 9 / 14 ADI <xsd:element name="documento" minoccurs="1" maxoccurs="1" type="xsd:string"> <xsd:element name="ctpcon" minoccurs="1" maxoccurs="1" type="xsd:int"> <xsd:element name="ctpsco" minoccurs="1" maxoccurs="1" type="xsd:int"> <!-- Tipo Documento Gasto --> <xsd:element name="tipodocumentogasto" minoccurs="1" maxoccurs="1" type="tiposdocumentogasto"> <xsd:element name="rutadocumento" minoccurs="1" maxoccurs="1" type="textmax2500type"> <!-- Definición de Otro Gasto --> <xsd:complextype name="otrogasto"> Definición de otro gasto <xsd:element name="numotrogasto" minoccurs="1" maxoccurs="1" type="textmax40type"> Número de Justificante <!-- Tipo Documento Proveedor --> <xsd:element name="tipodocumento" minoccurs="1" maxoccurs="1" type="tiposdocumentoproveedor"> <xsd:element name="documento" minoccurs="1" maxoccurs="1" type="textmax20type"> CIF/NIF <xsd:element name="fecotrogasto" minoccurs="1" maxoccurs="1" type="fecha"> <xsd:element name="ctpcon" minoccurs="1" maxoccurs="1" type="xsd:int">

10 10 / 14 ADI <xsd:element name="ctpsco" minoccurs="1" maxoccurs="1" type="xsd:int"> <!-- Tipo Documento Gasto --> <xsd:element name="tipodocumentogasto" minoccurs="1" maxoccurs="1" type="tiposdocumentogasto"> <xsd:element name="rutadocumento" minoccurs="1" maxoccurs="1" type="textmax2500type"> <!-- Definiciones de tamaños máximos para campos textuales --> <xsd:simpletype name="textmax20type"> <xsd:maxlength value="20" /> <xsd:simpletype name="textmax25type"> <xsd:maxlength value="25" /> <xsd:simpletype name="textmax40type"> <xsd:maxlength value="40" /> <xsd:simpletype name="textmax2500type"> <xsd:maxlength value="2500" /> <!-- Fechas --> <xsd:simpletype name="fecha"> <xsd:maxlength value="10" /> <xsd:minlength value="10" /> <xsd:pattern value="[0-9]{2}/[0-9]{2}/[0-9]{4}"> <xsd:documentation xml:lang="es"> Campo de fecha con formato: dd/mm/yyyy </xsd:pattern> <!-- Meses --> <xsd:simpletype name="meses"> <xsd:restriction base="xsd:int"> <xsd:enumeration value="1"> Enero

11 11 / 14 ADI <xsd:enumeration value="2"> Febrero <xsd:enumeration value="3"> Marzo <xsd:enumeration value="4"> Abril <xsd:enumeration value="5"> Mayo <xsd:enumeration value="6"> Junio <xsd:enumeration value="7"> Julio <xsd:enumeration value="8"> Agosto <xsd:enumeration value="9"> Septiembre <xsd:enumeration value="10"> Octubre <xsd:enumeration value="11"> Noviembre <xsd:enumeration value="12"> Diciembre <!-- Tipos de Documento para Personal --> <xsd:simpletype name="tiposdocumento">

12 12 / 14 ADI <xsd:enumeration value="f"> NIF <xsd:enumeration value="e"> NIE <xsd:enumeration value="p"> Pasaporte <!-- Anios de Gastos de Personal --> <xsd:simpletype name="aniogastopersonal"> <xsd:restriction base="xsd:int"> <xsd:enumeration value="2004"> 2004 <xsd:enumeration value="2005"> 2005 <xsd:enumeration value="2006"> 2006 <xsd:enumeration value="2007"> 2007 <xsd:enumeration value="2008"> 2008 <xsd:enumeration value="2009"> 2009 <xsd:enumeration value="2010"> 2010 <xsd:enumeration value="2011"> 2011 <xsd:enumeration value="2012">

13 13 / 14 ADI 2012 <xsd:enumeration value="2013"> 2013 <xsd:enumeration value="2014"> 2014 <xsd:enumeration value="2015"> 2015 <xsd:enumeration value="2016"> 2016 <xsd:enumeration value="2017"> 2017 <xsd:enumeration value="2018"> 2018 <!-- Tipos de Documento para Proveedor --> <xsd:simpletype name="tipodocumentoproveedor"> <xsd:enumeration value="f"> NIF <xsd:enumeration value="e"> NIE <xsd:enumeration value="c"> CIF <xsd:enumeration value="v"> Otros

14 14 / 14 ADI <!-- Tipos de Documento Gasto para Factura --> <xsd:simpletype name="tipodocumentogastofactura"> <xsd:enumeration value="jus_gas"> Justificante Gasto <xsd:enumeration value="jus_pag"> Justificante del Pago <xsd:enumeration value="dgas1"> Documentación factura sin contrato del <!-- Tipos de Documento Gasto (gasto personal y otros gastos) --> <xsd:simpletype name="tipodocumentogasto"> <xsd:enumeration value="jus_gas"> Justificante Gasto <xsd:enumeration value="jus_pag"> Justificante Pago </xsd:schema> del del