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.

עמלת עמלת מע"מ

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

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

string (Int64Value format)

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

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

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

CodeRemittanceStatementWithchangesResultCode

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