editran/sepa
Anuncio
EDITRAN/SEPA Conversor XML SEPA OS/400 Manual de usuario INDRA 25 de septiembre de 2015 INDRA La información aquí contenida puede ser objeto de cambios sin previo aviso. Las distintas versiones del producto pueden dar lugar a cambios, adiciones o supresiones de información en este documento. La correspondencia acerca de este documento debe realizarse en la hoja de comentarios aquí incluida y debe ser dirigida a la dirección de correo electrónico editran@indra.es, o a la dirección Indra, Producto EDITRAN, Avda. de Bruselas 35, 28108 Alcobendas-MADRID Comentarios de usuario sobre esta documentación. Exprese, y háganos llegar, su opinión y comentarios acerca de la documentación entregada y así podremos corregirla en las posteriores versiones de este documento. Producto: EDITRAN/SEPA OS/400 Manual de usuario Avda. de Bruselas 35. 28108 Alcobendas, MADRID. ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ ______________________________________________________________________________________________________________________________ Empresa: __________________________________________________________________________________________ Departamento: __________________________________________________________________________________________ Contacto : __________________________________________________________________________________________ Dirección : __________________________________________________________________________________________ EDITRAN/SEPA OS/400 Manual de usuario ÍNDICE 1. INTRODUCCION ................................................................................................................................... 1-1 2. REQUISITOS E INSTALACIÓN.............................................................................................................. 2-1 2.1. Requisitos. ..................................................................................................................................................... 2-1 2.2. Instalación: ..................................................................................................................................................... 2-5 2.3. Configuración del fichero Entidades.properties ......................................................................................... 2-6 2.1.1. 2.2.1. 3. Normativa y restricciones. ................................................................................................................................................................................................. 2-1 AS400 (java)............................................................................................................................................................................................................................. 2-5 DESCRIPCIÓN DE LA FUNCIONALIDAD. ............................................................................................. 3-1 3.1. Uso de listas de ficheros por EDItran. .......................................................................................................... 3-1 3.2. Parametrización EDItran. .............................................................................................................................. 3-3 3.3. Casos de uso de los conversores. ................................................................................................................. 3-4 3.4. Datos de entrada-salida para los conversores. .......................................................................................... 3-5 3.5. CLS y PROCEDIMIENTOS. ............................................................................................................................. 3-12 3.4.1. 3.6. 4. 4.1. Datos pasados al conversor mediante PARM. ........................................................................................................................................................... 3-6 Procedimientos. ........................................................................................................................................... 3-12 3.6.1.1. 3.6.1.2. Previo a emisión..................................................................................................................................................................................................... 3-12 Posterior a recepción. .......................................................................................................................................................................................... 3-21 ANEXO A. ............................................................................................................................................. 4-2 Códigos de Resultado del servidor............................................................................................................... 4-2 EDITRAN/SEPA OS/400. Manual de usuario. 1. INTRODUCCION La normativa SEPA exige intercambiar las siguientes normas en formato XML: Adeudos Directos SEPA en fichero electrónico – Esquema Básico (19.14) Adeudos Directos SEPA en fichero electrónico – Esquema B2B (19.44) Órdenes en fichero para emisión de transferencias y cheques en euros (34.14) Se han desarrollado unos conversones que permiten: Transforman los ficheros formato plano moderno (longitud de registro 600) a XML Transforman XML a ficheros formato plano moderno (longitud de registro 600) Estos conversores, podrán llamarse: En el previo a emisión, con un nuevo procedimiento (P1PRESEPA) que lleva un nuevo paso, previo al paso A1P En el posterior a recepción, con un nuevo procedimiento (P4POSSEPA) que lleva un nuevo paso, posterior al paso A4P Los conversores (programas CLI1SEPA y CLI4SEPA), llaman a un programa cliente TCP (WORKERSEPA), que se conecta contra el servidor java, residente en los servicios UNIX del AS/400. Le indican: 1. Datos para conexión al servidor a. IP y puerto del servidor java b. Tiempo de espera de respuestas del servidor java 2. Datos de la petición a. Función (1) plano a xml, (2) xml a plano b. Nombre de fichero de entrada c. Nombre de fichero de salida d. Tabla de traducción (sólo en caso necesario) 3. Otros datos a. Código origen, b. Código remoto (en caso de lanzarse con ficheros no Editran, es necesario indicar un código remoto de una sesión de pruebas) c. Aplicación (en caso de lanzarse con ficheros no Editran, es necesario indicar una aplicación de una sesión de pruebas) INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 1-1 EDITRAN/SEPA OS/400. Manual de usuario. 2. Requisitos e instalación. 2.1. Requisitos. El usuario, debe crear un fichero (ó n), con ciertos parámetros para pasar al conversor (detallado en este documento). Se debe tener instalado, al menos, la versión 5.4 de sistema operativo, Disponer de versión EDItran 5.0 ó superior Licencia. Haber contratado el producto EDItran/SEPA para SEPA. JAVA. Versión 1.6 de Java JRE. Una dirección y un puerto TCP en el que escuchar las peticiones realizadas desde el EDItran en as400 Acceso a los servicios UNIX del as400 EDItran, no realiza una validación de los ficheros de aplicación, sólo hace la conversión de plano a XML ó de XML a plano. 2.1.1. Normativa y restricciones. La normativa concreta que cumplen nuestros conversores es la siguiente: SEPA – 14 (ficheros planos) Documento “Órdenes en fichero para emisión de transferencias y cheques en euros”. Serie normas y procedimientos bancarios Nº 34-14, versión Noviembre 2012 Documento “Adeudos directos SEPA en formato electrónico - Esquema Básico”, Serie normas y procedimientos bancarios Nº 19-14, versión Noviembre 2012 Documento “Adeudos directos SEPA en formato electrónico - Esquema B2B”, Serie normas y procedimientos bancarios Nº 19-44, versión Noviembre 2012 Órdenes en formato ISO 20022 (ficheros xml) Documento Órdenes en formato ISO 20022 para emisión de transferencias y cheques en euros. Serie normas y procedimientos bancarios. Guía de Implantación v1.0, Noviembre 2012. Sigue el esquema pain.001.001.03.xsd Documento Órdenes en formato ISO 20022 para emisión de adeudos directos SEPA – Esquema Básico. Serie normas y procedimientos bancarios. Guía de Implantación, Noviembre 2012. Sigue los esquemas pain.008.001.02.xsd, pain.002.001.03.xsd y pain.007.001.02.xsd Documento Órdenes en formato ISO 20022 para emisión de adeudos directos SEPA – Esquema B2B. Serie normas y procedimientos bancarios. Guía de Implantación, Noviembre 2012. Sigue los esquemas pain.008.001.02.xsd, pain.002.001.03.xsd y pain.007.001.02.xsd EDItran, a modo de ejemplo, transmitirá: INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 2-1 EDITRAN/SEPA OS/400. Manual de usuario. o pain.008.001.02 Inicio Adeudo Directo (recibido por Editran desde aplicaciones de negocio) o pain.002.001.03 Comunicación de Estado En el formato pain.002.001.03 Comunicación de Estado Transferencia (enviado a aplicaciones de negocio), no existe norma plana, por lo que EDItran no transformará este contenido. o pain.007.001.02 Solicitud de Cancelación o pain.002.001.03 Comunicación de Devoluciones (enviado a aplicaciones de negocio) o pain.001.001.03 Inicio Transferencia (recibido por Editran desde aplicaciones de negocio) o AMPLIACIÓN versión del C19.14+ que ha publicado CECA. Consiste en adaptar el conversor de los xml de adeudos Sepa para incluir nuevas etiquetas que permitan informar conceptos ampliados (hasta 640 caracteres) para generar un nuevo cuaderno C19.14+ que se diferencia del actual en que incorpora un nuevo tipo de registro para incluir los conceptos con más de los 140 caracteres que se permiten actualmente. Por ello existirá un conversor (licenciado) capaz de tratar una nueva versión del CustomerDirectDebitInitiationV02 (pain.008.001.02) y generar una versión del C19.14+ que ha publicado CECA. o SEPARADOR XML Esta funcionalidad es un añadido a EDITRAN/SEPA, por tanto, esta funcionalidad también requiere una licencia adicional para poder usarse. En el caso de no tener esta licencia adicional si está interesado se debe poner en contacto con el Soporte de EDITRAN. Los archivos Xml no están pensados para ir anidados dentro de un solo fichero, ya que el fichero resultante no es un fichero válido. En respuesta a algunos clientes, se ha añadido una nueva funcionalidad que convierte esos ficheros con varios Xml anidados en un fichero con sus correspondientes planos anidados. o SEPARADOR PLANOS De manera análoga a la funcionalidad anterior, el conversor puede tratar ficheros de entrada de formato plano que incluyan varios ficheros lógicos. En este caso, el resultado de la conversión será un fichero cuyo contenido podrá ser un único fichero XML lógico o varios,. Para utilizar estas funcionalidades de los separadores, que requieren licencias específicas, en vez de iniciar EDITRAN/SEPA usando los scripts start.sh y stop.sh, se deben usar los scripts alternativos incluidos en la carpeta /scripts; startSeparador.sh y stopSeparador.sh. Estos scripts sustituyen a los anteriores. Antes de poder usar estos scripts, se debe configurarlos primero. La forma de configurarlos es exactamente la misma que en los scripts para EDITRAN/SEPA (apartado Instalación 2.2.1) INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 2-2 EDITRAN/SEPA OS/400. Manual de usuario. o Mensaje de respuesta automático Este campo sirve para generar mensajes de respuesta cuando se reciben ciertas normas SEPA, aunque sólo se puede usar para conversiones XML a Plano de las normas 3414 y 19 de tipo Presentaciones, en las que se genera este fichero. El código devuelto en <StsRsnInf> informa de si se ha podido realizar la conversión (ACCP), o no (RJCT). El valor de este campo es el nombre del fichero de respuesta automático. Por defecto no se crea el fichero de respuesta EDItran, no convierte tampoco la norma 57 (cobros en ventanilla bancaria) EDItran, con los conversores, trata siempre planos en formato “moderno”, con longitudes de registro 600. Todavía hay entidades que usan el formato antiguo, con longitud 72 ó 162, y estos ficheros no son tratados en los conversores descritos. Algunas entidades, introducen “particularidades” en los ficheros XML ó planos. En principio, habría que valorar técnicamente esas adaptaciones, ver si son posibles con el software distribuido, y si no fuera el caso valorarlas económicamente. Si las mismas se refieren al contenido de los ficheros xml, a los datos, pero no afectan a la estructura que exige el esquema, longitudes de los campos, etc., en principio, el conversor podría servir tal cual está son las entidades, las que siguen su propio reglamento a la hora de confeccionar los ficheros, si bien hay que tener en cuenta ciertos aspectos: Uno es que hay que ser conscientes de que la información que recoge el xml es un poco más extensa que la que puede alojar el fichero plano, por lo que esos datos (pocos), se pierden cuando la transformación es en ese sentido o no aparecen cuando son en el sentido contrario. Otro aspecto es el contrario, por ejemplo, puede que alguna normativa indique que no se va a utilizar la etiqueta <CtrlSum> en la cabecera del fichero xml. Dicha etiqueta recoge la suma de los importes de todas las operaciones del fichero y efectivamente según el esquema no es obligatorio rellenarla, sin embargo nuestro conversor siempre la añade puesto que en el fichero plano ese dato sí es obligatorio y la pauta que estamos siguiendo, por el momento, es la de que se pierda el mínimo de información posible en ambos sentidos. Otro ejemplo. La prioridad de la instrucción no está en el plano, por tanto, los xml que generamos no incluyen ese dato, por lo que se supone el defecto que es prioridad normal, y por tanto si el xml que tratamos lo lleva, en el plano se pierde. En general el fichero en formato xml está preparado para recoger más información que la especificada en las normas planas, por ejemplo en la norma xml de la norma 34 hay un identificador de mensaje que se pierde al llevarlo a plano, también en el xml se recogen la fecha y la hora de creación mientras que en el plano sólo es posible almacenar la fecha, en la norma plana 34-14 no se recoge la figura de presentador sobre la que en cambio sí se puede dar información en la norma xml, la clase de pago que se recoge en el registro de balanza de pagos de la norma plana 34-14 no se puede trasladar a la norma xml, en la norma plana no existe campo donde informar del BIC de la entidad del ordenante, dato que sí se refleja en la norma xml. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 2-3 EDITRAN/SEPA OS/400. Manual de usuario. Ampliación de la funcionalidad: Generar una versión del c19.14+ que ha publicado CECA. Permite convertir los ficheros planos de formato SEPA longitud de registro 600) a XML ISO 20022 y viceversa. Esta ampliación consiste en adaptar el conversor de los xml de adeudos Sepa para incluir nuevas etiquetas que permitan informar conceptos ampliados (hasta 640 caracteres) para generar un nuevo cuaderno C19.14+ que se diferencia del actual en que incorpora un nuevo tipo de registro para incluir los conceptos con más de los 140 caracteres que se permiten actualmente. Por ello existirá un conversor capaz de tratar una nueva versión del CustomerDirectDebitInitiationV02 (pain.008.001.02) y generar una versión del C19.14+ que ha publicado CECA. Separador XML Esta funcionalidad es una ampliación a EDITRAN/SEPA que convierte ficheros con varios Xml anidados en un fichero con sus correspondientes planos anidados. Separador planos Esta funcionalidad es una ampliación a EDITRAN/SEPA que convierte ficheros con varios planos anidados en un fichero con sus correspondientes XML anidados INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 2-4 EDITRAN/SEPA OS/400. Manual de usuario. 2.2. Instalación: 2.2.1. AS400 (java) Descomprimir el archivo EDItranSepaXml.tar en la carpeta de instalación creada para este fin p.ej. /editransepa quedando la siguiente estructura de directorios a partir de esta: |-conf |-bin |-lib |-logs Primero deberíamos comprobar que los ficheros start.sh y stop.sh tienen permisos de ejecución. A continuación se edita el fichero start.sh y se da valor a las siguientes variables: PWD=/ editransepa (ruta de instalación, donde se ha descomprimido) IP="0.0.0.0" (IP en la que arranca el servidor) PORT="7774" (PUERTO en el que está escuchando el servidor) JAVA_HOME="/QOpenSys/QIBM/ProdData/JavaVM/jdk60/32bit" (ruta de instalación de java) Posteriormente se edita el fichero stop.sh dando valor a las siguientes variables PWD=/ editransepa (ruta de instalación, donde se ha descomprimido) Una vez hecho esto ya es posible arrancar la aplicación ejecutando el comando: ./start.sh Para comprobar que el Servidor ha arrancado correctamente una vez ejecutado el comando editamos el archivo logs/out.log, y debería tener las siguientes trazas (en el puerto y la IP deberán aparecer las que hayamos configurado en el fichero): 17/04/2012 11:16:40,013 8530 INFO [main] servers.ThreadPooledServer main Starting Server 17/04/2012 11:16:40,031 openServerSocket - Port:7775 8548 INFO [Thread-3] servers.ThreadPooledServer 17/04/2012 11:16:40,033 8550 INFO [Thread-3] servers.ThreadPooledServer openServerSocket - LocalSocketAddress:/192.168.172.88:7775 INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 2-5 EDITRAN/SEPA OS/400. Manual de usuario. 17/04/2012 11:16:40,035 8552 INFO [Thread-3] openServerSocket - InetAddress:/192.168.172.88 servers.ThreadPooledServer Para parar el proceso: ./stop.sh Existen los ficheros: EDItranSepaXml.tar, EDItranSepaXml.rar, para probar una posible instalación desde cero. Existe un fichero de logs del servidor en el que se puede ver la evolución de las peticiones errores etc...(Logs/out.log). 2.3. Configuración del fichero Entidades.properties Este fichero es la plantilla de Entidades. Es un fichero opcional que configura una fuente de datos extra necesaria para que la conversión bidireccional entre los formatos XML y plano sea completa y correcta. Cuando este fichero no está definido, o los datos que se busquen no se encuentren, según el sentido de la transformación realizada los campos del formato plano se rellenaran con ceros o las etiquetas correspondientes de los formatos XML quedaran vacías. En concreto permite informar tanto la entidad y oficina del presentador en el formato plano de la norma 19 como los BIC de los ordenantes de la norma ISO de transferencias y de los acreedores de la norma ISO de adeudos. Pueden apuntarse en la lista tantas entidades como sean necesarias. El fichero contendrá exclusivamente relaciones entre números BIC y la pareja de números “entidad + oficina” con los que se corresponden. Será de uso exclusivo para entidades españolas pues el número “entidad + oficina” indicado se buscará en las posiciones desde la 4 a la 11, empezando a contar por 0, de las cuentas IBAN (comienzan por "ES") correspondientes a la figura de la que se desea informar del BIC o de la “entidad + oficina”. Ejemplo de localización: ES0001234567000000000000 Contenido inicial del fichero: #Ejemplo #bic.0=ABCDEFGHXXX #entyof.0=01234567 bic.1= entyof.1= bic.2= entyof.2= INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 2-6 EDITRAN/SEPA OS/400. Manual de usuario. 3. Descripción de la funcionalidad. 3.1. Uso de listas de ficheros por EDItran. EDItran permite la transmisión de varios ficheros por la misma sesión Para emitir: Algunos clientes, utilizan lista de ficheros (LISTAFICH, ver formato TABLA 1) para realizar las cargas, pues sus ficheros tienen nombres distintos en cada una de ellas. Por tanto, crean diariamente una lista de ficheros de cada presentación a emitir. Esta lista, es pasada al paso previo a emisión. Normalmente, para poder utilizar un único procedimiento con todos los remotos. el contenido de la lista de ficheros está formada con variables reconocibles por el procedimiento (origen, remoto y aplicación). Otros clientes, utilizan siempre los mismos nombres de ficheros a emitir (en cada transmisión tienen distinto contenido), por lo que optan por indicar en los propios perfiles del producto, el nombre de los ficheros a emitir. Para recibir: En los perfiles EDItran, se indica el nombre de los ficheros a descargar, EDItran descarga los ficheros recibidos con el nombre indicado. Tabla 1. Contenido del fichero LISTAFICH, fichero fijo de 327 de longitud, cuyo contenido son los ficheros de aplicación de emisión y las características de los mismos. El contenido es el siguiente (un registro por fichero): Nivel 1 2 2 2 1 2 2 2 Nombre Clave Identificador Sesión Número Orden Fichero de Aplicación Nombre físico filler Formato de fichero Long Tipo Descripción 1 24 2 Alfn. Alfn. Alfn. Identificador del registro de fichero “F” Sesión: CodLoc+CodRem+Aplicación Número de orden del fichero 30 8 1 Alfn. Nombre físico del fichero de aplicación Alfn. 2 Lenguaje datos origen 1 Alfn. 2 Traducir en emisión 1 Alfn. 2 Compresión 1 Alfn. Formato de fichero de aplicación: ‘R’: Registro, ‘B’: Binario Lenguaje original de los datos: ‘A’: Ascii, ‘E’: Ebcdic Lenguaje en el que se emiten los datos: ‘A’: Ascii, ‘E’: Ebcdic, ‘N’:Sin traducción Compresión: ‘S’ Comprimido, ‘N’ Sin compresión 2 2 2 Filler Nombre Fichero Binari Long fich binario 2 251 5 Alfn. Num INDRA. Todos los derechos reservados. EDITRAN/SEPA Nombre del Fichero Aplicación Binario Long a zeros Pág. 3-1 EDITRAN/SEPA OS/400. Manual de usuario. Uso de la zona libre de los registros Se ha acordado con ciertos clientes el uso de algunas posiciones de las zonas libres de ciertos registros de los ficheros en formato plano. La finalidad es alojar en ellos cierta información que, estando en el fichero XML de origen, se pierde en la conversión por no estar definido un campo para ella en la norma correspondiente. Dicha información es tratada exclusivamente por las aplicaciones de cliente que sólo tratan ficheros en formato plano y generalmente se emplean para generar a partir de ellos los ficheros de confirmación directamente en formato XML. Para hacer uso de esta funcionalidad hay que indicar ‘S’ en el parámetro Información libre del fichero ZTBGFDAT de la llamada al programa pues por defecto el conversor no la realiza. A continuación se describen los valores trasladados desde el fichero en formato XML y los registros y posición donde se dejan en el fichero de formato plano fruto de la transformación. Emisión de transferencias y cheques: Se traslada el contenido de: <GrpHdr><MsgId> a la posición 290 del registro de cabecera del ordenante. <PmtInf><DbtrAcct><Ccy> a la posición 325 del registro de cabecera del ordenante, siempre que el valor sea distinto de “EUR”. <PmtInf><PmtInfId> a la posición 23 de los registros de cabecera de transferencias SEPA, de otras transferencias o de cheques, según el tipo de bloque de los tres del que proceda el dato. El valor del atributo Ccy de <PmtInf><CdtTrfTxInf><Amt><InstdAmt Ccy="XXX"> o de <PmtInf><CdtTrfTxInf><Amt><EqvAmt><Amt Ccy="XXX">, siempre que sea distinto de “EUR”, en la posición 502 del primer registro obligatorio de beneficiario de transferencias si el bloque de origen es de transferencia SEPA. En cuanto a los registros de totales, recogen la suma de importes del fichero independientemente de la divisa en la que estén expresados en sus registros de beneficiario correspondientes. <PmtInf><CdtTrfTxInf><Amt><EqvAmt><CcyOfTrf> a la posición 505 del primer registro obligatorio de beneficiario de transferencias si el bloque de origen es de transferencia SEPA. <PmtInf><CdtTrfTxInf><XchgRateInf><XchRate> a la posición 508 del primer registro obligatorio de beneficiario de transferencias si el bloque de origen es de transferencia SEPA. <PmtInf><CdtTrfTxInf><XchgRateInf><RateTp> a la posición 521 del primer registro obligatorio de beneficiario de transferencias si el bloque de origen es de transferencia SEPA. <PmtInf><CdtTrfTxInf><XchgRateInf><CtrctId> a la posición 525 del primer registro obligatorio de beneficiario de transferencias si el bloque de origen es de transferencia SEPA. Se escribe “XML” en la posición 598 del registro de cabecera de ordenante. Adeudos directos (esquemas básicos y B2B): Se escribe “XML” en la posición 598 del registro de cabecera de presentador. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-2 EDITRAN/SEPA OS/400. Manual de usuario. En la conversión de la Presentación de adeudos de XML a plano, se traslada el contenido del campo <PmtInfId> a la posición 300 del registro de [Cabecera de acreedor por fecha de cobro]. Por su parte, cuando sea el cliente quien genere los ficheros planos, puede hacer uso de ciertas zonas libres para alojar en ellas información que de otra manera sería imposible trasladar al formato XML. Son las siguientes: Emisión de transferencias y cheques: Se trasladará el contenido de: 70 posiciones, comenzando en la 290, de la Cabecera de Ordenante a <InitgPty><Nm>. Esta funcionalidad se utiliza para poder transformar a un único XML varios ficheros lógicos planos que no coinciden en los nombres de ordenante. Adeudos directos (esquemas básicos y B2B), mensajes de devolución y rechazos: 35 posiciones, comenzando en la 335, del registro de [Cabecera de acreedor por fecha de cobro] a <OrgnlPmtInfAndSts><OrgnlPmtInfId>. El conversor buscará en primer lugar esta información en los campos libres y, de no estar, efectuará el mapeo como lo hace habitualmente para cada uno de esos campos. 3.2. Parametrización EDItran. Cuando se transmiten ficheros SEPA (XML), estos ficheros van en UTF-8 y no se pueden traducir, de ahí que en las sesiones EDItran que utilicen este tipo de ficheros, es requisito indicar: Lenguaje original de los datos: Binario Traducir en emisión: No Traducir en Recepción: No Tabla de conversión de emisión: Espacios. Tabla de conversión de recepción: Espacios Previo a emisión (se proporciona un nuevo procedimiento) Posterior a recepción (se proporciona un nuevo procedimiento) En los casos de recepciones, se recomienda actuar de la siguiente forma: EDItran, permite recibir n ficheros en cada transmisión. El usuario, puede indicar en los perfiles, en NOMBRE FISICO FICHERO APLICACIÓN RECEPCION: Que el usuario indique un nombre fijo. Que el usuario indique un nombre con variables. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-3 EDITRAN/SEPA OS/400. Manual de usuario. 3.3. Casos de uso de los conversores. Se plantean básicamente 3 casos de uso para llamar a los conversores: En procedimientos previos a emisión (A1P). En este caso, se plantea utilizar el conversor en un paso previo al A1P, de forma que con un único nuevo procedimiento (P1PRESEPA), se pueda dar solución a todas las sesiones de presentación EDItran que requieran emitir ficheros XML. Además, se da solución para que para el usuario, este conversor sea transparente con respecto a su funcionamiento anterior de carga (planos) Procedimientos posteriores a recepción (A4P). En este caso, se plantea utilizar el conversor en un paso posterior al paso A4P , de forma que con un único nuevo procedimiento (P4POSSEPA), se pueda dar solución a todas las sesiones de presentación EDItran que requieran recibir ficheros XML y los quieran pasar a PLANOS. Además, se da solución para que para el usuario, este conversor sea transparente con respecto a su funcionamiento anterior de descarga (planos) En definitiva, los conversores de planos a XML y de XML a plano, se han desarrollado: De forma que sirvan para ficheros transmitidos por EDItran. En este caso, lo más común será utilizar 2 nuevos procedimientos standard del producto: un previo a emisión (P1PRESEPA) y un posterior a recepción (P4POSSEPA). INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-4 EDITRAN/SEPA OS/400. Manual de usuario. 3.4. Datos de entrada-salida para los conversores. Datos de salida En todos los casos, se generará una lista de ficheros de salida que genera el proceso P1PRESEPA. Esta lista se genera por cada carga y no se borra, se va añadiendo una nueva. No se borra, para tenerla como comprobación de los ficheros que se van a enviar. Esta lista de ficheros de salida, es la que está en el paso A1P Por tanto, se incluirá como dato de entrada al conversor, el conversor genera una lista de ficheros, que será la que le llega al A1P. Datos de entrada Para llamar a los conversores, se usan: INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-5 EDITRAN/SEPA OS/400. Manual de usuario. 3.4.1. Datos pasados al conversor mediante PARM. Se ha creado un fichero de perfiles PERFSEPA, que contiene los datos necesarios para pasar a los conversores Se accede con el comando EDISEPA Por un lado está el Entorno Local que se define una vez y que contiene: Origen. código origen de la entidad. Dirección IP del servidor SEPA Puerto Timeout INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-6 EDITRAN/SEPA OS/400. Manual de usuario. Para definir sesiones que se utilizaran para obtener los parámetros de la descarga de recepción. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-7 EDITRAN/SEPA OS/400. Manual de usuario. Origen. código origen de la entidad. Destino. código destino Aplicación. Código de alguna aplicación/g ejemplo. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-8 EDITRAN/SEPA OS/400. Manual de usuario. Para el caso de EMISION, Leemos los perfiles de entorno para sacar la dirección del servidor Java, esto lo hace una vez que desde el proceso previo P1PRESEPA se le pasa los parámetros de la sesión y el nombre de la lista de ficheros, este proceso llama al PBIGA110SP que es el proceso equivalente al PBIGA110 pero específico de SEPA. Para el caso de RECEPCION, El proceso P4POSEPA se pondrá como programa posterior a recepción en la sesión de transmisión de EDItran/P. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-9 EDITRAN/SEPA OS/400. Manual de usuario. El proceso P4POSSEPA pasa “SEPA” al proceso posterior a recepción además de los parámetros de la sesión, siendo el programa C4GENERI el que lee de perfiles SEPA los ficheros recibidos y el nombre de los ficheros adaptados para pasárselos al conversor CLI4SEPA. Estos nombres deben coincidir con el Nombre Físico Fichero Aplicación Recepción que se ponga en el perfil de EDItran/g Si es transforma = F coincide con el nombre del fichero recibido INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-10 EDITRAN/SEPA OS/400. Manual de usuario. Si es transforma = X coincide con el nombre del fichero adaptado INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-11 EDITRAN/SEPA OS/400. Manual de usuario. 3.5. CLS y PROCEDIMIENTOS. 3.6. Procedimientos. 3.6.1.1.Previo a emisión. Se proporciona el previo P1PRESEPA. Ejemplo: INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-12 EDITRAN/SEPA OS/400. Manual de usuario. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-13 EDITRAN/SEPA OS/400. Manual de usuario. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-14 EDITRAN/SEPA OS/400. Manual de usuario. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-15 EDITRAN/SEPA OS/400. Manual de usuario. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-16 EDITRAN/SEPA OS/400. Manual de usuario. Ahora veremos el EJEMPLO 2 donde la transformación será de fichero XML a *FILE INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-17 EDITRAN/SEPA OS/400. Manual de usuario. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-18 EDITRAN/SEPA OS/400. Manual de usuario. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-19 EDITRAN/SEPA OS/400. Manual de usuario. Se rellena la lista de ficheros en el programa que transforma los ficheros CLI1SEPA El CLI1SEPA llama al WORKERSEPA : Se le indica que si el paso es : “X” --- *FILE a XML. o “F” --- XML a *FILE EDItran, en un primer paso para el caso “X” transformar de *FILE a XML, pasará los ficheros leídos en formato XML. Creará una lista, LSEPA0000 cuyo contenido es una lista de ficheros con los nombres de los XML generados. A continuación, el paso A1P tirará de la nueva lista de ficheros LSEPA0000, y cargará los mismos EDItran, en un primer paso para el caso “F” transformar de XML a *FILE, pasará los ficheros leídos en formato *FILE. Creará una lista, LSEPA0000 cuyo contenido es una lista de ficheros con los nombres de los *FILE generados. A continuación, el paso A1P tirará de la nueva lista de ficheros LSEPA0000, y cargará los mismos INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-20 EDITRAN/SEPA OS/400. Manual de usuario. 3.6.1.2.Posterior a recepción. Se proporciona el posterior P4POSSEPA, que se pondrá en procedimiento posterior a recepción y tiene lo siguiente: Es el C4GENERI, el que si le entra SEPA, pues llamará al conversor CLI4SEPA y este leerá del fichero de perfiles de SEPA los datos correspondientes y los tratará: El CLI4SEPA llama al WORKERSEPA : Se le indica si transforma = “F” , que el paso es XML a *FILE O si transforma = “X” , que el paso es *FILE a XML EDItran en el paso A4P, descarga los ficheros recibidos (XML). Si en los perfiles se indicó un nombre de descarga, por ejemplo EDISEPA/SALIDA%C, descargará con ese nombre (Este nombre debe coincidir con el definido en la sesión de SEPA –nombre del fichero adaptado). INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-21 EDITRAN/SEPA OS/400. Manual de usuario. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-22 EDITRAN/SEPA OS/400. Manual de usuario. EDItran en el paso A4P, descarga los ficheros recibidos (*FILE). Si en los perfiles se indicó un nombre de descarga, por ejemplo /editransepa/fichr%C, descargará con ese nombre (como es transforma = F, este nombre debe coincidir con el definido en la sesión de SEPA – nombre del fichero recibido). NOTA: hay que añadir la librería EDISEPA a la lista de librerías de las *JOBD EDITAJD y PFTAI001 de Editran. INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 3-1 EDITRAN/SEPA OS/400. Manual de usuario. 4. ANEXO A. 4.1. Códigos de Resultado del servidor Los posibles resultados son: 00 -Transformación correcta del fichero Errores de comunicaciones y gestión de ficheros 01 - Error al leer el socket 02 - Error en los parámetros de entrada 03 - No se ha encontrado o tiene un valor inválido el parámetro Función de la petición 04 - No se ha encontrado el parámetro Fichero de entrada 05 - No se ha encontrado el parámetro Fichero de salida 06 - No se ha encontrado o tiene un valor inválido el parámetro Lenguaje de la petición 07 - El parámetro Validar Xml tiene un valor invalido. Puede ser [S] o [N] 08 - Error al realizar el conversor 09 - Error al escribir la respuesta 10 - No se ha encontrado el fichero de entrada 11 - Error al abrir el fichero de salida 12 - Error al cerrar los ficheros 13 - Error en los ficheros 14 - Error al borrar el fichero de salida Errores en el conversor plano a xml 15 - Error en el fichero plano. No se reconoce el tipo de norma a la que pertenece el fichero 16 - Error al leer el fichero plano 17- Error en el unmarshaller del plano 18 - Error en la conversión entre objetos de plano a xml 19- Error en el marshaller del xml Errores en el conversor xml a plano 20 - Error en el fichero xml. No se reconoce el tipo de norma a la que pertenece el fichero 21 - Error al leer el xml 22 - Error al validar el xml INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 4-2 EDITRAN/SEPA OS/400. Manual de usuario. 23- Error en el unmarshaller del xml 24- Error en la conversión entre objetos de xml a plano 25 - Error en el marshaller del plano 26- Error, el valor del importe es inválido 27 - Licencia incorrecta 28- Fichero vacío INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 4-3 Centros de Competencia eCommerce Avda. de Bruselas 35 28108 Alcobendas. Madrid, España T. +34 91 480 80 80 T. +34 91 480 50 00 www.indracompany.com INDRA. Todos los derechos reservados. EDITRAN/SEPA Pág. 4-1
