Method: acceptRemittanceStatementWithModifications

Le indica a Google que la declaración que se indica en esta solicitud se pagará después de que se realicen modificaciones en la declaración, como la tarifa de reclasificación de IVA.

Las respuestas a esta consulta pueden estar vacías si este método no muestra un HTTP 200. Están vacíos en situaciones en las que se podría usar un ErrorResponse con una descripción clara para ayudar a un atacante a comprender el identificador de cuenta del integrador de pagos de otros integradores. En estas situaciones, en las que la clave de firma no coincide o la clave de encriptación era desconocida, este método mostrará un error HTTP 404 con un cuerpo vacío.

A continuación, se muestra una solicitud de ejemplo:


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

Esta es una respuesta de ejemplo:


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

Solicitud HTTP

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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.
}
Campos
requestHeader

object (RequestHeader)

OBLIGATORIO: Encabezado común para todas las solicitudes
paymentIntegratorAccountId

string

OBLIGATORIO: Este es el identificador de la cuenta del integrador de pagos que identifica las restricciones contractuales en torno a esta declaración.
statementId

string

OBLIGATORIO: Es el ID de solicitud de la notificación de la declaración que modifica esta solicitud.

Campo de unión modification_type.

modification_type puede ser una de las siguientes opciones:
feeToVatModification

object (FeeToVATModification)

OBLIGATORIO: Se solicitó una modificación para volver a atribuir una parte de las tarifas al impuesto sobre el valor agregado (IVA).

Cuerpo de la respuesta

Objeto de respuesta para el método acceptRemittanceStatementWithModifications.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Campos
responseHeader

object (ResponseHeader)

OBLIGATORIO: Encabezado común para todas las respuestas
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

OBLIGATORIO: Resultado de la llamada v1.AcceptRemittanceStatement.

FeeToVATModification

Este objeto proporciona modificaciones en los impuestos que se aplicarán a los resúmenes de remesas.

Representación JSON 
{
  "vatToFeeRatioInMicros": string
}
Campos
vatToFeeRatioInMicros

string (Int64Value format)

OBLIGATORIO: Proporción del IVA al importe de la tarifa en micros. Este es el porcentaje de las tarifas que se volverán a atribuir al IVA y debe ser mayor o igual que cero. El redondeo debe ser "medio par" o "del banquero", es decir, redondear al vecino par en caso de que ambos números sean equidistantes (p.ej., 2.5 -> 2, 5.5 -> 6).

A continuación, se muestra un ejemplo de cómo calcular impuestos:

  • Tarifa por procesamiento con impuestos incluidos por el integrador de pagos: USD 1,000
  • Tasa impositiva: 10%
  • Por lo tanto, USD 1,000 = (tarifa por procesamiento) + (10% * tarifa por procesamiento)
  • Tarifa de procesamiento (sin impuestos) = 1,000 / 1.1 = USD 909.090909
  • Impuesto pagado por el integrador de pagos = 1,000 - 909.090909 = USD 90.909091
  • vatToFeeRatioInMicros = (90.909091 / 1,000) × 1000000 = 90909.091
  • Redondeo de par en 90909.091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

Enumeradores
UNKNOWN_RESULT No establezcas nunca este valor predeterminado.
SUCCESS La declaración de remesa se aceptó correctamente con las modificaciones.
INVALID_VAT_MODIFICATION No se aceptó la modificación del IVA debido a una solicitud no válida.