إدارة الملف الشخصي للمؤسسة

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

تقدّم الأقسام التالية الملف الشخصي للمؤسسة وتوضّح كيفية إدارته باستخدام واجهة المستخدم وAPI.

لمحة عن الملف الشخصي للمؤسسة

في إطار الإعداد الأولي لتحقيق الربح، يُعِدّ فريق إعداد Apigee Edge الملف الشخصي لمؤسستك.

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

يمكنك ضبط المعلومات الأساسية حول مؤسستك، بما في ذلك:

  • اسم المؤسسة وعنوانها وبلد العمل
  • نوع الفوترة (الدفع المسبق أو الدفع عند الاستخدام أو كلاهما)، كما هو موضّح في مقالة فهم نوع الفوترة.
  • دورة الفوترة (مقسمة بالتناسب أو شهر تقويمي)
  • العملة الأساسية
  • النموذج الضريبي الذي تستخدمه مؤسستك

يمكنك إدارة الملف الشخصي لمؤسستك باستخدام واجهة المستخدم وAPI، كما هو موضّح في الأقسام التالية.

الاطّلاع على صفحة "الملف الشخصي للمؤسسة"

ادخل إلى صفحة "الملف الشخصي للمؤسسة"، كما هو موضّح أدناه.

Edge

للوصول إلى صفحة "الملف الشخصي للمؤسسة" باستخدام واجهة مستخدم Edge:

  1. سجِّل الدخول إلى apigee.com/edge.
  2. اختيار النشر > تحقيق الربح المادي > الملف الشخصي للمؤسسة في شريط التنقّل الأيمن

سيتم عرض صفحة "الملف الشخصي للمؤسسة".

كما هو موضح في الشكل، تتيح لك صفحة "الملف الشخصي للمؤسسة" ما يلي:

  • عرض الإعدادات الحالية للملف الشخصي للمؤسسة
  • عدِّل إعدادات الملف الشخصي للمؤسسة، بما في ذلك:

كلاسيكي Edge (السحابة الإلكترونية الخاصة)

للوصول إلى صفحة "الملف الشخصي للمؤسسة" باستخدام واجهة مستخدم Edge الكلاسيكي:

  1. سجِّل الدخول إلى http://ms-ip:9000، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.
  2. اختَر المشرف > الملف الشخصي للمؤسسة في شريط التنقّل العلوي.

سيتم عرض صفحة "الملف الشخصي للمؤسسة".

تتيح لك صفحة "الملف الشخصي للمؤسسة" ما يلي:

  • عرض الإعدادات الحالية للملف الشخصي للمؤسسة
  • عدِّل إعدادات الملف الشخصي للمؤسسة، بما في ذلك:

تعديل الملف الشخصي للمؤسسة باستخدام واجهة المستخدم

لتعديل الملف الشخصي للمؤسسة باستخدام واجهة المستخدم:

  1. انتقِل إلى صفحة الملف الشخصي للمؤسسة.
  2. انقر على تعديل.
  3. ضمن الاسم والمعلومات، عدِّل اسم المؤسسة وبلد العملية.
  4. ضمن الضرائب والعملة، عدِّل الحقول التالية:
    الحقل الوصف
    النموذج الضريبي

    ملاحظة: لا ينطبق هذا الإجراء إلا في حال إعداد خطط معدّلات مشاركة الأرباح وكنت تريد إنشاء مستندات الفوترة.

    نموذج ضريبي لخطط معدّل مشاركة الأرباح، ويحدّد نوع مستندات الفوترة المطلوبة

    وتشمل القيم الصالحة ما يلي:

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

    العملات التي توفّرها مؤسستك بالنسبة إلى مشاركة الأرباح وخطط بطاقة الأسعار وخطط الرسوم فقط، يتم استخدام العملة التلقائية لخطة الأسعار. عند إنشاء بطاقة أسعار أو خطة رسوم فقط، يمكنك تغيير العملة التي سيتم استخدامها عن طريق الاختيار من قائمة العملات المتوافقة. اختياريًا، يمكنك ضبط الحد الأدنى لمبلغ إضافة الرصيد الذي يمكن لمطوّري التطبيقات إضافته إلى رصيد الحساب المدفوع مسبقًا لكل عملة.

    لإضافة عملة:

    1. انقر على إضافة عملة.
    2. اختَر عملة من القائمة المنسدلة في حقل العملة.
    3. اختياريًا، يمكنك ضبط الحد الأدنى للمبلغ الذي يمكن لمطوّري التطبيقات إضافته إلى رصيد حساب الدفع المسبق بالعملة المحددة في حقل الحد الأدنى لإضافة رصيد.
    4. انقر على إضافة.
    5. قم بتعيينها كعملة افتراضية، إذا أردت، بالنقر على زر الاختيار ذي الصلة.
    6. كرر الخطوات لإضافة عملات أخرى.

    لحذف عملة، ضع مؤشر الماوس فوق العملة التي تريد حذفها وانقر على .

  5. يمكنك إدارة الأحكام والشروط، كما هو موضّح في إدارة الأحكام والشروط باستخدام واجهة المستخدم.
  6. انقر على حفظ.

