Orange France - Orange Kiosques
Transcription
Orange France - Orange Kiosques
Orange
Cahier des Charges Technique du service SMS+
Version 2.2
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
1
TABLE DES MATIERES
TABLE DES MATIERES ................................................................................................................................... 2
1
INTRODUCTION ....................................................................................................................................... 5
1.1
2
GLOSSAIRE ...................................................................................................................................... 5
RACCORDEMENT .................................................................................................................................... 7
2.1
ARCHITECTURE GENERALE ................................................................................................................... 7
2.2
MISE EN PLACE D’UNE LIAISON IP OPERATIONNELLE ............................................................................... 7
2.2.1
Raccordement via un accès privé.............................................................................................. 7
2.2.2
Raccordement via un accès public ............................................................................................ 8
2.2.3
Limite de responsabilité de l’opérateur ...................................................................................... 9
2.3
RECOMMANDATIONS ............................................................................................................................ 9
2.3.1
Mise en place d’un mécanisme de surveillance ........................................................................ 9
2.3.2
Attribution/échange des adresses IP ......................................................................................... 9
2.4
MISE EN SERVICE DES NUMEROS COURTS............................................................................................ 10
3
GESTION DES ECHANGES ................................................................................................................... 11
3.1
PROTOCOLE DE COMMUNICATION........................................................................................................ 11
3.2
CINEMATIQUE D’ENSEMBLE ................................................................................................................. 11
3.2.1
Détails des différents messages échangés ............................................................................. 11
3.3
UTILISATION DE LA FONCTION DE FENETRAGE (« W INDOWING ») .......................................................... 12
3.3.1
Gestion des SMS-MT émis en mode « windowing » ............................................................... 12
3.3.2
Gestion des SMS-MO émis en mode « windowing » .............................................................. 13
3.4
GESTION ET MAITRISE DES DEBITS ...................................................................................................... 13
3.5
ÉCHANGES A LA CONNEXION DE L’ÉDITEUR.......................................................................................... 14
3.5.1
Demande d’ouverture de session ............................................................................................ 14
3.5.2
Acquittement de la demande d’ouverture de session ............................................................. 14
3.5.3
Erreurs possibles ..................................................................................................................... 14
3.6
ÉCHANGES A L’ENVOI D’UN SMS-MT PAR L’EDITEUR ........................................................................... 15
3.6.1
Demande d’envoi d’un SMS-MT .............................................................................................. 15
3.6.2
Acquittement de la demande d’envoi du SMS-MT .................................................................. 16
3.6.3
Erreurs possibles ..................................................................................................................... 16
3.6.4
Durée de validité d’un SMS-MT ............................................................................................... 17
3.7
ÉCHANGES A LA REMISE EFFECTIVE DU SMS-MT ................................................................................ 17
3.8
ÉCHANGES A LA RECEPTION D’UN SMS-MO PAR L’ÉDITEUR ................................................................. 19
3.8.1
Acquittement de la réception d’un SMS-MO ........................................................................... 20
3.8.2
Gestion des erreurs ................................................................................................................. 20
3.9
TRANSMISSION D’UN IDENTIFIANT ........................................................................................................ 20
3.10 SPECIFICITES DU PROTOCOLE UCPO ................................................................................................. 21
3.10.1
Paramètres complémentaires échangés ................................................................................. 21
3.10.2
Codes erreurs spécifiques ....................................................................................................... 23
4
PRESENTATION DES OFFRES SMS+ NON SURTAXEES ................................................................. 25
4.1
OFFRES « LIGHT PUSH ».................................................................................................................... 25
4.1.1
Principales caractéristiques ..................................................................................................... 25
4.1.2
Description ............................................................................................................................... 25
4.1.3
Cinématique ............................................................................................................................. 25
4.2
OFFRE « LIGHT PULL » ..................................................................................................................... 26
4.2.1
Principales caractéristiques ..................................................................................................... 26
4.2.2
Description ............................................................................................................................... 26
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
2
4.2.3
Cinématique ............................................................................................................................. 27
4.3
OFFRE « LIGHT GALLERY » ............................................................................................................... 28
4.3.1
Principales caractéristiques ..................................................................................................... 28
4.3.2
Description ............................................................................................................................... 28
4.3.3
Cinématique ............................................................................................................................. 28
5
PRESENTATION DES OFFRES SMS+ SURTAXEES .......................................................................... 30
5.1
OFFRE « PREMIUM EXPRESS » ........................................................................................................... 30
5.1.1
Principales caractéristiques ..................................................................................................... 30
5.1.2
Description ............................................................................................................................... 30
5.1.3
Cinématique ............................................................................................................................. 30
5.2
OFFRE « PREMIUM TRIBU » ................................................................................................................ 31
5.2.1
Principales caractéristiques ..................................................................................................... 31
5.2.2
Description ............................................................................................................................... 32
5.2.3
Cinématique ............................................................................................................................. 32
5.3
OFFRE « PREMIUM TRANSACTION ».................................................................................................... 33
5.3.1
Principales caractéristiques ..................................................................................................... 33
5.3.2
Description ............................................................................................................................... 34
5.3.3
Cinématique ............................................................................................................................. 34
5.4
OFFRE « PREMIUM PUSH » ................................................................................................................ 36
5.4.1
Principales caractéristiques ..................................................................................................... 36
5.4.2
Description ............................................................................................................................... 36
5.4.3
Cinématiques d’inscription ....................................................................................................... 36
5.4.4
Cinématiques de résiliation...................................................................................................... 44
5.4.5
Cinématique de facturation et de livraison .............................................................................. 47
5.4.6
Gestion des alertes .................................................................................................................. 50
5.4.7
Cinématique de levée de suspension ...................................................................................... 51
5.4.8
Codes erreurs spécifiques ....................................................................................................... 52
6
SYNCHRONISATION DES BASES ........................................................................................................ 54
6.1
INTERFACE SOAP/HTTP ..................................................................................................................... 54
6.1.1
Caractéristiques techniques .................................................................................................... 54
6.1.2
Principaux échanges ............................................................................................................... 54
6.1.3
Formats spéciaux .................................................................................................................... 55
6.1.4
Détails des messages échangés ............................................................................................. 56
6.1.5
Gestion du paramètre de compression ................................................................................... 61
6.1.6
Gestion des contrôles .............................................................................................................. 61
6.1.7
Gestion des erreurs ................................................................................................................. 61
6.2
INTERFACE MSCA ............................................................................................................................. 62
7
SUPPORT TECHNIQUE D'ORANGE FRANCE ..................................................................................... 65
7.1
LES CONTACTS .................................................................................................................................. 65
7.1.1
Contact technique .................................................................................................................... 65
7.1.2
Les missions ............................................................................................................................ 65
7.1.3
Procédures en cas d’intervention ............................................................................................ 67
8
SYNTHESE DES OFFRES SMS+ .......................................................................................................... 68
8.1
8.2
8.3
8.4
9
OFFRES SURTAXEES UTILISANT LE PROTOCOLE UCP ........................................................................... 68
OFFRES SURTAXEES UTILISANT LE PROTOCOLE UCPO ......................................................................... 69
OFFRES NON SURTAXEES DE TYPE « PUSH »....................................................................................... 70
OFFRES NON SURTAXEES DE TYPE « PULL » ....................................................................................... 71
ANNEXES................................................................................................................................................ 72
9.1
9.2
MODELE DE FICHE DE SIGNALISATION .................................................................................................. 72
MODELE DE FICHE MPI (INTERVENTION PROGRAMMEE) ........................................................................ 73
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
3
Références
[1]
UCP-EMI Interface 4.6, specifications
CMG Wireless Data Solutions, April 2003
[2]
SMSC Operator Manual Version 4.6
CMG Wireless Data Solutions, April 2003
[3]
SMSC Command Reference Manual Version 4.6
CMG Wireless Data Solutions, April 2003
Conventions de lecture
1. Exemple : Les exemples sont indiqués par un trait bleu dans la marge de gauche.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
4
1 INTRODUCTION
L’objectif de ce document est de permettre aux Éditeurs de services ayant souscrit à une offre SMS+ de se
raccorder à la Plate-forme SMS d’Orange France.
Ce document est constitué des quatre parties :
la première traite du raccordement de l’Éditeur à la Plate-forme SMS ;
la seconde traite des échanges entre l’Éditeur et la Plate-forme SMS ;
la troisième présente les différentes offres proposées aux Éditeurs ;
la quatrième décrit le support technique fourni à l’Éditeur par Orange France.
1.1 GLOSSAIRE
Terme
Définition
AC
Authentication Code
AdC
Address Code
CV
Circuit Virtuel
ES
Éditeur de services
HPLMN
Home Public Land Mobile Network
IP/ VPN
IP sur VPN
bps
bits per seconde
IUA
Identifiant User Agent
Passerelle SMS ou
Plate-forme SMS
Désigne les équipements techniques et informatiques exploités par Orange France,
auxquels se raccordent les Plates-formes de l’Éditeur de services
Éditeur
Désigne l’équipement technique de l’Éditeur de services destiné à traiter l’envoi et
la réception de SMS dans le cadre du Contrat. La Plate-forme de services est
identifiée par son nom et l'adresse physique de sa liaison de données.
ou
Éditeur de services
ou
Plate -forme de
l’Éditeur de services
Transaction
Exprime la confirmation d’une commande de service et la facturation de celle-ci,
suivi du reversement de la surtaxe à l’ES
MSISDN
Mobile Station (Integrated Service Digital Network) number : N° d’appel de
l’Utilisateur
MULA
Multiple Address Large Account
NAdC
Notification Address Code
Code court à 5 chiffres attribué par Orange France dans le cadre du Contrat et
nécessaire à l’acheminement des SMS-MT.
Désigne le code court à 5 chiffres attribué par Orange France à un Éditeur de
service afin de faciliter la gestion de ses flux de trafic dans le cas d’Applications
mettant en relation des Utilisateurs inscrits, ou des applications permettant la
livraison de services et de sous services.
Chaque numéro secondaire est associé à un et un seul numéro court et dispose
Numéro Court
Numéros courts
secondaires
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
5
Terme
Définition
OAdC
d’un débit de 2 SMS par seconde
Originating Address Code
PLMN
Public Land Mobile Network
SESSION ID
Session identifier
SMS
Short Message Service
SMSC
Short Message Service Centre
SMS-MO
Mobile Originated SMS
SMS-MT
Mobile Terminated SMS
IMEI
International Mobile Equipment Identity: N° unique du terminal de l’Utilisateur
Code TAC
Type Approval Code : il représente les 8 premiers chiffres de l'IMEI
TAC id
Identifiant du code TAC
UCP
Universal Computer Protocol
UCPo
Protocole UCP adapté par Orange France
Incident
Toute interruption ou toute perturbation du service offert à un Éditeur
Trouble entraînant l’impossibilité de relayer :
- à un Éditeur les SMS-MO émis par ses clients ;
- aux clients les SMS-MT émis par leur Éditeur.
Interruption
Perturbation
Trouble entraînant un ralentissement du rythme ou du délai habituel :
- de transmission à un Éditeur des SMS-MO émis par ses clients
- de remise aux clients des SMS-MT émis par leur Éditeur
1- Tout dépassement de la durée prévue lors d’une interruption volontaire de
service.
(Ex : travail programmé ayant un impact sur le service)
2- Toute perturbation quantitative ou
dysfonctionnement d’un équipement.
qualitative
de
service
liée
au
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
6
2 Raccordement
2.1 Architecture générale
2.2 Mise en place d’une liaison IP opérationnelle
Pour se connecter aux infrastructures de l’opérateur, le partenaire doit disposer d’une liaison IP
opérationnelle qu’il peut établir en utilisant soit un accès privé, soit un accès public (internet).
2.2.1 Raccordement via un accès privé
Dans ce cas, le partenaire utilise un accès privé établi par la filiale Orange Business Services (OBS) pour
acheminer son trafic jusqu’au point d’entrée réseau de l’opérateur. Cet accès est ouvert à l’issue de la
souscription par le partenaire de l’offre « Business VPN IP » qui lui permet de bénéficier d’une liaison
dédiée, d’un support en cas d’incident et d’une bande passante garantie.
Le niveau de bande passante (de 512 Kbps, 1024 Kbps ou 2048 Kbps) dépend du nombre de messages par
seconde que le partenaire souhaite envoyer. Ainsi pour émettre plus de 20 SMS par seconde, le partenaire
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
7
doit demander un débit minimum de 1024 Kbps alors que pour en émettre moins, un débit de 512 Kbps est
suffisant.
A l’issue de son raccordement, le partenaire dispose :
-
d’une adresse IP dite « de nattage » lui permettant de masquer l’adresse réelle de ses
équipements et de les identifier de manière unique côté opérateur ;
de l’adresse IP de la plate-forme de l’opérateur qui doit traiter son trafic (xMS Gw).
Remarques :
Pour souscrire à l’offre « Business VPN IP », le partenaire doit contacter le correspondant commercial OBS
officiant sur sa région.
Cette offre inclut également une option permettant au partenaire de bénéficier d’un second lien afin de
sécuriser sa liaison principale en cas d’incident
Côté opérateur, l’adresse IP de substitution (« nattage ») fournie est déclarée sur plusieurs équipements de
manière à garantir la continuité du service en cas de défaillance de l’un d’entre eux.
2.2.2 Raccordement via un accès public
Dans ce cas, le partenaire utilise « internet » pour acheminer son trafic jusqu’au point d’entrée réseau de
l’opérateur. Cet accès prend la forme d’un tunnel VPN sécurisé qui peut être mis en place sous certaines
conditions à l’issue de la procédure suivante :
ère
-
1 étape : le partenaire se procure et complète le formulaire de demande de raccordement
associé (« VPN Fiche Interconnexion SVA.doc ») puis le retournent à l’opérateur ;
-
2
étape : l’opérateur étudie la faisabilité et la conformité de cette demande au regard de
ses règles/exigences en matière technique/sécurité ;
-
3
étape : à l’issue des analyses, l’opérateur valide ou refuse la demande de
raccordement du partenaire ;
-
4
étape : en cas d’acceptation, l’opérateur lance et instruit les actions nécessaires.
Parallèlement, le partenaire signe des clauses contractuelles de sécurité qui l’engagent à respecter les
recommandations techniques de l’opérateur relatives à l’interconnexion à ses équipements ;
-
5
étape : une fois l’interconnexion établie, le partenaire teste le bon fonctionnement de
son service avec le support technique de l’opérateur.
ième
ième
ième
ième
Remarques :
Les clauses contractuelles de sécurité à signer par le partenaire, visent à protéger l’opérateur contre les
comportements abusifs et/ou dangereux pour son activité.
Ces clauses sont respectivement détaillées aux Articles 4, 5, 6 et 7 du contrat de raccordement par VPN IP
Public du 2 septembre 2014.
Les recommandations techniques ainsi que les coûts de mise en œuvre d’un raccordement via un réseau
public, sont détaillées dans l’annexe « Conditions spécifiques » du contrat.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
8
2.2.3 Limite de responsabilité de l’opérateur
Dans le cadre de son obligation d’acheminent du trafic en provenance du partenaire, la responsabilité de
l’opérateur commence à son point d’entrée réseau.
Dans le cadre de son obligation d’acheminent du trafic à destination du partenaire, la responsabilité de
l’opérateur s’arrête à son point d’entrée réseau.
Dans ces conditions, Orange France ne peut être tenu pour responsable des difficultés d’accès et/ou
problèmes de débit rencontrés par le partenaire entre ses équipements et ce point d’entrée, et inversement.
Remarque :
En cas de difficulté d’accès et/ou problèmes de débit, le partenaire raccordé via la souscription de l’offre
« Business VPN IP » peut directement solliciter le support de la société OBS qui maintient sa liaison.
2.3 Recommandations
2.3.1 Mise en place d’un mécanisme de surveillance
Le raccordement en mode IP passe par l’ouverture d’une ou plusieurs connexions qui devront être
maintenues ouvertes en permanence par l’Éditeur. Pour garantir le maintien permanent de ces connexions
l’Éditeur doit mettre en place une surveillance qui peut s’appuyer sur les principes suivants :
vérifier à intervalle régulier l’état de la connexion. Le délai entre 2 vérifications doit être paramétrable et
doit être fixé à 5 secondes par défaut ;
tenter de se reconnecter dès que l’Éditeur détecte une rupture du service. Les reconnexions doivent être
tentées jusqu’au rétablissement effectif de la liaison avec la Plate-forme SMS. Le délai entre 2 tentatives
de reconnexions ne doit pas être supérieur à 30 secondes ;
s’assurer que la durée d'inactivité de la liaison ne dépasse 10 minutes. Si aucun message ne transite
pendant ce laps de temps, la Plate-forme SMS fermera la connexion. Pour éviter la coupure, l’Éditeur
peut faire un « ping » applicatif de manière récurrente (« keepalive ») en envoyant un message de type
« UCP31 ». Dans ce contexte, le champ « AdC » du message doit systématiquement être renseigné
mais sa valeur numérique peut ne pas être significative car elle n’est pas exploitée par la Plate-forme
SMS ;
acquitter systématiquement toutes les notifications adressées par la Plate-forme SMS même si celles-ci
concernent des SMS non envoyés par l’Éditeur. Cette précaution permet d’éviter les blocages applicatifs
déclenchés par la Plate-forme SMS.
2.3.2 Attribution/échange des adresses IP
Pour permettre le raccordement, Orange France va attribuer à l’Éditeur une « adresse IP de nattage » qui va
lui permettre de masquer l’adresse IP réelle de ses équipements. Cette « adresse IP de nattage » identifie
de façon unique l’Éditeur au sein du réseau d’Orange France et auprès de la Plate-forme SMS.
A chaque numéro court utilisé par l’Éditeur, Orange France associera un numéro de « port de TCP source »
permettant de le distinguer du reste des numéros.
L’adresse IP de la Plate-forme SMS est fournie à l’Éditeur par le support technique d’Orange France lors
des tests de raccordement.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
9
Actuellement, la Plate-forme SMS est associée à une seule adresse IP mais à laquelle plusieurs serveurs
physiques sont rattachés. Cette association permet d’offrir à l’Éditeur une continuité du service en cas de
défaillance d’un des serveurs.
2.4 Mise en service des numéros courts
Une fois raccordé à la Plate-forme SMS, l’Éditeur peut demander l’ouverture des numéros courts
nécessaires à son activité (Short ID).
L’ouverture de nouveaux numéros courts s’appuie sur la procédure suivante :
-
conformément à la procédure d’attribution et de mise en service d’un numéro court (cf. annexe 4 du
Contrat SMS+), l’équipe commerciale d’Orange France génère les ordres de travaux nécessaires à
leur ouverture ;
-
à l’issue du traitement des ordres de travaux, l’Éditeur doit prendre contact avec le support
technique d’Orange France afin d’organiser et effectuer les tests fonctionnels validant définitivement
son interconnexion et l’utilisation nominale de ses numéros courts.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
10
3 Gestion des échanges
3.1 Protocole de communication
Le protocole UCP est utilisé pour permettre à l’Éditeur d’échanger avec la Plate-forme SMS. Ce protocole
est décrit dans le document de référence « Short Message Service Center EMI – UCP Interface Version
4.6» fourni par Orange France sur demande.
3.2 Cinématique d’ensemble
Le schéma ci-dessous représente les différents messages UCP susceptibles d’être échangés entre l'Éditeur,
la Plate-forme SMS et le client Mobile.
3.2.1 Détails des différents messages échangés
Le tableau ci-dessous détaille les différents messages susceptibles d’être échangés entre l’'Éditeur et la
Plate-forme SMS.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
11
N°
Message
Description
Émetteur
Récepteur
Éditeur
UCP 60 Ack
Ce message permet à l’Éditeur de s'authentifier auprès de la
Plate-forme SMS et d’ouvrir une session
Ce message acquitte positivement la réception d’un UCP 60.
3
UCP 60 Nack
Ce message acquitte négativement la réception d’un UCP 60.
Éditeur
4
UCP 51
Ce message permet d’envoyer un SMS MT à un destinataire
mobile.
Plate-forme
SMS
Éditeur
5
UCP 51 Ack
UCP 51 Nack
Plate-forme
SMS
Plate-forme
SMS
Éditeur
6
C’est un message acquittant positivement la réception d’un UCP
51.
C’est un message acquittant négativement la réception d’un UCP
51.
7
UCP 52
UCP 52 Ack
Plate-forme
SMS
Éditeur
Éditeur
8
Ce message délivre un SMS-MO envoyé par le mobile à la Plateforme de Services.
C’est un message acquittant positivement la réception d’un UCP
52.
9
UCP 52 Nack
C’est un message acquittant négativement la réception d’un UCP
52.
Editeur
Plate-forme
SMS
1
UCP 60
2
Plate-forme
SMS
Plate-forme
SMS
Éditeur
Plate-forme
SMS
Éditeur
Plate-forme
SMS
3.3 Utilisation de la fonction de fenêtrage (« Windowing »)
Afin d'accroître ses performances, l’Éditeur doit utiliser la fonction de fenêtrage (« Windowing ») pour relayer
ses messages à la Plate-forme SMS.
Pour l’Éditeur, cette fonction permet de définir le nombre de SMS qu’il peut émettre ou recevoir en 1
seconde, sans pour autant être obligé d’attendre l’acquittement de chaque message envoyé.
3.3.1 Gestion des SMS-MT émis en mode « windowing »
Le nombre maximum de SMS-MT pouvant être émis en 1 seconde, doit être paramétré par l’Éditeur
(paramètre « Output window »). Orange France recommande de fixer la valeur de ce paramètre à « 10
messages par seconde ». Dans ce contexte, l’Éditeur doit être mesure d’envoyer 10 SMS-MT (message de
type UCP51) en moins d’une seconde sinon sa connexion à la Plate-forme SMS est rompue.
Exemple
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
12
3.3.2 Gestion des SMS-MO émis en mode « windowing »
Le nombre maximum de SMS-MO pouvant être reçus en 1 seconde, doit être paramétré par l’Éditeur
(paramètre « Input window »). Orange France recommande de fixer la valeur de ce paramètre à « 10
messages par seconde ». Dans ce contexte, l’Éditeur doit être mesure d’acquitter 10 SMS-MO (message
de type UCP52) en moins d’une seconde sinon sa connexion avec la Plate-forme SMS est rompue.
Exemple
3.4 Gestion et maîtrise des débits
La Plate-forme SMS contrôle le strict respect du débit souscrit par l’Éditeur (nombre de SMS-MT qu’il est
autorisé à émettre en 1 seconde).
En d’autres termes, tout SMS-MT supplémentaire envoyé sur un numéro court donné, sera ignoré par la
Plate-forme SMS si celui-ci entraîne un dépassement du débit autorisé. Dans ce cas, la Plate-forme SMS
émettra un message d’erreur spécifique en direction de l’Éditeur.
Exemple :
si un Éditeur ayant choisi un débit de 10 SMS-MT/seconde pour un numéro court donné, envoie un 11e
SMS-MT au cours de la même seconde, le dernier message émis sera rejeté par la Plate-forme SMS et un
message d’erreur spécifique lui sera adressé ("Police de trafic dépassée").
Dans ce cas, l’Éditeur devra attendre la seconde suivante pour réémettre le onzième SMS-MT.
Aucun contrôle n’est fait par la Plate-forme SMS concernant le débit des SMS-MO relayés à l’Éditeur.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
13
3.5 Échanges à la connexion de l’Éditeur
3.5.1 Demande d’ouverture de session
Lors de sa chaque connexion à la Plate-forme SMS, l’Éditeur doit obligatoirement envoyer un message de
type « UCP60 » lui permettant d’ouvrir une session après s’être authentifié à l’aide de l’identifiant et du mot
de passe fourni le support technique d’Orange France.
Une session ouverte le reste tant que la connexion est active.
En cas de rupture anormale de la connexion, aucune reprise de session ne peut être initiée par la Plateforme SMS puisqu’elle ne mémorise aucun contexte. Dans ce cas, l’Éditeur doit demander l’ouverture d’une
nouvelle session afin de réémettre les messages non encore acquittés par la Plate-forme SMS.
3.5.2 Acquittement de la demande d’ouverture de session
A l’issue de chaque tentative d’ouverture de session par l’Éditeur :
- un message de type « UCP60 Ack » est retournée par la Plate-forme SMS lorsque cette opération a
réussi ;
- un message de type « UCP60 Nack » est retournée par la Plate-forme SMS lorsque cette opération a
échoué.
De manière générale, l’Éditeur doit acquitter tous les messages émis par la Plate-forme SMS afin d’éviter
tout blocage applicatif.
3.5.3 Erreurs possibles
Si la Plate-forme SMS rejette la demande d'ouverture de session, l’Éditeur doit être capable d'émettre une
nouvelle demande en tenant compte du code d'erreur retourné.
Le tableau ci-dessous détaille les erreurs susceptibles de figurer dans les acquittements négatifs retournés à
l’Éditeur (message « UCP60 Nack»)
N°
1
Description
Réception d'un UCP60 avec un
numéro court ou un mot de
passe incorrect.
2
Réception d'un UCP60 sur une
connexion dont l'adresse IP ou le
port n'est pas valable.
3
Réception d'un UCP60 alors que
le nombre d'ouverture de
sessions autorisé est atteint.
4
Réception d'un deuxième
UCP60 alors qu'une session est
déjà ouverte.
Message d’erreur
UCP60 Nack
Error Code = 07
Authentication failure
System Message = " Login or password not valid "
UCP60 Nack
Error Code = 04
Operation not allowed
System Message = " Invalid IP:port "
UCP60 Nack
Error Code = 04
Operation not allowed
System Message = "Session not accepted, number of sessions exceeded"
UCP60 Nack
Error Code = 04
Operation not allowed
System Message = "Message not accepted, message session "
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
14
3.6 Échanges à l’envoi d’un SMS-MT par l’Editeur
3.6.1 Demande d’envoi d’un SMS-MT
L’émission d’un SMS-MT est matérialisée par un message de type « UCP51 ».
A l’issue de l’envoi d’un SMS-MT, l’Éditeur a la possibilité de suivre la livraison de son message au travers
du réseau d’Orange France en demandant une notification. Pour la demander, l’Éditeur doit renseigner le
paramètre « NRq » de la trame du message « UCP51 » avec la valeur « 1 ». En plus de ce champ, d’autres
paramètres peuvent être renseignés :
N°
Champ de la trame UCP51
1
NRq
2
NAdC
3
4
NT
NPID
Désignation
Notification Request
Notification Address
Code
Notification Type
Notification PID Value
Détails
Si le paramètre « NRq » est égal à 1 (utilisation du
service de notification). Dans ce cas, le paramètre
« NT » (qui correspond au type de notification
demandée) doit impérativement être renseigné.
Ce champ optionnel doit rester vide.
Détermine le type de notification demandée
Ce champ optionnel précise la valeur du PID pour
la notification.
Lors de l’envoi d’un message, l’Éditeur peut demander l’un des 3 types de notifications suivants :
N°
1
Type de notification
BN
Désignation
Buffered message
Notification
Détails
Indique que le message a bien été reçu par la Plateforme SMS et placé dans une file d’attente
2
DN
Delivery Notification
Indique que le message a été remis au destinataire
3
ND
Non Delivery
Notification
Indique que le message n’a pas été remis au
destinataire. Cette notification est envoyée à la fin
de la durée de vie prévue pour le message
En combinant ces différents types, l’Éditeur peut spécifier au niveau du champ « NT » (Notification type) du
message « UCP51 », l’une des notifications suivantes :
N°
1
Valeur possible
0
Types de notification retournée
Valeur par défaut (aucune notification n’est envoyée)
2
3
1
2
DN
ND
4
3
5
4
DN et ND
Une seule notification est remontée à l’ES:
- Soit le message remis au destinataire Une notification de remise est
remontée
- Soit le message non remis au destinataire Une notification de non
remise est remontée
BN
6
5
BN et DN
- Soit le message remis au destinataire Une notification de remise est
remontée
- Soit le message non remis au destinataire Aucune notification n'est
remontée
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
15
N°
Valeur possible
7
6
8
7
Types de notification retournée
- Soit le message stocké puis remis au destinataire deux notifications sont
remontées : une première indiquant que le message est stocké, puis une
deuxième notification indiquant que le message a été remis
- Soit le message stocké puis non remis au destinataire car VP expirée
une seule notification est remontée indiquant que le message est stocké
BN et ND
- Soit le message remis au destinataire Aucune notification n'est remontée
- Soit le message non remis au destinataire Une notification de non
remise est remontée
- Soit le message stocké puis remis au destinataire une seule notification
est remontée indiquant que le message est stocké
- Soit le message stocké puis non remis au destinataire car VP expirée
deux notifications sont remontées : une première indiquant que le message
est stocké, puis une deuxième notification indiquant que le message n'a pas
été remis
DN et ND et BN
- Soit le message remis au destinataire Une notification de remise est
remontée
- Soit le message non remis au destinataire Une notification de non
remise est remontée
- Soit le message stocké puis remis au destinataire deux notifications sont
remontées : une première indiquant que le message est stocké, puis une
deuxième notification indiquant que le message a été remis
- Soit le message stocké puis non remis au destinataire car VP expirée
deux notifications sont remontées : une première indiquant que le message
est stocké, puis une deuxième notification indiquant que le message n'a pas
été remis
3.6.2 Acquittement de la demande d’envoi du SMS-MT
A l’issue de chaque SMS-MT émis par l’Éditeur,
- un message de type « UCP51 Ack » lui est retourné par la Plate-forme SMS lorsque celle-ci acquitte
positivement le message UCP51 associé ;
- un message de type « UCP51 Nack » lui est retourné par la Plate-forme SMS lorsque celle-ci acquitte
négativement le message UCP51 associé.
De manière générale, l’Éditeur doit acquitter tous messages émis par la Plate-forme SMS afin d’éviter tout
blocage applicatif.
3.6.3 Erreurs possibles
Le tableau ci-dessous détaille les erreurs susceptibles de figurer dans les acquittements négatifs retournés à
l’Éditeur (message « UCP51 Nack»)
N°
Description
1
Réception d'un UCP51 avec une
erreur de "Cheksum"
Message d’erreur
UCP51 Nack
Error Code = 01 (Checksum error”)
System message = “Checksum error”.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
16
N°
Message d’erreur
Description
2
Réception d'un UCP51 avec une
erreur de syntaxe
UCP51 Nack
Error Code = 02 (Syntax error)
System message = “Syntax error”.
3
Réception
d'un
UCP51
en
provenance d'un ES ayant
dépassé le débit autorisé dans le
sens MT
4
Réception d'un UCP51 dont la
valeur du champ OAdC n'est pas
autorisée.
UCP51 Nack
Error Code = 04
Operation Not Allowed
System message = "Police de trafic dépassé"
ou
System message = “Throttling rate of <x> for account <account> is
exceeded.”
UCP51 Nack
Error Code = 04 (Operation not Allowed)
System message = “Originating Address not allowed”
5
Réception d'un UCP51 dont le
numéro du destinataire (champ
AdC) n'est pas autorisée.
6
7
Réception d'un UCP51 dont le
champ AdC contient un identifiant
invalide.
Réception d'un UCP51 dont la
valeur du champ DDT n'est pas
autorisée.
UCP51 Nack
Error Code = 05 (Call barring active)
System message = “Destination address in blacklist”
UCP51 Nack
Error Code = 06 (AdC invalid)
System message = “AdC invalid”
UCP51 Nack
Error Code = 18 (Deferred delivery not allowed)
System message = “Deferred delivery not allowed”
3.6.4 Durée de validité d’un SMS-MT
Lorsqu'un SMS-MT envoyé par un Éditeur n’est pas transmis immédiatement à son destinataire final (cas
d’un mobile éteint, par exemple), le message associé est stocké par la Plate-forme SMS afin que celle-ci
tente de le relivrer.
Par défaut, les SMS-MT non livrés sont conservés 3 jours par la Plate-forme SMS.
Cependant, l’Éditeur peut demander une conservation plus longue de ses SMS-MT (jusqu’à 7 jours) en
renseignant le champ « Validity Period » du message « UCP51 » avec la date/heure de fin de validité
souhaitée.
Dans ce cas, si le champ « Validity Period » :
-
n’est pas renseigné par l’Éditeur, la Plate-forme SMS attribue au message « UCP51 » la durée de validité
par défaut (3 jours) ;
-
est renseigné avec une durée de validité de moins de 7 jours, la Plate-forme SMS attribue au message
« UCP51 » la durée de validité demandée ;
-
est renseigné avec une durée de validité de plus de 7 jours, la Plate-forme SMS attribue au message
« UCP51 » la durée de validité maximum (7 jours).
Durant cette période de conservation, la Plate-forme SMS va tenter de réémette le SMS-MT non livré vers
son destinataire jusqu’à ce que sa date de fin de validité soit atteinte.
3.7 Échanges à la remise effective du SMS-MT
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
17
A l’issue de chaque tentative de remise d’un SMS-MT, l’Éditeur peut recevoir une notification matérialisée
par un message de type « UCP53 » retournée par la Plate-forme SMS, à condition d’avoir correctement
renseigné les paramètres « NRq » et « NT » du message « UCP51 » associé.
Dans la trame du message « UCP53 », le champ « DST » renseigne l’Éditeur sur l’état de la livraison de
son SMS-MT : remis à son destinataire, non remis, en attente de livraison ou de relivraison à la suite de
tentatives infructueuses.
Le tableau ci-dessous indique les valeurs génériques susceptibles d’être retournées à l’Éditeur au niveau du
champ « DST » (message « UCP53 »)
N°
1
Valeur
possible
0
Désignation
2
1
Bufferisé ou stocké au niveau
de la Plate forme SMS
3
2
Non Délivré
Type d’erreur
Explications
Délivré
Le message a été effectivement remis
au destinataire
Le message n’a pas pu être remis et
est stocké dans l’attente de nouvelles
tentatives
Le message ne peut définitivement pas
être remis à son destinataire.
N/A
Erreur temporaire.
Erreur Permanente.
A la suite d’une erreur temporaire, le message est stocké par la Plate-forme SMS afin que de nouvelles
tentatives de remises puissent être faites régulièrement (sur la base d’un cycle prédéfini).
A la suite d’une erreur permanente, la Plate-forme SMS supprime le SMS-MT stocké car il ne pourra plus
être remis à son destinataire.
En cas d’erreur temporaire ou permanente, le champ « RSN » du message « UCP53 », renseigne l’Éditeur
sur sa cause. Ce champ est uniquement renseigné lorsque le champ « DST » donnant l’état de la livraison,
prend les valeurs « 1 » ou « 2 ».
Le tableau ci-dessous détaille les erreurs susceptibles de figurer dans les notifications retournées à l’Éditeur
(message « UCP53»)
N°
Type d’erreur
1
Valeur
possible
000
Désignation
Unknown subscriber
Permanente
2
101
Unknown subscriber
Temporaire
3
103
Call barred
Permanente
4
107
Absent subscriber
Temporaire
5
108
Delivery fail
Permanente
6
109
Sc congestion
Temporaire
7
110
Protocol error
Permanente
8
111
MS not equiped
Permanente
Raison possible
L’abonné n'est pas inscrit au HLR, ou il y a un
faux numéro
Il n'y a pas de réponse du HLR
Le compte de l'Abonné est désactivé par
l'opérateur, notamment dans le cas ou il ne paie
pas sa facture
Le mobile Utilisateur est éteint ou est hors
couverture
La durée de validité du message est expirée. Ou,
la Carte SIM est pleine.
Ou, le mobile est déjà entrain de recevoir un
message d'un autre SMSC
Il y a congestion du SMS IWMSC (Interworking
MSC For Short Message Service)
Erreur de protocol
La classe du message n'est pas supportée par le
mobile
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
18
N°
Désignation
Type d’erreur
9
Valeur
possible
114
Illegal MS
Permanente
10
118
System fail
Permanente
11
12
126
127
Temporaire
Permanente
13
202
14
206
System failure
Unexpected data
value
Short message
exceeds maximum
Invalid destination
address
Raison possible
Permanente
Le numéro IMEI est dans la black list (mobile volé
par exemple)
Code d'erreur inconnu. Déconnexion réseau.
Problème dans le SMS MT, données non
comprises. Mobile n'est pas détectable par le
réseau.
Problème dans la partie du sous système radio.
Codage du message incorrect, ou il y a des
paramètres manquants
Taille des données utilisateur incorrecte
Permanente
Le MSISDN est porté par un autre opérateur
Pour contrôler la remise effective d’un SMS-MT, l’Éditeur peut rapprocher les messages « UCP51 Ack » et
« UCP53 » associés. Ce rapprochement s’appuie sur :
-
les valeurs du champ « SCTS » inclus dans les messages « UCP51 Ack » et « UCP53 » qui doivent
correspondre à la même date/heure d’acquittement positif du message par la Plate-forme SMS (au
format DDMMYYHHMMSS) ;
-
les valeurs du champ « OadC » inclus dans les messages « UCP51 Ack» et « UCP53 » qui doivent
correspondre au même destinataire (MSISDN).
Lorsque plusieurs SMS-MT sont émis dans la même seconde par l’Éditeur, leurs dates/heures
d’acquittement respectif sont décalées d’au moins 1 seconde.
Exemple de message « UCP53 » relatif à un SMS-MT émis
03/00146/O/53/68000/0612345678///////////171110142321/0/000/171105142322/3//534D532072656D697320
61752030363132333435363738206C652031372E31312E303520612031342E32332E3232/////////////75
Exemple de message « UCP51 Ack » relatif au même SMS-MT émis
00/00043/R/51/A/0612345678:171110142321/46
Et où :
- le champ « OadC » prend la valeur « 0612345678 »
l- e champs « SCTS » prend la valeur « 171110142321 ».
De manière générale, l’Éditeur doit acquitter tous les messages émis par la Plate-forme SMS afin d’éviter
tout blocage applicatif.
3.8 Échanges à la réception d’un SMS-MO par l’Éditeur
Les requêtes adressées par un client à l’Éditeur se traduisent par l’envoi de SMS-MO matérialisé par un
message de type « UCP52 » relayé par la Plate-forme SMS.
Lorsqu’aucune connexion n’est établie avec l’Éditeur, la Plate-forme SMS stocke ces messages afin de
pouvoir les lui relayer à nouveau lorsque la communication sera possible.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
19
3.8.1 Acquittement de la réception d’un SMS-MO
A l’issue de la réception d’un SMS-MO, l’Éditeur doit retourner à la Plate-forme SMS :
- un message de type « UCP52 Ack » lorsque le message UCP52 associé est acquitté positivement ;
- un message de type « UCP52 Nack » lorsque le message UCP52 associé est acquitté négativement.
De manière générale, l’Éditeur doit acquitter tous les messages émis par la Plate-forme SMS afin d’éviter
tout blocage applicatif.
3.8.2 Gestion des erreurs
En cas d’acquittement négatif retourné à la Plate-forme SMS, le support technique d’Orange France alertera
l’Éditeur afin qu’il procède aux investigations et aux corrections nécessaires.
3.9 Transmission d’un identifiant
3.9.1.1 Principe
Dans la plupart des cas, les échanges entre la Plate-forme SMS et l‘Éditeur n’utilisent pas le numéro du
client (MSISDN) mais un identifiant numérique (Alias) composé de 12 à 15 caractères. Il est attribué par la
Plate-forme SMS pour chaque couple « MSISDN client/numéro court Éditeur » et est inscrit dans le premier
message UCP52 transmis à l’Éditeur.
Lors d’échanges avec un client, l’Éditeur doit à son tour renseigner son identifiant dans chaque SMS-MT
qu’il adresse à la Plate-forme SMS afin que celle-ci le remplace par le MSISDN du destinataire.
Le premier chiffre de cet identifiant caractérise le réseau mobile auquel appartient le client. L’identifiant des
clients Orange France commence toujours par la valeur « 3 ».
Exemple : Identifiant d’un client Orange France
312345678901
3.9.1.2 Fourniture de l'identifiant statique et commun
L’identifiant fourni par la Plate-forme SMS est dit « statique » dans la mesure où sa valeur reste constante
pour chaque couple « MSISDN client/numéro court Éditeur ».
Dans le cas d’un Éditeur proposant des services basés sur des numéros secondaires, l’identifiant fourni par
la Plate-forme SMS est commun à l’ensemble de ces numéros et est toujours calculé sur la base du numéro
court de référence. Grâce à cette fonctionnalité, l’Éditeur peut identifier un client quel que soit le numéro
court qu’il utilise.
Pour bénéficier de cette fonctionnalité, l’Éditeur doit en faire la demande à Orange France en précisant le
numéro de référence et les numéros secondaires qu’il souhaite associer.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
20
Remarque
A l’issue de la de la mise en place de cette fonctionnalité, un Éditeur perd automatiquement tous les
identifiants dont il disposait lorsqu’il ne gérait qu’un numéro court de référence.
Pour rappel, le débit associé aux numéros secondaires est de 2 SMS par seconde.
3.9.1.3 Outil de correspondance
Suivant l’offre souscrite par l’Éditeur, Orange France met à sa disposition un outil lui permettant de faire
correspondre à un identifiant donné, le MSISDN du client concerné et inversement.
Pour utiliser cet outil, l’Éditeur doit préalablement s’authentifier en utilisant le « login » et « mot de passe »
fourni sur demande par Orange France.
Les conditions d’utilisation de cet outil sont précisées à l’Article 8.4 des Conditions Générales.
3.10 Spécificités du protocole UCPo
Suivant l’offre SMS+ souscrite par l’Éditeur, la Plate-forme SMS peut enrichir certains messages UCP
échangés afin de faciliter le dialogue avec son client. Les messages UCP enrichis composent le protocole
UCPo.
3.10.1 Paramètres complémentaires échangés
Les 4 paramètres suivants peuvent être ajoutés dans les messages UCP échangés entre la Plate-forme
SMS et l’Éditeur :
« Session ID » ;
« Code Action » ;
« Nombre de messages » ;
« Tac ID ».
3.10.1.1 Paramètre « Session ID »
Le paramètre « Session ID » identifie la session de service en cours. Composé de 11 chiffres, ce paramètre
est initialisé par la Plate-forme SMS avant d’être transmis à l’Éditeur.
Il est présent dans les messages de type UCP51 et UCP52.
3.10.1.2 Paramètre « Code Action »
Le paramètre « Code Action » est composé de 2 chiffres précisant l’action demandée à la Plate-forme SMS
par l’Éditeur. Présent dans les messages de type UCP51, ce paramètre peut prendre l’une des 5 valeurs
suivantes :
« 00 nop » : aucune action (utilisé pour les messages de dialogue)
« 01 end » : fin de transaction et de session de service (« confirm+close »)
« 02 confirm » : fin de transaction
« 03 close » : fin de session de service
« 04 Subscribe » : demande d'inscription
« 05 Unsubscribe » : demande de résiliation
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
21
3.10.1.3 Paramètre « nombre de messages »
Présent dans les messages de type UCP51, ce paramètre numérique codé sur 2 caractères précise le
nombre de messages composant le service délivré par l’Éditeur au client. Dans ce contexte, l’action
associée demandée à la Plate-forme SMS ne sera effectuée qu’à l’issue de l’acquittement positif de tous les
messages composant la livraison.
3.10.1.4 Paramètre « Tac ID »
La Plate-forme SMS gère les codes TAC qui identifient la marque et le modèle des différents terminaux
mobiles existant sur le marché. A chaque code TAC, la Plate-forme SMS associe également un « Tac ID »
qu’elle peut fournir l’Editeur afin qu’il adapte ses contenus aux terminaux de ses clients.
Codé sur 4 chiffres, le paramètre « Tac ID » est présent dans les messages de type UCP52.
Exemple : le terminal mobile MOTOROLA V600 est associé au code TAC 352813 et au TAC ID 0631
Remarque
Lorsque l’information est indisponible pour un terminal donné, le paramètre « Tac ID » transmis prend la
valeur « 0000 ».
3.10.1.5 Exemple de message UCP51 enrichi
Les paramètres « Session ID », « Nombre de messages » et « Code Action » sont véhiculés par le champ
Authentication Code Originator (noté AC) composé de 16 caractères et sont codés de la manière
suivante :
Digits 1..2
Digits 3..4
Digits 5..15
Code d'action
Nombre de messages composant le bien livré à l’Utilisateur
SESSION id
Exemple :
0
1
Code
d'action
0
3
Nombre de
messages
0
0
7
4
6
1
8
SESSION id
(11 chiffres)
2
4
5
3
Code d'action = 01
Nombre de messages = 03
SESSION id = 00746182453
Trame UCP51 correspondante
00/00086/O/51/312345678901/61000/010300746182453////////////////3//414243/////////////40
Remarque
ème
Les informations de session utilisent 15 chiffres (2 + 2+ 11) sur les 16 disponibles. Le 16
est réservé à une utilisation future.
emplacement
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
22
3.10.1.6 Exemple de message UCP52 enrichi
Les paramètres « Session ID » et « Tac ID » sont véhiculés par le champ HPLMN composé de 16
caractères et sont codés de la manière suivante :
Digits 1..4
Digits 5..15
TAC id
SESSION id
Exemple :
0
0
2
TAC id
(4 chiffres)
6
0
0
5
6
4
7
8
SESSION id
(11 chiffres)
5
2
2
4
TAC id = 0026
SESSION id = 00564785124
Trame UCP52 associée :
00/00102/O/52/61000/312345678901//////////////3//54657374/////////002600564785124////83
Remarque
Les informations de session utilisent 15 chiffres (2 + 2+ 11) sur les 16 disponibles. Le 16
est réservé à une utilisation future.
ème
emplacement
3.10.2 Codes erreurs spécifiques
Le tableau ci-dessous détaille les erreurs spécifiques au protocole UCPo susceptibles d’être retournés à
l’Éditeur (message « UCP51 Nack»)
N°
Description
1
Réception d'un UCP51 alors que
le nombre de messages autorisé
par jour est atteint.
UCP51 Nack
Error Code = 04 (Operation not Allowed)
System message ="The number of messages per day is reached”
2
Réception d'un UCP51 pour un
Utilisateur ayant changé de statut,
notamment lorsque le compte
Utilisateur est suspendu par
Orange.
UCP51 Nack
Error Code = 04
AdC invalid
System message = "Changement de statut de l’Utilisateur"
3
Réception d'un UCP51 dont le
champ AdC contient un identifiant
invalide
4
Réception d'un UCP51 de service
durant une session de service
contenant un code d'action
différent de ceux autorisés
UCP51 Nack
Error Code = 06
AdC invalid
System message = "Alias invalide"
UCP51 Nack
Error Code = 19
New AC not valid
System message = "Code d'action non autorisé »
Message d’erreur
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
23
N°
Message d’erreur
Description
5
Réception d'un UCP51 gratuit en
dehors d'une session de dialogue
ou de service
UCP51 Nack
Error Code = 04
Operation Not Allowed
System message = "Session inconnue"
6
Réception d'un UCP51 payant en
dehors d'une session de service
UCP51 Nack
Error Code = 04
Operation Not Allowed
System message = "Session de service inconnue"
7
Réception d'un UCP51 durant une
session de service "en attente"
UCP51 Nack
Error Code = 04
Operation Not Allowed
System message = "Session en attente"
8
Réception d'un UCP51 de service
contenant un SESSION id
inconnu (session de service close,
terminée ou n'ayant jamais été
créée)
9
Réception d'un UCP51 de service,
durant une session de service,
mais dont le paramètre "nombre
de messages" est incohérent par
rapport au même paramètre du ou
des UCP51 de service précédent
UCP51 Nack
Error Code = 19
New AC not valid
System message = "Nombre de messages incohérent"
10
Réception d'un UCP51 de service
durant une session de service
contenant un code d'action
différent de ceux autorisés
UCP51 Nack
Error Code = 19
New AC not valid
System message = "Code d'action non autorisé"
11
Réception d'un UCP51 de service
dont les informations de session
sont mal formatées
UCP51 Nack
Error Code = 19
New AC not valid
System message = "Informations de session mal formatées »
12
Réception d'un UCP51 de service,
durant une session de service,
mais dont le paramètre "nombre
de messages" est incohérent par
rapport au même paramètre du ou
des UCP51 de service précédent
Réception d'un UCP51 de service,
durant une session de service,
mais dont le code d'action est
incohérent avec l'action en cours
UCP51 Nack
Error Code = 19
New AC not valid
System message = "Nombre de messages incohérent"
Réception d'un UCP51 de service
dont les informations de session
sont mal formatées
UCP51 Nack
Error Code = 19
New AC not valid
System message = "Informations de session mal formatées"
13
14
UCP51 Nack
Error Code = 19
New AC not valid
System message = "Identifiant de session inconnu"
UCP51 Nack
Error Code = 19
New AC not valid
System message = "Code d'action incohérent avec l'action en cours »
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
24
4 Présentation des offres SMS+ non surtaxées
4.1 Offres « Light Push »
4.1.1 Principales caractéristiques
Type de cinématique
Push
Pull
Type d’offre
Surtaxée
Non surtaxée
Usage porteur de la surtaxe
SMS-MT
Type de paliers tarifaires associés
2
Mode de facturation client
A l’acte
Abonnement
Inscription client pré-requise
Oui
Non
Offre soumise à reversement
Oui
Non
Identifiant échangé
MSISDN
Alias
Protocole utilisé
UCP
UCPo
3
SMS-MO
4
5
6
N/A
7
8
4.1.2 Description
Les offres de la gamme « Light Push » s’adressent aux Editeurs qui souhaitent émettre en masse des SMSMT vers des clients mobiles dont ils possèdent le numéro (MSISDN).
Dans cette gamme, 3 offres sont disponibles :
« Light Push Pub » préconisée dans le cas de services de Marketing Direct visant à faire de la
prospection commerciale ;
« Light Push Tribu » préconisée dans le cas services d’échanges interpersonnels entre clients (Chat,
Peer To Peer…) ;
« Light Push Livraison » préconisée pour délivrer aux clients des contenus préalablement commandés
par un canal autre que SMS.
Remarque
Un Editeur ne peut associer un même numéro court qu’à une seule de ces offres.
4.1.3 Cinématique
Dans le cadre des offres « Light Push », les échanges avec le client (session) sont toujours initiés par
l’Editeur à l’issue de l’envoi d’un premier SMS-MT.
En retour, le client a la possibilité de répondre à l’Editeur en lui envoyant un SMS-MO (par exemple, pour
demander à ne plus être contacté lors d’une campagne de Marketing direct).
Chaque SMS-MT émis par un Éditeur initie une nouvelle session d’échanges (cinématique mono session).
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
25
Client
Mobile
Plate-forme
SMS
Réseau
OF
Éditeur de
services
UCP 51
(MSISDN, short ID)
UCP 51 ACK
UCP 51
(MSISDN, short ID)
SMS MT
(MSISDN, Short ID
UCP 51 ACK
UCP 53
SMS MO
(MSISDN, Short ID)
UCP 53
UCP 52
(MSISDN, Short ID)
UCP 52 ACK
UCP 52
(MSISDN, Short ID)
UCP 52 ACK
Session
4.2 Offre « Light Pull »
4.2.1 Principales caractéristiques
Type de cinématique
Push
Pull
Type d’offre
Surtaxée
Non surtaxée
Usage porteur de la surtaxe
SMS-MT
Type de paliers tarifaires associés
2
Mode de facturation client
A l’acte
Abonnement
Inscription client pré-requise
Oui
Non
Offre soumise à reversement
Oui
Non
Identifiant échangé
MSISDN
Alias
Protocole utilisé
UCP
UCPo
3
SMS-MO
4
5
6
N/A
7
8
4.2.2 Description
L’offre « Light Pull » s’adresse aux Editeurs proposant des services que leurs clients peuvent utiliser en
envoyant des SMS-MO (inscription, jeux…).
Dans ce cadre, l’Editeur n’est pas tenu de répondre au client (en lui envoyant par exemple un SMS-MT
d’acquittement). Cependant Orange France recommande à l’Editeur de le faire dans un délai de 24 heures,
à compter de la date/heure de réception du SMS-MO ayant initié la session d’échanges.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
26
4.2.3 Cinématique
Dans le cadre de l’offre « Light Pull », les échanges avec l’Editeur (session) sont toujours initiés par le client
à l’issue de l’envoi d’un premier SMS-MO. Une session d’échanges a une durée de vie limitée, configurable
en fonction du numéro court utilisé par l’Editeur.
A l’issue de l’expiration d’une première session, seule l’émission par le client d’un nouveau SMS-MO
permettra d’en initier une seconde. Par contre, l’émission d’un nouveau SMS-MO durant une session en
cours de validité, prolonge d’autant sa durée de vie.
Les échanges avec un Editeur n’utilisent pas le numéro mobile du client (MSISDN) mais un identifiant (alias)
défini et associé de manière fixe par la Plate-forme SMS au couple « numéro court Editeur/MSISDN client ».
Dans ce contexte, les prochains échanges entre le client et l’Editeur utiliseront systématiquement l’identifiant
initialement défini.
Client
Mobile
SMS MO
(MSISDN, Short ID)
Éditeur de
services
Plate-forme
SMS
Réseau
OF
UCP 52
(MSISDN, Short ID)
UCP 52 ACK
UCP 52
(Alias, Short ID)
UCP 52 ACK
S
e
s
s
i
o
n
UCP 51
(Alias, short ID)
UCP 51
(MSISDN, short ID)
UCP 51 ACK
UCP 51 ACK
SMS MT
(MSISDN, Short ID)
UCP 53
SMS MO
(MSISDN, Short ID)
UCP 53
UCP 52
(MSISDN, Short ID)
UCP 52 ACK
UCP 52
(Alias, Short ID)
UCP 52 ACK
S
e
s
s
i
o
n
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
27
4.3 Offre « Light Gallery »
4.3.1 Principales caractéristiques
Type de cinématique
Push
Pull
Type d’offre
Surtaxée
Non surtaxée
Usage porteur de la surtaxe
SMS-MT
Type de paliers tarifaires associés
2
Mode de facturation client
A l’acte
Abonnement
Inscription client pré-requise
Oui
Non
Offre soumise à reversement
Oui
Non
Identifiant échangé
MSISDN
Alias
Protocole utilisé
UCP
UCPo
3
SMS-MO
4
5
6
N/A
7
8
4.3.2 Description
L’offre « Light Gallery » s’adresse aux Editeurs proposant des services « Gallery » ou « MPME » et qui
souhaitent envoyer à leurs clients des SMS-MT permettant de les aider à accéder au service acheté, à
l’utiliser ou à faire de l’autopromotion.
Dans ce contexte, un client ne peut recevoir de SMS-MT :
-
que lorsqu’il en a fait la demande préalable auprès de l’Éditeur (en lui envoyant un SMS-MO) ;
-
que lorsqu’il a fait un achat effectué au travers du kit de paiement dans le cadre d’un Contrat « Gallery »
ou « MPME » ;
-
que lorsqu’il a préalablement consenti à recevoir des messages de prospection commerciale en
s’inscrivant au « Panel d’Optin ».
4.3.3 Cinématique
A la suite de la sollicitation du client, l’Éditeur peut émettre jusqu’à 2 SMS-MT non surtaxés. Cependant,
seule l’émission du premier SMS-MT dans un délai de 24 heures et au titre de la réponse due au client, est
obligatoire.
A l’issue d’un achat « Gallery » ou « MPME », une session de service d’une durée limitée (cf 8.4), est créée
par la Plate-forme SMS. Durant celle-ci l’Éditeur pourra envoyer au client au moins 1 SMS-MT non surtaxé.
En dehors de celle-ci, tous les SMS-MT non surtaxés adressés seront rejetés.
Tout nouvel achat effectué durant une session de service en cours de validité, réinitialise sa durée de vie.
Les échanges avec l’Editeur n’utilisent pas le numéro mobile du client (MSISDN) mais un identifiant (alias)
défini et associé de manière fixe par la Plate-forme SMS au couple « numéro court Editeur/MSISDN client ».
Dans ce contexte, les prochains échanges entre le client et l’Editeur utiliseront systématiquement l’identifiant
initialement défini.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
28
Client
Mobile
Plate-forme
SMS
Réseau
OF
Éditeur de
services
UCP 51
(MSISDN, short ID)
UCP 51 ACK
UCP 51
(MSISDN, short ID)
Client A
Achat de service
SMS MT
(MSISDN, Short ID
UCP 51 ACK
UCP 53
SMS MO
Client B
(MSISDN, Short ID)
Sollicitation Éditeur
UCP 53
UCP 52
(MSISDN, Short ID)
UCP 52 ACK
UCP 52
(MSISDN, Short ID)
UCP 52 ACK
UCP 51
(MSISDN, short ID)
UCP 51 ACK
UCP 51
(MSISDN, short ID)
SMS MT
(MSISDN, Short ID
UCP 51 ACK
UCP 53
UCP 53
UCP 51
(MSISDN, short ID)
UCP 51 ACK
UCP 51
(MSISDN, short ID)
Client C
Prospection
SMS MT
(MSISDN, Short ID
UCP 51 ACK
UCP 53
UCP 53
Session Service
Session Dialogue
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
29
5 Présentation des offres SMS+ surtaxées
5.1
Offre « Premium Express »
5.1.1 Principales caractéristiques
Type de cinématique
Push
Pull
Type d’offre
Surtaxée
Non surtaxée
Usage porteur de la surtaxe
SMS-MT
Type de paliers tarifaires associés
2
Mode de facturation client
A l’acte
Abonnement
Inscription client pré-requise
Oui
Non
Offre soumise à reversement
Oui
Non
Identifiant échangé
MSISDN
Alias
Protocole utilisé
UCP
UCPo
3
SMS-MO
4
5
6
N/A
7
8
5.1.2 Description
L’offre « Premium Express » s’adresse aux Editeurs qui proposent aux clients mobiles de participer à des
évènements diffusés sur de grands médias (vote, dédicace, sondage…) en envoyant un SMS-MO.
Dans ce cas, l’Editeur est tenu de répondre au client ayant participé à un évènement en lui envoyant un
SMS-MT de confirmation dans un délai de 24 heures.
5.1.3 Cinématique
Le premier SMS-MO émis par le client déclenche la création :
-
d’une transaction qui lui sera facturée ;
-
d’une session de service dont la durée de vie est limitée;
-
d’une session de dialogue qui reste ouverte jusqu’à ce que l’Editeur ordonne sa fermeture. A défaut, elle
est automatiquement clôturée par la Plate-forme SMS à l’issue d’une période de 60 jours.
Durant une session de service, le nombre de SMS-MO émis par un client et le nombre de SMS-MT
d’acquittement émis par l’Editeur ne sont pas limités. Dans ce contexte, chaque nouveau SMS-MO prolonge
d’autant la durée de vie de la session de service en cours de validité et déclenche une nouvelle facturation.
Les échanges avec l’Editeur n’utilisent pas le numéro mobile du client (MSISDN) mais un identifiant (alias)
défini et associé de manière fixe par la Plate-forme SMS au couple « numéro court Editeur/MSISDN client ».
Dans ce contexte, les prochains échanges entre le client et l’Editeur utiliseront systématiquement l’identifiant
initialement défini.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
30
Durant une session de dialogue, le nombre de SMS-MT émis par un Editeur, n’est pas limité non plus.
Cependant, ces messages ne sont pas porteurs d’informations relatives à la session de service existant en
parallèle.
Client
Mobile
Réseau
OF
SMS MO
Transaction
(MSISDN, Short ID)
Éditeur de
services
Plate-forme
SMS
UCP 52
(MSISDN, Short ID)
UCP 52 ACK
UCP 52
(Alias, Short ID)
UCP 52 ACK
UCP 51
(Alias, short ID)
UCP 51
(MSISDN, short ID)
UCP 51 ACK
UCP 51 ACK
SMS MT
(MSISDN, Short ID)
UCP 53
UCP 51 Dialogue
(MSISDN, short ID)
SMS MT Dialogue
(MSISDN, Short ID)
Transaction
SMS MO
(MSISDN, Short ID)
UCP 53
UCP 51 Dialogue
(Alias, short ID)
UCP 51 ACK
UCP 52
(MSISDN, Short ID)
UCP 52 ACK
UCP 52
(Alias, Short ID)
UCP 52 ACK
Session Service
…
Session Dialogue
5.2 Offre « Premium Tribu »
5.2.1 Principales caractéristiques
Type de cinématique
Push
Pull
Type d’offre
Surtaxée
Non surtaxée
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
31
Usage porteur de la surtaxe
SMS-MT
Type de paliers tarifaires associés
2
Mode de facturation client
A l’acte
Abonnement
Inscription client pré-requise
Oui
Non
Offre soumise à reversement
Oui
Non
Identifiant échangé
MSISDN
Alias
Protocole utilisé
UCP
UCPo
3
SMS-MO
4
5
6
N/A
7
8
5.2.2 Description
L’offre « Premium Tribu » s’adresse aux Editeurs qui proposent des services interpersonnels (Chat, Instant
Messaging…) à des communautés de clients qui s’y sont préalablement inscrits.
L’envoi d’un premier SMS-MO par un des membres de la communauté peut générer l’émission d’un SMSMT en direction d’autres membres de cette communauté sans aucune action de leur part.
L’Editeur n’est pas tenu de répondre à un membre ayant initié un échange avec d’autres membres de sa
communauté (en lui envoyant un SMS-MT d’acquittement par exemple). Dans ce cadre, les cinématiques
liées à l’émission d’un SMS-MO et à la réception d’un SMS-MT par un même membre sont à dissocier.
5.2.3 Cinématique
Le premier SMS-MO émis par le membre d’une communauté, déclenche la création :
-
d’une transaction qui lui sera facturée ;
-
d’une session de service dont la durée de vie est limitée et pendant laquelle les SMS-MT de réponse
émis par les autres membres lui seront envoyés par l’Editeur ;
-
d’une session de dialogue qui reste ouverte jusqu’à ce que l’Editeur ordonne sa fermeture. A défaut, elle
est automatiquement clôturée par la Plate-forme SMS à l’issue d’une période de 60 jours.
Durant une session de service, le nombre de SMS-MO émis par le membre et le nombre de SMS-MT de
réponses relayés par l’Editeur ne sont pas limités. Dans ce contexte, chaque nouveau SMS-MO prolonge
d’autant la durée de vie de la session de service en cours de validité et déclenche une nouvelle facturation.
Les échanges avec l’Editeur n’utilisent pas le numéro mobile du client (MSISDN) mais un identifiant (alias)
défini et associé de manière fixe par la Plate-forme SMS au couple « numéro court Editeur/MSISDN client ».
Dans ce contexte, les prochains échanges entre le client et l’Editeur utiliseront systématiquement l’identifiant
initialement défini.
Durant une session de dialogue, le nombre de SMS-MT émis par l’Editeur n’est pas limité non plus.
Cependant, ces messages ne sont pas porteurs d’informations relatives à la session de service existant en
parallèle.
Dans le cadre de cette cinématique, l’Editeur a la possibilité d’associer à son numéro de référence jusqu’à
10 numéros secondaires, reliés entre eux grâce à un identifiant commun. Sur le plan tarifaire, les échanges
utilisant les numéros secondaires sont facturés aux mêmes conditions que les échanges utilisant le numéro
de référence.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
32
Client
Mobile
Membre A
SMS MO
Transaction
(MSISDN, Short ID1)
Éditeur de
services
Plate-forme
SMS
Réseau
OF
UCP 52
(MSISDN, Short ID1)
UCP 52 ACK
UCP 52
(Alias, Short ID1)
UCP 52 ACK
UCP 51
(Alias, short ID2 )
UCP 51
(MSISDN, short ID2 )
Membre B
SMS MT
(MSISDN, Short ID2)
UCP 51 ACK
UCP 53
UCP 51 Dialogue
(MSISDN, short ID1)
Membre A
Membre B
SMS MT Dialogue
(MSISDN, Short ID1)
Transaction
SMS MO
(MSISDN, Short ID2)
UCP 51 ACK
UCP 53
UCP 51 Dialogue
(Alias, short ID1)
UCP 51 ACK
UCP 51 ACK
UCP 52
(MSISDN, Short ID2)
UCP 52 ACK
UCP 52
(Alias, Short ID2)
UCP 52 ACK
UCP 51
(Alias, short ID2 )
UCP 51
(MSISDN, short ID2 )
Membre A
SMS MT
(MSISDN, Short ID2)
UCP 51 ACK
UCP 51 ACK
UCP 53
UCP 53
Session Service
Session Dialogue
5.3 Offre « Premium Transaction »
5.3.1 Principales caractéristiques
Type de cinématique
Push
Pull
Type d’offre
Surtaxée
Non surtaxée
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
33
Usage porteur de la surtaxe
SMS-MT
Type de paliers tarifaires associés
2
Mode de facturation client
A l’acte
Abonnement
Inscription client pré-requise
Oui
Non
Offre soumise à reversement
Oui
Non
Identifiant échangé
MSISDN
Alias
Protocole utilisé
UCP
UCPo
3
SMS-MO
4
5
6
N/A
7
8
5.3.2 Description
L’offre « Premium Transaction » s’adresse aux Editeurs qui proposent des contenus (goodies, quizz, logos,
sonneries…) qui peuvent être commandés par un client en envoyant un SMS-MO puis réceptionnés sur son
terminal au travers d’un ou plusieurs SMS-MT.
5.3.3 Cinématique
La commande d’un contenu par un client va déclencher la création d’une session de service. Durant celle-ci,
l’Editeur va générer la transaction permettant de le facturer (dans un délai de 24 heures) et le ou les SMSMT permettant de lui délivrer le contenu acheté. La réception effective du contenu acheté par le client
déclenche la facturation puis clôture la transaction et la session de service associée.
En parallèle de cette session de service, une session de dialogue d’une durée maximale de 60 jours, est
créée. Durant cette période, l’Editeur peut envoyer au client des SMS-MT ne donnant lieu à aucune
facturation. Par contre, tout nouveau SMS-MO émis par un client émis durant une session de dialogue en
cours de validité, provoque la création d’une nouvelle transaction à facturer, d’une nouvelle session de
service et réinitialise la durée de vie de la session de dialogue.
A l’issue d’une session de dialogue, l’Editeur ne peut plus envoyer de SMS-MT à un client et est obligé
d’attendre que ce dernier commande à nouveau un contenu en envoyant un nouveau SMS-MO.
Les échanges avec l’Editeur n’utilisent pas le numéro mobile du client (MSISDN) mais un identifiant (alias)
défini et associé de manière fixe par la Plate-forme SMS au couple « numéro court Editeur/MSISDN client ».
Dans ce contexte, les prochains échanges entre le client et l’Editeur utiliseront systématiquement l’identifiant
initialement défini.
Les messages échangés entre le l’Editeur et la Plate-forme SMS utilisent le protocole UCPo et sont par
conséquent enrichis avec les attributs suivants :
-
« Session ID » qui est ajouté par la Plate-forme SMS dans le SMS-MO relayé à l’ l’Editeur et repris dans
tous les SMS-MT envoyés par ce dernier ;
-
« Code Action » qui est ajouté par l’Editeur dans tous les SMS-MT adressés à la Plate-forme SMS. Il
prend la valeur « 01 end » dans le cas des SMS-MT de livraison payants et la valeur « 00 nop » dans le
cas des SMS-MT de dialogue gratuits ;
-
« Nombre de messages » est ajouté par l’Éditeur dans tous les SMS-MT de livraison émis. La
transaction et la session de service ne sont clôturées que lorsque tous SMS-MT de livraison sont
acquittés positivement par la Plate-forme SMS ;
-
« Tac ID » qui est ajouté selon le cas par la Plate-forme SMS dans le SMS-MO relayés à l’Éditeur.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
34
Un Editeur peut gérer en parallèle plusieurs transactions pour le compte d’un même client. Dans ce cas,
chaque SMS-MO émis portera un identifiant de session (Session ID) différent. Lors de la reconnexion d’un
Éditeur à la Plate-forme SMS (suite à une coupure de service), ce dernier doit utiliser l’identifiant de session
figurant dans le dernier SMS-MO reçu.
Client
Mobile
SMS MO
(MSISDN, Short ID)
Éditeur de
services
Plate-forme
SMS
Réseau
OF
UCP 52
(MSISDN, Short ID)
UCP 52
(Session ID, Alias, Short ID, Tac ID)
UCP 52 ACK
UCP 52 ACK
UCP 51
(Session ID,Alias, short ID, Code Action “01”, Nb Msg = 3)
UCP 51 ACK
UCP 51
(MSISDN, short ID)
SMS MT
(MSISDN, Short ID)
UCP 51 ACK
UCP 53
UCP 53
UCP 51
(Session ID,Alias, short ID, Code Action “01”, Nb Msg = 3)
UCP 51 ACK
UCP 51
(MSISDN, Short ID)
SMS MT
(MSISDN, Short ID)
UCP 51 ACK
UCP 53
UCP 53
UCP 51
(Session ID,Alias, short ID, Code Action “00”)
UCP 51 ACK
UCP 51 Dialogue
(MSISDN, short ID)
SMS MT Dialogue
(MSISDN, Short ID)
UCP 51 ACK
UCP 51
(Session ID,Alias, short ID, Code Action “01”, Nb Msg = 3)
UCP 51 ACK
UCP 51
(Session ID, MSISDN, short ID, Code Action “01”, Nb Msg = 3)
UCP 51 ACK
Transaction
validée
SMS MT
(MSISDN, Short ID)
UCP 53
UCP 53
Session Service
Session Dialogue
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
35
5.4 Offre « Premium Push »
5.4.1 Principales caractéristiques
Type de cinématique
Push
Pull
Type d’offre
Surtaxée
Non surtaxée
Usage porteur de la surtaxe
SMS-MT
Type de paliers tarifaires associés
2
Mode de facturation client
A l’acte
Abonnement
Inscription client pré-requise
Oui
Non
Offre soumise à reversement
Oui
Non
Identifiant échangé
MSISDN
Alias
Protocole utilisé
UCP
UCPo
3
SMS-MO
4
5
6
N/A
7
8
5.4.2 Description
L’offre « Premium Push » s’adresse aux Editeurs qui proposent aux clients mobiles des abonnements à des
services ou des contenus qu’ils leurs délivrent régulièrement au travers de SMS-MT.
5.4.3 Cinématiques d’inscription
Pour bénéficier du service, le client doit obligatoirement être inscrit auprès de l’Éditeur. Cette inscription peut
être faite par le client :
-
en envoyant un SMS-MO incluant un mot clé prédéfini à un numéro court ;
-
en se rendant sur le site Gallery ou Internet Mobile de l’Éditeur et en renseignant la page d’inscription
mise à sa disposition par Orange France ;
-
en communiquant son numéro mobile (MSISDN) à l’Éditeur via l’environnement (site web, SVI, …) mis à
sa disposition par ce dernier.
5.4.3.1
Inscription du client via l’envoi d’un SMS-MO à l’Éditeur
Pour s’inscrire de cette manière, le client doit envoyer un SMS-MO incluant un mot clé prédéfini à l’Éditeur.
Durant cette inscription, les échanges avec l’Editeur n’utilisent pas le numéro mobile du client (MSISDN)
mais un identifiant (alias) défini et associé de manière fixe par la Plate-forme SMS au couple « numéro court
Editeur/MSISDN client ». Dans ce contexte, les prochains échanges entre le client et l’Editeur utiliseront
systématiquement l’identifiant initialement défini.
Le SMS-MO envoyé peut être enrichi par la Plate-forme SMS avant d’être relayé à l’Éditeur. Les
informations susceptibles d’être ajoutées sont les suivantes :
-
le « Tac ID » qui permet à l’Éditeur d’identifier la marque et le modèle du terminal mobile du client en
utilisant un fichier de correspondance mis à sa disposition par Orange France sur le site
www.OrangeKiosque.com ;
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
36
-
le type de client (prépayé ou post-payé) ;
-
le niveau d’accès autorisé (enfant, adolescent, adulte) ;
-
l’identifiant du MVNO chez lequel le client a souscrit son abonnement mobile, le cas échéant.
Le paramètre « Tac ID » figure systématiquement dans les SMS-MO d’inscription relayés à l’Éditeur alors
que les paramètres « type de client », « niveau d’accès » et « identifiant MVNO » figurent dans les SMSMO d’acceptation. Par contre, ces 3 derniers paramètres ne lui sont fournis que lorsque l’Éditeur a
préalablement souscrit à l’option payante permettant de les obtenir.
Dans le message UCP52 correspondant à chaque SMS-MO d’inscription ou d’acceptation transmis par la
Plate-forme SMS, ces paramètres sont codés dans le champ « HPLMN » dont la structure est détaillée cidessous :
Digit
Avec TAC
Sans
TAC
Longueur
Information
0à4
5
0
4 ou nulle
1
6
1
1
Autorisation accès
niveau de contenu
7 à 10
2
3
Identifiant MVNO
Identifiant
001
002
003
004
005
006
007
008
009
010
011
012
Tac ID
Post/Prépayé
Valeurs
0000 à 9999
0 – Post payé
1 – Prépayé
0 – Enfant (– 12 ans)
1 – Adolescent (– 16 ans)
2 – Statut inconnu
3 – Adulte
Cf. tableau ci-dessous.
Exemple
002401001
002401001
002401001
002401001
Nom MVNO
Orange France
Virgin Mobile
Télé2 Mobile
Breizh Mobile
MAO
Carrefour Mobile
Monaco Telecom
NRJ Mobile
Symacom Mobile
C le mobile
Bazile
LEO
A l’issue de l’envoi du SMS-MO d’inscription à l’Éditeur, la Plate-forme SMS va déclencher la création d’une
session de dialogue d’une durée maximale de 24 heures. Durant cette session, l’Éditeur pourra uniquement
envoyer des SMS-MT gratuits au client afin de l’aider à finaliser son inscription ou à personnaliser son
service.
A l’issue de la réception du SMS-MO d’inscription, l’Éditeur va adresser à la Plate-forme SMS une demande
de confirmation d’inscription que celle-ci va relayer au client au travers d’un SMS-MT préformaté. En
parallèle, la Plate-forme SMS va également créer une session de service au statut « En attente ».
Exemple : message de demande confirmation d’inscription préformaté adressé par la Plate-forme SMS au
client (message UCP51)
« Orange info: pour confirmer votre inscription au service Météo (0.20 E par SMS reçu), répondez OK à ce
SMS (prix d’un SMS) »
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
37
A l’issue de la réception de la confirmation, la Plate-forme SMS va passer la session de service du statut
« En attente » au statut « Actif » et va adresser au client et à l’Éditeur une notification de fin d’inscription.
Exemple : notification préformaté de fin d’inscription adressé par la Plate-forme SMS au client
« Orange info: votre inscription au service Météo est confirmée. A tout moment, vous pouvez vous
désinscrire en envoyant STOP au 58456 (prix d’un SMS) »
Si aucune confirmation n’est reçue à l’expiration de la session de dialogue (24 heures), la Plate-forme SMS
adresse un message d’erreur préformaté au client concerné.
Exemple : message de refus d’inscription préformaté adressé par la Plate-forme SMS au client
« Orange info: désolé mais votre délai pour répondre a expiré. Vous pouvez recommencer la procédure
d’inscription au service de votre choix »
Les messages UCPo échangés entre l’Éditeur et la Plate-forme SMS durant la phase d’inscription, sont
notamment enrichis avec les codes actions spécifiques suivants:
-
« 00 nop » au niveau des SMS-MT de dialogue émis par l’Éditeur afin qu’aucune facturation ne soit
déclenchée. Tout SMS-MT de dialogue utilisant un code action différent, sera rejeté par la Plate-forme
SMS ;
-
« 04 Subscribe » au niveau des SMS-MT de demande de confirmation d’inscription adressés par
l’Éditeur à la Plate-forme SMS.
Exemple : demande de confirmation d'inscription adressée par l’Éditeur à la Plate-forme SMS (message
UCP51) :
00/00086/O/51/312345678901/58456/04////////////////3//414243/////////////40
Et où :
- l'identifiant de client souhaitant s’inscrire est 312345678901
- le numéro court de l’éditeur est : 58456
- le code action renseigné est : 04
Exemple : notification de fin d’inscription (message UCP52) adressée par la Plate-forme SMS à l’Éditeur
00/00097/O/52/58456/312345678901////////////0000/200104120305////3//4F4B204F46///0/1//////0201F1///88
Et où :
- le numéro court de l’Éditeur est : 58456
- l’identifiant du client est 312345678901
- le texte utilisé est "OK OF" codé sous la forme 4F4B204F4
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
38
Client
Mobile
Éditeur de
services
Plate-forme
SMS
Réseau
OF
SMS MO
Inscription
(MSISDN, Short ID, Mot clé)
UCP 52
(MSISDN, Short ID,Mot Clé)
UCP 52
(Alias, Short ID, Mot clé, Tac Id)
UCP 52 ACK
UCP 52 ACK
UCP 51 Dialogue
(Alias, short ID,Code Action “00”)
UCP 51 ACK
UCP 51 Dialogue
(MSISDN, short ID)
UCP 51 ACK
SMS MT Dialogue
(MSISDN, Short ID)
Confirmation ?
UCP 51
Session service
(Alias, short ID, Code Action “04”)
En attente
UCP 51
(MSISDN, short ID)
SMS MT
(MSISDN, Short ID)
UCP 51 ACK
UCP 51 ACK
Acceptation
SMS MO
(MSISDN, Short ID, Mot clé)
Session service
Active
UCP 52
(MSISDN, Short ID, Mot Clé)
UCP 52 ACK
Validation inscription
SMS MT
(MSISDN, Short ID)
UCP 52
(Alias, Short ID, Mot Clé)
UCP 52 ACK
UCP 51
(MSISDN, short ID)
Validation inscription
UCP 52
(Alias, Short ID, Mot clé)
Session Dialogue
5.4.3.2
Inscription du client via Gallery / Internet Mobile
Pour utiliser ce mode d’inscription, le client doit au départ de son terminal mobile, se rendre sur le site
Gallery ou Internet Mobile de l’Éditeur proposant le service auquel il veut s’abonner. Après avoir pris
connaissance des conditions du service, le client accède à la page d’inscription d’Orange en sélectionnant le
lien dédié figurant au niveau de la page présentée. L’Éditeur doit publier sur son site le lien spécifique
d’Inscription vers la « servlet » de la Plate-forme SMS. Cette « servlet » utilise les paramètres figurant cidessous et supporte les méthodes GET et POST du protocole HTTP :
Paramètres
backUrl
shortCode
Définition
URL de retour vers l’éditeur de
services
Numéro court de l’éditeur de
services
Commentaires
Alphanumérique doit être de la forme
http://
Numérique sur 5 digits
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
39
Durant cette inscription, les échanges avec l’Editeur n’utilisent pas le numéro mobile du client (MSISDN)
mais un identifiant (alias) défini et associé de manière fixe par la Plate-forme SMS au couple « numéro court
Editeur/MSISDN client ». Dans ce contexte, les prochains échanges entre le client et l’Editeur utiliseront
systématiquement l’identifiant initialement défini.
Exemple : requête d’inscription adressée par l’Éditeur à la Plate-forme SMS
http://orange.w-ha.com/app-mtpregwml/node?shortCode=58456&backUrl=http://monmarchand.com/index.html?
Pour permettre aux clients dotés de terminaux mobiles récents (Iphone, Androïd…) de s’abonner à ses
services, l’Éditeur doit configurer une url d’inscription spécifique. Cette url doit obligatoirement utiliser
l’accroche au Proxy Orange suivante : « http://tp2.orange.fr »
Exemple : requête d’inscription propres aux clients dotés de smartphones (Iphone, Androïd…)
http://tp2.orange.fr/httppvc_clnssorange.w-ha.com/app-mtpregwml/node?shortCode=58456&backUrl=http://monmarchand.com/index.html?
Exemples : requêtes d’inscription utilisant la variable complémentaire usercode et adressée par l’Éditeur à
la Plate-forme SMS
http://orange.w-ha.com/app-mtpregwml/node?shortCode=58456&backUrl=http://monmarchand.com/index.html?usercode=1010
http://tp2.orange.fr/httppvc_clnssorange.w-ha.com/app-mtpregwml/node?shortCode=58456&backUrl=http://monmarchand.com/index.html?usercode=1010
En plus des paramètres « backUrl » et « ShortCode », l’Éditeur peut renseigner des variables
complémentaires lui permettant d’identifier plus facilement les clients qui ont déjà saisi leur profil. Dans ce
cas, les variables utilisées doivent être séparées par le caractère &" codé à l’aide de la valeur "%26".
http://orange.w-ha.com/app-mtpregwml/node?shortCode=58456&backUrl=http://monmarchand.com/index.html?usercode=1010%26param2=tot
o%26param3=123456
http://tp2.orange.fr/httppvc_clnssorange.w-ha.com/app-mtpregwml/node?shortCode=58456&backUrl=http://monmarchand.com/index.html?usercode=1010%26param2=tot
o%26param3=123456
A l’issue de la réception de la requête d’inscription, la Plate-forme SMS crée une session de service au
statut « En attente » et redirige le client vers une page pré-formatée l’invitant à confirmer son inscription.
Avant d’effectuer cette redirection, la Plate-forme SMS contrôle la validité du numéro court reçu en
paramètre et authentifie le client. Si un de ces contrôles échoue, une page d’erreur est retournée au client.
A l’issue de sa réponse (confirmation ou refus d’inscription), la Plate-forme SMS redirige le client vers
l’Éditeur en utilisant l’URL retour fournie par celui-ci. Parallèlement, elle informe l’Éditeur du choix fait par le
client en lui envoyant une URL incluant les 4 paramètres suivants :
Paramètres
acceptOffer
Définition
1 : l’Utilisateur a accepté de s’inscrire
0 : l’Utilisateur a annulé l’inscription
Commentaires
Numérique sur 1 digit
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
40
Paramètres
Définition
Identifiant de l’Utilisateur inscrit
Commentaires
Numérique. Ce champ est présent
uniquement dans le cas d’une acceptation
de l’offre
Code d'erreur renvoyé dans l'url de Numérique sur 1 digit. Ce champ est présent
retour.
uniquement dans le cas d’une annulation de
l’offre.
tacID : code numérique identifiant la Numérique sur 4 digits.
marque et le modèle du terminal
mobile d’un client
A partir de ce paramètre et en utilisant un
fichier de correspondance mis à sa
disposition
sur
le
site
www.OrangeKiosque.com , l’Éditeur peut
retrouver le modèle/marque du terminal
mobile de son client afin de connaître ses
caractéristiques
techniques (compatibilité
MMS, compatibilité MMS vidéo, compatibilité
SMS cliquable…)
alias
error
tac
Exemple : URL retournée par la Plate-forme SMS à un Éditeur à l’issue de l’inscription d’un client
http://monmarchand.com/index.wml?acceptOffer=1&alias=351233561591& tac=0026&
usercode=1010¶m2=tot
Page WAP de l ’ES :
Information sur le service
Premium Push
>>Inscription
Affichage d ’ une page
d ’erreur
de Orange France
<<Retour
NOK
Transmission paramètres :
code acceptation
( acceptOffer =0)
Page WAP de retour de
l’ES informant l’utilisateur
qu’il est inscrit
Vérification
de la
config .
de l ’ES
Transmission paramètres :
URL de Redirection vers la
page de retour de l ’ES ( BackUrl = http ://...)
N° court de l ’ES (58456)
OK
Paramètres :
code acceptation
( acceptOffer =0)
Page d ’Inscription
de Orange France
>>OK
NOK
Transmission paramètres :
code acceptation ( acceptOffer =0)
Affichage d ’ une page
d ’erreur
de Orange France
<<Retour
OK
NOK
Vérification
du
MSISDN
OK
Transmission paramètres :
code acceptation ( acceptOffer =1)
identifiant (312345678901)
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
41
La Plate-forme SMS confirme également à l’Éditeur l’inscription de son client en lui envoyant un message de
type UCP52.
Exemple : confirmation d’inscription adressée par la Plate-forme SMS à l’Éditeur (message UCP52)
00/00121/O/52/58456/351233561591////////////0000/200104120305////3//57454220524547495354524154494F
4E///0/1//////0201F1///68
Et où :
- le numéro court de l'Éditeur est : 58456
- l'identifiant du client est = 351233561591
- le mot clé est "WEB REGISTRATION" codé sous la forme 57454220524547495354524154494F4E
Remarque :
Les paramètres « type de client », « niveau d’accès » et « identifiant MVNO » figurent dans la
confirmation d’inscription adressée à l’Éditeur lorsque celui-ci a préalablement souscrit à l’option payante
permettant de les obtenir.
L’Éditeur doit acquitter ce message dans les 24 heures qui suivent sa réception. Si à l’expiration de ce délai,
le message n’est pas acquitté positivement, la Plate-forme SMS adresse au client SMS-MT préformaté de
refus d’inscription.
Exemple : message préformaté de refus d’inscription adressé par la Plate-forme SMS au client
« Orange info (SM gratuit) : Votre inscription au service Météo a échoué (service d’inscription de Météo
indisponible). Merci de vous réinscrire ultérieurement »
Si le message est acquitté positivement, la Plate-forme SMS passe la session de service du statut « En
attente » au statut « Actif ». Aucun SMS de confirmation n’est adressé au client.
5.4.3.3
Inscription sur MSISDN
L’utilisation de ce mode d’inscription par l’Éditeur suppose que le client ait saisi préalablement son numéro
mobile (MSISDN) dans l’environnement (site web, SVI…) mis à sa disposition par ce dernier. L’Éditeur utilise
alors ce MSISDN pour transmettre à la Plate-forme SMS une demande de confirmation d’inscription qu’elle
va à son tour relayer ensuite au client
Dans ce cas, les échanges avec l’Éditeur sont dits « démasqués » puisqu’ils utilisent le numéro mobile du
client (MSISDN) et non un identifiant (Alias). Ils s’appuient sur l’utilisation de SMS-MT notamment enrichis
avec le code action « 04 Subscribe ».
Exemple : demande de confirmation d'inscription adressée par l’Éditeur à la Plate-forme SMS :
00/00086/O/51/0612345678/58456/04////////////////3//414243/////////////40
Et où :
- le MSISDN du prospect est : 0612345678.
- le numéro court de l’Éditeur est : 58456
- le code action renseigné est : 04
A l’issue de la réception de cette demande d’inscription, la Plate-forme SMS va créer une session de service
au statut « En attente » et va transmettre au prospect un SMS-MT préformaté
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
42
Exemple : message préformaté de demande de confirmation d’inscription adressée par la Plate-forme SMS
au prospect
« Orange info: pour confirmer votre inscription au service Météo (0.20 E par SMS reçu), répondez OK à ce
SMS (prix d’un SMS) »
A l’issue de cet envoi, le prospect a 24 heures pour accepter de souscrire au service proposé. Si aucune
confirmation n’est retournée ou si celle-ci intervient après l’expiration du délai de 24 heures, la Plate-forme
SMS adresse au client un SMS-MT de refus d’inscription préformaté
Exemple : message préformaté de refus d’inscription adressée par la Plate-forme SMS au prospect
« Orange info: désolé mais votre délai pour répondre a expiré. Vous pouvez recommencer la procédure
d’inscription au service de votre choix ».
Au contraire, si le prospect confirme son inscription avant l’expiration du délai de 24 heures, un SMS-MT de
validation préformaté lui est envoyé et la Plate-forme SMS passe la session de service associée du statut
"En attente" au statut "Actif".
Exemple : message préformaté de validation d’inscription adressée par la Plate-forme SMS au prospect
« Orange info: votre inscription au service Météo est confirmée. A tout moment, vous pouvez vous
désinscrire en envoyant STOP au 58456 (prix d ’un SMS) »
La Plate-forme SMS confirme également à l’Éditeur l’inscription de son client en lui envoyant un message de
type UCP52.
Exemple : confirmation d’inscription adressée par la Plate-forme SMS à l’Éditeur (message UCP52)
00/00097/O/52/58456/0612345678////////////0000/200104120305////3//4F4B204F46///0/1//////0201F1///88
Et où :
- le numéro court de l’éditeur est : 58456
- le MSISDN du prospect est : 0612345678
-
le mot clé utilisé est "OK OF" codé sous la forme 4F4B204F46
Remarque :
Les paramètres « type de client », « niveau d’accès » et « identifiant MVNO » figurent dans la
confirmation d’inscription adressée à l’Éditeur lorsque celui-ci a préalablement souscrit à l’option payante
permettant de les obtenir.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
43
Client
Mobile
Éditeur de
services
Plate-forme
SMS
Réseau
OF
UCP 51
(MSISDN, Short ID, Code Action “04”))
Session service
UCP 51 ACK
En attente
Confirmation ?
UCP 51
(MSISDN, Short ID,Mot Clé)
UCP 51 ACK
SMS MT
(MSISDN, Short ID, Mot clé)
Validation
SMS MO
(MSISDN, Short ID, Mot clé)
UCP 52
(MSISDN, Short ID, Mot Clé)
UCP 52 ACK
Session service
Active
UCP 52
(Alias, Short ID, Mot Clé)
UCP 52 ACK
Notification inscription
UCP 51
SMS MT
UCP 52
(MSISDN, short ID)
Notification inscription (Alias, Short ID, Mot clé)
(MSISDN, Short ID)
Session Dialogue
5.4.4 Cinématiques de résiliation
Pour résilier son abonnement, le client peut s’adresser directement à l’Éditeur qui lui fournit le service ou à
défaut s’adresser à Orange France.
Dans le cas des services souscrits en envoyant un SMS-MO à l’Éditeur ou en s’inscrivant sur sont site
Gallery/Internet mobile, les échanges liés à la résiliation utilisent l’identifiant du client (alias).
5.4.4.1.1
Résiliation de l’abonnement adressée à l’Éditeur
Pour résilier son abonnement de cette manière, le client doit envoyer un SMS-MO contenant le mot clé
« STOP » au numéro court de l’Éditeur
Exemple : demande de résiliation adressée par un client à un Éditeur (message UCP52)
00/00097/O/52/58456/312345678901////////////0000/200104120305////3//53544F50///0/1//////0201F1///88
Et où
- le numéro court de l’Éditeur est : 58456
- l’identifiant du client est : 312345678901
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
44
- le mot clé "STOP" est codé sous la forme : 53544F50
A l’issue de la réception de ce message, l’Éditeur doit confirmer au client la prise en compte de sa demande
de résiliation en lui envoyant un SMS-MT préformaté gratuit.
Parallèlement, l’Éditeur doit prévenir la Plate-forme SMS de la résiliation du client en lui envoyant un
message de type UCP51 dont la réception clôturera les sessions de service et de dialogue en cours. Dans le
cas de la session de service, son statut passera d’« Actif » à « Terminé ».
Les messages UCPo échangés entre l’Éditeur et la Plate-forme de services durant la phase de résiliation
sont notamment enrichis avec des codes actions spécifiques suivants :
-
« 00 nop » au niveau du SMS-MT de confirmation de résiliation adressé par l’Éditeur au client ;
-
« 05 Unsubscribe » au niveau du SMS-MT de demande de clôture de sessions adressé par l’Éditeur à la
Plate-forme SMS.
Exemple : demande de clôture de session adressée par l’Éditeur à la Plate-forme SMS
00/00086/O/51/312345678901/58456/05////////////////3//414243/////////////40
Et où :
- le numéro court de l’Éditeur est : 58456
- l’identifiant du client est : 312345678901
Remarques :
Lorsqu’un SMS-MO de résiliation est envoyé à un Éditeur utilisant également des numéros secondaires, la
demande de clôture adressée à la Plate-forme SMS doit porter sur le numéro de référence et les numéros
secondaires où des sessions sont potentiellement actives.
Lorsqu’un SMS-MO de résiliation est envoyé au numéro secondaire d’un Éditeur, la demande de clôture
adressée à la Plate-forme SMS, doit être gérée de la même manière qu’une résiliation adressée à son
numéro de référence
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
45
Client
Mobile
Plate-forme
SMS
Réseau
OF
SMS MO
Résiliation
(MSISDN, Short ID, Mot clé)
Éditeur de
services
UCP 52
(MSISDN, Short ID,Mot Clé)
UCP 52
(Alias, Short ID, Mot clé)
UCP 52 ACK
UCP 52 ACK
UCP 51
(Alias, short ID, Code Action “00”)
Confirmation ?
UCP 51
(MSISDN, short ID)
SMS MT
(MSISDN, Short ID)
SMS MO
Confirmation
(MSISDN, Short ID, Mot clé)
UCP 51 ACK
UCP 51 ACK
UCP 52
(MSISDN, Short ID,Mot Clé)
UCP 52
(Alias, Short ID, Mot clé)
UCP 52 ACK
UCP 52 ACK
UCP 51
Clôture des sessions (Alias, short ID, Code Action “05”)
(Dialogue + Service)
UCP 51 ACK
5.4.4.1.2
Résiliation de l’abonnement adressée à Orange France
Pour résilier son abonnement de cette manière, le client doit envoyer un SMS-MO contenant le mot clé
« STOP » et le « numéro court de référence de l’Éditeur » à un numéro court d’Orange France issu des
tranches « 29000 » à « 29010 ».
Ce SMS-MO de résiliation se traduira par l’envoi d’un message de type UCP52 à la Plate-forme SMS qui
déclenchera la clôture immédiate des sessions de service et de dialogue en cours. Dans le cas de la session
de service, son statut passera d’ « Actif » à « Terminé ».
A l’issue de cette clôture, la Plate-forme SMS doit informer l’Éditeur de la résiliation de son client en lui
envoyant un message de type UCP52 incluant le texte « STOP OF ».
Exemple : demande de résiliation adressée par la Plate-forme SMS à l’Éditeur
00/00109/O/52/58456/312345678901////////////0000/200104120305////3//53544F50204F46///0/1////0201F1///F0
Et où
- le numéro court de l’Éditeur est 58456
- l’identifiant du client est 312345678901
- le texte "STOP OF" est codé : 53544F50204F46
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
46
Parallèlement, la Plate-forme SMS va confirmer au client sa résiliation en lui envoyant un message
préformaté.
Remarque
Lorsqu’un client envoie un SMS-MO de résiliation à Orange France sans indiquer le numéro court de
l’Éditeur concerné, la Plate-forme SMS lui renverra un SMS-MT indiquant la procédure à suivre pour se
désinscrire correctement (« Pour vous désinscrire, envoyer STOP au N° Court de l’Éditeur de service »).
Client
Mobile
Plate-forme
SMS
Réseau
OF
SMS MO
Résiliation
(MSISDN, Short ID, Mot clé)
UCP 52
(MSISDN, Short ID,Mot Clé)
UCP 52 ACK
Éditeur de
services
Clôture des sessions
(Dialogue + Service)
UCP 52
(Alias, Short ID, Mot clé)
UCP 52 ACK
Confirmation
SMS MT
(MSISDN, Short ID)
UCP 51
(MSISDN, short ID)
UCP 51 ACK
5.4.5 Cinématique de facturation et de livraison
L’Éditeur délivre et facture les services et contenus souscrits par les abonnés au travers de SMS-MT
envoyés périodiquement par l’intermédiaire de la Plate-forme SMS.
Ces messages se distinguent de ceux échangés lors des phases d’inscription/résiliation par la valeur du
paramètre « Code Action » qu’ils véhiculent. Dans le cas de SMS-MT payants, ce paramètre n’est jamais
renseigné alors qu’il prend la valeur « 00 » dans le cas des SMS-MT de dialogue, « 04 » dans le cas des
SMS-MT d’inscription » et « 05 » dans le cas des SMS-MT de résiliation.
Exemple : SMS-MT payant où le paramètre « Code Action » n’est pas renseigné
00/00086/O/51/312345678901/58456/////////////////3//414243/////////////40
Exemple : SMS-MT de dialogue gratuit utilisant le paramètre code Action prend la valeur « 00 »
00/00086/O/51/312345678901/58456/00////////////////3//414243/////////////40
A l’issue de l’émission d’un SMS-MT payant par l’Éditeur, les traitements suivants sont effectués :
1.
la Plate-forme SMS remplace au niveau du message, l’identifiant du client (alias) renseigné par l’Éditeur
par le MSISDN associé ;
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
47
2.
la Plate-forme SMS vérifie que le client est effectivement inscrit et qu’une session de service active
existe. Si aucune session de service n’existe ou si celle-ci existe mais a un statut différent (« En
attente », « Suspendue » « Invalide »), le SMS-MT est rejeté et un acquittement négatif est retourné à
l’Éditeur ;
3.
la Plate-forme SMS vérifie que pour la période en cours, les différents quotas gérés (nombre SMS-MT
payants envoyés, nombre d’acquittements ou autorisations négatifs…) ne sont pas dépassés. Dans le
cas contraire, le SMS-MT est rejeté et un acquittement négatif est retourné à l’Éditeur ;
4.
la Plate-forme SMS acquitte positivement le SMS-MT émis par l’Éditeur et incrémente les compteurs
relatifs au nombre de messages envoyés et au montant de la consommation courante du client ;
5.
la Plate-forme SMS recherche le compte du client. Si ce compte n’existe pas, elle procède à sa
création. Si la création du compte échoue, le SMS-MT est rejeté et une notification de traitement
négative (message UCP53) est retournée à l’Éditeur si ce dernier l’a demandée. Si le compte trouvé est
de type prépayé, la Plate-forme SMS vérifie que son solde couvre le coût du service et débite celui-ci
de son montant. Si le solde du client prépayé est insuffisant, le SMS-MT est supprimé et une notification
de traitement négative (message UCP53) précisant que le solde du client est insuffisant, est retourné à
l’Éditeur si ce dernier l’a demandée
6.
la Plate-forme SMS modifie la valeur du champ « NRq » inclus dans la SMS-MT reçu afin qu’une
notification de livraison (message UCP53) soit systématiquement renvoyée à l’Éditeur même si celui-ci
ne l’a pas explicitement demandée ;
7.
la Plate-forme SMS relaie le SMS-MT au réseau d’Orange France afin qu’il soit délivré au client ;
8.
sur la base de l’acquittement positif remonté par le réseau (message UCP51 Ack), la Plate-forme SMS
crée une transaction à l’état « non confirmé » et met à jour les données relatives à la consommation
globale mensuelle du client. Si le réseau renvoie un acquittement négatif, la Plate-forme SMS
décrémente les différents compteurs précédemment incrémentés et notifie à l’Éditeur l’échec de la
remise de son SMS-MT (message UCP53). Si l’échec concerne un client prépayé, la Plate-forme SMS
recrédite en plus son compte du montant de la transaction ;
9.
sur la base des données relatives à la consommation du client, la Plate-forme SMS vérifie que le seuil
d’alerte bloquant paramétré pour le service rendu par l’Éditeur n’est pas atteint. Si celui-ci est atteint, le
statut de la session de service est modifié pour passer de l’état « Actif » à l’état « Suspendu » et un
SMS-MT d’alerte est envoyé au client ;
10. sur la base de la notification de livraison (message UCP53) remontée par le réseau, la Plate-forme
SMS passe la transaction créée de l’état « Non confirmée » à « Confirmée ». Dans le cas d’un client
post-payé, la Plate-forme SMS déclenche en plus sa facturation. Si le réseau renvoie un acquittement
négatif, la Plate-forme SMS décrémente les différents compteurs précédemment mis à jour. Si l’échec
concerne un client prépayé, la Plate-forme SMS recrédite en plus son compte du montant de la
transaction ;
11. la Plate-forme MS transmet à l’Éditeur la notification de livraison (positive ou négative) de son SMSMT.
Exemple : notification de livraison (message UCP53) relative à un SMS-MT émis par un Éditeur
03/00146/O/53/68000/312345678901///////////171105142321/2/104//3//534D532072656D6973206175203036
3132333435363738206C652031372E31312E303520612031342E32332E3232/////////////75
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
48
Champ AdC = 68000 (numéro court de l’Éditeur)
Champ OAdC = 312345678901 (Identifiant du client)
Champ SCTS = 171105142321 (Time Stamp)
Champ DSCTS = vide
Champ Dst = 2 (Delivery Status 0 = délivré, 2 = non-délivré)
Champ Rsn = 104 (code erreur)
Champ AMsg (texte) = Texte informatif en cas de non remise (exemple : « SMS non remis au
destinataire : compte épuisé »)
Client
Mobile
Réseau
OF
Éditeur de
services
Plate-forme
SMS
UCP 51
(Alias, Short ID, Code Action “”)
Remplacement de l’Alias
Session de servie active ?
Dépassement des quotas ?
UCP 51 ACK
Recherche du compte
Débit du compte (si client prépayé)
MàJ du paramètre « Nrq » (UCP53)
UCP 51
(MSISDN, Short ID,Mot Clé)
UCP 51 ACK
Création de la transaction
MàJ de la consommation
SMS MT
(MSISDN, Short ID, Mot clé)
Atteinte du seuil d’alerte bloquante ?
UCP 53
Confirmation de la transaction
Facturation (si client post-payé)
UCP 53
Session Dialogue
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
49
5.4.6 Gestion des alertes
Pour chaque numéro court souscrit par un client, la Plate-forme SMS gère un compteur de consommation
qu’elle incrémente à la suite de chaque envoi de SMS-MT payants par un Éditeur et qu’elle réinitialise tous
les 31 jours.
Ce compteur permet également à la Plate-forme SMS gérer 3 types d’alertes qui prennent la forme de SMSMT préformatés qu’elle émet en utilisant un numéro court issu des tranches « 29000 » à « 29010 ».
5.4.6.1
Alerte informative à l’issue de la réinitialisation du compteur de consommation
A l’issue de la réinitialisation du compteur de consommation (tous les 31 jours), la Plate-forme SMS génère
systématiquement une alerte informative visant à rappeler au client les abonnements qu’il a souscrit.
Exemple : alerte informative suite à la réinitialisation du compteur de consommation d’un client
« Orange Info: vous êtes abonné(e) au service Météo. Désabonnement : envoyer STOP au 58456. +d’infos,
rubrique Mon compte du portail Orange »
La génération de cette alerte ne modifie pas le statut de la session de service (qui reste au statut « Actif »).
5.4.6.2
Alerte informative suite au dépassement d’un seuil de consommation
A la suite du dépassement d’un premier seuil de consommation paramétrable (en euros) et surveillé sur 31
jours glissants, la Plate-forme SMS peut générer une alerte informative visant à prévenir le client qu’il est
toujours abonné.
Exemple : alerte informative suite au dépassement d’un premier seuil de consommation
« Orange Info Conso: depuis le 26/03 vous avez reçu 4 SMS à 1,50 E du service Météo Rappel: pour vous
désinscrire, envoyez STOP au 58456 »
La génération de cette alerte ne modifie pas le statut de la session de service (qui reste au statut « Actif »).
Remarque
L’alerte informative sur dépassement de seuil n’est pas utilisée actuellement mais Orange France se réserve
le droit d’y recourir à nouveau.
5.4.6.3
Alerte bloquante suite au dépassement d’un seuil de consommation
A la suite du dépassement d’un second seuil de consommation paramétrable (en euros) et surveillé sur 31
jours glissants, la Plate-forme SMS génère une alerte bloquante visant à interdire à l’Éditeur l’envoi de
nouveaux SMS-MT payants.
Exemple : alerte bloquante suite au dépassement d’un second seuil de consommation
« ORANGE : depuis le 26/03 vous avez reçu 8 SMS à 1,50 Euro du 58456. Répondez RENOUV à ce SMS
pour continuer ce service »
A l’issue de cette alerte, la Plate-forme SMS suspend la session de service du client. Durant cette
suspension l’Éditeur pourra uniquement envoyer des SMS-MT de dialogue gratuits.
Remarque
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
50
Le seuil déclenchant la génération de cette alerte bloquante, est actuellement de 12 € TTC.
5.4.7 Cinématique de levée de suspension
Si en dépit de la suspension le client souhaite continuer à consommer, ce dernier doit explicitement
demander sa levée en envoyant à l’Éditeur un SMS-MO incluant un mot clé spécifique (exemple
« RENOUV ») dans un délai de 72 heures (non paramétrable).
A la réception du SMS-MO demandant la levée de suspension, la Plate-forme SMS va réinitialiser le
compteur de consommation du client et rendre sa session de service à nouveau active.
Exemple : demande de levée de suspension adressée par un client à un Éditeur (message UCP52)
00/00097/O/52/58456/312345678901////////////0000/200104120305////3//52454E4F5556204F46///0/1//////0201F1
///88
Et où
- le numéro court de l’Éditeur est : 58456
- l’identifiant du client est : 312345678901
- le mot clé transmis à l’Éditeur est "RENOUV OF" codé sous la forme 52454E4F5556204F46
Si à l’expiration du délai de 72 heures, le client n’a adressé aucune demande de levée de suspension la
Plate-forme SMS conserve sa session de service à l’état « Suspendue » pendant 31 jours. A l’issue de ce
délai, la Plate-forme SMS supprime définitivement la session de service du client.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
51
Client
Mobile
Réseau
OF
Éditeur de
services
Plate-forme
SMS
Session service
Active
UCP 51
(Alias, Short ID, Code Action “”)
Seuil d’alerte bloquante atteint
Session service
Suspendue
UCP 51 NACK
UCP 51
(MSISDN, Short ID,Alerte)
SMS MT
(MSISDN, Short ID, Alerte)
UCP 51
(Alias, Short ID, Code Action “”)
UCP 51 ACK
UCP 51 NACK
UCP 51 Dialogue
(Alias, short ID,Code Action “00”)
UCP 51 Dialogue
(MSISDN, short ID)
SMS MT Dialogue
(MSISDN, Short ID)
SMS MO
(MSISDN, Short ID, Mot clé)
Renouvellement
72
heures
UCP 51 ACK
UCP 51 ACK
UCP 52
(MSISDN, Short ID, Mot clé)
Session service
Active
UCP 51 ACK
UCP 52
(Alias, Short ID, Mot clé)
UCP 52 ACK
Session Dialogue
5.4.8 Codes erreurs spécifiques
Le tableau ci-dessous liste les codes erreurs spécifiques à l’offre « Premium Push » susceptibles d’être
retournés à l’Éditeur (message UCP51 Nack)
N°
1
2
Description
Réponse de la Plate-forme SMS
Réception d'un UCP51 de dialogue envoyé
hors d'une session de dialogue
Réception d'un UCP51 durant une session
de service "en attente"
UCP51 Nack
Error Code = 04
Operation Not Allowed
System message = "Session de dialogue expirée"
UCP51 Nack
Error Code = 04
Operation Not Allowed
System message = "Session en attente"
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
52
N°
Description
3
Réception d'un UCP51 en provenance d'un
Éditeur ayant dépassé son quota de SMSMT vers un abonné
4
Réception d'un UCP51 pour un Utilisateur
ayant atteint le seuil de consommation
bloquant
Réponse de la Plate-forme SMS
UCP51 Nack
Error Code = 04
Operation Not Allowed
System message = "Quota de SMS-MT dépassé pour la période
en cours"
UCP51 Nack
Error Code = 04
Operation Not Allowed
System message = "Seuil de consommation atteint"
Le tableau ci-dessous liste les motifs de refus de livraison spécifiques à l’offre « Premium Push »
susceptibles d’être retournés à l’Éditeur (message UCP53)
N°
Valeur
possible
Désignation
1
104
Operation barred
2
108
Delivery fail
3
209
4
211
5
210
Raison possible
Crédit insuffisant :
Lorsqu'un SMS MT payant est envoyé à un utilisateur prépayé qui
n'a pas suffisamment de crédit. Le message n'est pas transmis
vers l'Utilisateur
Message non délivré :
Lorsqu'un SMS MT est émis vers un Utilisateur. Si le message ne
peut pas être transmis vers l'Utilisateur (dépassement de débit,
problème réseau ...).
Not delivered : MVNO
Filtrage MVNO : Le service est inaccessible pour ce MSISDN.
Not delivered : Adult
(Blocked)
Not delivered : Adult
(Refused)
Filtrage contenu : Le service est inaccessible pour ce MSISDN
mais il a la possibilité de souscrire à l’option « adulte »
Filtrage contenu : Le service est inaccessible pour ce MSISDN et
il n’a pas la possibilité de souscrire à l’option « adulte »
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
53
6 Synchronisation des bases
Cette nouvelle fonctionnalité fournie aux Éditeurs ayant souscrit à l’offre « Premium Push » leur permet de
mettre à jour leur base clients totalement ou partiellement quand ils le souhaitent.
Pour accéder à cette fonctionnalité, l’Éditeur « Premium Push » peut utiliser une connexion « SOAP/http »
ou passer par l’outil MSCA (Merchant Self Care Application).
6.1 Interface SOAP/http
Cette interface permet à l’Éditeur « Premium Push » de mettre à jour sa base clients en émettant des
requêtes automatisées de type « serveur à serveur ». Pour pouvoir utiliser cette interface, l’Éditeur
« Premium Push » doit en faire la demande à Orange France.
6.1.1 Caractéristiques techniques
Les principales caractéristiques techniques de cette interface sont les suivantes :
-
le protocole d’échange utilisé est le « SOAP 1.2 » en mode message ;
-
les messages échangés s’appuient sur l’émission d’une requête (« REQ ») qui doit toujours être
acquittée par un message de réponse (« RES ») ;
-
ces échanges utilisent un identifiant (« requestID ») qui doit être présent dans chaque requête émise
(« REQ ») et rappelé dans chaque réponse (« RES ») ;
-
le protocole « HTTP » assure le transport de ces messages ;
-
ces échanges sous forme de « question /réponse » peuvent porter sur plusieurs éléments de même
nature. Cependant, le nombre d’’éléments contenus dans la réponse (« RES ») peut être différent du
nombre d’éléments contenus dans la requête associée (« REQ »).
6.1.2 Principaux échanges
Pour pouvoir utiliser l’interface, l’Éditeur « Premium Push » doit s’authentifier en renseignant le « user » et le
« mot de passe » préalablement fournis par Orange France.
A l’issue de cette authentification, une session est ouverte et un identifiant de session lui est retourné
(« SessionID »).
L’Éditeur « Premium Push » devra rappeler cet identifiant de session dans les différentes requêtes qu’il
adressera. En cas d’inactivité prolongée, la session est interrompue au bout d’une période donnée. Cette
session peut également être fermée à l’initiative du client.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
54
Orange
Plate-forme
France
SMS
Éditeur
Authentification (Request)
Identifiant de session (Response)
Ordre d’administration (Request)
Session
Résultat (Response)
Fermeture de session (Request)
(Response)
Orange
France
Éditeur
6.1.3 Formats spéciaux
6.1.3.1
Dates
Le format des dates échangées doit utiliser le format suivant : « YYYY-MM-DDThh:mm:ss.sss+hh:mm »
YYYY
MM
DD
T
hh:mm:ss
sss
+hh:mm
6.1.3.2
Année
Mois
Jour
Séparateur fixe entre la date et l’heure
Heure (sur 24 heures), minutes, secondes
Millisecondes
Fuseau horaire
Msisdn – si les échanges avec l’Éditeur sont faits en mode « démasqué »
Pour être validé, le numéro mobile du client (MSISDN) fourni par l’Éditeur « Premium Push » dans ses
requêtes, (« REQ »)doit disposer de l’un des formats suivants :
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
55
Format
International long
International court
National
Longueur
13
11
10
Type
Numérique
Numérique
Numérique
Contraintes
Doit commencer par 00
Doit commencer par 0
Le numéro mobile d’un client (MSISDN) présent dans les réponses (« RES ») faites à l’Éditeur « Premium
Push », est toujours au format international court (ex :33601020304).
Identifiant client (Alias) - si les échanges avec l’Éditeur utilisent un identifiant (alias)
6.1.3.3
Pour être validé, l’identifiant du client (Alias) fourni par l’Éditeur « Premium Push » dans ses requêtes
(« REQ »), doit être composé de 12 à 15 chiffres.
6.1.4 Détails des messages échangés
6.1.4.1
Ouverture de session
6.1.4.1.1
Structure de la requête (REQ)
Élément
Niveau
xml
env:Envelope
env:Header
requestId
Env:Body
xmsService
object
1
2
3
4
3
4
action
method
5
user
passwd
6
6
5
6
Description
Type
Valeur
Document XML
Message SOAP
Entête SOAP
Obligatoire ?
Dans ce contexte, toujours Alpha.
égal à « session »
session
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Dans ce contexte, toujours Alpha.
égal à « create »
Utilisateur
Alpha.
Mot de passe
Alpha.
create
Oui
Oui
Num.
Oui
Oui
Exemple :
<env:Header>
<requestId>1234158</requestId>
</env:Header>
<env:Body>
<xmsService>
<object>session</object>
<action>
<method>create</method>
<user>utilisateur</user>
<passwd>motdepasse</passwd>
</action>
</xmsService>
</env:Body>
</env:Envelope>
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
56
6.1.4.1.2
Structure de la réponse (RES)
Élément
Description
Niveau
xml
env:Envelope
env:Header
requestId
sessionId
1
2
3
4
Env:Body
xmsService
object
3
4
result
sessionId
5
Valeur
Document XML
Message SOAP
Entête SOAP
Numéro
courante
4
de
Obligatoire ?
Oui
Oui
Oui
Oui
Num.
session Num.
Dans ce contexte, toujours Alpha.
égale à « session »
5
session
Oui
Oui
Oui
Oui
6
roleId
logLevel
shortClientResponseT
imeout
longClientResponseTi
meout
Type
6
6
6
6
Numéro de session attribué
à reprendre dans tous les
échanges suivants
Zone réservée
Zone réservée
Zone réservée
Num.
Num.
Num.
Num.
Oui
Oui
Oui
Zone réservée
Num.
Oui
Exemple :
<env:Header>
<requestId>1234158</requestId>
<sessionId>301870</sessionId>
</env:Header>
<env:Body>
<xmsService>
<object>session</object>
<result>
<sessionId>301870</sessionId>
<roleId>2</roleId>
<logLevel>5</logLevel>
<shortClientResponseTimeout>8000</shortClientResponseTimeout>
<longClientResponseTimeout>120000</longClientResponseTimeout>
</result>
</xmsService>
</env:Body>
</env:Envelope>
6.1.4.2
Fermeture de session
6.1.4.2.1
Structure de la requête (REQ)
Élément
xml
env:Envelope
env:Header
Niveau
1
2
3
Description
Type
Valeur
Document XML
Message SOAP
Entête SOAP
Obligatoire ?
Oui
Oui
Oui
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
57
requestId
sessionId
4
Env:Body
xmsService
object
3
4
4
5
action
method
Numéro
courante
de
session
Num.
Num.
Oui
Dans
ce
contexte,
toujours
égale
à
« session »
Alpha.
sessio
n
Dans
ce
contexte,
toujours égale à « stop »
Alpha.
stop
5
6
Oui
Oui
Oui
Oui
Oui
Exemple :
<env:Header>
<requestId>3</requestId>
<sessionId>301870</sessionId>
</env:Header>
<env:Body>
<xmsService>
<object>session</object>
<action>
<method>stop</method>
</action>
</xmsService>
</env:Body>
</env:Envelope>
6.1.4.2.2
Structure de la Réponse (RES)
La structure de la réponse à une requête de fermeture de session est identique à la réponse à une requête
d’ouverture de session.
6.1.4.3
6.1.4.3.1
État des sessions « Premium Push »
Structure de la requête (REQ)
Élément
Niveau
xml
Env:Envelope
Env:Header
requestId
Env:Body
xmsService
1
2
3
4
3
action
method
5
4
6
object
5
Description
Type
Répété
Valeur
Document XML
Message SOAP
Entête SOAP
Oui
Oui
Oui
Oui
Oui
Oui
Num.
Demande d’informations
– Élément « Request »
Dans
ce
contexte, Alpha.
toujours égale à « get »
Dans
ce
contexte, Alpha.
toujours
égale
à
« pushSession »
Obligatoire ?
Get
pushSessi
on
Oui
Oui
Oui
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
58
Élément
Niveau
request
terminalId
Description
Type
Répété
Valeur
5
6
Identifiant client (Alias) Num.
ou msisdn
Identifiants de service
Num.
Identifiant de service
shortIds
6
shortId
7
Oui*
* Si le terminalId est présent, un seul shortId peut être précisé. Le message est refusé sinon.
Obligatoire ?
Non
Non
Oui
Oui
Exemples :
Requête unitaire
<?xml version="1.0" encoding="UTF-8"?><env:Envelope
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
<requestId>19</requestId>
<sessionId>301870</sessionId>
</env:Header>
<env:Body>
<xmsService>
<action>
<method>get</method>
</action>
<object>pushSession</object>
<request>
<terminalId>33601020304</ terminalId >
<shortIds>
<shortId>77733</shortId>
</shortIds>
</request>
</xmsService>
</env:Body>
</env:Envelope>
Requête globale
<?xml version="1.0" encoding="UTF-8"?><env:Envelope
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
<requestId>19</requestId>
<sessionId>301870</sessionId>
</env:Header>
<env:Body>
<xmsService>
<action>
<method>get</method>
</action>
<object>pushSession</object>
<request>
<shortIds>
<shortId>88333</shortId>
<shortId>77733</shortId>
</shortIds>
</request>
</xmsService>
</env:Body>
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
59
</env:Envelope>
6.1.4.3.2
Structure de la Réponse (RES)
Élément
Niveau
xml
env:Envelope
env:Header
requestId
1
2
3
env:Body
pushSessions
pushSession
shortId
terminalId
3
4
5
6
4
6
razDate
6
availableAmount
6
Description
Type
Répété
Valeur
Document XML
Message SOAP
Entête SOAP
Identifiant
unique Num.
d’échange SOAP
Liste des sessions
Session
Numéro court de service
Msisdn ou Identifiant
client (alias)
Dernière
date
d’initialisation
des
consommations
Montant
encore
disponible
Num.
Num.
Num.
Obligatoire ?
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Date
time
Oui
Num.
Oui
Exemples :
Réponse unitaire
<?xml version="1.0" encoding="UTF-8"?><env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/en
<env:Header>
<requestId>19</requestId>
<sessionId>301870</sessionId>
</env:Header>
<env:Body>
<pushSessions>
<pushSession>
<shortId>77733</shortId>
<terminalId>33601020304</terminalId>
<razDate>20100601T00:00:00.000+02:00</razDate>
<availableAmount>9.5</ availableAmount >
</pushSession>
</pushSessions>
</env:Body>
</env:Envelope>
Réponse globale
<?xml version="1.0" encoding="UTF-8"?><env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/en
<env:Header>
<requestId>19</requestId>
<sessionId>301870</sessionId>
</env:Header>
<env:Body>
<pushSessions>
<pushSession>
<shortId>88333</shortId>
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
60
<terminalId>33601020304</terminalId>
<razDate>20100601T00:00:00.000+02:00</razDate>
<availableAmount>9.5</ availableAmount >
</pushSession>
<pushSession>
<shortId>77733</shortId>
<terminalId>33601056377</terminalId>
<razDate >20100601T00:00:00.000+02:00</razDate>
<availableAmount>4</ availableAmount >
</pushSession>
</pushSessions>
</env:Body>
</env:Envelope>
6.1.5 Gestion du paramètre de compression
Les réponses retournées par l’interface sont toujours compressées.
Par conséquent, l’Éditeur « Premium Push » doit être capable d’accepter les messages compressés et doit
l’indiquer dans l’entête ( « header ») de ses requêtes. A ce niveau, le champ « Accept-Encoding » doit être
renseigné avec la valeur « gzip ».Toute requête n’incluant pas cette valeur sera rejetée.
Au niveau de la réponse, le paramètre équivalent « Content-Encoding » doit également être renseigné
avec la valeur « gzip ».
6.1.6 Gestion des contrôles
Avant d’acquitter positivement un message (par l’émission d’une réponse de type « http 200 »), l’interface
contrôle le format du message, la présence des valeurs obligatoires et le format des données.
Un contrôle concernant la le nombre maximum de requêtes émises par l’Éditeur « Premium Push » est
également effectué (1 requête unitaire par seconde quel qu’en soit le type et 1 requête globale par jour).
En cas de dépassement, un message d’erreur spécifique est retourné à l’Éditeur « Premium Push ».
6.1.7 Gestion des erreurs
Conformément aux préconisations du « w3c » sur le transport de messages SOAP via HTTP, toute erreur
critique doit être indiquée par un code retour de type « http 500 ». Le corps du message d’erreur alors émis,
doit prendre la forme d’une erreur SOAP générique.
Le tableau ci-dessous liste les principales erreurs susceptibles d’être retournées.
Code
5591
5592
5583
5595
5597
5598
Libellé
Kiosques indisponibles
Format de MSISDN invalide.
Éditeur inconnu.
Service (shortId) inconnu.
Format de message invalide
Message non prévu par l’interface.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
61
Code
5599
5580
5341
5342
5343
5358
5359
5344
Libellé
Erreur interne imprévue.
Fréquence des requêtes dépassée
Utilisateur inconnu
Mot de passe invalide
Session inconnue ou fermée
Méthode inconnue
Service (N° court) inconnu
Accès interdit (droits insuffisants)
Exemple :
<?xml version="1.0"?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
<requestId>12524</requestId>
</env:Header>
<env:Body>
<env:Fault>
<faultcode>5580</faultcode>
<faultstring>Requests frequency exceeded</faultstring>
</env:Fault>
</env:Body>
</env:Envelope>
6.2 Interface MSCA
L’Éditeur « Premium Push » peut également mettre à jour sa base client en utilisant l’outil MSCA (Merchant
Self Care Application) après s’y être connecté à l’aide du « login » et du « mot de passe » fournis par
Orange France.
L’URL d’accès à l’outil est la suivante : https://orange.w-ha.com/app-application-manager/node
A ce niveau, la fonctionnalité est accessible au niveau de l’onglet « Cust. Care » où apparaît la liste des
numéros courts de l’Éditeur « Premium Push », ses services, ainsi qu’un lien lui permettant de télécharger
les données clients associées (sous forme de fichier *.csv compressé).
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
62
Une fois le fichier extrait, les données fournies sont les suivantes :
-
numéro court Premium Push (colonne “ShortID”)
-
identifiant client ou alias (colonne « TerminalID »)
-
date de dernière remise à zéro du client (colonne « razDate »)
-
montant disponible à la date de l'extraction (colonne « AvailableAmount »).
Exemple :
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
63
shortId
58333
58333
58333
58333
58333
58333
58333
58333
58333
terminalId
337344775306
383189031330
357390035411
340800063755
350248208824
365595656920
395032084932
367390991082
373417084807
razDate
13/12/2010 14:48
13/12/2010 14:21
13/12/2010 13:17
13/12/2010 12:04
13/12/2010 11:41
12/12/2010 23:50
12/12/2010 23:23
12/12/2010 19:21
12/12/2010 18:50
availableAmount
12.2
12.2
12.2
12.2
12.2
12.2
12.2
12.0
12.2
Remarque
Lorsque ce montant contenu dans la colonne « AvailableAmount » devient nul, la session de service passe
à l'état "suspendu" et une alerte bloquante est émise en direction du client.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
64
7 Support technique d'Orange France
L’équipe SOUTIEN ÉDITEURS est l’entité d’Orange France chargée fournissant le support technique à
l’Éditeur.
7.1 Les contacts
7.1.1 Contact technique
Contact pour les services Orange SMS+ :
E-Mail : [email protected]
Téléphone : 01 55 45 96 50 en HO (du lundi au vendredi de 8h à 18h)
7.1.2 Les missions
Le rôle de l’équipe SOUTIEN ÉDITEURS est :
-
d’aider l’Éditeur à mettre en production ses nouveaux services en effectuant avec lui différents tests
(validation du raccordement, validation de la cinématique…) et en l’aidant à résoudre les problèmes
éventuellement rencontrés ;
-
centraliser et traiter les appels et signalisations remontés par l’Éditeur (incident, réclamation, information
concernant un incident ou une opération de maintenance prévue/en cours, demande d’intervention…).
7.1.2.1
Modalités de raccordement
Lors de son raccordement, l’équipe SOUTIEN ÉDITEURS fournira à l’Éditeur les éléments suivants :
-
un mot de passe (composé de 4 chiffres et 4 lettres) lui permettant de se connecter à la Plate-forme
SMS et ouvrir des sessions d’échanges ;
-
la taille de la fenêtre de réception (« Output window ») à paramétrer de son côté dans le cadre de ses
échanges en mode « windowing » ;
-
la taille de la fenêtre d’émission (« Input window ») à paramétrer de son côté dans le cadre de ses
échanges en mode « windowing » ;
-
l’adresse IP de la Plate-forme SMS.
Remarque
En fonction du volume et de la nature du trafic généré par l’Éditeur ou des évolutions apportées à son
réseau, Orange France pourra modifier la valeur de ces paramètres.
De son côté, l’Éditeur devra fournir à l’équipe SOUTIEN ÉDITEURS la valeur qu’il attribuera au champ
« CUD ».
7.1.2.2
Modalités de mise en service des numéros courts de l’Éditeur
A l’issue du traitement des ordres de travaux émis par l’équipe commerciale d’Orange France, les modalités
de mise en service des numéros courts de l’Éditeur sont les suivantes :
-
l’Éditeur doit se raccorder au simulateur mis à sa disposition par l’équipe SOUTIEN ÉDITEURS ;
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
65
-
à l’issue de ce raccordement, des échanges doivent être initiés en collaboration avec l’équipe SOUTIEN
ÉDITEURS afin de vérifier la correcte implémentation du protocole UCP (ou UCPo) par l’Éditeur ;
-
à l’issue de ces tests et lorsqu’ils sont concluants, les numéros courts de l’Éditeur sont ouverts en
production.
Remarque
Le franchissement d’une étape conditionne le passage à la phase suivante. Ce franchissement est toujours
prononcé par l’équipe SOUTIEN ÉDITEURS.
Pour organiser les tests pré-requis à la mise en service de ses numéros courts, l’Éditeur doit prendre contact
avec l’Équipe SOUTIEN ÉDITEURS
7.1.2.3
Modalités de d’émission /traitement d’une signalisation
Un Éditeur peut effectuer une signalisation du lundi au vendredi de 08h à 20h. Par contre, l’équipe SOUTIEN
ÉDITEURS chargée de son traitement peut être contactée par l’Éditeur du lundi au vendredi de 09h à 18h.
En dehors de ces horaires, tous les appels faits par l’Éditeur sont tracés puis transmis à l’équipe SOUTIEN
ÉDITEURS.
Chaque signalisation est enregistrée dans un journal de bord informatisée où les caractéristiques
suivantes doivent renseignées pour chacune d’elles :
-
numéro identifiant attribué par le système ;
-
coordonnées de l’auteur de la signalisation ;
-
attributs du service concerné (numéro court, serveur…) ;
-
date/heure d’enregistrement.
Suite à une signalisation faite par un Éditeur en heures ouvrées, l’équipe SOUTIEN ÉDITEURS fournira en
retour :
-
une information dans l’heure qui suit la fin de l’analyse de premier niveau ;
-
une information complémentaire dans un délai de 8 heures ouvrées lorsque l’analyse nécessite le
recours à un ou plusieurs experts.
A l’issue de la résolution, l’équipe SOUTIEN ÉDITEURS enverra à l’Éditeur un compte-rendu précisant
notamment les dates/heures effectives de début/fin de traitement de la signalisation. Ce compte-rendu sera
fourni par mail, dans un délai de 2 jours ouvrés.
Remarques :
Le délai de traitement d’une signalisation doit tenir compte des horaires pendant lesquels l’équipe SOUTIEN
ÉDITEURS est joignable (du lundi au vendredi de 09h à 18h).
L’assistance décrite ne peut être fournie qu’aux correspondants techniques désignés par l’Éditeur au niveau
des Conditions Particulières de son contrat SMS+. Côté SOUTIEN ÉDITEURS, les contacts seront fournis à
l’Éditeur à l’issue de la signature de ses Conditions Particulières.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
66
7.1.3 Procédures en cas d’intervention
7.1.3.1
Intervention programmée à l’initiative de l’Éditeur
Une intervention programmée est une opération technique planifiée à l’avance, pouvant perturber ou
interrompre temporairement le service rendu par l’Éditeur.
Lorsque l’intervention programmée est à l’initiative de l’Éditeur, ce dernier doit en avertir l’équipe SOUTIEN
ÉDITEURS par mail, au mois 1 jour ouvré avant.
Dans son mail, l’Éditeur doit décrire l’objectif de l’intervention, les différentes étapes, la procédure en cas de
retour arrière et doit donner les dates/heures prévisionnelles de début et de fin de l’opération.
L’équipe SOUTIEN ÉDITEURS met à disposition de l’Éditeur un modèle de document à utiliser par ce
dernier pour effectuer ce type de communication (fiche MPI, voir modèle en annexes)
A l’issue de l’intervention, l’Éditeur doit fournir à l’équipe SOUTIEN ÉDITEURS un compte-rendu de
l’intervention précisant notamment les dates de début et fin d’intervention effectives Ce compte-rendu doit
être adressé par mail dans un délai de 2 jours ouvrés.
7.1.3.2
Interventions à l’initiative d’Orange France
Lorsqu’une intervention préventive (visant à garantir la continuité et la qualité du service) est programmée
par Orange France et que celle-ci est susceptible de perturber ou interrompre temporairement le service
rendu par l’Éditeur, l’équipe SOUTIEN ÉDITEURS s’engage à informer les correspondants techniques
désignés dans délai minimum de 24 heures ouvrées.
Lorsqu’une intervention corrective (visant à rétablir le service ou sa qualité) doit être effectuée
immédiatement par Orange, l’équipe SOUTIEN ÉDITEURS s’engage à informer par mail les correspondants
techniques désignés dans les plus brefs délais.
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
67
8 Synthèse des offres SMS+
8.1 Offres surtaxées utilisant le protocole UCP
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
68
8.2 Offres surtaxées utilisant le protocole UCPo
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
69
8.3 Offres non surtaxées de type « Push »
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
70
8.4 Offres non surtaxées de type « Pull »
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
71
9 Annexes
9.1 Modèle de fiche de signalisation
A envoyer par mail à SOUTIEN ÉDITEUR S : [email protected]
Nom de l’Éditeur :
N° Court(s) impacté(s) :
Nom du/des service(s) :
Date et heure de début :
Date et heure de fin :
CARACTERISTIQUES DE L'INCIDENT
CONSEQUENCES DE L'INCIDENT, y compris au niveau de l’Utilisateur
CHRONOLOGIE DES EVENEMENTS
Construire la chronologie en identifiant les grandes étapes : dernière sauvegarde - premiers
symptômes – incident - prise en compte du défaut - déclenchement de l’intervention - localisation intervention - actions effectuées – rétablissement du service - fin de l’intervention
Date (jour/hh/mn)
Évènements clés
Commentaires (actions et
conséquences)
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
72
9.2 Modèle de fiche MPI (intervention programmée)
1. Objectifs
[A compléter]
2. Description Générales de l’intervention
[La durée et les conséquences sur le service sont à préciser dans chaque phase de l’intervention :
interruptions de service, altération des fonctionnalités etc. Préciser l’impact sur l’Utilisateur]
3. Durée globale / contraintes de l’intervention
Date et heure de début programmé :
Date et heure de fin programmée :
4. Procédure de retour en arrière
[Indiquer les étapes permettant un retour en arrière, pour quels motifs le retour en arrière sera
effectué, la
durée maximum de reprise du service après le retour en arrière, etc…]
Orange
S.A au capital de 10 595 541 532 euros, immatriculée au RCS Paris sous le n°380 129 866,
domiciliée pour les présentes au 78, rue Olivier de Serres, 75015 Paris.
Confidentiel © Orange novembre 2013 – La diffusion de ce document est soumise à autorisation
Reproduction interdite sans autorisation préalable
73