ForHosting KIT · المستندات وملفات PDF

إنشاء بطاقة ضمان منتج مع تاريخ انتهاء الصلاحية

يمكنكم إنشاء بطاقة ضمان منتج متسقة انطلاقا من أربع معلومات أساسية: اسم المنتج ورقمه التسلسلي وتاريخ الشراء ومدة الضمان بالأشهر.

● Betaمجاني · داخل متصفحك

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

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

تتحقق الأداة من القيم المقدمة، وتحسب تاريخ الانتهاء بحساب تقويمي حتمي، ثم تعيد مستندا منظما يسهل عرضه أو حفظه أو طباعته أو تمريره إلى سير عمل آخر. وتعالج مشتريات نهاية الشهر بعناية، فإذا كان الشهر المستهدف أقصر استُخدم آخر يوم صالح فيه بدلا من إنتاج تاريخ غير ممكن.

أعدوا بيانات موثوقة عن المنتج والشراء

ابدؤوا باسم المنتج الدقيق ورقمه التسلسلي كما يظهران على السلعة أو العبوة أو الفاتورة أو سجل الشركة المصنعة. تصبح هذه المعرّفات جزءا من بطاقة الضمان، وتساعد على تمييز الوحدة المشمولة عن غيرها، ولا سيما حين يمتلك العميل عدة منتجات من الطراز نفسه. أدخلوا تاريخ الشراء بالصيغة الواضحة YYYY-MM-DD. فالقيمة 2026-07-25 تعني دائما 25 يوليو 2026 مهما اختلفت عادات عرض التاريخ لدى القارئ. ترفض الأداة الاسم الفارغ والرقم التسلسلي الفارغ والتاريخ سيئ التنسيق وأي يوم غير موجود في التقويم. استخدموا تاريخ المعاملة الأصلي الذي تحدده شروط الضمان، وهو غالبا التاريخ الوارد في إيصال البيع. وإذا بدأت التغطية عند الشحن أو التسليم أو التسجيل أو التفعيل، فلا تقدموا ذلك التاريخ إلا عندما يمثل بداية الضمان المعتمدة فعلا. تعكس النتيجة المعلومات التي ترسلونها، لكنها لا تتحقق بصورة مستقلة من الإيصال أو الملكية أو الأهلية أو سياسة الشركة المصنعة.

افهموا طريقة حساب تاريخ الانتهاء

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

استخدموا البطاقة المنظمة في إجراءاتكم

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

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

تأكيد الشراء للعميل

أنشئوا بطاقة متسقة بعد الدفع ليطّلع المشتري على معرّف المنتج ومدة التغطية وتاريخ الانتهاء المحسوب.

إعداد سجل لخدمة الدعم

احفظوا تفاصيل الضمان المنظمة بجانب الطلب كي يجد الموظفون المنتج والتاريخ من دون إعادة الحساب.

مستند ضمان قابل للطباعة

مرروا الحقول المعادة إلى قالب يحمل الهوية التجارية للطباعة أو PDF مع إبقاء الحساب منفصلا عن العرض.

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

ما تكلفة بطاقة الضمان الواحدة؟

تكلفة كل بطاقة منشأة هي $0.002.

كيف يُعالج التاريخ الواقع في نهاية الشهر؟

يحافظ الحساب على يوم الشراء متى أمكن، وإلا فيستخدم آخر يوم صالح في الشهر المستهدف.

هل يمكن أن تكون مدة الضمان صفرا أو سالبة؟

لا. يجب أن تكون عددا صحيحا موجبا من الأشهر؛ وتؤدي القيم الصفرية أو السالبة أو الكسرية إلى خطأ في المدخلات.

هل تتحقق البطاقة من ضمان الشركة المصنعة؟

لا. تنظم القيم التي تقدمونها وتحسب التاريخ، لكنها لا تتحقق من الأهلية أو التسجيل أو الإيصالات أو الشروط.

ما صيغة التاريخ المطلوبة؟

استخدموا الصيغة YYYY-MM-DD، مثل 2026-07-25. ويجب أن يكون التاريخ موجودا في التقويم الغريغوري.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/doc/warranty-card-generate

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

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

curl -X POST https://api.kit.forhosting.com/doc/warranty-card-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_name":"Aurora Desk Lamp","serial_number":"ADL-2026-00481","purchase_date":"2026-07-25","warranty_duration_months":24}'

const res = await fetch("https://api.kit.forhosting.com/doc/warranty-card-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "product_name": "Aurora Desk Lamp",
    "serial_number": "ADL-2026-00481",
    "purchase_date": "2026-07-25",
    "warranty_duration_months": 24
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/doc/warranty-card-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "product_name": "Aurora Desk Lamp",
    "serial_number": "ADL-2026-00481",
    "purchase_date": "2026-07-25",
    "warranty_duration_months": 24
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/warranty-card-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"product_name":"Aurora Desk Lamp","serial_number":"ADL-2026-00481","purchase_date":"2026-07-25","warranty_duration_months":24}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"product_name":"Aurora Desk Lamp","serial_number":"ADL-2026-00481","purchase_date":"2026-07-25","warranty_duration_months":24}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/warranty-card-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "product_name": "Aurora Desk Lamp",
  "serial_number": "ADL-2026-00481",
  "purchase_date": "2026-07-25",
  "warranty_duration_months": 24
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_mb`	25
`max_pages`	200

الأخطاء

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

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