Intégration API IoT Connect Capped Plans

Cet article explique comment intégrer nos API pour l’offre IoT Connect Capped Plans. Si vous utilisez IoT Connect avec paiement à l’usage ou forfaits mutualisés (pooled bundles), consultez Intégration API IoT Connect.

Avant de commencer : lisez Comment intégrer nos API ? pour obtenir vos identifiants et trouver vos profils de service et valeurs techniques dans la plateforme de gestion des SIM. Les liens et références des API sont disponibles sur le Portail Développeurs.

1. Activer vos SIM et gérer leurs services

API : Connectivity Management

Utilisez cette API pour activer, suspendre ou résilier des SIM, modifier leurs services, renseigner les champs de référence et de groupe, et consulter les informations de service d’une SIM.

Recommandé : utiliser les profils de service

Créez ou choisissez un profil de service dans la plateforme de gestion des SIM, puis indiquez sa référence dans la requête d’activation. La SIM reçoit le modèle tarifaire et les services du profil, et apparaît sous ce profil dans l’interface, exactement comme si vous l’aviez activée depuis l’interface.

POST /api/subscribers/sim-serial/{simSerial}/activate
{
  "serviceProfile": "<référence de votre profil de service>",
  "externalReference": "Device-0001",
  "group": "Group A1"
}

Pour modifier les services d’une SIM, attribuez-lui un autre profil de service. La SIM reprend la configuration du nouveau profil et n’est pas marquée comme déviée. Elle reste alignée sur son profil et correctement classée dans l’interface.

Alternative : utiliser un rate plan et des options

Si vous avez besoin d’une configuration spécifique pour chaque SIM, indiquez le rate plan et le libellé technique de chaque option :

• Rate plan : M2MA_WW_TSL_IOTCONNECT_CAPPED (compte standard en EUR).
• Options : libellés techniques disponibles dans Catalogue > Options. Par exemple, pour le modèle tarifaire par forfaits, indiquez la valeur IOTC_REF_BUNDLES pour l’option OFFER_901_IOT_CONNECT_CAP_PRICING.

⚠️ Modifier les options d’une SIM une par une la marque comme déviée par rapport à son profil de service dans la plateforme de gestion des SIM. Pour modifier les services sans dévier vos SIM, attribuez-leur plutôt un autre profil de service.

Bon à savoir :

• Si aucun modèle tarifaire n’est indiqué, le modèle Capped Plans est appliqué par défaut.
• Chaque option a une valeur par défaut si vous ne la renseignez pas.
• Certaines options n’acceptent qu’une seule valeur, comme une liste déroulante dans l’interface.

2. Récupérer la liste de vos SIM

API : SIM Search

Recherchez, filtrez, triez et paginez vos SIM. Cas d’usage courants : tableaux de bord d’inventaire, portails clients, outils internes, récupération des SIM par compte ou par groupe, et processus de service client.

De nombreuses actions sont asynchrones (une activation peut prendre quelques minutes). Abonnez-vous aux événements Connectivity Management (webhooks) pour être notifié des changements de cycle de vie.

3. Ajouter et gérer des forfaits

API	Fonction
OCS Subscription	Ajoute un forfait data à une SIM. C’est l’API principale de cette offre.
OCS Inventory	Affiche les forfaits d’une SIM, le statut de souscription et le solde restant, par exemple pour l’afficher dans votre interface.
OCS Catalog	Liste les forfaits disponibles.
OCS Events	Envoie des webhooks lors des événements du cycle de vie des forfaits (par exemple, l’expiration d’un forfait), pour notifier les utilisateurs finaux ou mettre à jour votre interface.

4. Récupérer les informations eSIM

API : SIM Management, endpoint Get eSIM details uniquement

Cet endpoint renvoie le code d’activation, le lien de téléchargement du QR code, le statut de l’eSIM et le statut de l’appareil (utile pour le diagnostic). Les API de réservation et de libération de profil ne s’appliquent pas à cette offre.

5. Récupérer la consommation data

• OCS Inventory : détail des forfaits, solde restant et date d’expiration pour les SIM disposant d’un forfait.
• Network Usage : consommation data totale de toutes les SIM sur une période donnée, filtrable par pays et par date.

Glossaire – valeurs pour IoT Connect Capped Plans

La documentation API étant générique, elle ne précise pas les valeurs propres à chaque offre. Voici celles à utiliser pour IoT Connect Capped Plans.

Valeur	Utilisée dans	Valeur à renseigner
serviceProfile	Connectivity Management (activation, modification de services)	La référence de votre profil de service, dans Services > Profils de service
mvnoRef	API OCS	Le nom de votre compte, au format M2MA_WW_TSL_…, visible dans la plateforme de gestion des SIM
COS (Catalog of Services) pour récupérer les forfaits	OCS Catalog	WW_M2MA_COS_IOT_CONNECT
payment	OCS Subscription	Customer (en tant que client Transatel, c’est vous qui payez les forfaits)
ratePlan	Connectivity Management (méthode rate plan + options) et API optionnelle Subscriptions Management	M2MA_WW_TSL_IOTCONNECT_CAPPED par défaut, dans Catalogue > Options

Besoin d’aide ?

Contactez notre équipe support via le Service Desk.