إعداد الرواتب

# تحضير الرواتب

احصل على الساعات الصحيحة قبل أن يتقاضى أي شخص راتبه.

الرواتب هي سير العمل المالي الذي لا يترك مجالاً للخطأ. فاتورة خاطئة تُصحح في الأسبوع القادم. راتب خاطئ هو شخص لا يستطيع دفع الإيجار، وهي أسرع طريقة لصاحب العمل لفقدان فريقه. كل شيء في هذه المهارة مبني حول هذا عدم التوازن: الآلة تجمّع وتتحقق، صاحب العمل يقرر.

## الخطوة 1 — حل مشكلة الفترة قبل أي شيء آخر

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

تأكد من قائمة الموظفين أيضاً: الموظفون الجدد الذين بدأوا في منتصف الفترة، أي شخص تم إنهاء خدمته، أي شخص في إجازة. انظر إلى `reference/timesheet_intake.md`.

## الخطوة 2 — احصل على جداول الوقت

**مع توصيل Gusto**، أولاً اسأل Gusto نفسه ما الذي يعوق الطريق: استدعِ فحص حجب الرواتب فيه (`list_payroll_blockers`) قبل بناء أي شيء. إذا عادت عوائق، ترجم كل واحدة إلى لغة إنجليزية واضحة — ماذا تعني، من يصلحها، وأين. على سبيل المثال: "check payments unsupported" يعني أن هذه الشركة تدفع بشيك ورقي، وهو ما لا يمكن للتكامل أن يرحله، لذا يقوم صاحب العمل بهذا الجزء مباشرة في Gusto؛ "bank account not connected via Plaid" يعني أن صاحب العمل يوصل البنك في إعدادات Gusto؛ "hourly employees unsupported" قد تحجب على مستوى الحساب حتى عندما يكون هذا الدفع برواتب فقط. العوائق هي إشارة توجيه، وليست فشلاً — الدفع بُني وتحقق منه هنا على أي حال، والمُسلَّمة تصبح ورقة الدفع مع قائمة العوائق مرفقة.

ثم احصل على مدخلات الفترة، كل واحدة من أداتها الخاصة. **الساعات:** `list_time_records` لفترة الدفع؛ اقرأ حقل `source` فيه قبل أي شيء آخر. `native` يعيد الورديات مع ساعة البدء والانتهاء والفترات؛ `third_party` يعيد جداول الوقت من شريك تتبع الوقت لدى الشركة، و `get_time_sheet` يعطي بنود السطر لكل يوم من أي واحدة منها (يرفض معرفات الورديات الأصلية)؛ `none` يعني أن Gusto لا يمسك بساعات لهذه الشركة، لذا مسار جدول البيانات أدناه يوفرها. **الإجازات:** `list_time_off_requests` للفترة مع `status: approved` — كل يوم معتمد يُدفع كإجازة أو إجازة مرضية، وليس أبداً كيوم عمل، وطلب معلق هو علم، وليس يوم مدفوع. **الأرصدة:** `get_time_off_balances`، وهو ما يقرأه فحص "PTO beyond available balance" في الخطوة 4. **المعدلات والتصنيفات:** قائمة الموظفين من `list_employees` مع تعويضات كل شخص. تأتي المعدلات من Gusto، وليس من جدول الوقت أبداً. أشكال الاستدعاء لهذه موجودة في `../../shared/connector-call-shapes.md`.

**توقيع مفقود يمكن لصاحب العمل ملؤه.** عندما تُعلِّم الخطوة 4 عن وردية بلا ساعة انتهاء وصاحب العمل يعطي الأوقات الفعلية، `record_time` يكتبها — فقط الأوقات التي ذكرها صاحب العمل، مُعروضة لهم أولاً، وكـ `update` للوردية الموجودة بدلاً من إدخال ثانٍ. المعاملات التي ترفض إذا كانت مفقودة (المنطقة الزمنية، الوظيفة على تتبع Gusto الخاص، معرّف أي عنصر يعتبر الوردية) والفخ الذي يُقرأ مرة أخرى (ساعات العامل المقاول المؤكدة تعود بأوقات توقيع فارغة؛ لا تكتب مرة أخرى) موجودة في صف `record_time` من `../../shared/connector-call-shapes.md`. اقرأ هذا الصف قبل الاستدعاء. هذه هي الطريقة الوحيدة التي تغيّر بها المهارة توقيعاً؛ وقت مفترض لا يُكتب أبداً.

**ثم أثبت أن المصدر يعيد بيانات المصدر قبل أن يتم رحل أي شيء.** احصل على قائمة الموظفين (`list_employees`) والجداول الزمنية (`list_pay_schedules`). شركة تُبلغ عن عدد الموظفين بينما أي من هذه القوائم يعود فارغاً، أو استدعاء حجب يُرجع خطأ بدلاً من الإجابة، هي مصدر رواتب متصل لكن غير مُسلِّم. توقف عن مسار الرحل، قُل ذلك في سطر واحد ("Gusto is connected but returned no employees or pay schedules, so I cannot stage a run against it")، وقدّم مسار جدول البيانات أدناه. لا تبني أبداً دفعة من قائمة موظفين فارغة، ولا تتعامل أبداً مع شارة الاتصال الأخضر كإثبات على أن البيانات موجودة.

**مع توصيل QuickBooks Payroll**، احصل على نفس الحقول من هناك. فشلان مختلفان يبدوان متشابهان هنا، وصاحب العمل يسمعهما بشكل مختلف. **مصدر فارغ** (قوائم Gusto تعود بلا صفوف على شركة تُبلغ عن عدد موظفين) هو فجوة بيانات: قُل ذلك واستخدم ورقة الدفع. **مصدر يناقض نفسه** هو عيب في الأداة: `qbo_payroll_get_company_payroll_readiness` يجيب `has_employees: false` و `run_payroll_ready: false` بينما `qbo_payroll_get_employees` على نفس الشركة يعيد `total_count` من 50 لا يمكن أن يكونا صحيحين معاً. هذا مستقل عن حجم البيانات التي تمتلكها الشركة. عندما يحدث ذلك، استخدم قائمة الموظفين للقائمة (هو الاستدعاء الذي أعاد الصفوف)، لا ترحل دفعة بينما الجاهزية تقول غير جاهز، وقُل كلا الرقمين لصاحب العمل في سطر واحد حتى يكون التناقض مسجلاً بدلاً من أن يكون مخفياً وراء "not ready". ثم خذ مسار جدول البيانات أدناه مع هذه القائمة: ورقة دفع مُتحققة منها يُدخلها صاحب العمل في QuickBooks Payroll هي النتيجة، نفس الشيء بالنسبة لمصدر فارغ. هذا مصدر من الدرجة الأولى، وليس