ForHosting KIT · أدوات المطورين

محول UPC-E

يتوسع رمز UPC-E ذو الأرقام 425261 إلى UPC-A هو 042100005264: تعود الأصفار المحذوفة من أجل العبوات الصغيرة، فيكون رمز الصانع 42100 والمنتج 00526، ويُحسب رقم التحقق المشترك 4. والضغط يسلك الطريق العكسي. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

الرمز: 425261
وضع الحساب: Expand

تحصل على

الاتجاه: expand
رمز المدخلات: 425261
نظام الترقيم: 0
Upc e: 425261

رمز UPC-E هو الشكل السداسي الأرقام مع كبت الأصفار لرمز شريطي تجزئة UPC-A، ويُستخدم على العبوات الصغيرة حيث لا يتسع الرمز الاثنا عشري. تخزّن أنظمة المستودعات وطابعات الملصقات وقواعد بيانات المنتجات غالبًا الشكل الموسَّع UPC-A، فيحتاج المشغّلون إلى تحويل موثوق بين الشكلين دون تخمين الأصفار المحذوفة. يوسّع محول UPC-E هذا رمز UPC-E صالحًا إلى مكافئه UPC-A الكامل، ويضغط UPC-A المؤهل مجددًا إلى UPC-E، ويحسب أو يتحقق دائمًا من رقم التحقق المشترك لالتقاط الرقم الأخير الخاطئ فورًا. يختار وضع auto الاتجاه من طول سلسلة الأرقام، بينما يفرض expand وcompress اتجاهًا واحدًا للسكربتات والنماذج.

كيف يعمل توسيع UPC-E وضغطه

يتكون رمز UPC-A القياسي من اثني عشر رقمًا: رقم نظام الترقيم (0 أو 1 لـ UPC-E التجزئة)، ورمز مصنع من خمسة أرقام، ورمز منتج من خمسة أرقام، ورقم تحقق mod-10 واحد يُحسب بأوزان ثلاثة وواحد من اليسار إلى اليمين. يخزّن UPC-E ستة أرقام بيانات فقط بكبت سلاسل أصفار في أنماط مصنع ومنتج معينة وفق GS1.

يعيد التوسيع الأصفار الناقصة من الرقم السادس للبيانات: إن كان 0 أو 1 أو 2 ينتهي رمز المصنع بذلك الرقم مع صفرين ويكون المنتج 00 مع الأرقام الثلاثة الوسطى؛ وإن كان 3 ينتهي المصنع بصفرين والمنتج 000 مع رقمين؛ وإن كان 4 ينتهي المصنع بصفر والمنتج 0000 مع رقم واحد؛ ومن 5 إلى 9 يُحفظ المصنع الخماسي والمنتج 0000 مع ذلك الرقم الأخير. يُسبق نظام الترقيم، وتُحسب مجموع التحقق لجسم أحد عشر رقمًا، والنتيجة UPC-A قانوني من اثني عشر رقمًا.

الضغط هو العكس: فقط الرموز ذات النظام 0 أو 1 ونمط أصفار مطابق تصبح UPC-E؛ وما عدا ذلك يُبلَّغ بأنه غير قابل للضغط. ولأن رقم تحقق UPC-E هو رقم تحقق UPC-A الموسَّع، فإن التوسيع ثم الضغط يغلق الدورة دائمًا لكل رسالة UPC-E صالحة، فيصلح هذا المحول مولدًا آمنًا لبيانات اختبار برمجيات الملصقات ومفاتيح الامتحانات. لا يوجد فاصلة عائمة ولا عيّنة عشوائية ولا جداول خارجية—فروع على الأرقام ومجموع مرجّح واحد فقط.

المدخلات والأوضاع وحقول الاستجابة

أرسل الحقل الإلزامي code متضمنًا أرقام الرمز الشريطي. تُزال المسافات والشرطات والشرطات السفلية والنقاط حتى تُحلَّل القيم المنسوخة من العبوة. سبعة أرقام هي النظام مع ستة بيانات إن كان الأول 0 أو 1، وإلا ستة بيانات مع رقم تحقق.

