محاسبة التجارة والمخزون

دورة الفواتير والاشتراكات والاسترداد

• ينشئ customer.upserted عميلًا ضمن الاتصال أو يزامنه بالمراجعات: اسم الفوترة والاتصال والعنوان والهوية الضريبية. لا تُدمج العملاء اليدوية أو غير المرتبطة تلقائيًا.
• تنشئ invoice.created وorder.created وsubscription.renewed فواتير. تطبق invoice.updated وorder.updated مراجعات المسودات المدعومة. تُهمل المراجعات القديمة وتُراجع المتعارضة. تُصحح الفواتير المرحّلة بأحداث دائن صريحة أو تعديلات Ledger المعتمدة دون استبدالها.
• استخدم معرف فاتورة مصدر مستقلًا لكل فترة شهرية أو سنوية. أرسل فواتير التناسب أو تغيير الخطة بالمبالغ الفعلية والفترة المناسبة؛ لا يحسب MeshDex جداول الاشتراك أو الاستحقاقات. تحدّث أحداث إنشاء الاشتراك وتغييره وإلغائه المراجع مع accountingEffect: NONE. إلغاء التجديد المستقبلي لا يرد أو يلغي فترة مدفوعة.
• تلغي invoice.cancelled وorder.cancelled المسودات غير المدفوعة وتحرر الحجوزات غير المنفذة. السجلات المرحّلة أو المدفوعة أو المنفذة تتطلب مسارات دائن أو استرداد أو إرجاع صريحة.
• يتضمن payment.captured الحقول invoiceId وpaymentId وcurrency وamountMinor وpaidAt الاختياري، ويسجل نقدًا محصلًا مؤكدًا في حساب البنك أو التسوية. التفويض والدفعات الفاشلة مراجع فقط.
• يتضمن credit.issued الحقول invoiceId وcreditId وcurrency وamountMinor وtaxMinor وreason وcreditedAt الاختياري. يخفض الإيراد أو الذمم ولا يعيد النقد.
• يتضمن refund.completed الحقول invoiceId وrefundId وcurrency وamountMinor وtaxMinor وreason وcompletedAt ويسجل استرداد البوابة المؤكد والدائن المقابل. أدرج creditId لإعادة استخدام دائن مطابق؛ لا يستهلكه سوى استرداد نقدي مطابق واحد. وإلا يُنشأ دائن منفصل. لا تكرر المعرفات الأثر. أحداث إنشاء الاسترداد أو فشله مراجع فقط.
• تُدعم استردادات جزئية متعددة ضمن النقد المسجل وحدود الدائن والضريبة المتبقية. تستخدم المرتجعات return.received مع orderId وreturnId وlines وqualityApproved؛ الاسترداد المالي لا يعيد المخزون. تنتظر المرتجعات الفحص افتراضيًا، ولا يُعتمد فحص المصدر إلا بسياسة موافقة مصدر موثوق يختارها المسؤول.

التسويات والرسوم والنزاعات

وجّه التحصيل إلى حساب أصل وسيط عندما تودع البوابة صافي النقد لاحقًا. يحدد settlement.completed الحقول settlementId وcurrency وsettlementCurrency وgrossMinor وnetMinor وfeeMinor وfeeTaxMinor وbankAccountId وfeeAccountId وcompletedAt. أرسل entries من نوع RECEIPT أو REFUND مع externalId ثابت وamountMinor. يجب مطابقة كل تحصيل أو استرداد مسجل بدقة، ولا ينتمي إلا لتسوية واحدة. تنتظر التحصيلات المفقودة الاعتماد السابق وتُراجع الدفعات المكررة أو المتعارضة.

الإجمالي هو المقبوضات ناقص الاستردادات. الصافي والرسوم وضريبتها تساوي الإجمالي المحول لعملة التسوية. يلزم للتحويل settlementExchangeRate وsettlementExchangeRateSource وsettlementExchangeRateDate؛ أما exchangeRate فيحوّل عملة الإيداع إلى عملة Ledger الأساسية. تتطلب ضريبة الرسوم حساب أصل ضريبة مدخلات feeTaxAccountId ومرجع feeTaxReference. تحرر التسوية القيمة الدفترية المعتمدة من الوسيط وترحّل الإيداع والرسوم والضريبة وفروق الصرف الصريحة.

يحدد chargeback.opened الحقول chargebackId وpaymentId وcurrency وamountMinor وreason وcompletedAt ويسجل المبلغ المتنازع عليه في حساب ذمم نزاعات مقابل النقد دون إلغاء فاتورة العميل. يتضمن chargeback.reversed الحقول chargebackId وcurrency وcompletedAt لاسترداد النزاع نفسه؛ يلزم سعر النقد الفعلي ومصدره وتاريخه عند العملة الأجنبية. لا تتجاوز النزاعات التراكمية الدفعة المحصلة. تصحيح دفعة تمت تسويتها أو عكسها يتطلب مطابقة التسوية ولا يلغي المقبوض ضمنيًا.

هوية الكتالوج وملكية المخزون

معرفات المنتجات والمتغيرات ثابتة من المصدر؛ SKU والاسم وصف وليسا مفتاحي مطابقة تلقائية. تعيد GET /api/integrations/commerce/v1/catalog/ الربط المعتمد؛ اتبع nextCursor. تحفظ أحداث المنتجات المراجع ولا تستبدل منتجات Ledger أو Supply المعتمدة ولا تنشر المخزون.

