Method: acceptRemittanceStatementWithModifications

Cho Google biết rằng bảng sao kê nêu trong yêu cầu này sẽ được thanh toán sau khi bạn sửa đổi nội dung trên bảng sao kê, chẳng hạn như phí phân loại lại thuế GTGT.

Nếu điểm cuối gặp lỗi trong khi xử lý yêu cầu, thì phản hồi từ điểm cuối này sẽ thuộc loại ErrorResponse.

Phản hồi cho truy vấn này có thể trống nếu phương thức này không trả về HTTP 200. Nội dung phản hồi bị trống trong trường hợp ErrorResponse có nội dung mô tả rõ ràng có thể được dùng để giúp kẻ tấn công hiểu được giá trị nhận dạng tài khoản của đối tác tích hợp thanh toán khác. Trong những trường hợp như vậy, khi khoá ký không khớp, không tìm thấy giá trị nhận dạng của trình tích hợp thanh toán hoặc không xác định được khoá mã hoá, thì phương thức này sẽ trả về một HTTP 404 có phần nội dung trống. Nếu chữ ký của yêu cầu có thể được xác minh thì thông tin bổ sung về lỗi sẽ được trả về trong nội dung phản hồi.

Yêu cầu mẫu sẽ có dạng như sau:


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

Câu trả lời mẫu sẽ có dạng như sau:


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

Yêu cầu HTTP

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Trường
requestHeader

object (RequestHeader)

BẮT BUỘC: Tiêu đề chung cho tất cả các yêu cầu.
paymentIntegratorAccountId

string

BẮT BUỘC: Đây là giá trị nhận dạng tài khoản của đối tác tích hợp thanh toán giúp xác định những điều kiện ràng buộc theo hợp đồng áp dụng cho bảng sao kê này.
statementId

string

BẮT BUỘC: Mã yêu cầu của thông báo bảng sao kê mà yêu cầu này sửa đổi.

Trường kết hợp modification_type.

modification_type chỉ có thể là một trong những trạng thái sau đây:
feeToVatModification

object (FeeToVATModification)

BẮT BUỘC: Yêu cầu sửa đổi để phân bổ lại một phần phí cho thuế giá trị gia tăng (GTGT).

Nội dung phản hồi

Đối tượng phản hồi cho phương thức acceptRemittanceStatementWithModifications.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Trường
responseHeader

object (ResponseHeader)

BẮT BUỘC: Tiêu đề chung cho tất cả câu trả lời.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

BẮT BUỘC: Kết quả của lệnh gọi v1.acceptRemittanceStatement.

FeeToVATModification

Đối tượng này cung cấp thông tin sửa đổi về thuế sẽ áp dụng cho bảng sao kê chuyển tiền.

Biểu diễn dưới dạng JSON 
{
  "vatToFeeRatioInMicros": string
}
Trường
vatToFeeRatioInMicros

string (Int64Value format)

BẮT BUỘC: Tỷ lệ giữa thuế GTGT và số tiền Phí dưới dạng phần triệu. Đây là tỷ lệ phần trăm các khoản phí được quy đổi lại thành thuế GTGT và phải lớn hơn hoặc bằng 0. Làm tròn phải là "nửa đều" hoặc " của ngân hàng" làm tròn, nghĩa là làm tròn đến hàng xóm chẵn trong trường hợp cả hai số cách đều nhau (ví dụ: 2,5 -> 2, 5,5 -> 6).

Dưới đây là mẫu để tính thuế:

  • Phí xử lý bao gồm thuế do đơn vị tích hợp thanh toán thu: 1.000 USD
  • Thuế suất: 10%
  • Theo đó, 1000 USD = (phí xử lý) + (10% * phí xử lý)
  • Phí xử lý (thuế Sans) = 1000 / 1,1 = 909,090909 USD
  • Khoản thuế trả bởi nhà tích hợp thanh toán = 1000 - 909,090909 = 90,909091 USD
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • Làm tròn nửa chẵn trên 90909,091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

Enum
UNKNOWN_RESULT Đừng bao giờ đặt giá trị mặc định này!
SUCCESS Bảng sao kê chuyển tiền đã được chấp nhận và có sửa đổi thành công.
INVALID_VAT_MODIFICATION Nội dung sửa đổi thuế GTGT không được chấp nhận do yêu cầu không hợp lệ.