Method: acceptRemittanceStatementWithModifications

Indica a Google che l'estratto conto indicato in questa richiesta verrà pagato dopo aver apportato modifiche all'estratto conto, ad esempio una commissione per la riclassificazione dell'IVA.

Se si verifica un errore durante l'elaborazione della richiesta, la risposta di questo endpoint sarà di tipo ErrorResponse.

Le risposte a questa query potrebbero essere vuote se questo metodo non restituisce un codice HTTP 200. Il corpo della risposta è vuoto nel caso in cui un ErrorResponse con una descrizione chiara possa essere utilizzato per aiutare un utente malintenzionato a comprendere l'identificatore di account integratore di pagamento di altri integratori. In questi casi, in cui la chiave di firma non corrisponde, non è stato trovato l'identificatore dell'integratore dei pagamenti o la chiave di crittografia era sconosciuta, questo metodo restituirà un errore HTTP 404 con un corpo vuoto. Se è stato possibile verificare la firma della richiesta, nel corpo della risposta verranno restituite ulteriori informazioni sull'errore.

Una richiesta di esempio ha il seguente aspetto:


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

Un esempio di risposta è:


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

Richiesta HTTP

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

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
requestHeader

object (RequestHeader)

REQUIRED: intestazione comune per tutte le richieste.
paymentIntegratorAccountId

string

REQUIRED: è l'identificatore dell'account integrato del pagamento che identifica i vincoli contrattuali presenti in questo estratto conto.
statementId

string

REQUIRED: l'ID richiesta della notifica di dichiarazione della modifica.

Campo unione modification_type.

modification_type può essere solo uno dei seguenti:
feeToVatModification

object (FeeToVATModification)

REQUIRED: è stata richiesta una modifica per attribuire una parte di commissioni all'imposta sul valore aggiunto (IVA).

Corpo della risposta

Oggetto della risposta per il metodo acceptRemittanceStatementWithModifications.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Campi
responseHeader

object (ResponseHeader)

REQUIRED: intestazione comune per tutte le risposte.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

REQUIRED: risultato della chiamata v1.acceptRemittanceStatement.

Modifica della tariffa IVA

Questo oggetto fornisce modifiche fiscali da applicare ai documenti di versamento.

Rappresentazione JSON 
{
  "vatToFeeRatioInMicros": string
}
Campi
vatToFeeRatioInMicros

string (Int64Value format)

REQUIRED: rapporto tra IVA e importo della commissione in micro. È la percentuale delle commissioni da attribuire nuovamente all'IVA e deve essere maggiore o uguale a zero. L'arrotondamento dovrebbe essere arrotondato per"mezza uniforme " o "per la banca", cioè arrotondato al vicino pari nel caso in cui entrambi i numeri siano equidistanti (ad es. 2.5 -> 2, 5.5 -> 6).

Un esempio di calcolo delle imposte è il seguente:

  • Commissione di elaborazione comprensiva di IVA riscossa dall'integratore dei pagamenti: 1000 $
  • Aliquota imposta: 10%
  • Di conseguenza, 1000 EUR (costo di elaborazione) + (10% * commissione di elaborazione)
  • Commissione di elaborazione (imposta Sans) = 1000 / 1,1 = 909,090909 USD
  • Imposte pagate dall'integratore di pagamenti = 1000 - 909.090909 = 90.909091 USD
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • Arrotondamento semipari su 90909.091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

Enum
UNKNOWN_RESULT Non impostare questo valore predefinito.
SUCCESS Dichiarazione del versamento accettata con le modifiche apportate.
INVALID_VAT_MODIFICATION La modifica dell'IVA non è stata accettata a causa di una richiesta non valida.