الانتقال إلى المحتوى الرئيسي

ما هي الأسعار الشاملة للضرائب؟

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

الفوائد الرئيسية

  • وضوح للعملاء: سعر نهائي واحد معروض مسبقًا
  • امتثال حسب المنطقة: يتم حساب الضريبة حسب الموقع ويتم فصلها
  • فواتير دقيقة: تظهر الفواتير المبلغ الصافي والضريبة المشتقة من السعر
  • صديقة للتحويل: تقليل المفاجآت عند الدفع

إعداد المنتج

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

التسعير

  • السعر (مطلوب): السعر الأساسي الذي يتم عرضه للعميل.
  • أسعار شاملة للضرائب: قم بالتبديل لتعتبر السعر المعروض شاملًا للضرائب. سيقوم Dodo بحساب المبلغ الصافي (قبل الضريبة) والجزء الضريبي عند الدفع بناءً على موقع العميل وفئة الضريبة.
تعكس المشتريات المستقبلية فقط إعدادات الأسعار الشاملة للضرائب المحدثة. لا يتم تغيير المشتريات الحالية والاشتراكات النشطة بأثر رجعي.
استخدم نص منتج متسق مثل “شامل للضرائب” حتى يفهم العملاء المجموعات بسرعة.

إدارة واجهة برمجة التطبيقات

استخدم POST /products لإنشاء منتجات مع tax_inclusive تم تعيينها إلى true.

مرجع واجهة برمجة التطبيقات

إنشاء منتج عبر واجهة برمجة التطبيقات
استخدم PATCH /products/{id} لتبديل tax_inclusive على المنتجات الحالية.

مرجع واجهة برمجة التطبيقات

تحديث منتج عبر واجهة برمجة التطبيقات
استخدم POST /checkout-sessions/create لبيع المنتجات المميزة كشاملة للضرائب. يبقى السعر المعروض كما هو؛ تستمد صفحة الدفع المبلغ الصافي والضريبة.

مرجع واجهة برمجة التطبيقات

إنشاء جلسة دفع
استخدم POST /refunds لإصدار استردادات. يمكنك تحديد ما إذا كان الاسترداد شاملًا للضرائب باستخدام علامة tax_inclusive عند الاقتضاء.

مرجع واجهة برمجة التطبيقات

إنشاء استرداد

أمثلة على التكامل

إنشاء منتج بأسعار شاملة للضرائب

const product = await client.products.create({
  name: 'Pro Plan',
  description: 'All features included',
  price: {
    currency: 'USD',
    price: 10000
    tax_inclusive: true
  }
});

تحديث منتج موجود لتبديل شامل للضرائب

await client.products.update(product.id, {
  price: {
    tax_inclusive: true
  }
});

أفضل الممارسات

  • اختر فئة الضريبة الصحيحة لضمان الحساب الصحيح حسب المنطقة.
  • تواصل المجموعات بوضوح مع تسميات “شامل للضرائب” في نص المنتج.
  • اختبر في بيئة الاختبار للتحقق.

ذات صلة