- Yêu cầu HTTP
- Nội dung yêu cầu
- Nội dung phản hồi
- Phí sửa đổi thuế GTGT
- AcceptRemittanceStatementWithModifyResultCode
Thông báo cho Google biết bảng sao kê trong yêu cầu này sẽ được thanh toán sau khi sửa đổi, chẳng hạn như phí phân loại lại VAT.
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
Các 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 các tình huống mà
có nội dung mô tả rõ ràng có thể được sử dụng để giúp kẻ tấn công hiểu giá trị nhận dạng tài khoản của nhà 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, không tìm thấy giá trị nhận dạng nhà tích hợp thanh toán hoặc khoá mã hoá, phương thức này sẽ trả về HTTP 404 không có mã. Nếu có thể xác minh chữ ký yêu cầu, thông tin bổ sung về lỗi sẽ được trả về nội dung phản hồi.ErrorResponse
Một yêu cầu mẫu 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"
}
}
Một 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 với cấu trúc như sau:
Biểu diễn dưới dạng JSON |
---|
{ "requestHeader": { object ( |
Các trường | |
---|---|
requestHeader |
BẮT BUỘC: Tiêu đề chung cho tất cả các yêu cầu. |
paymentIntegratorAccountId |
BẮT BUỘC: Đây là mã định danh tài khoản tích hợp thanh toán xác định ràng buộc hợp đồng xung quanh bảng sao kê này. |
statementId |
BẮT BUỘC: ID yêu cầu của thông báo tuyên bố mà yêu cầu này sửa đổi. |
Trường nhóm
|
|
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 (VAT). |
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 ( |
Các trường | |
---|---|
responseHeader |
BẮT BUỘC: Tiêu đề chung cho tất cả các phản hồi. |
acceptRemittanceStatementWithModificationsResultCode |
BẮT BUỘC: Kết quả của lệnh gọi v1.AcceptRemittanceStatement. |
Sửa đổi phí VAT
Đối tượng này cung cấp các nội dung 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 } |
Các trường | |
---|---|
vatToFeeRatioInMicros |
BẮT BUỘC: Tỷ lệ VAT với số tiền Phí theo micro. Đây là tỷ lệ phần trăm phí để quy lại thuế VAT và phải lớn hơn hoặc bằng 0. Làm tròn phải là "một nửa chẵn" hoặc "ngân hàng" làm tròn, nghĩa là làm tròn đến hàng xóm đồng đều trong trường hợp cả hai số đều bằng nhau (ví dụ: 2,5 -> 2, 5,5 -> 6). Dưới đây là ví dụ về cách tính thuế:
|
AcceptRemittanceStatementWithModifyResultCode
Enum | |
---|---|
UNKNOWN_RESULT |
Không bao giờ đặt giá trị mặc định này! |
SUCCESS |
Đã chấp nhận bản sao kê chuyển tiền có nội dung sửa đổi. |
INVALID_VAT_MODIFICATION |
Sửa đổi VAT không được chấp nhận do yêu cầu không hợp lệ. |