Interface des opérations commerciales Businessmanager CFF Instructions complémentaires pour le Travelmanager de partenaires disposant d une interface des opérations commerciales active Ce document sert de complément au manuel du Businessmanager CFF. Il décrit les différences pour les partenaires disposant d une interface des opérations commerciales active. Les spécifications techniques et le support concernant l interface des opérations commerciales sont fournis lors de l activation via partnervertrieb@sbb.ch. Pour toute question relative au Ticket Shop et aux tarifs, notre Service Center Businesstravel se tient à votre disposition au 0848 111 456. Objectif et fonction de l interface des opérations commerciales Elle permet de transmettre en temps réel les données supplémentaires de vente et les données spécifiques aux entreprises au système de back-office. Pour cela, les données des positions d achat sont transmises, après la clôture des réservations, au serveur FTP mis à disposition par le partenaire de distribution sous forme codée (enregistrement XML). L application back-office peut accéder à partir de là aux fichiers et éditer leur contenu. Saisie des données supplémentaires spécifiques aux entreprises Les données spécifiques aux entreprises sont saisies dans le masque supplémentaire qui s affiche (si l option est activée) après le processus d achat. Les données saisies dans le masque supplémentaire sont reprises dans l enregistrement XML et les champs désignés par un astérisque * sont repris par ailleurs dans les statistiques. Le Travelmanager peut configurer le masque supplémentaire dans le Businessmanager (définition des champs requis et de leur désignation) et l adapter si nécessaire ultérieurement. Conditions pour le partenaire de distribution Le partenaire: doit disposer d un serveur FTP et connaître ses données d accès (hôte, port, protocole, répertoire cible, nom d utilisateur, mot de passe); doit indiquer sur une liste blanche («whitelist») les adresses IP des CFF qui envoient les données sur le serveur FTP; est responsable de la lecture et du traitement des fichiers dans son système de back-office; il s agit de préférence d un serveur FTP codé utilisant le protocole FTPS; reçoit les spécifications techniques de l interface des opérations commerciales sur demande via partnervertrieb@sbb.ch. Vue dans le Businessmanager Si l interface des opérations commerciales est activée, les champs supplémentaires suivants sont affichés dans le Businessmanager sous la rubrique «Contrat»: 8 Geschaftsfall-Schnittstelle BM - F - v0.5.doc 1/5 24.4.2014/www.cff.ch/businessmanager
Configurer FTP Configurer le masque supplémentaire 8 Geschaftsfall-Schnittstelle BM - F - v0.5.doc 2/5 24.4.2014/www.cff.ch/businessmanager
Configurer FTP Cliquez sur le bouton» Configuration FTP pour consulter le masque de configuration. Le bouton»éditer permet de configurer le serveur FTP. Hôte Saisissez l adresse hôte de votre serveur FTP, SANS toutefois indiquer le protocole utilisé (p. ex. ftp://)). Il est également possible d utiliser l adresse IP directe. Port Saisissez le port de votre serveur FTP. Port standard pour le serveur FTP: 21. Protocole Sélectionnez le protocole de votre serveur FTP: FTP: protocole standard FTPS: connexion cryptée (FTP explicite via TSL). Utilisateur Saisissez le nom d utilisateur et le mot de passe pour l utilisateur FTP. Assurez-vous au préalable que l utilisateur est autorisé à accéder au serveur FTP. Répertoire cible/chemin d accès Format de l enregistrement XML Générer un fichier test Indiquez le chemin d accès au sous-dossier dans lequel les fichiers XML doivent être enregistrés. Tenez compte des points suivants: Le nom de l hôte NE doit PAS être ajouté une nouvelle fois. Le chemin d accès doit commencer par une barre oblique ( / ). Sélectionnez le format dans lequel les enregistrements XML doivent être émis. Les deux types d enregistrement et leurs différences sont représentés dans la spécification technique de l interface des opérations commerciales. Une fois toutes les informations saisies, appuyez sur le bouton»tester afin de générer un fichier test permettant de vérifier la connexion au serveur FTP. Si le fichier test a été généré avec succès, un message apparaît (cf. illustration à droite). Cliquez ensuite sur le bouton»sauvegarder pour enregistrer les informations. Le masque supplémentaire doit ensuite être configuré. 8 Geschaftsfall-Schnittstelle BM - F - v0.5.doc 3/5 24.4.2014/www.cff.ch/businessmanager
Impossible de générer le fichier test Si le fichier test n a pas été créé, vérifiez les informations saisies. Contrôlez par ailleurs les points suivants: L utilisateur est saisi correctement dans votre serveur FTP et est activé. Il se peut que votre serveur FTP ne permette qu un accès restreint de l extérieur. Veillez à ce que les adresses IP des CFF soient activées. Veuillez vous adresser pour cela à partnervertrieb@sbb.ch. Configurer le masque supplémentaire Cliquez sur le bouton Configuration du masque supplémentaire pour consulter le masque de configuration. Les désignations techniques (standard) des champs figurent dans la colonne du milieu. Ces désignations sont également affichées par défaut dans le masque supplémentaire lors du processus de vente si aucun texte individuel n a été défini; elles correspondent à la désignation des balises («tags») dans le fichier XML. Les champs suivis d un astérisque * sont repris dans les statistiques établies toutes les deux semaines. Afficher les champs Il est possible de définir si les différents champs doivent être affichés ou non dans le masque supplémentaire. La sélection des champs est effectuée au moyen des menus déroulants dans la colonne de gauche. Obligatoire: le champ doit être toujours renseigné dans le masque supplémentaire. Afficher: le champ est affiché dans le masque supplémentaire mais ne doit pas être obligatoirement renseigné. Ne pas afficher: le champ n est pas affiché dans le masque supplémentaire. Recommandation: limitez le nombre de champs affichés. Le niveau de convivialité du masque supplémentaire baisse fortement lors du processus de vente si les champs affichés sont trop nombreux (plus de quinze). Champ «refposnr» Ce champ doit obligatoirement être défini sur «Afficher» étant donné qu il est requis pour les enregistrements des prestations de service-aprèsvente. Format des champs Affichage du format du champ en laissant brièvement le curseur de la souris sur la désignation dans la colonne du milieu («mouse over»). Alphanum (chiffre): alphanumérique (lettres et chiffres). Et nombre maximal de caractères entre parenthèses. Date: date selon le format yyyymmdd (un calendrier est disponible dans le masque 8 Geschaftsfall-Schnittstelle BM - F - v0.5.doc 4/5 24.4.2014/www.cff.ch/businessmanager
supplémentaire pour la sélection). Boolean: sélection via une case à cocher. Decimal (10,2): un nombre de 10 chiffres, dont deux maximum après la virgule. Définir des textes individuels Les champs du masque supplémentaire peuvent être définis individuellement en quatre langues. Sélectionnez pour cela la langue de saisie et saisissez le texte souhaité dans le champ Désignation individuelle dans la colonne de droite. Nombre de champs utilisables Sauvegarder Si l enregistrement standard est utilisé, il est possible de transférer les premiers champs jusqu à <freetext2> dans l enregistrement et de reprendre par ailleurs les champs <customerreference09> jusqu à < customerreference 16> dans les statistiques. Dans le cas de l enregistrement étendu, vous disposez par ailleurs de tous les champs jusqu à <customerreference44>. Il convient toutefois de noter qu un trop grand nombre de champs dans le masque supplémentaire a une incidence sur la convivialité et la vitesse du système. Dans le champ <customerreference45> de l enregistrement étendu, la variable du lien PDF vers le billet est transmise par défaut. C est la raison pour laquelle le champ doit être défini sur «Ne pas afficher». Cliquez sur»sauvegarder pour enregistrer les données. Afin d assurer le bon fonctionnement du masque supplémentaire, il convient, avant la première utilisation, de configurer et de sauvegarder au moins un champ du masque supplémentaire. 8 Geschaftsfall-Schnittstelle BM - F - v0.5.doc 5/5 24.4.2014/www.cff.ch/businessmanager