> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/connect-v3.1/firma/administracionconnectfirma/grupoficheros/alta/configuracion.md). # Configuración Esta primera etapa de la configuración de un *grupo de ficheros* recoge sus parámetros generales (dónde están los ficheros, formato, datos que deben estar informados en los ficheros a los que aplica, modo de firma) y sus parámetros específicos para el envío. ![Nuevo grupo de ficheros](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-b94b27723b5bd99ee515699821c835decc4b514e%2F02_configuracion_grupo_ficheros.png?alt=media) ## Datos generales * **Nombre**: identificador único del *grupo de ficheros* en el sistema. Se compone de manera automática a partir del valor de los parámetros **Propósito**, **Aplicación**, **Formato**, **NIF**, **Sufijo**, **Cuenta** y valor mínimo y máximo del tipo de **Importe** que se configuren. No es editable. * **Descripción**: literal amigable para que el administrador identifique fácilmente el *grupo de ficheros*. * **Aplicación**: identificador para aglutinar los *grupos de ficheros* que se refieren a un mismo conjunto de ficheros. Es el identificador que ve el firmante y debería ayudarle a reconocer a qué conjunto de ficheros pertenece el fichero que está firmando. * **Propósito**: finalidad del *grupo de ficheros* que se está configurando. Su valor es uno de: * **`Firmar`**: los ficheros van a recibir tratamiento de firma previo al envío * **`Verificar`**: los ficheros a tratar son firmas que se reciben y se verifican. * **Email**: dirección de correo para recibir notificaciones referentes a documentos que pertenezcan a este *grupo de ficheros*. * **Verificar el estado de revocación de los certificados**: si se marca, se comprobará el estado de revocación de los certificados antes de realizar la firma. * **Directorio de entrada/salida**: * Si el propósito es firmar, este es el directorio donde están inicialmente los ficheros a firmar. Los ficheros permanecen allí hasta que el sistema les asigna un *grupo de ficheros*. En ese momento, se trasladan a un directorio interno de Connect, donde se registran con un nuevo nombre y se genera el fichero de firmas correspondiente a cada uno. Durante el tiempo en el que los ficheros de datos y de firmas permanecen en el directorio interno, no son accesibles ni identificables por ningún proceso ajeno a Connect. * Si el propósito es verificar, este es el directorio de salida en el que se dejarán los documentos extraídos de la firmas una vez que estas sean verificadas. El directorio de entrada/salida debe existir y ser accesible antes de la creación/modificación del *grupo de ficheros*, en caso contrario, el *grupo de ficheros* no se podrá crear/modificar. * **Guardar ficheros de salida**: este parámetro solo se muestra si el propósito es firmar. Cuando se marca, una vez enviado el tipo de fichero indicado en el parámetro **Enviar**, la pareja de ficheros de datos y firmas se copia desde el directorio interno de Connect donde se encuentran (y donde no es accesible desde ningún proceso ajeno al producto) a otro directorio donde ambos ficheros recuperan el nombre del original y pueden ser accesibles por procesos externos. El directorio de salida se puede consultar pulsando el icono de información del parámetro y no es editable. Si no se activa este parámetro, al finalizar el proceso de emisión solo permanecerá accesible, en el directorio de envío del canal, el fichero o los ficheros que se transmitan al otro extremo (por lo general, solo uno de la pareja de datos y firma). * **Eliminar ficheros de trabajo de datos y firma definitivamente**: este parámetro solo se muestra si el propósito es firmar. Cuando se activa, una vez enviado el tipo de fichero indicado en el parámetro **Enviar**, la pareja de ficheros de datos y firma se elimina del directorio interno en el que se encuentra. En ese caso, los ficheros seguirán mencionados en el registro de actividad, pero ya no se podrán consultar ni visualizar desde el menú **Ficheros**. * **Formato del fichero**: tipo de fichero a firmar --propósito firmar-- o del fichero firmado --propósito verificar--. Puede ser uno de: `Transferencia`, `Adeudos`, `Confirming Único`, `AEB 63 (Embargos)`- Fases 3 (Orden de ejecución de embargo) y 5 (Orden de levantamiento de la retención), `Multiformato` y `Sin formato`. * Los ficheros de **Transferencias** son XML según ISO 20022. * Los ficheros de **Adeudos** son ficheros XML según ISO 20022 y pueden corresponder a los mensajes de Presentación, Rechazo, Devolución o Retrocesión. * Los ficheros de **Confirming Único** son ficheros de formato plano de longitud fija de 250 y según la norma regulada para estos mensajes. * Los ficheros de **AEB 63** son ficheros de formato plano de longitud fija 650 y según la norma regulada para estos mensajes. Se han implementado las Fases 3 (Orden de ejecución de embargo) y 5 (Orden de levantamiento de la retención). La selección de los formatosTransferencias, Adeudos, AEB - 63 y Confirming Único para ficheros de dichos formatos permite que la visualización del documento por parte del firmante sea amigable. Es decir, los ficheros no se visualizan tal cual son, sino que se muestran organizados en tablas con filas y columnas para facilitar la comprobación de su contenido. Esta visualización no se guarda en ningún caso y no altera el documento original ni su formato, que es el que se firma. Además, para los formatos Transferencias, Adeudos y Confirming Único, es posible establecer reglas de firmado de acuerdo a información contenida en los ficheros (NIF, sufijo y cuentas de la figura principal - Ordenante o Acreedor - e importe total del fichero o importe de operación mayor). * **Multiformato** es el valor del parámetro adecuado cuando se van a tratar ficheros TXT, XML, Word, Excel y PDF. En este caso, la visualización de los ficheros los muestra tal cual son y no es posible establecer reglas de firmado de acuerdo a información contenida en los documentos. Por eso, cuando se selecciona esta opción, los parámetros **NIF**, **Sufijo**, **Cuenta** e **Importes** se muestran deshabilitados . * **Sin formato** con este valor del parámetro **Formato** no se visualiza el contenido del documento antes de firmarlo. Este formato no permite establecer reglas de firmado de acuerdo a información contenida en los documentos. Por eso, cuando se selecciona, los parámetros **NIF**, **Sufijo**, **Cuenta** e **Importes** se muestran deshabilitados. * **NIF**: se muestra disponible para los formatos Transferencias, Adeudos y Confirming Único. Es el que debe estar informado en el documento que se va a firmar, o en el documento extraído de una firma que se verifica, para que le aplique el *grupo de ficheros* que se está configurando. Corresponde a la identificación de la figura principal de los ficheros (Ordenante o Acreedor). * **Sufijo**: se muestra disponible para los formatos Transferencias, Adeudos y Confirming Único. Es el que debe estar informado en el documento que se va a firmar, o en el documento extraído de una firma que se verifica, para que le aplique el *grupo de ficheros* que se está configurando. Corresponde a la identificación de figura principal de los ficheros (Ordenante o Acreedor). * **Número de cuenta**: se muestra disponible para los formatos Transferencias, Adeudos y Confirming Único. Es la que debe estar informada en el documento que se va a firmar, o en el documento extraído de una firma que se verifica, para que le aplique el *grupo de ficheros* que se está configurando. Corresponde a la figura principal de los ficheros (Ordenante o Acreedor). El sistema valida que el número de cuenta indicado sea válido. * **Tipo de transferencia**: se muestra disponible para el formato Transferencias. Es el que debe estar informada en el documento que se va a firmar, o en el documento extraído de una firma que se verifica, para que le aplique el *grupo de ficheros* que se está configurando. * **Tipo de importe con el que validar**: se muestra disponible para Transferencias, Adeudos y Confirming Único. Se debe seleccionar uno de `Importe total del fichero`o `Importe de operación mayor`. En ambos casos se especificará el valor menor y el valor mayor. El importe del fichero del tipo seleccionado (total o de operación mayor) del fichero que se va ba firmar debe estar comprendido en el rango descrito en este parámetro para que le aplique el *grupo de ficheros* que se está configurando.\ Cuando se configure este parámetro: 1. Deben tenerse en cuenta los céntimos para que todos los valores queden cubiertos. Por ejemplo, si se configura un *grupo de ficheros* para documentos con importe de operación mayor entre `0` y `1.000`, el *grupo de ficheros* para el siguiente tramo de importes debería empezar en `1.000,01`; o bien el primero abarcar de `0` a `1.000,99` y el siguiente empezar en `1.001`. 2. Debe evitarse el solapamiento de los tramos de importes para que el sistema no encuentre ambigüedad a la hora de asignar los *grupos del ficheros* a los documentos que se van a firmar o verificar. Por ejemplo, si se configura un *grupo de ficheros* para documentos con importe de operación mayor entre `0` y `1.000`, no puede haber otro grupo de ficheros para esos mismos documentos con importe de operación mayor entre `100` y `900` o entre `500` y `1001`, etc. 3. Debe elegirse una única estrategia de validación de importes (importe de operación mayor o importe total) para el conjunto de *grupos de ficheros* que regulen un mismo conjunto de documentos. * **Modo de firma**: es el formato en el que se va a realizar la firma y puede ser uno de `PKCS#7 Attached` o `XAdES Detached Interna Implícita`. Incluye ayuda para consultar si, con el modo elegido, el fichero con las firmas incluye o no el fichero de datos que se firma. * **Plantilla/Política XAdES**: cuando se haya seleccionado uno cualquiera de los modos de firma *XAdES*, se deberá definir aquí: * Si el *grupo de ficheros* tiene propósito firmar, es la plantilla a utilizar. Las plantillas son documentos XML, según esquema propietario de Editran, que reúnen un conjunto de características que son configurables para el modo de firma elegida, tales como nivel de protección (BES o EPES), versión de SHA para obtener el hash del documento, versión SHA de algoritmo RSA con el que se firma, etiquetas obligatorias, etc. Con el producto se distribuyen diferentes plantillas para cada modo de firma con las configuraciones más utilizadas. * Si el *grupo de ficheros* tiene propósito verificar y el nivel de protección requerido para las firmas que se van a recibir es EPES, se define aquí la política a utilizar. El fichero de política es otro fichero XML, esta vez según un esquema propietario de *XAdES*, que recoge una serie de características exigidas en las firmas recibidas. El producto incluye la política de la Agencia General de Estado (AGE). Cuando el nivel de protección que se quiera utilizar en las firmas intercambiadas sea EPES, en este campo el extremo que firma colocará una plantilla con EPES en el nombre, y el extremo que valida colocará el fichero de política. El uso en el extremo firmante de aquellas plantillas “EPES-AGE” en el nombre garantiza el cumplimiento de la política AGE en el extremo receptor y validador de dichas firmas. Por el contrario, cuando el nivel de protección que se quiera utilizar en las firmas intercambiadas sea BES, en este campo el extremo que firma colocará una plantilla con BES en el nombre y el extremo que valida dejará el campo Política con el valor Ninguno. ## Datos de transmisión * **Enviar**: este parámetro solo se muestra si el propósito es firmar. En este parámetro se configura qué ficheros, de la pareja que se existe en todo proceso de firma, se van a enviar al otro extremo. * Se elige **`Datos`** cuando el extremo receptor no requiere recibir la información firmada. * Se elige **`Firmas`** cuando el extremo receptor requiere recibir la información firmada y el modo de firma elegido es uno en el que el fichero con las firmas incluye el fichero de datos. * Se elige **`Datos y Firmas`** cuando el extremo receptor requiere recibir la información firmada y el modo de firma elegido es uno en el que el fichero con las firmas no incluye el fichero de datos. Junto al parámetro **Modo de firma** se encuentra un icono de información que permite consultar qué modo de firma incluye en la misma el fichero de datos y cuál no. * **Enviar automáticamente al finalizar la firma**: este parámetro solo se muestra si el propósito es firmar. Cuando se marca, Connect envía de manera inmediata el fichero una vez que se alcanza el número de firmas necesarias y todas son correctas. Cuando no se marca, el fichero ya firmado queda disponible en el buzón de envío del *canal*, a la espera de que otro proceso desencadene el envío (planificador, envío manual, etc.). * **Contacto**: destinatario de los ficheros que se van a enviar o emisor de los fircheros de firma que se van a recibir. El combo ofrece aquellos *contactos* del sistema que cuenten con *canales* de firma en el sentido de la transmisión que corresponda (emisión, si el propósito es firmar, o recepción, si el propósito es verificar). * **Canal**: cuando el propósito sea firmar, es el *canal* del *contacto* por el que se realizará la transmisión del fichero una vez firmado. Cuando el propósito sea verificar, es el *canal* del *contacto* por el que se reciben los documentos de firma a verificar. El combo ofrece aquellos *canales* del *contacto* que se hayan configurado con la característica de firma en el sentido de la transmisión correspondiente al propósito (emisión, si el propósito es firmar, o recepción, si el propósito es verificar). * **Formato, Longitud de Registro, Delimitador, Compresión, Alfabeto y Traducir**: solo se muestran cuando el propósito es firmar. Son parámetros para la propia transmisión de los ficheros por Connect. Cuando lo que se transmite son ficheros de firma o ficheros de datos de Transferencias o Adeudos, .doc, .xls, .pdf o .xml, el valor de Formato debe ser Binario. 📌 **A tener en cuenta** * Dado que el nombre del *grupo de ficheros* es un identificador que se compone de manera automática (no editable) a partir de los valores de los parámetros **Propósito**, **Aplicación**, **Formato**, **NIF**, **Sufijo**, **Cuenta** y valor mínimo y máximo de **Importe** que se configuren, y que dicho identificador debe ser único en el sistema, no puede haber en una misma instalación más de un *grupo de ficheros* con los mismos valores en dichos parámetros. De esta forma, siempre que se hayan configurado los *grupos de ficheros* suficientes, el sistema podrá elegir sin ambigüedad cual es el adecuado para cada fichero que se encuentre en el directorio de entrada. * A la hora de definir los *grupos de ficheros* de un mismo conjunto de ficheros en los que se especifique rango de importes, se debe elegir una de las dos estrategias entre importe de operación mayor o importe total para todos ellos. Esto es debido a que el nombre del *grupo de ficheros* menciona los tramos de importes que se hayan especificado (si los hay) pero no el tipo de los mismos, si de operación mayor o total. Por lo tanto, no puede haber dos grupos de ficheros con los mismos valores de **Propósito**, **Aplicación**, **NIF**, **Sufijo**, **Cuenta** en los que coincidan los valores de importe mínimo y máximo, por más que uno se refiera a importe de operación mayor y otro a importe total. * No puede haber *grupos de ficheros* con unos mismos valores para **Propósito**, **Aplicación**, **Formato**, **NIF**, **Sufijo**, **Cuenta** y con rangos de importes que, aun siendo diferentes, produzcan solapamiento con otros tramos de importes ya definidos en el resto de *grupos de ficheros*. * Cuando en *grupos de ficheros* para formatos de ficheros bancarios no se establecen valores para alguno de **NIF**, **Sufijo**, **Cuenta** e **Importes**, esos datos de los ficheros no se tienen en cuenta a la hora de asignar la regla de firmado al fichero. Las reglas de firmado, o *grupos de ficheros*, serán más restrictivas cuantos más de esos parámetros se establezcan y más genéricas cuantos menos de ellos se configuren. * Cuando a un mismo fichero le pueda aplicar más de un *grupo de ficheros*, el sistema siempre elegirá el más restrictivo. * Cuando a un mismo fichero le pueda aplicar más de un *grupo de ficheros* y estos sean igual de restrictivos (en los dos se ha especificado el mismo número de parámetros de **NIF**, **Sufijo**, **Tipo de transferencia**, **Cuenta** e **Importes**), el sistema informará de la ambigüedad y el fichero no será recibido. * Debido al tratamiento inicial que se hace de los ficheros en cada caso, no puede haber **grupos de ficheros** con formato `Multiformato` o `Sin formato` apuntando al mismo directorio de entrada que ya esté configurado para *grupos de ficheros* de formatos bancarios (Transferencia, Adeudos y Confirming). Sin embargo, *grupos de ficheros* para diferentes formatos bancarios sí podrán compartir un mismo directorio de entrada. * Cuando el propósito es verificar, todos los *grupos de ficheros* que se reciben por el mismo *canal* deben coincidir en el modo de firma. Esto es debido a que en el caso de la verificación de un fichero de firma, las operaciones se realizan en sentido inverso al de la firma: primero se verifica la firma y se extrae el documento firmado (tareas ambas absolutamente ligadas al modo de firma) y a continuación, cuando la verificación prospera y el documento firmado es extraído del fichero de firma, se obtienen sus datos principales para, de acuerdo a ellos, asignarle el *grupo de ficheros* de propósito verificar que le corresponde. ## 📝 Ejemplos En los siguientes ejemplos, todos los *grupos de ficheros* mencionados comparten el mismo directorio de entrada): **Ejemplo 1** > *Grupo de ficheros uno* para formato *A* con valor *nif* en NIF\ > *Grupo de ficheros dos* para formato *A* con valor para importe de operación mayor entre *X* e *Y*. Si llega al directorio de entrada un fichero de formato *A*, con NIF *nif* en la figura principal y un importe de operación mayor entre *X* e *Y*, el sistema encuentra ambigüedad a la hora de asignar un *grupo de ficheros* al fichero dado que podría aplicarle tanto `Grupo de ficheros uno` como `Grupo de ficheros dos`. En este caso, el sistema no acepta el fichero y lo informa. **Ejemplo 2** > *Grupo de ficheros uno* para formato *A* con NIF *nif* e importe de operación mayor entre *X* e *Y*.\ > *Grupo de ficheros dos* para formato *A* con NIF *nif*.\ > *Grupo de ficheros tres* para formato *A* sin valores para NIF, sufijo, cuenta e importe. Si llega al directorio de entrada un fichero de formato *A* con NIF *nif* en la figura principal y un importe de operación mayor entre *X* e *Y*, aunque en el sistema se han definido también *Grupo de ficheros dos* y *Grupo de ficheros tres*, que en cuanto a valores serían posibles candidatos para ese fichero, no existe ambigüedad a la hora de asignar el *grupo de ficheros* al fichero dado que *Grupo de ficheros uno* es más restrictivo que los otros dos (es el que tiene un mayor número de parámetros definido). Si llega al directorio de entrada un fichero de formato *A* con NIF *nif* en la figura principal y un importe de operación mayor que no está comprendido entre *X* e *Y*, se le asignará *Grupo de ficheros dos* porque es más restrictivo que *Grupo de ficheros tres*, que es el único otro candidato en este caso. Si llega al directorio de entrada un fichero de formato *A* pero con NIF distinto de *nif*, se le asignará *Grupo de ficheros tres* porque es el único posible candidato en este caso. Si llega al directorio de entrada un fichero de formato *B*, como no hay ningún *grupo de ficheros* definido para ese formato, el sistema no recibe el fichero y lo informa. 📌 **En resumen, el sistema siempre escoge el *****grupo de ficheros***** más restrictivo entre todos los que podrían aplicar al fichero. Cuando entre todos los que podrían aplicar al fichero exista ambigüedad porque ninguno de ellos es más restrictivo que los demás, no se recibe el fichero y se informa. Por último, cuando no exista ningún grupo de ficheros candidato para el fichero, tampoco se recibirá por parte de Connect y se informará.** Una vez configurados los parámetros generales y de transmisión del *grupo de ficheros*, se deberá pasar a la siguiente pantalla para dar de alta los *grupos de firmantes* y para definir el número total de firmas necesarias para cada fichero. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.editran.onesait.com/documentacion-editran/connect-v3.1/firma/administracionconnectfirma/grupoficheros/alta/configuracion.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.