Method: acceptRemittanceStatementWithModifications

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

Bu yöntem bir HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir. Net bir açıklamaya sahip ErrorResponse, bir saldırganın diğer entegratörlerin ödeme entegratörü hesap tanımlayıcısını anlamasına yardımcı olmak için kullanılabileceği durumlarda boştur. İmzalama anahtarının eşleşmediği veya şifreleme anahtarının bilinmediği bu durumlarda, bu yöntem boş gövdeli bir HTTP 404 döndürür.

Örnek bir istek şu şekilde görünür:


{
  "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 şöyle görünür:


{
  "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ıyla birlikte 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 başlık.
paymentIntegratorAccountId

string

ZORUNLU: Bu ifadeyle ilgili sözleşmeden doğan kısıtlamaları tanımlayan ödeme entegratörü hesap kimliğidir.
statementId

string

ZORUNLU: Bu istek değiştirildiğinde bildirim bildiriminin istek kimliği.

modification_type alanı.

modification_type şunlardan yalnızca biri olabilir:
feeToVatModification

object (FeeToVATModification)

ZORUNLU: Ücretlerin bir bölümünün katma değer vergisi (KDV) ile yeniden ilişkilendirilmesi için değişiklik istendi.

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)

ZORUNLU: v1.acceptRemittanceStatement çağrısının sonucu.

FeeToVATModification

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

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

string (Int64Value format)

ZORUNLU: KDV'nin ücret tutarına oranı (mikro ölçekte). Bu değer, KDV ile yeniden ilişkilendirilecek ücretlerin yüzdesidir ve sıfıra eşit ya da sıfırdan büyük olmalıdır. Yuvarlama, "yarım çift" veya "bankacı" şeklinde yuvarlama olmalıdır. Diğer bir deyişle, her iki sayı da eşit uzaklıktaysa çift komşuya yuvarlanmalıdır (ör. 2,5 -> 2, 5,5 -> 6).

Vergi hesaplamasına ilişkin bir örnek aşağıda verilmiştir:

  • Ödeme entegratörü tarafından tahsil edilen vergi dahil işlem ücreti: 1.000 ABD doları
  • Vergi oranı: %10
  • Dolayısıyla, 1.000 ABD doları = (işlem ücreti) + (%10 * işlem ücreti)
  • İşlem ücreti (vergi hariç) = 1000 / 1,1 = 909,090909 ABD doları
  • Ödeme entegratörü tarafından ödenen vergi = 1000 - 909,090909 = 90,909091 ABD doları
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • 90909,091 = 90909'da yarı çift yuvarlama

AcceptRemittanceStatementWithModificationsResultCode

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlamayın.
SUCCESS Havale ekstresi, değişiklikler yapılarak başarıyla kabul edildi.
INVALID_VAT_MODIFICATION KDV değişikliği, geçersiz bir istek nedeniyle kabul edilmedi.