إدارة الملف الشخصي للمؤسسة باستخدام واجهة برمجة التطبيقات

يمكنك إدارة الملف الشخصي للمؤسسة باستخدام واجهة برمجة التطبيقات، كما هو موضَّح في الأقسام التالية.

عرض الملف الشخصي للمؤسسة باستخدام واجهة برمجة التطبيقات

يمكنك الاطّلاع على الملف الشخصي لمؤسستك من خلال إصدار طلب استرداد بيانات باستخدام GET إلى /mint/organizations/{org_name}. مثال:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Accept: application/json" \
  -u email:password

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

{
    "address" : [ {
      "address1" : "Test address”,
      "city" : "Test City",
      "country" : "US",
      "id" : "test-address",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "54321"
    } ],
    "approveTrusted" : false,
    "approveUntrusted" : false,
    "billingCycle" : "CALENDAR_MONTH",
    "country" : "US",
    "currency" : "USD",
    "description" : "Test organization",
    "hasBillingAdjustment" : true,
    "hasBroker" : false,
    "hasSelfBilling" : false,
    "hasSeparateInvoiceForProduct" : false,
    "id" : "{org_name}"
    "issueNettingStmt" : false,
    "logoUrl" : " https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
    "name" : "myorg",
    "nettingStmtPerCurrency" : false,
    "regNo" : "RegNo-1234-myorg",
    "selfBillingAsExchOrg" : false,
    "selfBillingForAllDev" : false,
    "separateInvoiceForFees" : true,
    "status" : "ACTIVE",
    "supportedBillingType" : "PREPAID",
    "taxModel" : "UNDISCLOSED",
    "taxRegNo" : "TaxRegNo-1234-myorg",
    "timezone" : "UTC"
}

تعديل الملف الشخصي للمؤسسة باستخدام واجهة برمجة التطبيقات

يمكنك تعديل الملف الشخصي للمؤسسة من خلال إصدار طلب PUT إلى /mint/organizations/{org_name}. عند تعديل الملف الشخصي للمؤسسة، يجب تحديد جميع خصائص الملف الشخصي للمؤسسة، وليس فقط الخصائص التي تعدّلها.

لتعديل العملة التلقائية للمؤسسة، اضبط القيمة currency على رمز العملة ISO 4217 بالعملة المتوافقة التي تريد ضبطها كعملة تلقائية.

على سبيل المثال، تم تعديل قيمة السمة currency إلى الدولار الأمريكي في طلب البيانات من واجهة برمجة التطبيقات، وإعداد النموذج الضريبي ليصبح HYBRID (يتم تمييز الحقول المعدَّلة في المثال). لمزيد من المعلومات حول الخيارات المعروضة، يُرجى الاطّلاع على خصائص إعداد الملف الشخصي للمؤسسة لواجهة برمجة التطبيقات.

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
  "address" : [ { 
    "address1" : "Test address”,
    "city" : "Test City",
    "country" : "US",
    "id" : "corp-address",
    "isPrimary" : true,
    "state" : "CA",
    "zip" : "54321"
  } ], 
  "approveTrusted" : false, 
  "approveUntrusted" : false, 
  "billingCycle" : "CALENDAR_MONTH", 
  "country" : "US", 
  "currency" : "USD", 
  "description" : "Test organization", 
  "hasBillingAdjustment" : true, 
  "hasBroker" : false, 
  "hasSelfBilling" : false, 
  "hasSeparateInvoiceForProduct" : false,
  "id" : "myorg", 
  "issueNettingStmt" : false, 
  "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
  "name" : "{org_name}", 
  "nettingStmtPerCurrency" : false, 
  "regNo" : "RegNo-1234-myorg", 
  "selfBillingAsExchOrg" : false, 
  "selfBillingForAllDev" : false, 
  "separateInvoiceForFees" : false, 
  "status" : "ACTIVE", 
  "supportedBillingType" : "POSTPAID",
  "taxModel" : "HYBRID", 
  "taxRegNo" : "TaxRegNo-1234-myorg", 
  "timezone" : "UTC" 
}' \

