Method: acceptRemittanceStatementWithModifications

Informuje Google, że oświadczenie wskazane w tym żądaniu zostanie opłacone po wprowadzeniu w nim zmian, takich jak opłata za zmianę klasyfikacji podatku VAT.

Jeśli podczas przetwarzania żądania punkt końcowy napotka błąd, odpowiedź z tego punktu końcowego będzie typu ErrorResponse.

Jeśli ta metoda nie zwraca kodu HTTP 200, odpowiedzi na to zapytanie mogą być puste. Treść odpowiedzi jest pusta w sytuacjach, gdy można wykorzystać pole ErrorResponse z jasnym opisem, aby ułatwić osobie przeprowadzającej atak rozpoznanie identyfikatora konta integratora płatności innych integratorów. W takich sytuacjach, gdy klucz podpisywania nie pasuje, nie znaleziono identyfikatora integratora płatności lub klucz szyfrowania jest nieznany, ta metoda zwróci błąd HTTP 404 z pustą treścią. Jeśli podpis żądania można zweryfikować, dodatkowe informacje dotyczące błędu zostaną zwrócone w treści odpowiedzi.

Przykładowe żądanie wygląda tak:


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

Przykładowa odpowiedź wygląda tak:


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

Żądanie HTTP

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

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis 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.
}
Pola
requestHeader

object (RequestHeader)

WYMAGANE: wspólny nagłówek dla wszystkich żądań.
paymentIntegratorAccountId

string

WYMAGANE: identyfikator konta integratora płatności określa ograniczenia umowne związane z tym wyciągiem.
statementId

string

WYMAGANE: identyfikator żądania powiadomienia zmodyfikowanego przez to żądanie.

Pole sumy modification_type.

modification_type może mieć tylko jedną z tych wartości:
feeToVatModification

object (FeeToVATModification)

WYMAGANE: wymagana zmiana w celu ponownego przypisania części opłat do podatku od towarów i usług (VAT).

Treść odpowiedzi

Obiekt odpowiedzi dla metody acceptRemittanceStatementWithModifications.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Pola
responseHeader

object (ResponseHeader)

WYMAGANE: wspólny nagłówek wszystkich odpowiedzi.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

WYMAGANE: wynik wywołania v1.acceptRemittanceStatement.

FeeToVATModification

Ten obiekt zawiera zmiany dotyczące podatków, które należy zastosować w zestawieniach operacji.

Zapis JSON 
{
  "vatToFeeRatioInMicros": string
}
Pola
vatToFeeRatioInMicros

string (Int64Value format)

WYMAGANE: stosunek podatku VAT do kwoty opłaty w mikro. Jest to procent opłat do ponownego przypisania do podatku VAT, który musi być większy lub równy 0. Zaokrąglenie powinno być „równomierne” lub „bankier” zaokrąglania, czyli zaokrąglania do parzystego sąsiada w przypadku, gdy obie liczby są w równej odległości (np. 2,5 -> 2, 5,5 –> 6).

Oto przykład obliczania podatku:

  • Opłata za przetworzenie uwzględniająca podatek pobrana przez integratora płatności: 1000 USD
  • Stawka podatku: 10%
  • Tym samym 1000 PLN = (opłata manipulacyjna) + (10% * opłata transakcyjna)
  • Opłata transakcyjna (podatek sans) = 1000 / 1,1 = 909,090909 USD
  • Podatek odprowadzany przez integratora płatności = 1000 – 909,090909 = 90,909091 USD
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • Zaokrąglenie 90909,091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

Wartości w polu enum
UNKNOWN_RESULT Nigdy nie ustawiaj tej wartości domyślnej.
SUCCESS Deklaracja przelewu została zaakceptowana, ale wprowadzono zmiany.
INVALID_VAT_MODIFICATION Zmiana podatku VAT nie została zaakceptowana z powodu nieprawidłowego żądania.