Method: acceptRemittanceStatementWithModifications

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

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. Chúng trống trong trường hợp ErrorResponse có nội dung mô tả rõ ràng có thể dùng để giúp kẻ tấn công hiểu được giá trị nhận dạng tài khoản của bên tích hợp thanh toán của các nhà tích hợp khác. Trong các trường hợp này, khi khoá ký không khớp hoặc khoá mã hoá không xác định, phương thức này sẽ trả về HTTP 404 với phần nội dung trống.

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

Phản hồ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.
}
Các trường
requestHeader

object (RequestHeader)

REQUIRED: Tiêu đề chung cho tất cả các yêu cầu.
paymentIntegratorAccountId

string

REQUIRED: Đây là mã nhận dạng tài khoản của đơn vị tích hợp thanh toán, giúp xác định những ràng buộc theo hợp đồng xung quanh tuyên bố này.
statementId

string

REQUIRED: Mã yêu cầu của thông báo cho biết yêu cầu này sửa đổi.

Trường nhóm 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í vào 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)
}
Các trường
responseHeader

object (ResponseHeader)

REQUIRED: Tiêu đề chung cho tất cả các câu trả lời.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

REQUIRED: Kết quả của lệnh gọi v1.acceptRemittanceStatement.

FeeToVATModification

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

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

string (Int64Value format)

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

Sau đây là ví dụ về cách tính thuế:

  • Phí xử lý bao gồm thuế do công ty 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
  • Thuế do bên tích hợp thanh toán trả = 1.000 - 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 Đã chấp nhận thành công bảng sao kê chuyển tiền với các nội dung sửa đổi.
INVALID_VAT_MODIFICATION Sửa đổi thuế GTGT không được chấp nhận do yêu cầu không hợp lệ.