Method: acceptRemittanceStatementWithModifications

Comunica a Google che la dichiarazione indicata in questa richiesta verrà pagata dopo aver apportato modifiche all'estratto conto, ad esempio l'addebito per la riclassificazione dell'IVA.

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

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

Ecco un esempio di richiesta:


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

Ecco 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: si tratta dell'identificatore dell'account dell'integratore pagamenti che identifica i vincoli contrattuali relativi a questa dichiarazione.
statementId

string

REQUIRED: l'ID richiesta della notifica della dichiarazione modificata da questa richiesta.

Campo unione modification_type.

modification_type può essere solo uno dei seguenti:
feeToVatModification

object (FeeToVATModification)

OBBLIGATORIO: modifica richiesta per riaffermare una parte delle commissioni all'imposta sul valore aggiunto (IVA).

Corpo della risposta

Oggetto di 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: il risultato della chiamata v1.acceptRemittanceStatement.

FeeToVATModification

Questo oggetto fornisce modifiche fiscali da applicare agli estratti conto.

Rappresentazione JSON 
{
  "vatToFeeRatioInMicros": string
}
Campi
vatToFeeRatioInMicros

string (Int64Value format)

OBBLIGATORIO: rapporto tra IVA e importo della tariffa in micro. Questa è la percentuale delle tariffe da reintegrare all'IVA e deve essere maggiore o uguale a zero. L'arrotondamento deve essere "mezza pari" o "banker's" l'arrotondamento, ovvero arrotondamento al vicino pari nel caso in cui entrambi i numeri siano equidistanti (ad es. 2,5 -> 2, 5,5 -> 6).

Ecco un esempio per il calcolo delle imposte:

  • Commissioni di elaborazione comprensive di imposte riscosse dall'integratore dei pagamenti: 1000 $
  • Aliquota fiscale: 10%
  • Pertanto, 1000 $ = (commissioni di elaborazione) + (10% * commissioni di elaborazione)
  • Commissione di elaborazione (imposta esclusa) = 1000 / 1,1 = 909,090909 USD
  • Imposte pagate dall'integratore dei pagamenti = 1000 - 909,090909 = 90,909091 $
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • Arrotondamento a metà pari per 90909,091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

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