NORMAS DE GRABACIÓN. Revisado por: Aprobado por: Elaborado por: Dpto. Explotación. Dpto. Desarrollo. Dpto. Explotación.

Transcripción

1 NORMAS DE GRABACIÓN Título: Envíos por Comunicaciones (Rechazos de Liquidaciones). Código: Destinatarios: ENESA y Organismos oficiales Fecha entrada en vigor: 3 Junio de 2014 Este Documento es propiedad de Agroseguro, S.A, todos los derechos reservados. No se permite sin la oportuna autorización escrita la cesión, copia o reproducción de este documento Elaborado por: Dpto. Desarrollo Fecha Elaboración: 30 de Mayo de 2014 Revisado por: Dpto. Explotación Fecha Revisión: 3 de Junio de 2014 Aprobado por: Dpto. Explotación Fecha Aprobación: 3 de Junio de 2014

2 CONTROL DE VERSIONES VERSIÓN FECHA VIGOR COMENTARIOS 1.0 1/6/2014 Versión inicial /6/2014 Nuevo diseño de entrada de incidencias en ETG s Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 2 de 11

3 FICHA DE DISTRIBUCIÓN DE DOCUMENTO NOMBRE/ÁREA/COMPAÑÍA SOPORTE DISTRIBUCIÓN (Intranet/ Papel) Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 3 de 11

4 INDICE 1. OBJETO AMBITO DE APLICACIÓN DOCUMENTACION DE REFERENCIA DESCRIPCIÓN DE LA NORMA INTRODUCCIÓN ENVÍO/RECEPCIÓN DE RECHAZOS DE LIQUIDACIONES Envío Recepción: ESTRUCTURA DEL ACUSE DE RECIBO Especificación de cada etiqueta EJEMPLO Acuse de Recibo Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 4 de 11

5 1. OBJETO El presente documento pretende establecer normas generales para el envío a través de comunicaciones de Rechazos de Liquidaciones. 2. AMBITO DE APLICACIÓN Estas normas serán de aplicación a ENESA y todos los Organismos Oficiales que envíen Rechazos de Liquidaciones a Agroseguro a través de comunicaciones. 3. DOCUMENTACION DE REFERENCIA Esquema de Salida AcuseRecibo.xsd Definición XML: Versión más actualizada de: Caracteres Permitidos en las Normas de Grabación (DES-X-0001) Normas Técnicas y Procedimientos Generales de Envíos (DES-N-0009) 4. DESCRIPCIÓN DE LA NORMA INTRODUCCIÓN La presente norma es para ENESA y los Organismos Oficiales que deseen utilizar el envío de Rechazo de Liquidaciones a través de Comunicaciones. Si el medio utilizado es FTP, la definición del procedimiento se detalla en al documento DES-N Si el medio utilizado es HTTP, se puede realizar a través de nuestra página web: en acceso identificado, mediante el punto de menú: XXXXXXXXXXXXXXXXXX Los documentos permitidos son los siguientes: LE Incidencias en comprobación exhaustiva de ETGs DES-N AL Aceptación de Liquidación - DES-N-0051 Se verificará en la recepción de los envíos en Agroseguro que los documentos se ajustan a la Norma especificada. Se generará el documento AcuseRecibo con la relación de errores detectados en los documentos erróneos. Los siguientes errores serán causa de rechazo total de un envío: Errores referentes a autorización a la trasmisión Validación de la etiqueta del envío (Tipo de documento erróneo ) Errores de lectura de los ficheros. El Nº de archivos recibidos NO corresponde con lo indicado en la etiqueta del envío. Serán causa de rechazo ante envío con formato XML, si el envío tiene alguno de los siguientes errores: No es un documento XML bien formado (Faltan etiquetas de apertura,..) según la Versión El esquema no se corresponde con el especificado para el tipo de documento del envío. Para cada tipo de documento se debe corresponder con el esquema de entrada establecido. Error de validación frente al esquema: Los datos no cumplen las restricciones definidas en el esquema. Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 5 de 11