-u email:password

ضبط أنواع الفوترة بنظام الدفع المسبق والدفع عند الاستخدام باستخدام واجهة برمجة التطبيقات

يمكن إعداد حسابات المطوّرين لاستخدام أنواع الفوترة التالية: الدفع المسبق أو الدفع عند الاستخدام أو كليهما.

باستخدام الحسابات المدفوعة مسبقًا، يدفع مطوّرو البرامج مسبقًا مقابل استخدام واجهات برمجة التطبيقات. تُخصم الأموال من رصيد الدفع المسبق لدى المطوّر الذي يتم الاحتفاظ به من خلال مقدِّم خدمات دفع متكامل. يجب أن يحتفظ المطوّر برصيد مدفوع مسبقًا كافٍ لشراء واجهات برمجة التطبيقات.

باستخدام الحسابات بنظام الدفع الآجل، يتم تحصيل الرسوم من المطوّرين شهريًا (من خلال فاتورة) في نهاية الشهر. يدفع المطوّر مقابل استخدام منتجات واجهة برمجة التطبيقات استنادًا إلى بنود الدفع المحدَّدة في الخطط المضمَّنة في الفاتورة.

لإعداد أنواع الفوترة بنظام الدفع المسبق والدفع عند الاستخدام لمؤسستك، اضبط السمة supportedBillingType على إحدى القيم التالية للإشارة إلى أنواع الفوترة الصالحة: PREPAID أو POSTPAID أو BOTH. وإذا تم ضبط القيمة على BOTH، ستكون القيمة التلقائية PREPAID عند إضافة مطوّر تطبيقات أو شركة. في هذه الحالة، يمكنك تحديد نوع الفوترة لشركة أو مطوّر تطبيقات بشكل واضح باستخدام واجهة برمجة التطبيقات، وذلك على النحو الموضّح في مقالة إدارة الشركات ومطوّري التطبيقات.

مثال:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
  "address" : [ {
    "address1" : "Test address",
    "city" : "Test City",
    "country" : "US",
    "id" : "corp-address",
    "isPrimary" : true,
    "state" : "CA",
    "zip" : "54321"
  } ],
  "approveTrusted" : false,
  "approveUntrusted" : false,
  "billingCycle" : "CALENDAR_MONTH",
  "country" : "US",
  "currency" : "USD",
  "description" : "Test organization",
  "hasBillingAdjustment" : true,
  "hasBroker" : false,
  "hasSelfBilling" : false,
  "hasSeparateInvoiceForProduct" : false,
  "id" : "myorg",
  "issueNettingStmt" : false,
  "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
  "name" : "{org_name}",
  "nettingStmtPerCurrency" : false,
  "regNo" : "RegNo-1234-myorg",
  "selfBillingAsExchOrg" : false,
  "selfBillingForAllDev" : false,
  "separateInvoiceForFees" : false,
  "status" : "ACTIVE",
  "supportedBillingType" : "POSTPAID",
  "taxModel" : "HYBRID",
  "taxRegNo" : "TaxRegNo-1234-myorg",
  "timezone" : "UTC"
  }' \
  -u email:password

ضبط دورة الفوترة باستخدام واجهة برمجة التطبيقات

لضبط دورة الفوترة لمؤسستك، اضبط السمة billingCycle على إحدى القيم التالية:

  • PRORATED: تستند الفوترة إلى عدد الأيام التي يتم فيها استخدام منتج واجهة برمجة التطبيقات في شهر تقويمي معيّن.
  • CALENDAR_MONTH: تتم الفوترة شهريًا.

