> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# أسعار شاملة للضرائب

> عرض الأسعار النهائية الشاملة للضرائب مسبقًا. يقوم Dodo بحساب الضرائب حسب الموقع ويفصلها بوضوح عند الدفع وعلى الفواتير.

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

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

<Info>
  يظل الضريبة النهائية متغيرة حسب موقع العميل وفئة الضريبة. يظهر Checkout والفواتير الجزء المحسوب من الضريبة المستمد من السعر المعروض.
</Info>

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

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

## إعداد المنتج

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

#### التسعير

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

<Warning>
  تنطبق الإعدادات المحدثة التي تشمل الضريبة فقط على عمليات الشراء المستقبلية. لا يتم تعديل عمليات الشراء الحالية أو الاشتراكات النشطة بأثر رجعي.
</Warning>

<Tip>
  استخدم نصوص منتجات متناسقة مثل “Tax inclusive” حتى يتمكن العملاء من فهم الإجماليات بنظرة سريعة.
</Tip>

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

<AccordionGroup>
  <Accordion title="Create products (tax inclusive)">
    استخدم `POST /products` لإنشاء منتجات مع ضبط `tax_inclusive` إلى `true`.

    <Card title="API Reference" icon="code" href="/api-reference/products/post-products">
      إنشاء منتج عبر واجهة برمجة التطبيقات
    </Card>
  </Accordion>

  <Accordion title="Update products">
    استخدم `PATCH /products/{id}` لتبديل `tax_inclusive` على المنتجات الحالية.

    <Card title="API Reference" icon="code" href="/api-reference/products/patch-products">
      تحديث منتج عبر واجهة برمجة التطبيقات
    </Card>
  </Accordion>

  <Accordion title="Checkout Sessions">
    استخدم `POST /checkouts` لبيع المنتجات المحددة كضريبة شاملة. يظل السعر المعروض كما هو؛ يقوم الدفع بحساب المبلغ الصافي والضريبة.

    <Card title="API Reference" icon="code" href="/api-reference/checkout-sessions/create">
      إنشاء جلسة Checkout
    </Card>
  </Accordion>

  <Accordion title="Refunds (tax handling)">
    استخدم `POST /refunds` لإصدار استردادات. يمكنك تحديد ما إذا كان الاسترداد شاملًا للضريبة باستخدام العلم `tax_inclusive` عند الاقتضاء.

    <Card title="API Reference" icon="code" href="/api-reference/refunds/post-refunds">
      إنشاء استرداد
    </Card>
  </Accordion>
</AccordionGroup>

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

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

```typescript theme={null}
const product = await client.products.create({
  name: 'Pro Plan',
  description: 'All features included',
  tax_category: 'saas',
  price: {
    type: 'one_time_price',
    currency: 'USD',
    price: 10000,
    discount: 0,
    purchasing_power_parity: false,
    tax_inclusive: true
  }
});
```

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

```typescript theme={null}
await client.products.update(product.id, {
  price: {
    tax_inclusive: true
  }
});
```

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

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

## ذات صلة

<CardGroup cols={2}>
  <Card title="Products" icon="dollar-sign" href="/features/products">
    قم بإدارة خيارات التسعير عبر المنتجات.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    تكوين المنتجات المتكررة باستخدام إعدادات متقدمة.
  </Card>

  <Card title="Discount Codes" icon="percent" href="/features/discount-codes">
    عرض العروض الترويجية مع الحفاظ على وضوح الفاتورة.
  </Card>
</CardGroup>