6 4.2. ENVÍO/RECEPCIÓN DE RECHAZOS DE LIQUIDACIONES Envío Información relacionada con el TXT: El Código de Usuario: (*) Código Usuario/Oficina: 5 caracteres alfanuméricos, indicando el código asignado y notificado por Agroseguro. El tipo de documento debe consignarse en el fichero TXT (Tipo de documento (*)), que acompaña al ZIP en cada transmisión y será el siguiente: LE Incidencias en comprobación exhaustiva de ETGs DES-N AL Aceptación de Liquidación - DES-N-0051 (*) Tipo de Documento: 2 caracteres alfanuméricos, indicando el código del tipo de información enviada. El formato de texto (Página de códigos): N para los archivos TXT (ANSI) U para los archivos XML con encodding UTF-8 El dato Plan será el plan de las pólizas incluidas en el rechazo. 4 posiciones numéricas. El número de documentos que también se indica en el TXT (etiqueta), contendrá el número total de archivos que contiene el envío (ZIP), debe ser sólo uno. Valor fijo El dato número de pólizas rechazadas, contendrá el número total de pólizas rechazadas incluidas en el fichero empaquetado dentro del ZIP. 5 posiciones numéricas El dato número de Liquidación al que corresponde el rechazo. 4 posiciones numéricas. Ej.: La etiqueta del envío de un total de 200 Pólizas rechazadas del plan 2014, de la liquidación 6052 sería: XXXXXLEN Donde XXXXX equivale al código asignado y notificado en su momento por Agroseguro. Información relacionada con el ZIP: Los datos grabados se enviarán en un fichero empaquetado en formato ZIP (PKZIP) con la información del lote a procesar. El fichero ZIP contendrá un sólo archivo: La nomenclatura del archivo TXT/XML será la siguiente: XXXXXX Donde: XXXXXX será el Nº de ETG En el caso de no tener éxito en la operación de envío se recibirá una respuesta de rechazo Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 6 de 11

7 Recepción: Un vez procesado el envío en Agroseguro, cada Organismos recibirá una respuesta. En el caso de no tener éxito en la operación se recibirá una respuesta estándar de rechazo, si se incumplió la norma, o de terminación anormal, si existió algún problema en las comunicaciones. El formato del contenido del fichero TXT será una línea, terminada con los caracteres <CR><LF>, que contendrá los siguientes campos: Nombre del Envío: 8 caracteres alfanuméricos con el nombre del lote de información (nombre del fichero TXT/ZIP) en el que se envió la información. Código de Respuesta: 1 carácter alfanumérico, indicando el resultado de envío. La codificación seguida es la siguiente: A Envío Aceptado. (Se aceptan todos los documentos) R Envío Rechazado. (Se rechazan todos los documentos) Descriptivo del Error: 71 caracteres alfanuméricos. Vendrá relleno si el envío es rechazado. La recepción de un fichero empaquetado en formato ZIP (PKZIP) con la información detallada de la respuesta indicada en el TXT de su mismo nombre y las siguientes características: El nombre del fichero empaquetado ZIP será el mismo que el del fichero TXT previamente recibido pero con la extensión ZIP. Dicho fichero ZIP puede no existir si el error se produjo en la etiqueta recibida o por no poder leerse el paquete de información. En dicho fichero empaquetado ira el fichero AcuseRecibo con el detalle de los documentos erróneos así como la descripción del error ESTRUCTURA DEL ACUSE DE RECIBO AcuseRecibo Documento [1..1] DatosAsociados [0..N] ErrorPoliza [0..N] Localizacion [0..1] Error [0..N] Localizacion [0..1] Especificación de cada etiqueta Etiquetas Comunes AcuseRecibo Atributos Obligatorios Concepto Esquema Env.Com. Num. Documentos rechazosrecibidos Env.Com. Fec.Recepcion fecharecepcion Env.Com. Fec.Respuesta fecharespuesta Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 7 de 11

8 Tipo Documento tipodocumento Opcionales Env.Com. Nombre Envio Id Nombre envío. Env.Com. Num.Doc.Acept. rechazosaceptados Etiquetas Anidadas Nombre Uso Ocurrencias Documento Obligatorio Una Documento Error Localizacion Atributos Obligatorios Concepto Esquema Env.Com. Estado Documento estado {1 (aceptado), 2 (rechazado)} Opcionales Env.Com. ID Documento id El identificador del documento dentro del envío. Etiquetas Anidadas Nombre Uso Ocurrencias DatosAsociados Opcional Varias La estructura de esta etiqueta es propia de cada tipo de documento Error Opcional Varias Atributos Obligatorios Concepto Esquema Env.Com. Codigo Error Codigo Env.Com. Desc. Error descripcion Env.Com. Tipo Error tipo {1 (rechazo)} Opcionales No tiene Etiquetas Anidadas Nombre Uso Ocurrencias Localizacion Opcional Una Atributos Obligatorios Concepto Esquema Env.Com. Loc. Error xpath xpath Localización de la etiqueta del documento XML en la que se localiza el error. Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 8 de 11

