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)

חובה: ביקשתם לבצע שינוי כדי לשייך מחדש חלק מהעמלות למס ערך מוסף (מע"מ).

גוף התגובה

אובייקט תשובה ל-method acceptRemittanceStatementWithModifications.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
שדות
responseHeader

object (ResponseHeader)

חובה: כותרת נפוצה לכל התשובות.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

נדרש: התוצאה של הקריאה v1.acceptRemittanceStatement.

FeeToVATModification

אובייקט זה מספק שינויים במס החלים על תצהירים על העברת כספים.

ייצוג JSON 
{
  "vatToFeeRatioInMicros": string
}
שדות
vatToFeeRatioInMicros

string (Int64Value format)

חובה: היחס בין סכום המע"מ לעמלה במיקרו נתונים. זהו אחוז העמלות שצריך לשייך מחדש למע"מ, והוא צריך להיות גדול מ-0 או שווה לו. העיגול צריך להיות "חצי זוגי" או "בנקאי", כלומר לעגל כלפי השכן הזוגי במקרה ששני המספרים שווי מרחק (לדוגמה, 2.5 -> 2, 5.5 -> 6).

לפניכם דוגמה לחישוב המס:

  • עמלת עיבוד כוללת מס שנגבה על ידי משלב תשלומים: 1,000 דולר ארה"ב
  • שיעור המס: 10%
  • לכן, 1,000 דולר ארה"ב = (עמלת עיבוד) + (10% * עמלת עיבוד)
  • עמלת עיבוד (מס sans) = 1,000 חלקי 1.1 = 909.090909 דולר ארה"ב
  • מס שמשלם על ידי משלב תשלומים = 1000 - 909.090909 = 90.909091 דולר ארה"ב
  • vatToFeeRatioInMicros = (90.909091 / 1000) * 1000000 = 90909.091
  • עיגול חצי שווה ב-90909.091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

טיפוסים בני מנייה (enums)
UNKNOWN_RESULT אל תגדיר את ערך ברירת המחדל הזה אף פעם!
SUCCESS הצהרת התשלום אושרה עם השינויים.
INVALID_VAT_MODIFICATION שינוי המע"מ לא התקבל עקב בקשה לא חוקית.