Method: acceptRemittanceStatementWithModifications

Google'a, bu talepteki beyan beyanının, KDV yeniden sınıflandırma ücreti gibi değişiklikler yapıldıktan sonra ödeneceğini bildirir.

Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktadan gelen yanıt ErrorResponse türünde olur.

Bu yöntem bir HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir. Saldırganın, diğer entegratörlerin ödeme entegratörü hesap tanımlayıcılarını anlamasına yardımcı olmak için açık bir ErrorResponse açıklaması kullanılabileceği yanıt gövdesi boş. Bu durumlarda, imzalama anahtarının eşleşmediği, ödeme entegratör tanımlayıcısının bulunmadığı veya şifreleme anahtarının bilinmediği durumlarda bu yöntem boş gövdeye sahip bir HTTP 404 döndürür. İstek imzası doğrulanabilirse yanıt gövdesinde hatayla ilgili ek bilgiler döndürülür.

Örnek bir istek:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-abc",
    "requestTimestamp": "1502545413098"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc",
  "feeToVatModification": {
    "vatToFeeRatioInMicros": "150000"
  }
}

Örnek bir yanıt:


{
  "responseHeader": {
    "responseTimestamp": "1519996752221"
  },
  "acceptRemittanceStatementWithModificationsResultCode": "SUCCESS"
}

HTTP isteği

POST https://vgw.googleapis.com/secure-serving/gsp/v1/acceptRemittanceStatementWithModifications/:PIAID

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "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.
}
Alanlar
requestHeader

object (RequestHeader)

ZORUNLU: Tüm istekler için ortak üstbilgi.
paymentIntegratorAccountId

string

ZORUNLU: Bu ekstreyle ilgili sözleşme kısıtlamalarını tanımlayan ödeme entegratörü hesap tanımlayıcısıdır.
statementId

string

ZORUNLU: Bu isteğin değiştirdiği ifade bildiriminin istek kimliği.

Birlik alanı modification_type.

modification_type aşağıdakilerden yalnızca biri olabilir:
feeToVatModification

object (FeeToVATModification)

ZORUNLU: Ücretlerin bir kısmını katma değer vergisi (KDV) ile yeniden ilişkilendirmek için değişiklik isteğinde bulunuldu.

Yanıt gövdesi

acceptRemittanceStatementWithModifications yöntemi için yanıt nesnesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Alanlar
responseHeader

object (ResponseHeader)

ZORUNLU: Tüm yanıtlar için ortak başlık.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

GEREKLİ: v1.AcceptRemittanceStatement çağrısının sonucu.

ÜcretToKDVDeğişikliki

Bu nesne, havale ekstrelerine uygulanacak vergi değişiklikleridir.

JSON gösterimi 
{
  "vatToFeeRatioInMicros": string
}
Alanlar
vatToFeeRatioInMicros

string (Int64Value format)

GEREKLİ: Mikro cinsinden Ücret tutarının KDV oranı. Bu, KDV ile yeniden ilişkilendirilecek ücretlerin yüzdesidir ve sıfıra eşit veya sıfırdan büyük olmalıdır. Yuvarlama "yarı çift" veya "bankacı" yuvarlaması olmalıdır. Yani yuvarlama işlemi, her iki sayının eşit olduğu hâlinde çift komşuya yuvarlanır (ör. 2,5 -> 2, 5,5 -> 6).

Vergi hesaplaması için örnek aşağıda verilmiştir:

  • Ödeme entegratörü tarafından alınan vergi dahil işleme ücreti: 1.000 ABD doları
  • Vergi oranı: %10
  • Dolayısıyla, 1.000 ABD doları = (işlem ücreti) + (%10 * işlem ücreti)
  • İşlem ücreti (Google Ads vergisi) = 1000 / 1,1 = 909,090909 ABD doları
  • Ödeme entegratörü tarafından ödenen vergi = 1.000 - 909,090909 = 90,909091 ABD doları
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • Yarı çift yuvarlama 90909.091 = 90909

Kabul Edilen Havale KabulUSonuç Kodu

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlama!
SUCCESS Havale özeti, yapılan değişikliklerle kabul edildi.
INVALID_VAT_MODIFICATION KDV değişikliği, geçersiz bir istek nedeniyle kabul edilmedi.