9 Etiquetas Anidadas Opcionales Env.Com. Loc. Error fila fila Fila del documento XML en la que se localiza el error. Se rellenará para errores de validación del esquema XML. Env.Com. Loc. Error col. columna Columna del documento XML en la que se localiza el error. Se rellenará para errores de validación del esquema XML Etiquetas Propias del Documento LE No tiene DatosAsociados En esta etiqueta se incluirán datos generados en Agroseguro al procesar el documento y que deban ser comunicados al emisor. Atributos Obligatorios Concepto Esquema Estado estado Aceptado o Rechazado Plan plan Referencia Poliza referenciapoliza. Opcionales Modulo Etiquetas Anidadas Nombre Uso Ocurrencias Error Opcional Varias modulo Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 9 de 11

10 4.4. EJEMPLO Acuse de Recibo El siguiente ejemplo muestra el acuse de recibo de un envío aceptado con cuatro pólizas. <?xml version="1.0" encoding="utf-8" standalone="yes"?> <AcuseRecibo id="092ue45" tipodocumento="lg" fecharespuesta=" t12:59: :00" fecharecepcion=" t00:00: :00" rechazosaceptados="1" rechazosrecibidos="1" xmlns=" <Documento estado="1" id="etg1" > <DatosAsociados estado="1" plan="2014" referenciapoliza="464745j" /> <DatosAsociados estado="1" plan="2014" referenciapoliza="377588g" /> <DatosAsociados estado="1" plan="2014" referenciapoliza="568478h" > <DatosAsociados estado="1" plan="2014" referenciapoliza="684895t" > </Documento> </AcuseRecibo> El siguiente ejemplo muestra el acuse de recibo de un envío rechazado con dos pólizas. Detallando errores de cada póliza. <?xml version="1.0" encoding="utf-8" standalone="yes"?> <AcuseRecibo id="092ue46" tipodocumento="la" fecharespuesta=" t10:20: :00" fecharecepcion=" t10:20: :00" rechazosaceptados="0" rechazosrecibidos="1" xmlns=" <Documento estado="2" id="etg2" > <DatosAsociados estado="2" plan="2014" referenciapoliza="g526487" > <Error tipo="1" descripcion="cultivo erroneo" codigo="7"> <Localizacion /> </Error> </DatosAsociados> <DatosAsociados estado="2" plan="2014" referenciapoliza="g126354" > <Error tipo="1" descripcion="hoja/parcela errónea" codigo="19"> <Localizacion /> </Error> <Error tipo="1" descripcion="hoja/parcela errónea" codigo="19"> <Localizacion /> </Error> </DatosAsociados> </Documento> </AcuseRecibo> El siguiente ejemplo muestra el acuse de recibo de un envío rechazado xml no válido. <?xml version="1.0" encoding="utf-8" standalone="yes"?> <AcuseRecibo id="092ue47" tipodocumento="la" fecharespuesta=" t10:30: :00" fecharecepcion=" t10:30: :00" rechazosaceptados="0" rechazosrecibidos="1" xmlns=" Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 10 de 11

11 <Documento estado="2" id="etg3" > <Error tipo="1" descripcion="documento xml no valido o mal formado, imposible leer." codigo=""/> </Documento> </AcuseRecibo> El siguiente ejemplo muestra el acuse de recibo de aceptación de liquidación. <?xml version="1.0" encoding="utf-8" standalone="yes"?> <AcuseRecibo id="092ue45" tipodocumento="al" fecharespuesta=" t12:59: :00" fecharecepcion=" t00:00: :00" rechazosaceptados="1" rechazosrecibidos="1" xmlns=" <Documento estado="1" id="etg1" > </Documento> </AcuseRecibo> Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) Página 11 de 11