Protocolos FTP de conexión a ediversa

Transcripción

1 Protocolos FTP de conexión a ediversa

2 2 de 6 1 Introducción Datos para la conexión al servidor FTP Envío de mensajes Mensajes de servicio Notificaciones de entrega (DSN positivo) Notificaciones de no entrega (DSN negativo) Acuses de recibo (MDN) Recepción de mensajes Mensajes de servicio... 6

3 3 de 6 1 Introducción Esta guía tiene como objetivo documentar los requisitos a tener en cuenta para la conexión al servidor FTP del servicio EDI de ediversa, desde cualquier aplicación ajena a las que ofrece ediversa para este fin. El sistema de buzones FTP de ediversa está pensado para aquellos usuarios que ya tienen un sistema que genera y lee documentos EDI, y que prefieren la simplicidad del FTP para transferirlos a nuestra plataforma. Sin embargo, no existe en el estándar FTP ningún tipo de mensajes de servicio, que son aquellos que se generan para que el emisor de un mensaje conozca cual es el estado del mismo (entregado, recogido por el destinatario, erróneo). Por esta razón, ediversa ha diseñado unos ficheros muy sencillos que recomendamos se implementen en sus sistemas, y cuyo objetivo es que el emisor de los mensajes tenga la garantía de que estos han llegado a su destino 2 Datos para la conexión al servidor FTP Tanto para enviar como para recibir, la conexión se establece entrando en la zona FTP reservada al cliente. Una vez aquí, tendremos una estructura de directorios que nos permitirá intercambiar los mensajes. Los parámetros para la conexión FTP son los siguientes: Servidor de correo: ftp.ediversa.net Puerto: 21 Nombre de usuario: el suministrado por ediversa (código de 10 dígitos) Contraseña: la suministrada por ediversa (código de 8 dígitos) 3 Envío de mensajes Una vez establecida la conexión, encontraremos un directorio upload. Para enviar documentos EDI, únicamente deberemos copiarlos tal cual en este directorio. El documento EDI debe contener las cabeceras de intercambio (UNB-UNZ), ya que los datos de estas cabeceras son las que se utilizan para la entrega de los mensajes. El nombre del fichero que contiene el intercambio EDI, y que se copia al directorio upload puede ser cualquiera, pero único, ya que luego se utiliza este nombre para identificar de forma inequívoca por los acuses se recibo. La extensión siempre debe ser.edi. Un fichero debe contener un único intercambio (UNB-UNZ). Aunque un intercambio puede contener varios documentos (UNH-UNT), se recomienda para facilitar la trazabilidad que contenga un solo documento. Existe un proceso interno que mueve los ficheros copiados a las colas internas de procesos de la plataforma, de tal manera que, una vez copiado, ya no se podrá ver el fichero en el directorio. Una vez el usuario recoge sus mensajes, debe borrarlos del servidor FTP, ya que en caso contrario se los encontrará en cada nueva conexión.

4 4 de Mensajes de servicio Una vez el centro compensador EDI de ediversa recibe un mensaje, lo procesa y lo deposita en el buzón del destinatario (si es de la propia red de ediversa), o lo redirige a una red ajena (en caso de ser de un usuario de una red externa). Si se produce un error en este proceso, tanto en nuestra red como en una red ajena, se devuelve al emisor del mensaje una notificación de no entrega, que se utiliza como aviso de que no se ha podido entregar el mensaje a su destinatario. En caso de que el mensaje sea depositado correctamente en el buzón del destinatario (que no quiere decir que éste lo haya recogido), se generará al emisor una notificación de entrega, que le indica que el destinatario ya lo tiene disponible en su buzón. Cuando el destinatario recoge el mensaje, se genera automáticamente un acuse de recibo dirigido al emisor. Cuando este lo reciba, sabrá que su mensaje ha sido recogido por el destinatario (lo que no garantiza que éste lo haya procesado correctamente). (Nota: hay redes que no generan algunos mensajes de servicio. En este caso, a ediversa le es imposible saber cual ha sido el destino de los mensajes, y por tanto no puede enviar al emisor ningún tipo de notificación). Dado que no existe protocolo para este tipo de mensajes en el estándar FTP, ediversa ha creado el suyo propio, con un sencillo sistema de intercambio de ficheros que notifican el estado de los mensajes enviados. Estos mensajes se reciben en el directorio raíz del usuario (el mismo de donde encontrarán los archivos recibidos) Notificaciones de entrega (DSN positivo) Se reciben en el directorio raíz del usuario. Llamaremos mensaje original a aquel mensaje que genera una notificación de entrega. Las características de este mensaje son las siguientes: El nombre del fichero es el mismo que el del mensaje original. Mediante este nombre lo relacionaremos de forma única con el mensaje original. La extensión será.dsn. Esto nos indica que se trata de una notificación de entrega (DSN), aunque no sabemos todavía si es positiva o negativa. El contenido será DSN OK!. Nos indica que se trata de un DSN positivo. Por ejemplo, si enviamos un intercambio EDI dentro de un fichero llamado 1234.EDI, la notificación de entrega positiva la recibiremos en un archivo llamado 1234.DSN.

5 5 de Notificaciones de no entrega (DSN negativo) Se reciben en el directorio raíz del usuario. Llamaremos mensaje original a aquel mensaje que genera una notificación de no entrega. Las características de este mensaje son las siguientes: El nombre del fichero es el mismo que el del mensaje original. Mediante este nombre lo relacionaremos de forma única con el mensaje original. La extensión será.dsn. Esto nos indica que se trata de una notificación de entrega (DSN), aunque no sabemos todavía si es positiva o negativa. El contenido será DSN ERROR!. Nos indica que se trata de un DSN negativo. Por ejemplo, si enviamos un intercambio EDI dentro de un fichero llamado 1234.EDI, si recibimos una notificación de no entrega, la recibiremos en un archivo llamado 1234.DSN Acuses de recibo (MDN) Se reciben en el directorio raíz del usuario. Llamaremos mensaje original a aquel mensaje que genera una notificación de no entrega. Las características de este mensaje son las siguientes: El nombre del fichero es el mismo que el del mensaje original. Mediante este nombre lo relacionaremos de forma única con el mensaje original. La extensión será.mdn. Esto nos indica que se trata de un acuse de recibo. Por ejemplo, si enviamos un intercambio EDI dentro de un fichero llamado 1234.EDI, el acuse de recibo será un archivo llamado 1234.MDN.

6 6 de 6 4 Recepción de mensajes Los mensajes recibidos destinados al usuario FTP, se depositarán en el directorio raíz. Lo único que debe hacerse es, una vez conectado, bajarlos al sistema del cliente y borrarlos posteriormente (una vez se ha comprobado que se ha bajado correctamente. La extensión de los ficheros que contienen intercambios EDI será siempre.edi. 4.1 Mensajes de servicio En este caso, no es necesario generar los acuses de recibo, ya que el sistema los genera automáticamente.