مثال:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
    "address" : [ {
      "address1" : "Test address",
      "city" : "Test City",
      "country" : "US",
      "id" : "corp-address",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "54321"
    } ],
    "approveTrusted" : false,
    "approveUntrusted" : false,
    "billingCycle" : "CALENDAR_MONTH",
    "country" : "US",
    "currency" : "USD",
    "description" : "Test organization",
    "hasBillingAdjustment" : true,
    "hasBroker" : false,
    "hasSelfBilling" : false,
    "hasSeparateInvoiceForProduct" : false,
    "id" : "myorg",
    "issueNettingStmt" : false,
    "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
    "name" : "{org_name}",
    "nettingStmtPerCurrency" : false,
    "regNo" : "RegNo-1234-myorg",
    "selfBillingAsExchOrg" : false,
    "selfBillingForAllDev" : false,
    "separateInvoiceForFees" : false,
    "status" : "ACTIVE",
    "supportedBillingType" : "POSTPAID",
    "taxModel" : "HYBRID",
    "taxRegNo" : "TaxRegNo-1234-myorg",
    "timezone" : "UTC"
  }' \
  -u email:password

خصائص إعدادات الملف الشخصي للمؤسسة لواجهة برمجة التطبيقات

يتيح لك الملف الشخصي للمؤسسة ضبط خصائص الإعداد التالية باستخدام واجهة برمجة التطبيقات.

الاسم الوصف تلقائي مطلوب؟
address

عنوان المؤسسة، والذي يمكن أن يشمل عنوان الشارع والمدينة والولاية والرمز البريدي والبلد ومؤشرًا على ما إذا كان هذا هو العنوان الرئيسي للمؤسسة

لا ينطبق لا
approveTrusted

هذه العلامة غير مستخدمة.

لا ينطبق لا
approveUntrusted

هذه العلامة غير مستخدمة.

لا ينطبق لا
billingCycle

المدة الزمنية لدورة الفوترة. يمكن أن تكون القيمة واحدة مما يلي:

  • مقسّمة: تستند الفوترة إلى عدد الأيام التي يتم فيها استخدام منتج واجهة برمجة التطبيقات في شهر تقويمي.
  • calendar_MONTH: تتم الفوترة شهريًا.

ويُرجى الاطّلاع على ضبط دورة الفوترة باستخدام واجهة برمجة التطبيقات.

لا ينطبق نعم
country

رمز ISO 3166-2 للبلد الذي تعمل فيه المؤسسة، مثل BR في البرازيل.

لا ينطبق نعم
currency

رمز ISO 4217 للقيمة "الأساسية" أو عملة المحاسبة التي تستخدمها المؤسسة (مثل USD للدولار الأمريكي)

بالنسبة إلى خطط مشاركة الأرباح: يتم استخدام العملة المحدّدة لخطتك.

بالنسبة إلى خطط بطاقة الأسعار (نموذج الشحن): ينطبق الأمر نفسه على خطط مشاركة الأرباح، ولكن يمكنك تغيير إعدادات العملة إلى أي عملة توفّرها المؤسسة.

بالنسبة إلى خطط الرسوم فقط: يمكنك تغيير إعدادات العملة إلى أي عملة معتمَدة في المؤسسة.

لا ينطبق نعم
description

وصف موجز للمؤسسة

لا ينطبق لا
hasBillingAdjustment

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

  • true: تم تفعيل التعديلات.
  • خطأ: لم يتم تفعيل التعديلات.
لا ينطبق لا
hasBroker

علامة تحدد ما إذا كانت الأرباح تعتمد على الصافي، ويمكن أن تكون القيمة أيًا مما يلي:

  • صحيح: يتم احتساب الأرباح حسب الصافي.
  • خطأ: لا يتم احتساب الأرباح بناءً على الصافي.
لا ينطبق لا
hasSelfBilling