ثمانية أرقام هي النظام وستة بيانات ورقم تحقق؛ ورقم تحقق خاطئ يفشل التحقق. أحد عشر رقمًا هي UPC-A بلا تحقق—تحسبه الأداة ثم تضغط. اثنا عشر رقمًا UPC-A كامل مع تحقق.

ثلاثة عشر رقمًا تُقبل فقط إذا كانت السلسلة شكل EAN-13 لـ UPC-A يبدأ بـ 0.

أين يُثبت محول UPC-E فائدته

تلصق فرق عمليات التجزئة رموزًا قصيرة من عبوات صغيرة لمستحضرات التجميل والحلويات والإلكترونيات في أدوات مخزون تقبل فقط UPC-A الاثني عشري، وتحتاج توسيعًا لا يخترع أصفارًا. تصمم المطابع ومصنعو العلامة الخاصة رموزًا بكبت أصفار للرسوم الضيقة ويجب ضغط UPC-A الكتالوج إلى UPC-E فقط عندما يسمح نمط GS1، مع فشل واضح خلاف ذلك حتى لا يُطبع SKU غير مؤهل خطأ. تمرّر سكربتات ضمان الجودة آلاف الرموز ذهابًا وإيابًا: توسيع ثم ضغط ثم تأكيد المساواة، لالتقاط أرقام تحقق منزاحة قبل التشغيل الإنتاجي.

تعرض قوائم التجارة الإلكترونية غالبًا رمزًا بستّة أرقام من جدول المورّد بينما يطلب السوق GTIN-12؛ والتحويل عبر هذه النقطة يحافظ على أتمتة القوائم حتمية. اربط هذه القدرة بالتحقق العام من رقم التحقق أو توليد صورة رمز شريطي عند الحاجة أيضًا إلى براهين متعددة الرموز أو رموز قابلة للطباعة، لكن أبقِ توسيع UPC-E وضغطه في صفحة هبوط خاصة به ليبقى قصد البحث أحادي الغرض. فضّل auto لواجهات اللصق، وexpand لدفعات الرموز القصيرة، وcompress لصادرات الكتالوج التي يجب أن تصبح UPC-E فقط عند الأهلية.

حالات الاستخدام

استلام تجزئة للعبوات الصغيرة

يوسّع موظفو الاستلام رموز UPC-E السداسية من العبوات المدمجة إلى UPC-A الاثني عشري لملفات مسح WMS التي تخزّن الشكل الكامل فقط.

تصميم الملصقات والعلامة الخاصة

يضغط المصممون قيم UPC-A الكتالوج إلى UPC-E عندما يسمح نمط الأصفار، ويتلقون خطأ واضحًا عندما لا يجوز لـ SKU استخدام كبت الأصفار قانونيًا.

الأسئلة الشائعة

ماذا يفعل محول UPC-E هذا؟

يوسّع UPC-E (6–8 أرقام) إلى UPC-A كامل من 12 رقمًا ويضغط UPC-A المؤهل (أو EAN-13 بادئ بـ 0) مجددًا إلى UPC-E، مع حساب أو تحقق دائم من رقم التحقق المشترك.

ما أنظمة الترقيم المدعومة؟

ينطبق كبت أصفار UPC-E على نظامي الترقيم 0 و1 فقط.

كيف يختار وضع auto بين التوسيع والضغط؟

يوسّع auto الرموز من 6–8 أرقام ويضغط رموز 11–13 رقمًا. افرض expand أو compress عندما تحتاج اتجاهًا واحدًا بغض النظر عن الطول.

لماذا لا يمكن ضغط رمز UPC-A الخاص بي إلى UPC-E؟

لا يملك شكلًا من ستة أرقام إلا الرمز الذي نظام ترقيمه 0 أو 1 ويحتوي جزءا الصانع والمنتج فيه أحد أنماط الأصفار التي حددتها GS1. وأي رمز آخر يُبلَّغ عنه بأنه غير قابل للضغط بدل أن ينتهي على ملصق خاطئ.

كيف تُعاد الأصفار المفقودة؟

