- Żądanie HTTP
- Treść żądania
- Treść odpowiedzi
- Opłaty związane z podatkiem VAT
- AcceptRemittanceStatementWithModificationsResultCode
Informuje Google, że oświadczenie określone w tym wniosku zostanie wypłacone po wprowadzeniu w nim zmian, takiej jak opłata za zmianę klasyfikacji podatku VAT.
Jeśli podczas przetwarzania żądania punkt końcowy otrzyma 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 użyć
z wyraźnym opisem, aby ułatwić atakującemu rozpoznanie identyfikatora konta integratora płatności innych integratorów. W takich przypadkach, jeśli klucz podpisywania nie pasuje, nie znaleziono identyfikatora integratora płatności lub klucz szyfrowania jest nieznany, ta metoda zwraca kod HTTP 404 z pustą treścią. Jeśli będzie można zweryfikować podpis w żądaniu, w treści odpowiedzi zostaną zwrócone dodatkowe informacje o błędzie.ErrorResponse
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ź:
{
"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 ( |
Pola | |
---|---|
requestHeader |
REQUIRED: wspólny nagłówek dla wszystkich żądań, |
paymentIntegratorAccountId |
WYMAGANE: to identyfikator konta integratora płatności, który określa ograniczenia umowne związane z tym wyciągiem. |
statementId |
WYMAGANE: identyfikator żądania powiadomienia dotyczącego modyfikacji żądania. |
Pole sumy
|
|
feeToVatModification |
WYMAGANE: poproszono o zmianę przypisania części opłat związanych z podatkiem od towarów i usług (VAT). |
Treść odpowiedzi
Obiekt odpowiedzi na metodę acceptRemittanceStatementWithModifications
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "responseHeader": { object ( |
Pola | |
---|---|
responseHeader |
WYMAGANE: wspólny nagłówek wszystkich odpowiedzi. |
acceptRemittanceStatementWithModificationsResultCode |
WYMAGANE: wynik wywołania v1.AcceptRemittanceStatement. |
Opłata za zmodyfikowanie VAT
Ten obiekt dostarcza zmiany dotyczące podatku, które zostaną zastosowane do wyciągów.
Zapis JSON |
---|
{ "vatToFeeRatioInMicros": string } |
Pola | |
---|---|
vatToFeeRatioInMicros |
WYMAGANE: współczynnik VAT do kwoty opłaty w mikro. Jest to odsetek opłat, którymi trzeba ponownie przypisać podatek VAT. Wartość ta musi być równa zeru lub większa. Zaokrąglanie powinno być zaokrąglone do połowy lub równości w kierunku banku, czyli do równomiernego sąsiada, jeśli obie liczby są w równej odległości (np. 2,5 -> 2, 5,5 -> 6). Oto przykład obliczania podatku:
|
AcceptRemittanceStatementWithModificationsResultCode
Wartości w polu enum | |
---|---|
UNKNOWN_RESULT |
Nie ustawiaj nigdy tej wartości domyślnej! |
SUCCESS |
Deklaracja dotycząca płatności została zaakceptowana z modyfikacjami. |
INVALID_VAT_MODIFICATION |
Zmiana podatku VAT nie została zaakceptowana z powodu nieprawidłowego żądania. |