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)

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

نص الاستجابة

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

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

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

object (ResponseHeader)

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

enum (AcceptRemittanceStatementWithModificationsResultCode)

مطلوب: نتيجة طلب v1.acceptRemittanceStatement.

FeeToVATModification

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

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

string (Int64Value format)

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

في ما يلي نموذج لحساب الضريبة:

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

AcceptRemittanceStatementWithModificationsResultCode

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