ESPECIFICACIONES TÉCNICAS DEL SERVICIO EDI-SEDEB2B y PROCEDIMIENTO DE HOMOLOGACION

Transcripción

1 ESPECIFICACIONES TÉCNICAS DEL SERVICIO 1. Introducción 2. Formato de MENSAJES a transmitir por las estaciones EDI a través de 3. Formato de RECONOCIMIENTOS a transmitir por las estaciones EDI a través de 4. Flujo de documentos 5. Pruebas a realizar para la homologación 6. Plantilla de pruebas de homologación 7. Contactos

2 1. Introducción Este documento describe las especificaciones técnicas del servicio, así como el procedimiento de homologación que deben seguir las estaciones EDI que deseen operar en este servicio. Las especificaciones describen aspectos técnicos sobre la construcción del encapsulado MIME de los mensajes el formato flujo de los acuses de recibo necesarios en el servicio. Las pruebas de homologación a realizar consistirán en el envío recepción de documentos acuses de recibo por parte de la estación a homologar. A partir de la edición 4 de esta especificación, los protocolos a utilizar obligatoriamente son ESMTP para el envío con autentificación POP3 para la recepción de mensajes. La especificación de estos protocolos las puede encontrar en los siguientes documentos: 1. RFC 821 SMTP. 2. RFC SMTP AUTH 3. RFC 1225 POP3

3 NOTA: EDICOMUNICACIONES S.L. como empresa propietaria del servicio EDI- SEDEB2B se reserva el derecho de realizar las modificaciones que considere oportunas para mejorar el servicio. Notificando con suficiente antelación dichos cambios a las empresas que tengan estaciones EDI homologadas.

4 2. Formato de MENSAJES a transmitir por las estaciones EDI a través de El formato de mensajes reconocimientos que se intercambian a través de se basa en los estándares recomendados por el IEFT para la interoperabilidad en el transporte de mensajes EDI a través de Internet. Las RFC que sustentan estos formatos son: 1. RFC 821 SMTP. 2. RFC 822 Text Message Format 3. RFC 1847 MIME Securit Multiparts 4. RFC 1767 EDI Content 5. RFC 2045, 2046, and 2049 MIME 6. RFC 1892 Multipart/report (En el se apoa la MDN RFC 2298) 7. RFC 2298 Message Disposition Notification (Solicitud de acuse de recibo (MDN)). Las Cabeceras MIME requeridas por los mensajes en SEDEB2B: Content-Tpe: Application/EDIFACT; name="s42965.edi" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename= S42965.edi X-Mailer: EDIWIN xxxxxxxx El atributo filename del campo Content-Disposition debe ser único para cada mensaje generado para que después pueda ser acusado dicho mensaje de forma inequívoca. La cabecerá X-Mailer, deberá tener el valor EDIWIN. Podrá concatenarse si se desea con cualquier otra expresión, que pueda reflejar el software que genera el mensaje, por ejemplo: EDIWIN/MESSENGER, EDIWIN 3, EDIWIN 4, etc. Un mensaje válido en el servicio quedaría: From: edicom4@sedeb2b.com < edicom4@sedeb2b.com > To: edicom5@sedeb2b.com < edicom5@sedeb2b.com > Subject: EDIWIN Mensaje EDIFACT Mime-Version: 1.0 X-Mailer: EDIWIN xxxxx Content-Tpe: Application/EDIFACT; name="s42965.edi" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="s42965.edi" Content-Description: Intercambio EDI Date: Fri, 28 Dec :51: // Datos del protocolo SMPT/POP3 // Datos del protocolo SMPT/POP3 // Datos del protocolo SMPT/POP3 //Comienzo de la cabecera MIME. //Campo Obligatorio. //Campos obligatorios para EDI/MIME. //Campos obligatorios para EDI/MIME. //Campos obligatorios para EDI/MIME.(EDIWIN3) VU5BoisuPAnVU5CK1VOT0M6Mis4NDExMTExMDAwMDAxOjE0Kzg4Odg4Odg4ODg4ODg6MTQrMDEx MjI4OjA5NDYrUzQOTY1J1VOSCtFVzk4NzA1MjIwK1RFWFRPTDo5MDo0OkFFOkFFQ09NJ0JHTStU WewrMDAwMDAwMDgrMDExMjI4J09ERCs4ODg4ODg4ODg4ODg4Kzg0MTExMTEwMDAwMDEnVFhUK1R YW5zbWl0aWVuZGRvIGVkaSBhIHRYXbpcBkZSBpbnRlcm5ldC4nVU5UkzUrRVc5ODcwNTIMCdV TlorMStTNDI5NjUn

