> 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/editran-sepa-v3/adaptacion-para-pagos-telematicos-de-la-tgss.md). # Adaptación para Pagos Telemáticos de la TGSS Para facilitar a nuestros clientes la integración del protocolo completo de Pagos Telemáticos de la TGSS con el conversor SEPA, se han implementado los dos mapeos adicionales que se detallan en este documento. ## 10.1 Recepción de los ficheros Las entidades van a recibir de la TGSS los ficheros en formato XML, según el esquema `pain.001.001.03.xsd` de ISO 20022. **XML (pain.001.001.03) → Conversor → Fichero formato plano: registro de cabecera TGSS + fichero SEPA 34-14** El contenido de la etiqueta `` de estos ficheros XML es: * Tipo de envío (2 posiciones): * Fecha de creación del fichero, 6 posiciones (AAMMDD) * NRBE entidad financiera del pago (4 posiciones) * Referencia (20 posiciones) Bajo la indicación específica del parámetro `param.Cabecera`, cuando estos ficheros pasen por el Conversor, se traducirán a formato plano. > **Atención:** si no se desea añadir esa cabecera en todos los ficheros de la norma 34-14 que pasen por el conversor, `param.Cabecera` se indicará como parámetro de la máquina virtual de Java en el script correspondiente de la sesión de Editran, y no en el fichero `Configuracion.properties` (véase el apartado [5 Configuración de Onesait Ecosystems · Editran/SEPA](#5-configuración-de-onesait-ecosystems--editransepa)). El uso de este parámetro ignora cualquier valor dado a `param.resp.auto` si el fichero a convertir es de la norma 34-14. El contenido del fichero resultante será el registro de cabecera TGSS que se definió en su día, cuya estructura se detalla a continuación, seguido por el fichero sepa 34-14. **REGISTRO DE CABECERA DE TRANSMISIÓN (formato plano)** | Campo | Descripción | | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **CAMPO A** | Código de Registro de Cabecera. Campo numérico de 2 posiciones. Su valor será `01` | | **CAMPO B** | Código de Norma. Campo numérico de 2 posiciones. Su valor será `34` | | **CAMPO C** | Tipo de Operación. Campo numérico de 2 posiciones. Su valor será `14` | | **CAMPO D** | Tipo de envío I. Campo numérico de 2 posiciones. Sus posibles valores son: `50` - Ficheros de transferencias R03, firmadas electrónicamente | | **CAMPO E** | Tipo de envío II. Campo numérico de 2 posiciones. Sus valores serán los siguientes: `01` - Para todos los tipos de envíos anteriores (Posibilidad de incluir `06` en algún caso particular en versiones posteriores) | | **CAMPO F** | Referencia de Cliente: **F1** Fecha de creación del Fichero (numérico, 6 posiciones); **F2** Hora de Creación del Fichero (numérico, 4 posiciones); **F3** Código de la Entidad Financiera (numérico, 6 posiciones) | | **CAMPO G** | Ampliación de Referencia del Cliente. Campo alfanumérico de 20 posiciones. Contendrá el número de la R y la Caja Pagadora | | **CAMPO H** | Campo de longitud variable hasta ajustarse a 600 | El mapeo que realiza el Conversor es el siguiente: > Registro de cabecera TGSS: `01` + `34` + `14` + dos primeros caracteres de la etiqueta `` + `01` + seis siguientes caracteres de `` + `000000` + veinticuatro caracteres restantes de `` + 554 blancos. ## 10.2 Envío de la confirmación La TGSS espera recibir de las entidades un fichero de confirmación XML según el esquema `pain.002.001.03.xsd`. **Confirmación TGSS → Conversor → XML (pain.002.001.03)** Podrán obtenerlo con el Conversor aquellos usuarios que las hayan generado en sus aplicaciones en formato plano y de acuerdo a la siguiente estructura: **FICHERO DE RESPUESTA DE CONFIRMACIÓN (formato plano)** | Campo | Descripción | | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **CAMPO A** | Identificación del Cuaderno y Tipo de Operación del CSB. Su valor será `3414` | | **CAMPO B** | Identificación del Fichero transmitido: **B1** corresponde al CAMPO F1 del Registro de Cabecera de Transmisión; **B2** corresponde al CAMPO F2; **B3** corresponde al CAMPO F3 | | **CAMPO C** | Identificación de las Entidades Emisoras: **C1** Reservado (12 posiciones); **C2** Identificación de la Entidad, alfanumérico (40 posiciones) | | **CAMPO D** | Identificación de la Entidad Financiera: **D1** NRBE de la Entidad, numérico (4 posiciones); **D2** Reservado (4 posiciones) | | **CAMPO E** | Datos para el Cuadrante: **E1** Número Total de Registros que figura en el Registro de cola del fichero lógico, numérico (10 posiciones); **E2** Importe Total que figura en el Registro de cola del fichero lógico, numérico (17 posiciones); **E3** Número de Registros del Fichero Recibido, numérico (10 posiciones); **E4** Suma Total de Importes del Fichero Recibido, numérico (17 posiciones). *Nota: en la primera versión, donde existe un único fichero físico, los campos E1 y E2 aparecerán a ceros.* | | **CAMPO F** | Códigos de Control: **F1** Código Resultado de la Transmisión, numérico (2 posiciones); **F2** Reservado para futuros códigos, numérico (2 posiciones), su valor será `00` | | **CAMPO G** | Información adicional de Comprobación del Cliente: **G1** corresponde al CAMPO D del Registro de Cabecera de Transmisión; **G2** corresponde al CAMPO E; **G3** corresponde al CAMPO G; **G4** Reservado (8 posiciones) | El mapeo que realiza el Conversor es el siguiente: * ``: G1 + B1 + posiciones de la 2 a la 5 de B3 + G3 * ``: en formato ISODateTime `YYYY-MM-DDThh:mm:ss`. Primera y segunda cifra de B1, formateados a `YYYY` + "-" + tercera y cuarta cifra de B1 + "-" + quinta y sexta cifra de B1 + "T00:00:00" * ``: mismo contenido que `` * ``: `pain.001.001.03` * ``: E4 (con las dos cifras de la derecha separadas por '.') * ``: `ACTC` si F1 es `00`, `RJCT` para cualquier otro valor. * ``: según el contenido de F1 y siempre que sea distinto de `00`. *** --- # 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/editran-sepa-v3/adaptacion-para-pagos-telematicos-de-la-tgss.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.