Method: acceptRemittanceStatementWithModifications

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

قد تكون الردود على هذا الاستعلام فارغة إذا لم تعرض هذه الطريقة الخطأ 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.

FeeToVATModification

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

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

string (Int64Value format)

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

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

  • رسوم معالجة شاملة للضرائب تحصّلها شركة تكامل الدفعات: 1,000 دولار أمريكي
  • معدّل الضريبة: 10%
  • وبالتالي، 1000 دولار أمريكي = (رسوم معالجة) + (10% * رسوم معالجة)
  • رسوم المعالجة (ضريبة بدون) = 1000 / 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 لم يتم قبول تعديل ضريبة القيمة المضافة بسبب طلب غير صالح.