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)

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

גוף התשובה

אובייקט תשובה ל-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)

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

דוגמה לחישוב מס:

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

AcceptRemittanceStatementWithModificationsResultCode

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