ملفات مدفوعات Stripe Marketplace لا تشبه ملفات تصدير المدفوعات العادية في Stripe. حركة الأموال تعود إلى المنصة، لكن النشاط موزَّع على حسابات مرتبطة متعددة. إيداع بنكي واحد قد يرتبط بعشرات البائعين، والرسوم، والاستردادات، وعمليات العكس، والتحويلات، وفوارق التوقيت.
هنا يبدأ دفتر الأستاذ في الانحراف.
ملف المدفوعات يقول إن Stripe حوّل أموالاً للخارج. دفتر الأستاذ يقول أيّ بائع أو حساب داخلي يستحق هذا القيد. هذان الملفان يجيبان على أسئلة مختلفة. المقارنة سطراً بسطر ستنتج فوارق وهمية حتى حين يكون الملفان صحيحَين.
المطابقة يجب أن تثبت ثلاثة أشياء:
- أي حساب مرتبط أنشأ كل حركة دفع
- أي حساب في دفتر الأستاذ يحمل هذه الحركة داخلياً
- أي فوارق متوقعة بسبب رسوم، أو استردادات، أو تجميدات، أو فوارق توقيت
مطابقة ملفات مدفوعات Stripe Marketplace مع دفاتر الأستاذ ليست بحثاً عن معرّف مشترك. هي مطابقة طبقة بطبقة — من الدفعة إلى الحساب المرتبط، ثم إلى حساب دفتر الأستاذ — مع عزل الاستثناءات قبل اعتماد التقرير النهائي.
ابدأ بالتمييز بين ملف المدفوعات ودفتر الأستاذ
ملف مدفوعات Stripe Marketplace يحتوي عادةً على بيانات حركات: ما دفعه Stripe، أو عكسه، أو عدَّله، أو جمَّده. دفتر الأستاذ الداخلي يحتوي عادةً على بيانات ملكية: أي بائع، أو مورّد، أو حساب فرعي، أو محفظة، أو رصيد داخلي يستحق الأموال.
هذان الملفان يتقاطعان، لكنهما ليسا بديلَين عن بعضهما.
| حقل ملف مدفوعات Stripe | حقل دفتر الأستاذ الداخلي | ما الذي يثبته |
|---|---|---|
payout_id | مرجع دفعة المدفوعات | إلى أي دفعة ينتمي هذا السطر |
connected_account_id | معرّف حساب البائع / معرّف المورّد | أي حساب يملك النشاط |
balance_transaction_id | مرجع المعاملة | أي حركة في Stripe أنشأت هذا السطر |
amount | المبلغ الإجمالي أو المبلغ المستحق | القيمة قبل الخصومات أو بعدها |
fee | رسوم المنصة / رسوم المعالجة | الخصم المطبَّق على الحركة |
net | التسوية الصافية | الأثر النقدي بعد الرسوم |
available_on | تاريخ التسوية المتوقع | متى أصبحت الأموال متاحة |
type | نوع القيد في دفتر الأستاذ | ما إذا كان السطر رسماً، أو استرداداً، أو تحويلاً، أو عمولةً، أو تعديلاً، أو تجميداً |
الخطأ الأول: معاملة amount في كلا الملفَّين كنوع واحد من المبالغ. ليس الأمر كذلك دائماً.
في ملف Stripe، قد يصف amount الرسم الإجمالي، أو التحويل إلى حساب مرتبط، أو استرداداً سالباً، أو حركة دفع. في دفتر الأستاذ، قد يصف المبلغ المستحق للبائع، أو إيرادات المنصة، أو النقد الصافي، أو التغيير في الرصيد الداخلي. الأرقام قد تكون مترابطة دون أن تتساوى.
قبل أي مطابقة، ضع تسمية لأساس المبلغ في كلا الملفَّين: رسم إجمالي، أو رسوم منصة، أو رسوم معالجة، أو تحويل إلى حساب مرتبط، أو صافي الدفعة، أو استرداد، أو عملية عكس، أو احتياطي، أو تجميد. إذا لم يكن أساس المبلغ واضحاً، ستبدو المطابقة خاطئة لاحقاً. ستقارن مبلغاً مستحقاً للبائع بصافي دفعة وتسمّيه فارقاً غير مفسَّر، رغم أنه ببساطة رسوم المنصة أو رسوم المعالجة.
ابنِ المطابقة حول الحساب المرتبط
الحساب المرتبط هو نقطة التحكم. السطر البنكي يؤكد أن Stripe دفع أموالاً، لكنه لا يثبت أي البائعين كانوا مدرجين في هذه الدفعة، ولا ما إذا كان رصيد دفتر الأستاذ لكل بائع صحيحاً.
استخدم هذا الترتيب في أدلة المطابقة:
| طبقة المطابقة | الجانب في Stripe | الجانب في دفتر الأستاذ | الغرض |
|---|---|---|---|
| دفعة المدفوعات | payout_id أو تاريخ الدفعة | معرّف الدفعة أو دورة التسوية | يجمع الأسطر في حركة نقدية واحدة |
| الحساب المرتبط | connected_account_id | معرّف البائع / المورّد / الحساب | يسند كل سطر إلى صاحبه الصحيح |
| مرجع المعاملة | balance_transaction_id، معرّف الرسم، معرّف التحويل | مرجع الدفع أو الطلب أو دفتر الأستاذ | يثبت هوية السطر |
| أساس المبلغ | إجمالي، رسوم، صافي، تحويل | مستحق، رسوم، إيرادات، نقد | يمنع المقارنة بين مبالغ غير متجانسة |
| نافذة التاريخ | created، available_on، تاريخ الدفعة | تاريخ المعاملة، تاريخ دفتر الأستاذ، تاريخ التسوية | يفصل فوارق التوقيت عن الأسطر الغائبة |
لا تبدأ بمبلغ الدفعة. هو مجمَّع أكثر مما ينبغي.
ابدأ بالحساب المرتبط. اجمع أسطر Stripe لهذا الحساب. قارنها بدفتر أستاذ الحساب. حين تُغلق كل حساب، انتقل بالنتائج إلى دفعة المدفوعات الإجمالية.
هذا الترتيب يجعل المطابقة قابلة للقراءة. إذا كانت المنصة تعاني من عجز بقيمة 3,842.18، تريد أن تعرف أن الحساب المرتبط acct_72K يفتقد سطرَي استرداد، وأن acct_91P لديه تجميد احتياطي، وأن بقية دفعة المدفوعات سليمة.
لسير العمل المعتاد من الدفعة إلى البنك، المشكلة المجاورة هي مطابقة CSV مدفوعات Stripe مع كشف حسابك البنكي. العمل على مدفوعات marketplace يضيف طبقة لأن الدفعة يجب أن ترتبط بملكية الحساب، لا بالنقد المستلم فحسب.
وحِّد الملفَّين دون تعديل المصادر
لا تعدِّل ملفات التصدير الأصلية. أنشئ أعمدة عمل بجانبها.
هذه الأعمدة تجعل الملفَّين قابلَين للمقارنة مع الحفاظ على القيم الخام الواردة من Stripe ومن دفتر الأستاذ الداخلي.
| عمود العمل | المصدر في Stripe | المصدر في دفتر الأستاذ | لماذا يهم |
|---|---|---|---|
normalized_account_id | connected_account_id | معرّف البائع، المورّد، المحفظة | يوحّد تسميات الحسابات |
normalized_reference | معرّف الرسم، التحويل، أو معاملة الرصيد | معرّف الطلب، مرجع الدفع، مرجع دفتر الأستاذ | ينشئ مرشحات مطابقة على مستوى السطر |
signed_amount | المبلغ، الرسوم، الصافي مع الحفاظ على الإشارة | مبلغ المدين أو الدائن مع توحيد الإشارة | يمنع قلب الديون والدائنيات |
amount_basis | النوع وفئة إعداد التقارير | حساب دفتر الأستاذ أو نوع المعاملة | يزيل الخلط بين الإجمالي والصافي |
settlement_window | تاريخ الإنشاء، الإتاحة، الدفعة | تاريخ الترحيل أو التسوية | يضبط فوارق التوقيت |
currency | عمود العملة | عملة دفتر الأستاذ | يمنع المطابقة الوهمية بين عملات مختلفة |
بالنسبة لـ normalized_reference، الصيغة الأساسية هي:
=TRIM(SUBSTITUTE(UPPER(A2),CHAR(160)," "))العمود A هو حقل المرجع — معرّف معاملة الرصيد، معرّف الرسم، معرّف التحويل، أو مرجع دفتر الأستاذ الداخلي. تزيل TRIM المسافات العادية؛ وتغطي CHAR(160) مسافة عدم الانقطاع التي تُصدِّرها بعض الأنظمة. إن كان دفتر الأستاذ يخزّن جزءاً فقط من مرجع Stripe، استخرج القيمة بـ MID أو RIGHT قبل التوحيد.
العمود المساعد الأهم هو amount_basis.
بدونه، قد تعيد دالة البحث مطابقة متقاربة رياضياً لكنها خاطئة مفاهيمياً. تحويل بقيمة 100.00 إلى بائع ورسم إجمالي من عميل بقيمة 100.00 ليسا السجل نفسه. القيم المتطابقة لا تثبت الهوية حين تختلف أنواع المعاملات.
الحكم ذاته ينطبق على الإشارات. قد يُصدِّر Stripe الاستردادات وعمليات العكس والرسوم كقيم سالبة. قد يخزّن دفتر الأستاذ الحركة الاقتصادية ذاتها كمدين في عمود أو كرقم موجب في عمود مصروفات. وحِّد الإشارة للمقارنة، لكن أبقِ الإشارة الأصلية ظاهرة في التقرير.
طابِق كل حساب مرتبط قبل المطابقة الإجمالية للدفعة
المنهجية الصحيحة: الحساب أولاً، ثم الدفعة.
لنفترض أن ملف مدفوعات Stripe يحتوي على هذا:
| معرّف الدفعة | الحساب المرتبط | النوع | المرجع | الإجمالي | الرسوم | الصافي |
|---|---|---|---|---|---|---|
| po_8841 | acct_A | تحويل | tr_1001 | 500.00 | -20.00 | 480.00 |
| po_8841 | acct_A | استرداد | re_1008 | -75.00 | 0.00 | -75.00 |
| po_8841 | acct_B | تحويل | tr_1002 | 900.00 | -36.00 | 864.00 |
| po_8841 | acct_C | تجميد احتياطي | adj_4421 | -120.00 | 0.00 | -120.00 |
ودفتر الأستاذ الداخلي قد يُظهر هذا:
| حساب دفتر الأستاذ | المرجع | حركة الحساب | رسوم المنصة | حالة التسوية |
|---|---|---|---|---|
| البائع A | tr_1001 | 480.00 | 20.00 | مسوَّى |
| البائع A | re_1008 | -75.00 | 0.00 | مسترَدّ |
| البائع B | tr_1002 | 864.00 | 36.00 | مسوَّى |
| البائع C | adj_4421 | 0.00 | 0.00 | مجمَّد |
إذا قارنت مجموع الدفعة أولاً، يبدو التجميد الاحتياطي دفعةً مفقودة. إذا قارنت كل حساب مرتبط أولاً، البائع C ليس مفقوداً. دفتر الأستاذ صنَّف السطر كمجمَّد لا كمسوَّى.
هذا الفارق يغير الإجابة النهائية.
التقرير لا يجب أن يقول:
البائع C يعاني من عجز بقيمة 120.00.
يجب أن يقول:
لدى البائع C تجميد احتياطي بقيمة 120.00 في Stripe، غير مستحق الدفع في التسوية الحالية لدفتر الأستاذ.
هذه ملاحظة مطابقة قابلة للاستخدام. تخبر المشغّل بما حدث وما يجب فعله بعد ذلك.
ابدأ بمرشحات المطابقة ثم انتقل إلى المطابقات المؤكَّدة
ملفات marketplace غالباً لا تمنحك مفتاحاً مثالياً مشتركاً عبر جميع الملفات. النشاط ذاته قد يظهر كمعرّف رسم في تصدير، ومعرّف تحويل في آخر، ومرجع طلب في دفتر الأستاذ.
ابدأ بمرشحات المطابقة.
| قاعدة المطابقة المرشَّحة | متى تستخدمها | الخطر |
|---|---|---|
| مطابقة مرجع دقيقة | معرّف الرسم أو التحويل أو معاملة الرصيد نفسه يظهر في كلا الملفَّين | منخفض |
| حساب مرتبط + جزء من المرجع | دفتر الأستاذ يخزّن جزءاً فقط من مرجع Stripe | متوسط |
| حساب مرتبط + مبلغ + نافذة تاريخ | المرجع غائب لكن المبلغ والتوقيت متوافقان | متوسط |
| حساب مرتبط + معرّف طلب + مبلغ | دفتر الأستاذ يتتبع الطلب لا حركة Stripe | متوسط |
| مطابقة على المبلغ فقط | لا مرجع موثوق متاح | مرتفع |
مرشحات المطابقة ليست نهائية. هي قائمة مختصرة للتحقق منها.
المطابقة المؤكَّدة يجب أن تجتاز هذه التحقيقات:
- الحساب المرتبط متوافق.
- نوع المعاملة أو أساس المبلغ متوافق.
- المبلغ بإشارته متوافق بعد فهم معالجة الرسوم.
- التاريخ يقع ضمن نافذة التسوية المتوقعة.
- العملة متوافقة.
- السطر لم يُطابَق بعد مع قيد آخر في دفتر الأستاذ.
هذه النقطة الأخيرة مهمة. تصديرات marketplace قد تحتوي على قيم متكررة. إذا سمح نظام المطابقة لسطر Stripe واحد بمطابقة سطرَين في دفتر الأستاذ، ستتوازن المطابقة على الورق مع إخفاء تكرار.
افصل الرسوم والاستردادات والتجميدات وفوارق التوقيت
قائمة الاستثناءات لا يجب أن تكون حاوية واحدة باسم "غير مطابَق."
تلك الحاوية مبهمة لإغلاقها. تخلط أخطاءً حقيقية مع سلوك متوقع من marketplace.
استخدم فئات استثناءات تصف السبب الفعلي:
| فئة الاستثناء | المعنى | الإجراء |
|---|---|---|
| غائب من دفتر الأستاذ | سطر Stripe موجود لكن لا قيد في دفتر الأستاذ | إضافة قيد دفتر الأستاذ أو التحقيق فيه |
| غائب من ملف Stripe | قيد دفتر الأستاذ موجود لكن لا سطر في Stripe | التحقق من فلاتر التاريخ أو نطاق التصدير أو الإدخال اليدوي |
| تعارض في الحساب | المرجع موجود لكن الحساب المرتبط مختلف | مراجعة تعيين البائعين |
| تعارض في أساس المبلغ | النشاط نفسه، نوع مبلغ مختلف تمت مقارنته | إعادة تصنيف الإجمالي أو الرسوم أو الصافي أو المبلغ المستحق |
| فارق في الرسوم | رسوم المنصة أو المعالجة غير متوافقة | التحقق من قواعد ترحيل الرسوم |
| توقيت استرداد أو عملية عكس | الحركة السالبة مرتبطة بمعاملة سابقة | الربط بالنشاط الأصلي |
| احتياطي أو تجميد | Stripe أجّل الدفعة بدلاً من الدفع للبائع | الترحيل إلى دورة التسوية التالية |
| فارق في التاريخ | السطر ذاته، تاريخ ترحيل أو دفعة مختلف | تصنيفه كفارق توقيت لا كسطر مفقود |
| قيد مكرر في دفتر الأستاذ | سطر Stripe واحد يطابق قيوداً متعددة في دفتر الأستاذ | إزالة المكرر أو عكسه |
الاستردادات وعمليات العكس تستحق معالجة خاصة. الاسترداد قد ينتمي إلى رسم من فترة سابقة لكنه يظهر في الدفعة الحالية. إذا كان دفتر الأستاذ يحتوي على طلبات الفترة الحالية فقط، سيبدو الاسترداد غير مطابَق. الحل ليس إدراج الاسترداد في قائمة المبيعات الحالية. الحل هو تحديد الرسم الأصلي، وتسجيل الاسترداد في الحساب الصحيح، وإظهار أن الدفعة الحالية انخفضت بمقدار هذا الاسترداد.
الاشتراكات تضيف مشكلة توقيت مماثلة حين تقع الفواتير والمدفوعات وتسوية الدفعة في فترات مختلفة. إذا كانت الفواتير المتكررة جزءاً من تدفق marketplace، تنطبق هنا الانضباطية ذاتها في التواريخ المستخدمة في مطابقة فواتير اشتراك Stripe: تاريخ الفاتورة، وتاريخ الدفع، وتاريخ الإتاحة، وتاريخ الدفعة حقول منفصلة.
أغلق دفعة المدفوعات بعد إتمام المطابقة على مستوى الحسابات
حين تُطابَق كل حساب مرتبط، دمِّج النتائج في ملخص الدفعة.
الملخص يجب أن يجيب على أربعة أسئلة:
- هل يتوافق مجموع دفعة Stripe مع الإيداع البنكي أو الحركة النقدية؟
- هل يتوافق نشاط Stripe لكل حساب مرتبط مع دفتر الأستاذ الداخلي؟
- هل الرسوم والاستردادات والتجميدات وفوارق التوقيت مفصولة عن الأخطاء الحقيقية؟
- هل الفارق غير المفسَّر المتبقي صفر؟
ملخص دفعة مفيد يبدو هكذا:
| الفئة | العدد | المبلغ |
|---|---|---|
| تحويلات الحسابات المرتبطة المطابَقة | 82 | 48,210.00 |
| رسوم المنصة المطابَقة | 82 | -1,928.40 |
| الاستردادات وعمليات العكس المطابَقة | 9 | -1,144.20 |
| التجميدات الاحتياطية المرحَّلة | 3 | -640.00 |
| القيود الغائبة من دفتر الأستاذ | 2 | -318.75 |
| القيود المكررة في دفتر الأستاذ | 1 | 120.00 |
| الفارق غير المفسَّر بعد المراجعة | 0 | 0.00 |
التسميات الدقيقة تعتمد على marketplace الخاص بك، لكن البنية لا يجب أن تتغير. النشاط المطابَق، والفوارق المتوقعة، والاستثناءات الحقيقية في أسطر منفصلة.
يجب أن يتضمن التقرير النهائي أيضاً جدول استثناءات على مستوى الحسابات:
| الحساب المرتبط | المشكلة | المبلغ | الدليل | الإجراء |
|---|---|---|---|---|
| acct_A | استرداد غائب من دفتر الأستاذ | -75.00 | استرداد Stripe re_1008 | تسجيل الاسترداد في حساب البائع A |
| acct_C | تجميد احتياطي | -120.00 | تعديل Stripe adj_4421 | الترحيل حتى الإفراج |
| acct_D | تحويل مكرر في دفتر الأستاذ | 120.00 | سطران في دفتر الأستاذ يطابقان tr_4410 | عكس المكرر |
هذا الجدول هو ما يمكن للمشغّل استخدامه. يُشير إلى أسطر وحسابات وأدلة وإجراءات. جدول بيانات مُسلَّط الضوء عليه بلا هذا البنية يُبقي السؤال مفتوحاً.
ما تثبته مطابقة marketplace الصحيحة
مطابقة مدفوعات marketplace المكتملة لا تثبت أن كل رقم في كل ملف متطابق. تثبت أن كل فارق له تسمية صحيحة.
دفعة المنصة قد تختلف عن مبيعات marketplace الإجمالية لأن تحويلات البائعين والرسوم والاستردادات والنزاعات والتجميدات وتوقيت الدفعة كلها تقع بين البيع وحركة النقد. قد يختلف دفتر الأستاذ للحسابات المرتبطة عن ملف المدفوعات لأن بعض الأسطر لم تصبح مستحقة بعد، أو تنتمي إلى معاملات فترات سابقة، أو رُحِّلت بمرجع مختلف.
الناتج الصحيح يجب أن يقول:
- هذه دفعة المدفوعات تتوافق مع النقد.
- هذه الحسابات المرتبطة طُوبقت بنجاح.
- هذه الأسطر فوارق توقيت أو تجميدات أو استردادات أو رسوم متوقعة.
- هذه الأسطر تتطلب تصحيحاً في دفتر الأستاذ.
- الفارق غير المفسَّر المتبقي صفر، أو محصور في أسطر بعينها.
هذا هو المعيار المطلوب قبل إغلاق المطابقة.
قائمة التحقق قبل إغلاق الملف
قبل تسليم تقرير الدفعة، تأكد من تحديد الدفعة، وتعيين معرّفات الحسابات المرتبطة إلى حسابات دفتر الأستاذ، ووضع تسمية لأساس المبلغ في كلا الملفَّين، وعدم خلط الأسطر الإجمالية بالصافية، وفصل الاستردادات والتجميدات، وحذف المطابقات المكررة، وإدراج أسطر دفتر الأستاذ الغائبة فعلاً مع مراجعها.
الترتيب هو المفتاح. المطابقة على مستوى الحسابات تسبق الراحة على مستوى الدفعة. إذا توافق مجموع الدفعة لكن أرصدة الحسابات المرتبطة لم تتوافق، المطابقة لم تنتهِ. إذا أُغلق كل حساب مرتبط لكن دفعة المدفوعات لم تتوافق مع النقد، الحركة النقدية النهائية لا تزال بحاجة إلى مراجعة.
ملف مدفوعات marketplace يحمل معلومات أكثر مما تتحمله معادلة بحث واحدة. عامله كمطابقة منهجية: حدِّد الدفعة، عيِّن الحسابات المرتبطة، طابِق الأسطر، صنِّف الفوارق المتوقعة، ثم دمِّج النتيجة في تقرير يشرح الدفعة بدلاً من إخفائها.
