إدارة مخزون eSIM

تشرح هذه الدليل كيفية تكوين مخزون eSIM لقنوات التوزيع المختلفة: الرقمية (عبر الإنترنت) مقابل المطبوعة (بطاقات فعلية).

انظر أيضًا: المخزون لإدارة المخزون العامة، توفير بطاقة SIM لعمليات التوفير وواجهة برمجة التطبيقات لمصدر eSIM.

نظرة عامة

يمكن توزيع eSIMs من خلال قناتين:

1. التوزيع الرقمي: يتم إصدارها على الفور عبر بوابة التسجيل الذاتي، ويتم تسليمها عبر البريد الإلكتروني مع رمز QR
2. التوزيع المطبوع: مطبوعة مسبقًا على بطاقات كرتونية للتوزيع الفعلي أو البيع بالتجزئة

يتحكم حقل item_location في جدول المخزون في القناة المتاحة لـ eSIM.

تكوين قناة التوزيع

يحدد حقل item_location كيفية توزيع eSIM:

القيمة	الوصف	متاحة عبر
digital	متاحة للإصدار عبر الإنترنت / الفوري	بوابة التسجيل الذاتي، واجهة برمجة التطبيقات
printed	محجوزة لتوزيع بطاقات فعلية	تعيين يدوي فقط
قيم أخرى	غير متاحة للإصدار التلقائي	تعيين يدوي فقط

إعداد eSIMs الرقمية

لجعل eSIMs متاحة للتوزيع عبر الإنترنت:

1. انتقل إلى المخزون في OmniCRM
2. اختر عناصر مخزون eSIM المخصصة للتوزيع الرقمي
3. اضبط item_location على digital
4. احفظ التغييرات

إعداد eSIMs المطبوعة

بالنسبة لـ eSIMs التي تم طباعتها على بطاقات فعلية:

1. انتقل إلى المخزون في OmniCRM
2. اختر عناصر مخزون eSIM المطبوعة
3. اضبط item_location على printed (أو أي قيمة غير digital)
4. احفظ التغييرات

كيفية عمل الإصدار الرقمي

عندما يطلب عميل eSIM عبر بوابة التسجيل الذاتي عبر POST /crm/oam/issue-esim:

1. تستعلم واجهة برمجة التطبيقات عن المخزون للحصول على eSIMs المتاحة
2. يتم اعتبار eSIMs التي تطابق جميع المعايير أدناه فقط
3. يتم اختيار eSIM واحدة عشوائيًا من المجموعة المتاحة
4. يتم إرسال تفاصيل eSIM إلى العميل عبر البريد الإلكتروني

معايير اختيار المخزون

الحقل	الشرط	الغرض
item	يحتوي على "esim" (غير حساس لحالة الأحرف)	يحدد عناصر مخزون eSIM
item_location	يساوي digital	يقتصر على قناة التوزيع الرقمية
customer_id	فارغ	لم يتم تعيينه بعد لعميل
service_id	فارغ	لم ي��م تعيينه بعد لخدمة

للحصول على تفاصيل كاملة حول نقطة النهاية issue-esim بما في ذلك معلمات الطلب، وحدود المعدل، واستجابات الخطأ، انظر توفير بطاقة SIM - واجهة برمجة التطبيقات العامة لمصدر eSIM.

معالجة الأخطاء

إذا لم تكن هناك eSIMs رقمية متاحة، فإن واجهة برمجة التطبيقات تعيد:

حالة HTTP	نوع الخطأ	الرسالة
503	NoInventory	"لا توجد eSIMs متاحة حاليًا. يرجى المحاولة مرة أخرى لاحقًا أو اختيار SIM فعلي."

الحقول الرئيسية للمخزون لـ eSIMs

الحقل	النوع	الوصف
item	سلسلة	معرف نوع العنصر (يجب أن يحتوي على "esim" لعناصر eSIM)
item_location	سلسلة	قناة التوزيع: digital للإنترنت، قيم أخرى للموقع الفعلي
itemtext1	سلسلة	ICCID: المعرف الفريد لـ eSIM
management_url	سلسلة	سلسلة تفعيل LPA (مثل، LPA:1$rsp-eu.simlessly.com$...)
customer_id	عدد صحيح	العميل المعين (فارغ إذا لم يتم تعيينه)
service_id	عدد صحيح	الخدمة المعينة (فارغ إذا لم يتم تعيينه)

