Story Transcript
NORMAS DE GRABACIÓN
Título: Envíos por Comunicaciones (Rechazos de Liquidaciones). Código: DES-N-0052-1.1 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:
Revisado por:
Aprobado por:
Dpto. Desarrollo
Dpto. Explotación
Dpto. Explotación
Fecha Elaboración:
Fecha Revisión:
Fecha Aprobación:
30 de Mayo de 2014
3 de Junio de 2014
3 de 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
AGROSEGURO, S.A.
CONTROL DE VERSIONES
VERSIÓN 1.0 1.1
FECHA VIGOR 1/6/2014 3/6/2014
COMENTARIOS Versión inicial. Nuevo diseño de entrada de incidencias en ETG’s
Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) DES-N-0052-1.1
Página 2 de 11
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
AGROSEGURO, S.A.
FICHA DE DISTRIBUCIÓN DE DOCUMENTO
NOMBRE/ÁREA/COMPAÑÍA
Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) DES-N-0052-1.1
SOPORTE DISTRIBUCIÓN (Intranet/ Papel)
Página 3 de 11
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
AGROSEGURO, S.A.
INDICE 1.
OBJETO................................................................................................................................................................. 5
2.
AMBITO DE APLICACIÓN ............................................................................................................................... 5
3.
DOCUMENTACION DE REFERENCIA .......................................................................................................... 5
4.
DESCRIPCIÓN DE LA NORMA........................................................................................................................ 5 4.1.
INTRODUCCIÓN ........................................................................................................................................... 5
4.2. ENVÍO/RECEPCIÓN DE RECHAZOS DE LIQUIDACIONES ...................................................................... 6 4.2.1. Envío ....................................................................................................................................................... 6 4.2.2. Recepción: ............................................................................................................................................... 7 4.3. ESTRUCTURA DEL ACUSE DE RECIBO ..................................................................................................... 7 4.3.1. Especificación de cada etiqueta ............................................................................................................... 7 4.4.
EJEMPLO Acuse de Recibo .......................................................................................................................... 10
Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) DES-N-0052-1.1
Página 4 de 11
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
AGROSEGURO, S.A.
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: http://www.w3.org/TR//REC-Xml
Versión más actualizada de: ¾ ¾
Caracteres Permitidos en las Normas de Grabación Normas Técnicas y Procedimientos Generales de Envíos
(DES-X-0001) (DES-N-0009)
4. DESCRIPCIÓN DE LA NORMA. 4.1. 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-0009. Si el medio utilizado es HTTP, se puede realizar a través de nuestra página web: www.agroseguro.es, 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-0057-1.0 • 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) DES-N-0052-1.1
Página 5 de 11
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
AGROSEGURO, S.A.
4.2. ENVÍO/RECEPCIÓN DE RECHAZOS DE LIQUIDACIONES 4.2.1. 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 AL
Incidencias en comprobación exhaustiva de ETGs – DES-N-0057-1.0 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 000000001
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: XXXXXLEN2014000000001002006052 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) DES-N-0052-1.1
Página 6 de 11
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
AGROSEGURO, S.A.
4.2.2. 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 , 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.
4.3. ESTRUCTURA DEL ACUSE DE RECIBO
AcuseRecibo Documento [1..1] DatosAsociados [0..N] ErrorPoliza [0..N] Localizacion [0..1] Error [0..N] Localizacion [0..1] 4.3.1. Especificación de cada etiqueta 4.3.1.1. Etiquetas Comunes AcuseRecibo Atributos Obligatorios Concepto Env.Com. Num. Documentos Env.Com. Fec.Recepcion Env.Com. Fec.Respuesta
Esquema rechazosRecibidos fechaRecepcion fechaRespuesta
Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) DES-N-0052-1.1
Página 7 de 11
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
AGROSEGURO, S.A. Tipo Documento
tipoDocumento
Opcionales Env.Com. Nombre Envio Env.Com. Num.Doc.Acept.
Id rechazosAceptados
Nombre envío.
Etiquetas Anidadas Nombre
Uso
Ocurrencias
Documento
Obligatorio
Una
Documento Atributos Obligatorios Concepto Env.Com. Estado Documento
Esquema estado
Opcionales Env.Com. ID Documento
id
{1 (aceptado), 2 (rechazado)}
El identificador del documento dentro del envío.
Etiquetas Anidadas Nombre
Uso
Ocurrencias
DatosAsociados
Opcional
Varias
Error
Opcional
Varias
La estructura de esta etiqueta es propia de cada tipo de documento
Error Atributos Obligatorios Concepto Env.Com. Codigo Error Env.Com. Desc. Error Env.Com. Tipo Error
Esquema Codigo descripcion tipo
{1 (rechazo)}
Opcionales No tiene Etiquetas Anidadas Nombre
Uso
Ocurrencias
Localizacion
Opcional
Una
Localizacion Atributos Obligatorios Concepto Env.Com. Loc. Error xpath
Esquema xpath
Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) DES-N-0052-1.1
Localización de la etiqueta del documento XML en la que se localiza el error. Página 8 de 11
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
AGROSEGURO, S.A. 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 Anidadas No tiene
4.3.1.2 Etiquetas Propias del Documento LE 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 Estado
Esquema estado
Plan Referencia Poliza
plan referenciaPoliza
Opcionales Modulo Etiquetas Anidadas
Aceptado o Rechazado .
modulo
Nombre
Uso
Ocurrencias
Error
Opcional
Varias
Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) DES-N-0052-1.1
Página 9 de 11
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
AGROSEGURO, S.A. 4.4. EJEMPLO Acuse de Recibo El siguiente ejemplo muestra el acuse de recibo de un envío aceptado con cuatro pólizas.
El siguiente ejemplo muestra el acuse de recibo de un envío rechazado con dos pólizas. Detallando errores de cada póliza.
El siguiente ejemplo muestra el acuse de recibo de un envío rechazado xml no válido. Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) DES-N-0052-1.1
Página 10 de 11
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
AGROSEGURO, S.A.
El siguiente ejemplo muestra el acuse de recibo de aceptación de liquidación .
Seguro Creciente: Comunicaciones (Rechazos de Liquidaciones) DES-N-0052-1.1
Página 11 de 11