- درخواست HTTP
- درخواست بدن
- بدن پاسخگو
- اصلاح FeeToVATM
- Accept RemittanceStatementWithModificationsResultCode
به Google میگوید که صورتحساب نشاندادهشده در این درخواست پس از انجام تغییراتی در صورتحساب، مانند هزینهای برای طبقهبندی مجدد VAT، پرداخت میشود.
اگر این روش یک HTTP 200 را برنگرداند، ممکن است پاسخهای این پرسوجو خالی باشد. در شرایطی که میتوان از یک ErrorResponse
با توضیح واضح برای کمک به مهاجم برای درک شناسه حساب یکپارچهساز پرداخت سایر ادغامکنندهها استفاده کرد، پاسخها خالی هستند. در این شرایط، که یا کلید امضا مطابقت ندارد یا کلید رمزگذاری ناشناخته بود، این روش یک HTTP 404 را با بدنه خالی برمی گرداند.
یک نمونه درخواست به نظر می رسد:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "0123434-abc",
"requestTimestamp": "1502545413098"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD",
"statementId": "0123434-statement-abc",
"feeToVatModification": {
"vatToFeeRatioInMicros": "150000"
}
}
یک نمونه پاسخ به نظر می رسد:
{
"responseHeader": {
"responseTimestamp": "1519996752221"
},
"acceptRemittanceStatementWithModificationsResultCode": "SUCCESS"
}
درخواست HTTP
POST https://vgw.googleapis.com/secure-serving/gsp/v1/acceptRemittanceStatementWithModifications/ :PIAID
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "requestHeader": { object ( |
زمینه های | |
---|---|
requestHeader | مورد نیاز : هدر مشترک برای همه درخواست ها. |
paymentIntegratorAccountId | الزامی : این شناسه حساب یکپارچهکننده پرداخت است که محدودیتهای قراردادی پیرامون این بیانیه را مشخص میکند. |
statementId | الزامی است : شناسه درخواست اعلان بیانیه ای که این درخواست تغییر می دهد. |
اتحادیه | |
feeToVatModification | الزامی : درخواست اصلاح برای تخصیص مجدد بخشی از هزینه ها به مالیات بر ارزش افزوده (VAT). |
بدن پاسخگو
شی پاسخ برای روش acceptRemittanceStatementWithModifications
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "responseHeader": { object ( |
زمینه های | |
---|---|
responseHeader | مورد نیاز : هدر مشترک برای همه پاسخ ها. |
acceptRemittanceStatementWithModificationsResultCode | مورد نیاز : نتیجه تماس v1.acceptRemittanceStatement. |
اصلاح FeeToVATM
این شی تغییرات مالیاتی را برای اعمال در صورتهای حواله ارائه میکند.
نمایندگی JSON |
---|
{ "vatToFeeRatioInMicros": string } |
زمینه های | |
---|---|
vatToFeeRatioInMicros | مورد نیاز : نسبت مالیات بر ارزش افزوده به مبلغ کارمزد در میکرو. این درصد هزینه هایی است که باید دوباره به مالیات بر ارزش افزوده تخصیص داده شود و باید بیشتر یا مساوی صفر باشد. گرد کردن باید "نیمه زوج" یا "بانکدار" باشد، به معنای گرد کردن به همسایه زوج در صورتی که هر دو عدد از هم فاصله دارند (مثلاً 2.5 -> 2، 5.5 -> 6). نمونه ای برای محاسبه مالیات به شرح زیر است:
|
Accept RemittanceStatementWithModificationsResultCode
Enums | |
---|---|
UNKNOWN_RESULT | هرگز این مقدار پیش فرض را تنظیم نکنید! |
SUCCESS | بیانیه حواله با تغییرات با موفقیت پذیرفته شد. |
INVALID_VAT_MODIFICATION | اصلاح VAT به دلیل یک درخواست نامعتبر پذیرفته نشد. |