5 3. Formato de RECONOCIMIENTOS a transmitir por las estaciones EDI a través de Para confirmar la recepción de un documento a través del servicio se debe generar un acuse de recibo, que referencia al intercambio recibido. La recepción de un acuse de recibo por parte de las estaciones EDI provocará un cambio de situación de los documentos referenciados por el acuse, quedando éstos como recuperados por el destinatario. La no recepción de un reconocimiento transcurrido un periodo de tiempo desde el envío del intercambio original, será considerado como un fallo en la entrega, pudiendo establecer cada solución EDI el mecanismo de respuesta que considere adecuado. El acuse de recibo consiste en un correo electrónico donde añadiremos obligatoriamente la cabecera MIME X-File, donde indicaremos la referencia al intercambio recibido. Concretamente se indicará el nombre del fichero adjunto del mensaje que queremos acusar. Adicionalmente, se puede adjuntar un fichero donde se exprese de una forma legible por un humano cual es el mensaje reconocido. Un ejemplo de un mensaje de reconocimiento correcto en sería: From: edicom2@sedeb2b.es <edicom2@ sedeb2b.es> To: edicom1@ sedeb2b.es <edicom1@ sedeb2b.es> Subject: EDIWIN3: Mensaje EDIFACT Mime-Version: 1.0 X-Mailer: EDIWIN 3 X-File: S46969.edi // Obligatorio: Referencia al intercambio origen Content-Tpe: Application/EDIFACT; name="ack_s46969.edi" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="ack_s46969.edi" Content-Description: Acuse de Recibo Date: Wed, 19 Jun :18: Message-Id: < @comunicador2000> Repl-To: edicom2@edicom.es RGlZWNjLiBSZWNvbm9jaW1pZW50bzplZGljb20xQGVkaWNvbS5lcA8ZWRpY29tMUBlZGljb 20u ZXM+DQpJbnRlcmNhbWJpbBSZWNvbm9jaWRvOlM0Njk2OS5lZGkNCg== La novedad que introduce esta edición de las especificaciones técnicas del servicio EDI- SEDEB2B, es la posibilidad de utilizar reconocimientos según especifica la RFC 2298 Message Disposition Notifications(MDN), que define cómo solicitar un acuse de recibo, así como el formato la sintaxis del mismo. Se podrá contestar con el acuse descrito en la edición 2 vista anteriormente u opcionalmente podrá generarse un acuse de recibo MDN (Message Disposition Notifications), siempre cuando sea solicitado de forma expresa, según regula la RFC 2298.

6 Las estaciones que soliciten este tipo de acuse deberán ser capaces de procesar, tratar entender ambos tipos de acuse. La forma de solicitar un acuse de recibo MDN es añadiendo las siguientes cabeceras MIME al mensaje original que debe ser acusado: Message-ID: < Disposition-Notification-To: Donde, Message-ID debe ser único para cada mensaje generado para que después pueda ser acusado dicho mensaje de forma inequívoca. Y Disposition-Notification-To debe tener la forma user@domain address (según la RFC 822 ) e indica la dirección de retorno del acuse de recibo. El acuse de recibo se debe enviar con los siguientes campos MIME según RFC 2298: Content-Tpe: multipart/report; report-tpe=disposition-notification; boundar="----=_nextpart_000_0011_01c d4a5aa0" En el Content-Tpe indicamos que se trata de un acuse de recibo formado por múltiples partes según especifica la RFC El mensaje de acuse debe contener como mínimo dos partes: La primera debe ser legible por un humano haciendo referencia al mensaje reconocido. La segunda debe tener el formato que se describe a continuación: Content-Tpe: message/disposition-notification Final-Recipient: rfc822;edicom4@edicom.es Original-Message-ID: <S42965@EDIWIN> Disposition: automatic-action/mdn-sent-automaticall; processed Donde, Final-Recipient es la dirección del destinatario del acuse, Original- Message-ID es el identificador de mensaje que tenía el mensaje original que estamos acusando Disposition deberá contener siempre el valor automaticaction/mdn-sent-automaticall; processed. La tercera parte del mensaje de acuse puede ser el contenido del mensaje acusado en sí mismo o una parte del mismo es opcional. Un ejemplo de un mensaje de reconocimiento MDN en sería: From: edicom4@edicom.es <edicom4@edicom.es> To: edicom4@edicom.es <edicom4@edicom.es> Subject: Leído: EDIWIN4: Mensaje EDIFACT Mime-Version: 1.0 X-Mailer: EDIWIN 4 X-Autack: EDIWIN Content-Transfer-Encoding: base64 References: <S42965@EDIWIN> Content-Tpe: multipart/report; Report-tpe=disposition-notification; Boundar="----=_NextPart_000_0011_01C D4A5AA0"

