Gestion de l'inventaire eSIM

Ce guide explique comment configurer l'inventaire eSIM pour différents canaux de distribution — numérique (en ligne) contre imprimé (cartes physiques).

Voir aussi : Inventaire pour la gestion générale de l'inventaire, Provisionnement de carte SIM pour les flux de travail de provisionnement et l'API émetteur eSIM.

Aperçu

Les eSIM peuvent être distribuées par deux canaux :

1. Distribution Numérique — Émis instantanément via le portail d'auto-inscription, livré par email avec un code QR
2. Distribution Imprimée — Pré-imprimé sur des cartes en carton pour remise physique ou vente au détail

Le champ item_location dans le tableau d'inventaire contrôle quel canal une eSIM est disponible.

Configuration du Canal de Distribution

Le champ item_location détermine comment une eSIM peut être distribuée :

Valeur	Description	Disponible Via
digital	Disponible pour émission en ligne/instantanée	Portail d'auto-inscription, API
printed	Réservé pour la distribution de cartes physiques	Attribution manuelle uniquement
Autres valeurs	Non disponible pour émission automatique	Attribution manuelle uniquement

Configuration des eSIM Numériques

Pour rendre les eSIM disponibles pour une distribution en ligne :

1. Accédez à Inventaire dans OmniCRM
2. Sélectionnez les éléments d'inventaire eSIM destinés à la distribution numérique
3. Définissez item_location sur digital
4. Enregistrez les modifications

Configuration des eSIM Imprimées

Pour les eSIM qui ont été imprimées sur des cartes physiques :

1. Accédez à Inventaire dans OmniCRM
2. Sélectionnez les éléments d'inventaire eSIM qui sont imprimés
3. Définissez item_location sur printed (ou toute valeur autre que digital)
4. Enregistrez les modifications

Fonctionnement de l'Émission Numérique

Lorsqu'un client demande une eSIM via le portail d'auto-inscription via POST /crm/oam/issue-esim :

1. L'API interroge l'inventaire pour les eSIM disponibles
2. Seules les eSIM correspondant à tous les critères ci-dessous sont prises en compte
3. Une eSIM est sélectionnée au hasard dans le pool disponible
4. Les détails de l'eSIM sont envoyés au client par email

Critères de Sélection de l'Inventaire

Champ	Condition	Objectif
item	Contient "esim" (insensible à la casse)	Identifie les éléments d'inventaire eSIM
item_location	Égal à digital	Restriction au canal de distribution numérique
customer_id	Est nul	Pas encore attribué à un client
service_id	Est nul	Pas encore attribué à un service

Pour des détails complets sur le point de terminaison issue-esim, y compris les paramètres de requête, la limitation de débit et les réponses d'erreur, voir Provisionnement de carte SIM - API Émetteur eSIM Publique.

Gestion des Erreurs

Si aucune eSIM numérique n'est disponible, l'API retourne :

Statut HTTP	Type d'Erreur	Message
503	NoInventory	"Aucune eSIM actuellement disponible. Veuillez réessayer plus tard ou choisir une carte SIM physique."

Champs Clés de l'Inventaire pour les eSIM

Champ	Type	Description
item	Chaîne	Identifiant de type d'élément (doit contenir "esim" pour les éléments eSIM)
item_location	Chaîne	Canal de distribution : digital pour en ligne, autres valeurs pour physique
itemtext1	Chaîne	ICCID — l'identifiant unique de l'eSIM
management_url	Chaîne	Chaîne d'activation LPA (ex. : LPA:1$rsp-eu.simlessly.com$...)
customer_id	Entier	Client attribué (nul si non attribué)
service_id	Entier	Service attribué (nul si non attribué)

Pour une référence complète de tous les champs d'éléments d'inventaire, voir Inventaire - Champs d'Éléments d'Inventaire.

Importation Automatique depuis HSS

Lorsque des SIM sont importées depuis le HSS à l'aide du script de provisionnement, deux champs sont définis automatiquement en fonction de l'enregistrement HSS :

Canal de Distribution (item_location) :

• Si le nom du lot contient "digital" (insensible à la casse), l'eSIM est marquée comme item_location = 'digital' pour une distribution en ligne
• Sinon, l'eSIM est définie sur l'emplacement physique par défaut (ex. : "Île de l'Ascension")

Chaîne d'Activation LPA (management_url) :

• Le champ lpa de l'enregistrement SIM HSS est automatiquement importé comme management_url
• Cela permet la génération de codes QR dans le CRM pour l'activation de l'eSIM
• Si l'enregistrement HSS n'a pas de valeur lpa, l'eSIM est importée sans chaîne d'activation

Cela signifie que les données de canal de distribution et LPA peuvent être contrôlées au niveau HSS :

• Nommez les lots de manière appropriée (ex. : "eSIM numériques T1 2026", "Lot de Cartes Imprimées 3")
• Assurez-vous que les eSIM ont leur champ lpa rempli dans le HSS avant l'importation

Meilleures Pratiques

Ségrégation de l'Inventaire

• Gardez les pools d'eSIM numériques et imprimées séparés en utilisant item_location
• Surveillez les niveaux de pool numérique pour garantir la disponibilité pour les clients en auto-inscription
• Envisagez de définir des alertes lorsque l'inventaire d'eSIM numériques devient faible

Mises à Jour Manuelles par Lot

Lors de l'importation ou de la mise à jour manuelle des eSIM :

1. eSIM Numériques : Définissez item_location = 'digital' lors de l'importation
2. eSIM Imprimées : Définissez item_location = 'printed' ou l'emplacement physique (ex. : "Bureau de Georgetown")

Conversion entre Canaux

Pour déplacer des eSIM entre les canaux :

• Imprimé à Numérique : Mettez à jour item_location de printed à digital
• Numérique à Imprimé : Mettez à jour item_location de digital à printed (uniquement si pas encore émis)

Dépannage

Aucune eSIM Disponible pour Émission en Ligne

Symptômes : Les clients voient "Aucune eSIM actuellement disponible" lorsqu'ils demandent une eSIM en ligne.

Causes possibles :

• Aucune eSIM n'a item_location défini sur digital
• Toutes les eSIM numériques sont déjà attribuées (à la fois customer_id et service_id sont non nuls)
• Les éléments eSIM n'ont pas "esim" dans le nom de l'élément

Résolution :

1. Vérifiez l'inventaire pour les eSIM avec item_location = 'digital'
2. Vérifiez qu'il y a des eSIM non attribuées (à la fois customer_id et service_id sont nuls)
3. Ajoutez plus d'eSIM au pool numérique ou convertissez celles imprimées si disponibles

eSIM Imprimées Émises en Ligne

Symptômes : Les eSIM destinées aux cartes physiques sont émises via le portail.

Causes possibles :

• item_location non défini correctement sur les eSIM imprimées

Résolution :

1. Mettez à jour toutes les eSIM imprimées pour avoir item_location = 'printed'
2. Assurez-vous que les nouvelles importations d'eSIM imprimées définissent la valeur correcte de item_location