يحدد ذلك رقم البيانات السادس. فمع 0 أو 1 أو 2 ينتهي رمز الصانع بذلك الرقم ثم صفرين، ومع 3 بصفرين، ومع 4 بصفر واحد، ومن 5 إلى 9 يبقى رمز الصانع كاملًا ويصبح المنتج أربعة أصفار يليها ذلك الرقم.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/enc/upce

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/enc/upce \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"425261"}'

const res = await fetch("https://api.kit.forhosting.com/enc/upce", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "code": "425261"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/upce",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "code": "425261"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/upce", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"code":"425261"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"code":"425261"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/upce", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "code": "425261"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.upce",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

تُرفض الرموز غير القابلة للضغط أو ذات رقم تحقق خاطئ أو نظام ترقيم غير مدعوم بـ invalid_input بدل تسمية خاطئة صامتة. الخوارزمية حساب حتمي لكبت أصفار GS1—بلا شبكة ولا نموذج ولا ساعة—فيعيد ودجت المتصفح المجاني وواجهة API المدفوعة مسبقًا نفس JSON. تكلف استدعاءات API الناجحة السعر الأساسي المنشور $0.002 لكل عنصر.

المدخلات والأوضاع وحقول الاستجابة

تُعامل ستة أرقام كبيانات UPC-E بنظام 0 افتراضيًا، أو 0 أو 1 عند تعيين number_system. يوسّع وضع auto (الافتراضي) الأطوال حتى ثمانية ويضغط من أحد عشر إلى ثلاثة عشر؛ ويفرض expand وcompress اتجاهًا واحدًا ويرفعان invalid_input عند عدم تطابق الطول. تُقبل الأسماء البديلة text وvalue وinput وbarcode وupc للحقل code؛ وop وaction وdirection بدل mode؛ وns وnumberSystem وsystem بدل number_system. تتضمن الاستجابة الناجحة دائمًا mode وdirection وcode_in وnumber_system وupc_e (ستة أرقام بيانات) وupc_e_full (ثمانية مع النظام والتحقق) وupc_a (اثنا عشر) وmanufacturer_code وproduct_code وcheck_digit وvalid بقيمة true. المدخلات الناقصة أو الفارغة أو غير الرقمية أو الطويلة جدًا أو غير القابلة للضغط أو ذات رقم تحقق خاطئ تفشل بـ invalid_input ولا تُفوتر على المسار المدفوع مسبقًا. تسعير الاستدعاءات الناجحة هو الأساس المنشور $0.002 لكل عنصر.

أين يُثبت محول UPC-E فائدته

تستفيد مواد الصف والشهادات عن رموز الأشرطة من ودجت حي تتطابق نتائجه المجانية في المتصفح بايتًا ببايت مع API المدفوعة على نفس الوحدة النقية. كل استدعاء ناجح يكلف السعر الأساسي $0.002 بلا رموز نموذج ولا شبكة صادرة؛ والتحقق الفاشل لا يستهلك الرصيد.

حالات التكامل

بيانات اختبار QA وتغذية الأسواق

تجري خطوط الأنابيب ذهابًا وإيابًا للتوسيع والضغط في اختبارات golden وتحوّل رموز المورّد القصيرة إلى GTIN-12 لرفع القوائم دون تخمين الأصفار يدويًا.

أسئلة تقنية

ماذا لو لم يكن UPC-A قابلاً للضغط؟

إذا لم تطابق أرقام المصنع والمنتج نمط كبت أصفار GS1، يفشل الطلب بـ invalid_input موضحًا أن الرمز غير قابل للضغط إلى UPC-E.

كم يكلف محول UPC-E؟

أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بمبلغ $0.002 لكل استدعاء ناجح؛ والمدخل غير الصالح لا يُفوتر.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

كيف يعمل توسيع UPC-E وضغطه

المدخلات والأوضاع وحقول الاستجابة

أين يُثبت محول UPC-E فائدته

حالات الاستخدام

استلام تجزئة للعبوات الصغيرة

تصميم الملصقات والعلامة الخاصة

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الأخطاء

ملاحظات تقنية

المدخلات والأوضاع وحقول الاستجابة

أين يُثبت محول UPC-E فائدته

حالات التكامل

بيانات اختبار QA وتغذية الأسواق

أسئلة تقنية

شكرًا