علامة توجّه ميزة تحقيق الربح لإنشاء فاتورة بنظام الفوترة الذاتية بدلاً من بيان حصة الأرباح الفاتورة الذاتية هي مستند مالي يعرض بالتفصيل المبلغ المستحق لمطوِّر التطبيق. وهو بمثابة فاتورة لمقدّم واجهة برمجة التطبيقات نيابةً عن مطوِّر التطبيقات. يمكن أن تكون القيمة أيًا مما يلي:

  • true: تنشئ فواتير ذاتية الفوترة بدلاً من كشوف حصة الأرباح.
  • false: لإيقاف الفواتير الذاتية الفوترة.
لا ينطبق لا
hasSeparateInvoiceForProduct

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

  • true: يتم إنشاء فاتورة منفصلة لكل منتج من منتجات واجهة برمجة التطبيقات.
  • خطأ: لا يتم إنشاء فاتورة منفصلة لكل منتج من منتجات واجهة برمجة التطبيقات.
لا ينطبق لا
id

رقم تعريف المؤسسة.

لا ينطبق لا
issueNettingStmt

علامة تحدد ما إذا كان قد تم إنشاء بيان التقسيم عند إنشاء مستندات الفوترة يمكن أن تكون القيمة أيًا مما يلي:

  • true: يتم إنشاء بيان التصفية عند إنشاء مستندات الفوترة.
  • خطأ: لا يتم إنشاء بيان التصفية عند إنشاء مستندات الفوترة.
لا ينطبق لا
logoUrl

تمثّل هذه السمة عنوان URL لشعار المؤسسة.

لا ينطبق لا
name

اسم المؤسسة

لا ينطبق نعم
netPaymentAdviceNote

إشعار بشأن صافي الدفع

لا ينطبق لا
nettingStmtPerCurrency

علامة تحدد ما إذا كان سيتم إنشاء بيان تقسيم منفصل لكل عملة مستخدمة يمكن أن تكون القيمة أيًا مما يلي:

  • true: يتم إنشاء بيان تقسيم منفصل لكل عملة مستخدمة.
  • خطأ: لا يتم إنشاء بيان تقسيم منفصل لكل عملة مستخدمة.
لا ينطبق لا
regNo

رقم تسجيل المؤسسة يتم عرض الرقم الذي تُدخله لهذا الموقع في أسفل مستندات الفوترة.

لا ينطبق لا
selfBillingAsExchOrg

في حال تفعيل الفواتير الذاتية، يشير ذلك إلى ما إذا كانت مُفعَّلة لمؤسسات الاستبدال أم لا. يمكن أن تكون القيمة أيًا مما يلي:

  • صحيح: فواتير الفوترة الذاتية مفعّلة لمؤسسات الصرف.
  • false: لا يتم تفعيل فواتير الفوترة الذاتية لمؤسسات الصرف.
لا ينطبق لا
selfBillingForAllDev

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

  • صحيح: فواتير الفوترة الذاتية مفعّلة لجميع مطوّري التطبيقات.
  • خطأ: فواتير الفوترة الذاتية غير متاحة لبعض مطوّري التطبيقات.
false لا
separateInvoiceForFees

علامة تحدّد ما إذا كان قد تم نشر فاتورة منفصلة للرسوم أم لا. ويمكن أن تكون القيمة أيًا مما يلي:

  • true: يتم نشر فاتورة منفصلة للرسوم.
  • خطأ: لا يتم نشر فاتورة منفصلة للرسوم.
false نعم
status

حالة المؤسسة وتشمل القيم الصالحة ما يلي:

  • نشط: حساب المؤسسة مسجَّل في ميزة تحقيق الربح وهو متاح للاستخدام.
  • غير نشط: حساب المؤسسة مسجَّل في ميزة تحقيق الربح، ولكنه غير متاح للاستخدام.
لا ينطبق لا
supportedBillingType

نموذج الدفع الخاص بالمطوّر والمستخدَم للفوترة يمكن أن تكون القيمة واحدة مما يلي:

  • PREPAID: يدفع المطوّر رسومًا مُسبقًا مقابل استخدام منتج واجهة برمجة التطبيقات. ويتم خصم الأموال من رصيد المطوّر عند استخدام منتج واجهة برمجة التطبيقات. يجب أن يحتفظ مطوِّر البرامج برصيد مدفوع مسبقًا يكفي لشراء منتج واجهة برمجة التطبيقات.
  • POSTPAID: يتم تحصيل فاتورة من مطوّر البرامج شهريًا (من خلال فاتورة) مقابل استخدام منتجات واجهة برمجة التطبيقات. يدفع المطوّر مقابل استخدام منتجات واجهة برمجة التطبيقات استنادًا إلى بنود الدفع المحدّدة في الخطط المضمَّنة في الفاتورة.
  • كلا نوعي الفوترة: يدعم أي من نوعي الفوترة. يكون الإعداد التلقائي هو PREPAID.