اعتمد الربط من الإدارة ← الكتالوج والأحداث. اختر Ledger فقط أو تنفيذًا خارجيًا أو مخزون Supply أو مراجعة Supply. مخزون Supply وحده يحجز تلقائيًا. تستخدم الإتاحة المستودع والحجوزات والاستدعاءات وحالة المخزون ومخزون الأمان المعتمدة. تعيد GET /api/integrations/commerce/v1/availability/?productId=your-source-id&variantId=your-variant-id نطاق الإتاحة أو الكمية الدقيقة المهيأة.

ينفذ fulfillment.completed الحجز الكامل القائم مرة واحدة. التنفيذ الجزئي أو تغيير البنود المحجوزة يتطلب مراجعة مخزون. لا يتجاوز return.received الكمية المنفذة ويستخدم موقع الإرجاع المعتمد. نشر Supply للقنوات خاص بموصلات مُدارة مفعلة منفصلًا؛ هذا العقد لا يدّعي توفر Shopify أو WooCommerce.

الاختبار والاستيراد التاريخي والمطابقة

1. ابدأ باتصال اختبار مستقل. يتحقق من البيانات والإعداد والربط والضريبة ويسجل TEST_VALIDATED دون ترحيل عملاء أو فواتير أو نقد أو دائن أو مخزون حي.
2. تتحقق POST /api/integrations/commerce/v1/batches/ مع events كمصفوفة JSON وdryRun: true من الدفعة. أضف historical: true لحفظ معاينة بإجماليات العملات وعناصر المراجعة وبصمة الموافقة؛ تبقى معاينة حتى مع dryRun: false.
3. في الإدارة ← المطابقة والاستيراد، طابق العملاء والفواتير اليدوية الموجودة أولًا. أدخل معرفات المصدر وLedger الدقيقة وسبب التدقيق. تفحص مطابقة الفاتورة العميل والعملة والإجمالي الأصلي مقابل لقطة مصدر الإصدار 2. مزامنة بيانات العميل تحتاج تحديدًا صريحًا منفصلًا.
4. راجع إجماليات المصدر وكل عناصر المراجعة. يتطلب التطبيق إدارة مخولة واتصالًا حيًا نشطًا وبصمة المعاينة الدقيقة وسببًا. توضع 25 واقعة كحد أقصى في الطابور لكل إجراء؛ يواصل استئناف الاستيراد من نقطة التوقف. اكتمال الطابور لا يعني اكتمال المحاسبة.
5. افحص نتائج الأحداث والمطابقة بعد المعالجة. إعادة التطبيق أو استئنافه تستخدم الإيصالات الموجودة. عالج الربط والاعتمادات المفقودة أولًا. الدفعة المتغيرة تحتاج معاينة جديدة؛ لا تستبدل قيم دفعات أو استردادات غير قابلة للتغيير.

إيرادات الخدمات المؤجلة الاختيارية

يمكن للمحاسب اختيار التأجيل على فترة الخدمة وحساب التزام مؤجل معتمد لاتصال SaaS ضمن التوجيه المحاسبي. تستخدم الفواتير الجديدة تواريخ خدمة المصدر؛ تغيير السياسة لا يعيد كتابة الفواتير والجداول المعتمدة.

يؤجَّل صافي إيراد الخدمة فقط، وتبقى الضريبة والنقد منفصلين. يُعترف يوميًا بالقسط الثابت باستخدام تواريخ UTC ونهاية غير شاملة. يغلق اليوم الأخير فرق التقريب. تدعم السياسة التزام خدمة واحدًا لكل فاتورة.

1. أرسل هوية الاشتراك وفترة الخدمة الشهرية أو السنوية الصريحة مع كل فاتورة. اعتمد حسابات الإيراد والالتزام المؤجل قبل الترحيل.
2. في المطابقة والاستيراد افتح إيرادات الخدمات المؤجلة واختر الفاتورة وتاريخ الخدمة المكتملة ثم عاين المكتسب والمتبقي.
3. أدخل سبب الموافقة واعتمد المعاينة الدقيقة. أكمل الموافقات المستقلة المطلوبة في Ledger قبل ترحيل قيد الاعتراف المجهز.
4. حدّث بعد الدائن أو تعديل الفاتورة وراجع معاينة جديدة. لا تستبدل موافقة قديمة الجدول الحالي؛ تستعيد الطلبات المتكررة القيد الموجود.

• تقلل الإشعارات الدائنة الإيراد المكتسب وغير المكتسب بالقيمة الدفترية الأصلية. يغلق الدائن الكامل الجدول؛ عكس الفاتورة غير المدفوعة يتبع مسار الفاتورة المعتمد.
• لا تعدّل أو تلغِ قيود الاعتراف منفصلة عن فاتورتها. عكس فاتورة دائنة يتطلب مراجعة محاسبية.
• يبدأ المحاسب الاعتراف؛ لا ينشئ فواتير تجديد ولا يغيّر الاستحقاقات ولا يرسل استردادات بوابة.

أدلة ذات صلة

• تكاملات التجارة
• الإعداد المشترك للتجارة
• تكامل API مخصص
• تكامل Shopify
• تكامل WordPress وWooCommerce