حاسبة الساعات القابلة للفوترة

تشغّل الحسابات الحتمية ذاتها ودجة المتصفح المجانية وواجهة API، فيطابق الفحص في الصفحة أتمتة لاحقة. تُفوتر الاستدعاءات الناجحة بسعر $0.002؛ ولا تُحاسب المدخلات غير الصالحة.

ما الساعات القابلة للفوترة وكيف يتكوّن إجمالي الفاتورة

الساعات القابلة للفوترة هي الساعات التي يدفعها العميل فعلًا: زمن المهمة ناقص الشطب والتدريب والإدارة الداخلية والمجاملة التي تقررون ألا تفوتروها. مثال: أربعون ساعة معمولة بأجر مئة وخمسين في الساعة مع ساعتين مشطوبتين تعادل ثمانيًا وثلاثين ساعة قابلة للفوترة وإجمالي فاتورة خمسة آلاف وسبعمئة. أجر الساعة الصفري مسموح وينتج فاتورة صفر، وهو تمثيل سطر مجاملة أو عمل مجاني دون اختراع صيغة أخرى. لا يجوز أن تتجاوز الساعات غير القابلة للفوترة الساعات المعمولة، لأن ذلك سيختلق زمنًا قابلًا للفوترة سالبًا. يجوز أن تكون الساعات كسرية (سبع وربع ساعة جدول وقت صالح بربع الساعة)، وتُقرَّب حقول المال نصفًا إلى أعلى إلى منزلتين عشريتين حتى يطابق إجمالي الفاتورة العملة المعتادة. الهوية طرح واحد وضرب واحد. hours_worked هو كل ما سُجّل في جدول الوقت أو ساعة المهمة، بما فيه الزمن الذي قد تعلّمون لاحقًا أنه غير قابل للفوترة. non_billable_hours هو الشريحة التي يجب أن تبقى خارج الفاتورة. اطرحوا تلك الشريحة من الساعات المعمولة فتحصلون على billable_hours. اضربوا الساعات القابلة للفوترة في hourly_rate فتحصلون على invoice_total، وهو المبلغ الذي تعيده هذه الحاسبة نتيجةً أولى ثم مرة أخرى باسم amount حتى يربط لوحة التحكم أيًا من المفتاحين. عندما يُحذف non_billable_hours يُعامل صفرًا، فأسبوع نظيف من ثماني ساعات بأجر خمسة وسبعين في الساعة يفوتر ستمئة بلا شطب. أجر الساعة السالب ليس خصمًا ولا إشعار دائن: يُرفض بـ invalid_input حتى لا يصدر خطأ كتابة فاتورة بإشارة يسجّلها دفتر لاحق استردادًا. تعيد سلسلة الصيغة في الاستجابة أن invoice_total يساوي hours_worked ناقص non_billable_hours مضروبًا في hourly_rate، فيطبع المراجع الهوية بجانب الرقم دون إعادة بنائها.

عقد الإدخال وشكل الاستجابة وسلوك الخطأ

مثال: ساعات معمولة سبعة نقطة اثنان خمسة، أجر الساعة خمسة وثمانون نقطة خمسة، غير قابلة للفوترة صفر نقطة اثنان خمسة تنتج سبع ساعات قابلة للفوترة وإجمالي فاتورة خمسمئة وثمانية وتسعين نقطة خمسة. فضّلوا الأرقام العارية على السلاسل المنسّقة؛ لا تُحلَّل علامات العملة ولا فواصل الآلاف ولا تسميات الوحدة في النهاية. لا يطبّق هذا الطرف ضريبة مبيعات ولا دفعات مقدمة ولا مضاعفات وقت إضافي ولا تحويل عملة، ولا يصدر فاتورة PDF. اقرنوا النتيجة بخطوتكم الضريبية أو الوثائقية إن احتجتم فاتورة مقدَّمة. أرسلوا جسم JSON برقمين محدودين مطلوبين ورقم محدود اختياري، كلها بالعملة نفسها ونافذة الفوترة نفسها. hours_worked هو الزمن الإجمالي المسجّل ويجب أن يكون أكبر من الصفر أو مساويًا له؛ تُقبل الأسماء البديلة hours وtotal_hours وtime_worked وworked_hours حتى لا تحتاج صادرات جدول الوقت خطوة إعادة تسمية. hourly_rate هو الأجر القابل للفوترة لكل ساعة ويجب أن يكون أكبر من الصفر أو مساويًا له؛ تُقبل الأسماء البديلة rate وrate_per_hour وbill_rate وhourly. يفشل أجر الساعة السالب بـ invalid_input مع تسمية hourly_rate ولا يُفوتر. non_billable_hours اختياري ويساوي صفرًا افتراضيًا ويجب أن يكون أكبر من الصفر أو مساويًا له وألا يتجاوز hours_worked؛ تُقبل الأسماء البديلة nonbillable_hours وunpaid_hours وwrite_off_hours وnon_billable. يجوز أن يصل كل حقل عددًا JSON أو سلسلة رقمية تطابق نمطًا عشريًا محدودًا صارمًا. الحقول المطلوبة الناقصة والسلاسل الفارغة والقيم غير المحدودة والساعات فوق المليون أو أجر فوق المليار تفشل بـ invalid_input مع تسمية الحقل. عند النجاح يعيد الجسم hours_worked وhourly_rate وnon_billable_hours مقربة، ويعيد billable_hours فرقًا بينهما، ويعيد invoice_total وamount حاصل الضرب نفسه بمنزلتين مع تقريب نصف إلى أعلى، ويتضمن سلسلة صيغة يمكنكم طبعها بجانب الأرقام. سعر العنصر الناجح مبلغ ثابت $0.002.

أين تبرر حاسبة الساعات القابلة للفوترة مكانها

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