للحصول على مرجع كامل لجميع حقول عناصر المخزون، انظر المخزون - حقول عناصر المخزون.

الاستيراد التلقائي من HSS

عند استيراد SIMs من HSS باستخدام نص التوفير، يتم تعيين حقلين تلقائيًا بناءً على سجل HSS:

قناة التوزيع (item_location):

• إذا كان اسم الدفعة يحتوي على "digital" (غير حساس لحالة الأحرف)، يتم وضع علامة على eSIM كـ item_location = 'digital' للتوزيع عبر الإنترنت
• خلاف ذلك، يتم تعيين eSIM إلى الموقع الفعلي الافتراضي (مثل "المكتب الرئيسي")

سلسلة تفعيل LPA (management_url):

• يتم استيراد حقل lpa من سجل SIM في HSS تلقائيًا كـ management_url
• يتيح ذلك إنشاء رمز QR في CRM لتفعيل eSIM
• إذا لم يكن لدى سجل HSS قيمة lpa، يتم استيراد eSIM بدون سلسلة تفعيل

هذا يعني أنه يمكن التحكم في قناة التوزيع وبيانات LPA على مستوى HSS:

• قم بتسمية الدفعات بشكل مناسب (مثل "eSIMs الرقمية Q1 2026"، "دفعة بطاقات مطبوعة 3")
• تأكد من أن eSIMs تحتوي على حقل lpa ممتلئ في HSS قبل الاستيراد

أفضل الممارسات

فصل المخزون

• احتفظ بمجموعات eSIM الرقمية والمطبوعة منفصلة باستخدام item_location
• راقب مستويات ا��مجموعة الرقمية لضمان توفرها للعملاء الذين يسجلون أنفسهم
• ضع في اعتبارك إعداد تنبيهات عندما ينخفض مخزون eSIM الرقمي

تحديثات الدفعات اليدوية

عند استيراد أو تحديث eSIMs يدويًا:

1. eSIMs الرقمية: اضبط item_location = 'digital' أثناء الاستيراد
2. eSIMs المطبوعة: اضبط item_location = 'printed' أو الموقع الفعلي (مثل "مكتب جورجتاون")

التحويل بين القنوات

لنقل eSIMs بين القنوات:

• من المطبوعة إلى الرقمية: تحديث item_location من printed إلى digital
• من الرقمية إلى المطبوعة: تحديث item_location من digital إلى printed (فقط إذا لم يتم إصدارها بعد)

استكشاف الأخطاء وإصلاحها

لا توجد eSIMs متاحة للإصدار عبر الإنترنت

الأعراض: يرى العملاء "لا توجد eSIMs متاحة حاليًا" عند طلب eSIM عبر الإنترنت.

الأسباب المحتملة:

• لا توجد eSIMs تم تعيين item_location لها على digital
• جميع eSIMs الرقمية قد تم تعيينها بالفعل (كلا من customer_id و service_id غير فارغين)
• عناصر eSIM لا تحتوي على "esim" في اسم العنصر

الحل:

1. تحقق من المخزون عن eSIMs مع item_location = 'digital'
2. تحقق من وجود eSIMs غير المعينة (كلا من customer_id و service_id فارغين)
3. أضف المزيد من eSIMs إلى المجموعة الرقمية أو قم بتحويل المطبوعة إذا كانت متاحة

إصدار eSIMs المطبوعة عبر الإنترنت

الأعراض: يتم إصدار eSIMs المخصصة للبطاقات الفعلية عبر البوابة.

الأسباب المحتملة:

• لم يتم تعيين item_location بشكل صحيح على eSIMs المطبوعة

الحل:

1. تحديث جميع eSIMs المطبوعة لتكون item_location = 'printed'
2. تأكد من أن استيرادات eSIMs المطبوعة الجديدة تعين القيمة الصحيحة لـ item_location