7 Content-Description: Acuse de Recibo Date: Fri, 28 Dec :59: ' =_NextPart_000_0011_01C D4A5AA0 Ésta es una confirmación del correo que envió a <edicom4@edicom.es> a las 03/01/02 01:48 p.m. Esta confirmación verifica que el mensaje se ha procesado en el equipo del destinatario a las 04/01/02 12:24 p.m =_NextPart_000_0011_01C D4A5AA0 Content-Tpe: message/disposition-notification Final-Recipient: rfc822;edicom4@edicom.es Original-Message-ID: < S42965@EDIWIN> Disposition: automatic-action/mdn-sent-automaticall; processed =_NextPart_000_0011_01C D4A5AA0 Content-Tpe: text/plain Content-Transfer-Encoding: base64 RGlZWNjLiBSZWNvbm9jaW1pZW50bzplZGljb200QGVkaWNvbS5lcA8ZWRpY29TneblZGljb20u ZXM+DQpJbnRlcmNhbWJpbBSZWNvbm9jaWRvOlM0Mjk2NS5lZGkNCg== =_NextPart_000_0011_01C D4A5AA0-- Nota: Conviene tener en cuenta que algunas estaciones EDI (como EDIWIN), interpretan la no recepción de un acuse de recibo como un fallo en la entrega, pudiendo generar reenvíos transcurrido un cierto periodo de tiempo.

8 ( 4.Flujo de documentos )*+"*,-. /0"1 Flujo de envío de intercambios Estación EDI a Homologar Estación EDI Homologadora 3 EDI-SEDEB2B PASOS 1.- La estación EDI a homologar envía un intercambio con uno o varios documentos. 2.- La estación EDI homologadora recibe dicho intercambio lo procesa correctamente. 3.- La estación EDI homologadora emite un acuse de recibo (reconocimiento). 4.- La estación EDI a homologar recibe dicho acuse lo procesa correctamente Flujo de recepción de intercambios Estación EDI a Homologar Estación EDI Homologadora 4 EDI-SEDEB2B PASOS 1.- La estación EDI homologadora envía un intercambio con uno o varios documentos. 2.- La estación EDI a homologar recibe dicho intercambio lo procesa correctamente. 3.- La estación EDI a homologar emite un acuse de recibo (reconocimiento) construido correctamente. 4.- La estación EDI homologadora recibe dicho acuse lo procesa correctamente

9 2 5.Pruebas a realizar para la homologación Las pruebas de homologación consistirán en realizar por parte de la estación EDI a homologar varios ciclos de envío recepción completos. El ciclo de envío constará de dos partes: 1. Envío de un documento: Se deberá comprobar la correcta recepción del mismo en la estación homologadora. Ésta generará un reconocimiento hacia la estación a homologar. 2. Recepción de reconocimiento: La estación a homologar tendrá que recibir el acuse generado por la estación homologadora e interpretarlo correctamente actualizando el estado del documento original. El ciclo de recepción constará de dos partes: 1. Recepción de un documento: La estación homologadora generará un intercambio lo enviará a la estación a homologar. Ésta deberá recepcionarlo correctamente. 2. Envío de reconocimiento: La estación a homologar tendrá que generar emitir un acuse de recibo construido correctamente en base al documento recibido anteriormente. De forma que la estación homologadora sea capaz de actualizar el estado documento enviado.

10 6.Plantilla de pruebas de homologación Pruebas de homologación en el servicio Datos de la estación a homologar Fecha Estación EDI: Versión: Empresa Pruebas del flujo de envío Prueba Nº1 (Edición 2) Realizada Observaciones Envío de un intercambio Recepción de RECONOCIMIENTO Prueba Nº2 (Edición 2) Realizada Observaciones Envío de un intercambio Recepción de RECONOCIMIENTO Prueba Nº3 (Edición 3 MDN) Realizada Observaciones Envío de un intercambio Recepción de RECONOCIMIENTO Prueba Nº4 (Edición 3 MDN) Realizada Observaciones Envío de un intercambio Recepción de RECONOCIMIENTO Pruebas del flujo de recepción Prueba Nº1 (Edición 2) Realizada Observaciones Recepción de un intercambio Envío del RECONOCIMIENTO Prueba Nº2 (Edición 3 MDN) Realizada Observaciones Recepción de un intercambio Envío del RECONOCIMIENTO Prueba Nº3 Realizada Observaciones Recepción de un intercambio Envío del RECONOCIMIENTO

11 7.Contactos Los contactos para realizar las pruebas de homologación en EDICOMUNICACIONES son: 1. José Vilata (- 3+1) Director técnico EDICOM 2. Santiago Bellosta Carreras Responsable Departamento I+D 3. Jorge Pradas Responsable soporte servicio Datos de la empresa EDICOMUNICACIONES: Ronda de Auguste Louis Lumiere, Parque Tecnológico de Paterna Valencia (España) Teléfono Dep. Técnico: Teléfono Dep. Comercial: WEB: