Method: acceptRemittanceStatementWithModifications

Le informa a Google que la declaración indicada en esta solicitud se pagará después de que se realicen modificaciones en el estado, como una tarifa de reclasificación del IVA.

Si el extremo encuentra un error mientras procesa la solicitud, la respuesta de este extremo será del tipo ErrorResponse.

Es posible que las respuestas de esta consulta estén vacías si este método no muestra un HTTP 200. El cuerpo de la respuesta estará vacío en situaciones en las que se pueda usar una 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, no se encontró el identificador del integrador de pagos o se desconocía la clave de encriptación, este método mostrará un error HTTP 404 con un cuerpo vacío. Si se puede verificar la firma de la solicitud, se devolverá información adicional sobre el error en el cuerpo de la respuesta.

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

Una respuesta de ejemplo se ve de la siguiente manera:


{
  "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)

REQUIRED: Encabezado común para todas las solicitudes
paymentIntegratorAccountId

string

REQUIRED: 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 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 un porcentaje 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)

REQUIRED: Encabezado común para todas las respuestas
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

REQUIRED: Es el resultado de la llamada a v1.acceptRemittanceStatement.

FeeToVATModification

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

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

string (Int64Value format)

OBLIGATORIO: Es la proporción entre el IVA y el importe de la tarifa en micros. Es el porcentaje de las tarifas que se deben volver a atribuir al IVA y debe ser mayor o igual que cero. El redondeo debe ser "medio par" o "banqueros" redondear, lo que significa redondear al vecino par en caso de que ambos números sean equidistantes (p.ej., 2.5 -> 2, 5.5 -> 6).

Este es un ejemplo para calcular los impuestos:

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

AcceptRemittanceStatementWithModificationsResultCode

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