Method: acceptRemittanceStatementWithModifications

يتم إخبار Google بأنّ البيان المُشار إليه في هذا الطلب سيتم دفعه بعد إجراء تعديلات على البيان، مثل رسوم إعادة تصنيف ضريبة القيمة المضافة.

إذا واجهت نقطة النهاية خطأ أثناء معالجة الطلب، سيكون الرد من نقطة النهاية هذه من النوع ErrorResponse.

قد تكون الردود على طلب البحث هذا فارغة إذا كانت هذه الطريقة لا تعرض HTTP 200. نص الاستجابة فارغ في الحالات التي يمكن فيها استخدام ErrorResponse مع وصف واضح لمساعدة المهاجم في التعرّف على معرّف حساب عملية تكامل الدفع بالنسبة إلى الشركاء الآخرين. في هذه الحالات، في حال عدم تطابق مفتاح التوقيع، أو عدم العثور على معرِّف وحدة تكامل الدفعات، أو عدم أن مفتاح التشفير معروف، ستعرض هذه الطريقة HTTP 404 مع نص فارغ. إذا تم التحقّق من توقيع الطلب، سيتم عرض معلومات إضافية حول الخطأ في نص الاستجابة.

مثال على طلب يبدو:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-abc",
    "requestTimestamp": "1502545413098"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc",
  "feeToVatModification": {
    "vatToFeeRatioInMicros": "150000"
  }
}

مثال على ردّ:


{
  "responseHeader": {
    "responseTimestamp": "1519996752221"
  },
  "acceptRemittanceStatementWithModificationsResultCode": "SUCCESS"
}

طلب HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v1/acceptRemittanceStatementWithModifications/:PIAID

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "statementId": string,

  // Union field modification_type can be only one of the following:
  "feeToVatModification": {
    object (FeeToVATModification)
  }
  // End of list of possible types for union field modification_type.
}
الحقول
requestHeader

object (RequestHeader)

مطلوب: عنوان شائع لجميع الطلبات.
paymentIntegratorAccountId

string

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

string

مطلوب: يتم تعديل رقم تعريف طلب الإشعار في كشف الحساب.

حقل الاتحاد modification_type.

لا يمكن أن يكون modification_type سوى واحد مما يلي:
feeToVatModification

object (FeeToVATModification)

مطلوبة: تم طلب إعادة ضبط جزء من الرسوم إلى ضريبة القيمة المضافة (VAT).

نص الاستجابة

عنصر الاستجابة لطريقة acceptRemittanceStatementWithModifications

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
الحقول
responseHeader

object (ResponseHeader)

مطلوب: عنوان شائع لجميع الردود.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

مطلوبة: نتيجة للمكالمة v1.AcceptRemittanceStatement.

تعديل على ضريبة القيمة المضافة

يوفّر هذا العنصر تعديلات على الضرائب يتم تطبيقها على كشوفات الحوالات المالية.

تمثيل JSON 
{
  "vatToFeeRatioInMicros": string
}
الحقول
vatToFeeRatioInMicros

string (Int64Value format)

مطلوبة: نسبة ضريبة القيمة المضافة إلى مبلغ الرسوم بوحدة المايكرو. هي النسبة المئوية للرسوم المطلوب إعادة إحالتها إلى ضريبة القيمة المضافة ويجب أن تكون أكبر من الصفر أو مساوية له. يجب أن يكون التقريب إلى نصفَين أو تقريب الرقم، أي التقريب إلى الرقم المجاور في حال تطابق الرقمَين معًا (على سبيل المثال، 2.5 -> 2,5.5 -> 6).

في ما يلي عينة لحساب الضريبة:

  • رسوم معالجة شاملة الضرائب التي تم جمعها من خلال شركة دمج الدفعات: 1000 دولار أمريكي (أو ما يعادلها بالعملة المحلية)
  • معدّل الضريبة: 10%
  • وبالتالي، يجب دفع 1, 000 دولار أمريكي (أو ما يعادله بالعملة المحلية) = (رسوم المعالجة) + (10% * رسوم معالجة).
  • رسوم معالجة (ضريبة السلع المُباعة) = 1000 / 1.1 = 909.090909 دولار أمريكي
  • الضريبة المفروضة على جهة تكامل الدفعات = 1000 - 909.090909 = 90.909091 دولار أمريكي (أو ما يعادلها بالعملة المحلية)
  • vatToFeeRatioInMicros = (90.909091 / 1000) * 1000000 = 90909.091
  • تقريب نصف الرصيد على 90909.091 = 90909

قبول رمز الاستقبال باستخدام الرمز ModificationsResultCode

عمليات التعداد
UNKNOWN_RESULT عدم ضبط هذه القيمة التلقائية مطلقًا
SUCCESS تم قبول كشف تحويل الأموال بنجاح مع إجراء التعديلات بنجاح.
INVALID_VAT_MODIFICATION لم يتم قبول تعديل ضريبة القيمة المضافة بسبب طلب غير صالح.