Method: acceptRemittanceStatementWithModifications

Comunica a Google che la dichiarazione indicata in questa richiesta verrà pagata dopo che verranno apportate modifiche all'estratto conto, ad esempio la commissione per la riclassificazione dell'IVA.

Le risposte a questa query potrebbero essere vuote se questo metodo non restituisce un HTTP 200. Sono vuoti nelle situazioni in cui potrebbe essere utilizzato un elemento ErrorResponse con una descrizione chiara per aiutare un utente malintenzionato a comprendere l'identificatore dell'account dell'integratore dei pagamenti di altri integratori. In questi casi, in cui la chiave di firma non corrisponde o la chiave di crittografia non è nota, il metodo restituisce un errore HTTP 404 con un corpo vuoto.

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"
  }
}

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: questo è l'identificatore dell'account dell'integratore dei pagamenti che identifica i vincoli contrattuali relativi a questa affermazione.
statementId

string

OBBLIGATORIO: ID richiesta della notifica di dichiarazione modificata da questa richiesta.

Campo di unione modification_type.

modification_type può essere solo uno dei seguenti:
feeToVatModification

object (FeeToVATModification)

OBBLIGATORIO: modifica richiesta per riattribuire una parte delle tariffe 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)

OBBLIGATORIO: risultato della chiamata v1.acceptRemittanceStatement.

FeeToVATModification

Questo oggetto fornisce modifiche fiscali da applicare alle dichiarazioni di versamento.

Rappresentazione JSON 
{
  "vatToFeeRatioInMicros": string
}
Campi
vatToFeeRatioInMicros

string (Int64Value format)

OBBLIGATORIO: rapporto tra IVA e importo della commissione in micro. Si tratta della percentuale di commissioni da riattribuire all'IVA e deve essere maggiore o uguale a zero. L'arrotondamento dovrebbe essere"mezza pari " o "del banchiere", il che significa arrotondare al vicino pari nel caso in cui entrambi i numeri siano equidistanti (ad es. 2,5 -> 2, 5,5 -> 6).

Di seguito è riportato un esempio per il calcolo delle tasse:

  • Commissione di elaborazione comprensiva di imposte riscossa dall'integratore dei pagamenti: 1000 $
  • Aliquota fiscale: 10%
  • Pertanto, 1000 $ = (commissione di elaborazione) + (10% * commissione di elaborazione)
  • Commissione di elaborazione (senza imposte) = 1000 / 1,1 = 909,090909 USD
  • Imposte pagate dall'integratore dei pagamenti = 1000 - 909.090909 = 90.909091 USD
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • Arrotondamento dimezzamento su 90909.091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

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