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

حساب تواريخ انتهاء ضمانات متعددة والتنبيه إليها

تحول أداة متابعة الضمان هذه سجل مشترياتكم إلى قائمة عملية بالمواعيد. أدخلوا اسم كل منتج وتاريخ شرائه ومدة ضمانه بالأشهر الكاملة، ثم اختاروا تاريخاً مرجعياً ونافذة للتنبيه.

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

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

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

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

أعدوا سجلاً واضحاً للمشتريات والضمانات

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

افهموا طريقة الحساب بالأشهر التقويمية

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

استعملوا نافذة التنبيه لترتيب الإجراءات

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

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

راجعوا تغطية معدات المكتب

احسبوا مواعيد الحواسيب والشاشات والطابعات والملحقات، وحددوا الضمانات السارية التي تتطلب اهتماماً قبل المراجعة الشهرية التالية.

خططوا للمطالبات والاستبدال المنزلي

اجمعوا الأجهزة المنزلية والإلكترونيات في قائمة واحدة للتحقق من الإيصالات وخيارات الدعم قبل انتهاء التغطية.

ادعموا المشتريات وتدقيق الأصول

أنشئوا لقطة قابلة لإعادة الإنتاج تتضمن تاريخاً مرجعياً وأياماً متبقية وحالة الانتهاء وعلامة موحدة لقرب الموعد.

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

كيف يُحسب تاريخ انتهاء الضمان؟

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

ماذا يحدث إذا كانت مدة الضمان سالبة؟

يفشل الطلب بخطأ إدخال غير صالح، لأن المدة السالبة لا يمكن أن تمثل تغطية مستقبلية.

هل يُعد الضمان المنتهي قريب الانتهاء؟

لا. يُعرض بوصفه منتهياً مع عدد سالب من الأيام المتبقية، وتظل علامة النافذة المستقبلية غير مفعلة.

هل تشمل نافذة التنبيه حديها؟

نعم. يُعلّم الضمان الساري إذا انتهى في التاريخ المرجعي أو بعد عدد الأيام المختار تماماً.

لماذا يجب تقديم تاريخ مرجعي؟

يجعل التاريخ المرجعي الصريح الحساب حتمياً، ويتيح إعادة إنتاج تقارير ماضية أو مستقبلية من دون الاعتماد على الساعة الحالية.

ما كلفة طلب API؟

تبلغ الكلفة $0.002 لكل طلب API. ويمكن لنسخة المتصفح تنفيذ الحساب الحتمي نفسه محلياً.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/final3/warranty-expiration-tracker

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

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

curl -X POST https://api.kit.forhosting.com/final3/warranty-expiration-tracker \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchases":[{"name":"Laptop","purchase_date":"2024-02-29","warranty_months":24},{"name":"Headphones","purchase_date":"2025-08-15","warranty_months":12}],"reference_date":"2026-07-31","within_days":30}'

const res = await fetch("https://api.kit.forhosting.com/final3/warranty-expiration-tracker", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "purchases": [
      {
        "name": "Laptop",
        "purchase_date": "2024-02-29",
        "warranty_months": 24
      },
      {
        "name": "Headphones",
        "purchase_date": "2025-08-15",
        "warranty_months": 12
      }
    ],
    "reference_date": "2026-07-31",
    "within_days": 30
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/warranty-expiration-tracker",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "purchases": [
        {
            "name": "Laptop",
            "purchase_date": "2024-02-29",
            "warranty_months": 24
        },
        {
            "name": "Headphones",
            "purchase_date": "2025-08-15",
            "warranty_months": 12
        }
    ],
    "reference_date": "2026-07-31",
    "within_days": 30
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/warranty-expiration-tracker", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"purchases":[{"name":"Laptop","purchase_date":"2024-02-29","warranty_months":24},{"name":"Headphones","purchase_date":"2025-08-15","warranty_months":12}],"reference_date":"2026-07-31","within_days":30}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"purchases":[{"name":"Laptop","purchase_date":"2024-02-29","warranty_months":24},{"name":"Headphones","purchase_date":"2025-08-15","warranty_months":12}],"reference_date":"2026-07-31","within_days":30}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/warranty-expiration-tracker", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "purchases": [
    {
      "name": "Laptop",
      "purchase_date": "2024-02-29",
      "warranty_months": 24
    },
    {
      "name": "Headphones",
      "purchase_date": "2025-08-15",
      "warranty_months": 12
    }
  ],
  "reference_date": "2026-07-31",
  "within_days": 30
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_items 1000

الأخطاء

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

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