Method: acceptRemittanceStatementWithModifications

Indique à Google que le relevé indiqué dans cette demande sera payé après modification, comme les frais de reclassification de la TVA.

Si le point de terminaison rencontre une erreur lors du traitement de la requête, sa réponse sera de type ErrorResponse.

Les réponses à cette requête peuvent être vides si cette méthode ne renvoie pas de réponse HTTP 200. Le corps de la réponse est vide dans les situations où un élément ErrorResponse avec une description claire pourrait être utilisé pour aider un pirate informatique à comprendre l'identifiant de compte d'intégrateur de paiement d'autres intégrateurs. Dans ces situations, lorsque la clé de signature ne correspond pas, l'identifiant de l'intégrateur de paiement est introuvable ou la clé de chiffrement est inconnue, cette méthode renvoie une erreur HTTP 404 avec un corps vide. Si la signature de la requête peut être validée, des informations supplémentaires sur l'erreur seront renvoyées dans le corps de la réponse.

Exemple de requête:


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

Exemple de réponse:


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

Requête HTTP :

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

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
requestHeader

object (RequestHeader)

REQUIRED: en-tête commun à toutes les requêtes.
paymentIntegratorAccountId

string

OBLIGATOIRE: il s'agit de l'identifiant de compte de l'intégrateur de paiements qui identifie les contraintes contractuelles liées à cet relevé.
statementId

string

OBLIGATOIRE: ID de la notification de relevé modifiée par cette requête.

Champ d'union modification_type.

modification_type ne peut être qu'un des éléments suivants :
feeToVatModification

object (FeeToVATModification)

OBLIGATOIRE: modification demandée pour réattribuer une partie de la taxe à la taxe sur la valeur ajoutée (TVA).

Corps de la réponse

Objet de réponse pour la méthode acceptRemittanceStatementWithModifications.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Champs
responseHeader

object (ResponseHeader)

REQUIRED: en-tête commun pour toutes les réponses.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

REQUIRED: résultat de l'appel v1.acceptRemittanceStatement.

Modification des frais de TVA

Cet objet fournit les modifications de taxes à appliquer aux relevés de paiement.

Représentation JSON 
{
  "vatToFeeRatioInMicros": string
}
Champs
vatToFeeRatioInMicros

string (Int64Value format)

OBLIGATOIRE: ratio entre TVA et frais Pourcentage des frais à réattribuer à la TVA. Il doit être supérieur ou égal à zéro. Les valeurs arrondies doivent être arrondies à la moitié égale ou égale à celle du banquier, c'est-à-dire arrondies au voisin pair dans le cas où les deux nombres sont équidistants (par exemple, 2.5 -> 2, 5.5 -> 6).

Voici un exemple de calcul des taxes:

  • Frais de traitement TTC collectés par l'intégrateur de paiements: 1 000 USD
  • Taux de taxe: 10%
  • Ainsi, 1 000 USD = (frais de traitement) + (10% * frais de traitement)
  • Frais de traitement (hors taxes) = 1 000 / 1,1 = 909,090909 USD
  • Taxes payées par l'intégrateur de paiements = 1 000 - 909,090909 = 90,909091 USD
  • vatToFeeRatioInMicros = (90,909091 / 1 000) * 1 000 000 = 90909,091
  • Arrondi de moitié 90909.091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

Enums
UNKNOWN_RESULT Ne définissez jamais cette valeur par défaut.
SUCCESS Le relevé de paiement a bien été accepté et les modifications ont bien été apportées.
INVALID_VAT_MODIFICATION La modification de la TVA n'a pas été acceptée en raison d'une demande non valide.