Method: acceptRemittanceStatementWithModifications

Informa ao Google que a fatura indicada na solicitação será paga depois que o extrato for alterado, como a taxa de reclassificação de IVA.

Se o endpoint encontrar um erro ao processar a solicitação, a resposta dele será do tipo ErrorResponse.

As respostas a esta consulta podem ficar vazias se o método não retornar HTTP 200. O corpo da resposta fica vazio em situações em que um ErrorResponse com uma descrição clara pode ser usado para ajudar um invasor a entender o identificador da conta do integrador de pagamentos de outros integradores. Quando a chave de assinatura não corresponde, o identificador do integrador de pagamentos não é encontrado ou a chave de criptografia é desconhecida, esse método vai retornar um HTTP 404 com corpo vazio. Se for possível verificar a assinatura da solicitação, informações adicionais sobre o erro serão retornadas no corpo da resposta.

Um exemplo de solicitação é semelhante a este:


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

Veja um exemplo de resposta:


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

Solicitação HTTP

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

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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)

OBRIGATÓRIO: cabeçalho comum para todas as solicitações.
paymentIntegratorAccountId

string

OBRIGATÓRIO: o identificador da conta do integrador de pagamentos que identifica as restrições contratuais relacionadas a esta declaração.
statementId

string

OBRIGATÓRIO: ID da notificação de instrução que a solicitação modifica.

Campo de união modification_type.

modification_type pode ser apenas de um dos tipos a seguir:
feeToVatModification

object (FeeToVATModification)

OBRIGATÓRIO: modificação solicitada para reatribuir uma parte das taxas ao Imposto sobre Valor Agregado (IVA).

Corpo da resposta

Objeto de resposta para o método acceptRemittanceStatementWithModifications.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Campos
responseHeader

object (ResponseHeader)

OBRIGATÓRIO: cabeçalho comum para todas as respostas.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

OBRIGATÓRIO: resultado da chamada v1.acceptRemittanceStatement.

FeeToVATModification

Este objeto apresenta modificações fiscais que serão aplicadas aos extratos de remessa.

Representação JSON 
{
  "vatToFeeRatioInMicros": string
}
Campos
vatToFeeRatioInMicros

string (Int64Value format)

OBRIGATÓRIO: a proporção do IVA em relação ao valor da taxa em micros. Essa é a porcentagem das taxas a serem reatribuídas ao IVA. Ela precisa ser maior ou igual a zero. O arredondamento deve ser "meio par" ou "banqueiro" arredondamento, o que significa arredondar para o vizinho par no caso de ambos os números serem equidistantes (por exemplo, 2,5 -> 2, 5,5 -> 6).

Confira a seguir um exemplo para calcular o tributo:

  • Taxa de processamento com tributos incluídos coletada pelo integrador de pagamentos: US$ 1.000
  • Alíquota de imposto: 10%
  • Assim, US$ 1.000 = (taxa de processamento) + (10% * taxa de processamento)
  • Taxa de processamento (tributo Sans) = 1.000 / 1,1 = US$ 909,090909
  • Tributos pagos pelo integrador de pagamentos = 1.000 - 909,090909 = US$ 90,909091
  • vatToFeeRatioInMicros = (90,909091 / 1.000) * 1000000 = 90.909,091
  • Arredondamento de meio par em 90909,091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

Enums
UNKNOWN_RESULT Nunca defina esse valor padrão.
SUCCESS Extrato de remessa aceito com modificações.
INVALID_VAT_MODIFICATION A modificação do IVA não foi aceita devido a uma solicitação inválida.