راجِع إعداد أنواع الفوترة بنظام الدفع المسبق والدفع عند الاستخدام باستخدام واجهة برمجة التطبيقات.

مُسبقة الدفع نعم
taxModel

ملاحظة: لا ينطبق هذا الإجراء إلا في حال إعداد خطط معدّلات مشاركة الأرباح وكنت تريد إنشاء مستندات الفوترة.

نموذج ضريبي لخطط معدّل مشاركة الأرباح، ويحدّد نوع مستندات الفوترة المطلوبة

وتشمل القيم الصالحة ما يلي:

  • تم الإفصاح: يعمل موفِّر واجهة برمجة التطبيقات كوكيل مُفصَح لدى المطوّر. يتم إرسال إجمالي الأرباح (بما في ذلك ضرائب المبيعات) التي يتم تحصيلها من المستخدم إلى المطوّر. يتم تحصيل عمولة موفّر واجهة برمجة التطبيقات من المطوّر في شكل فاتورة عمولة. لا يتولّى موفّر واجهة برمجة التطبيقات مسؤولية ضريبة المبيعات التي يتم تحصيلها من المستخدم النهائي، وتقع على عاتق المطوّر مسؤولية الإبلاغ عن ضريبة المبيعات.
  • لم يتم الإفصاح عنه: يعمل موفِّر واجهة برمجة التطبيقات كوكيل لم يتم الإفصاح عنه للمطوّر، ويخصم الضريبة التي يتم تحصيلها من المستخدمين ويدفعها إلى السلطات الضريبية المحلية. يرسل مطوّر البرامج فاتورة إلى مقدِّم واجهة برمجة التطبيقات مقابل صافي حصة الأرباح المستحقة لمطوّر التطبيق (مع تخفيض ضرائب المبيعات وعمولة مقدِّم واجهة برمجة التطبيقات).
  • مختلط: يعمل موفِّر واجهة برمجة التطبيقات كوكيل مُفصَح عنه لدى المطوّر. في المقابل، يدفع مقدّم واجهة برمجة التطبيقات ضريبة المبيعات التي يتم تحصيلها من المشتركين إلى السلطات الضريبية المحلية نيابةً عن المطوّر. يمرّر موفِّر واجهة برمجة التطبيقات الأرباح المتبقية إلى المطوّر، ثم يرسل الفواتير عن رسوم العمولة.
لا ينطبق نعم
taxNexus

البلد الذي تم تسجيل المؤسسة فيه لأغراض ضريبية.

لا ينطبق لا
taxRegNo

رقم التسجيل الضريبي للمؤسسة أو رقم تسجيل ضريبة القيمة المضافة، إذا كان ذلك منطبقًا هذه السمة اختيارية لأنّ رقم التسجيل الضريبي أو رقم تسجيل ضريبة القيمة المضافة لا ينطبق في كل البلدان. يتم عرض الرقم الذي تُدخله لهذه المعلّمة في أسفل مستندات الفوترة.

لا ينطبق لا
transactionRelayURL

عنوان URL لنظام آخر يمكن نقل المعاملات إليه، مثل مستودع بيانات.

لا ينطبق لا
timezone

معرّف المنطقة الزمنية لعمليات المؤسسة، مثل America/New_York أو أوروبا/باريس. يمكن أيضًا استخدام اختصارات المناطق الزمنية، مثل UTC أو EST (التوقيت الرسمي الشرقي) أو CET (توقيت وسط أوروبا).

لا ينطبق نعم

إلغاء إعدادات الملف الشخصي لتحقيق الربح لشركة أو مطوّر تطبيق

إلغاء إعدادات الملف الشخصي لتحقيق الربح لدى شركة أو مطوّر تطبيق باستخدام واجهة المستخدم أو واجهة برمجة التطبيقات، كما هو موضّح في الأقسام التالية: