salesValidate
测试中
POST
/posservice/rest/salestransaction/salesvalidate
接口說明： 貨品校驗，庫存校驗，促銷計算，折扣券驗證，禮券驗證（根據validationMethod字段判斷）
Interface description: items verification, inventory verification, promotion calculation, coupon verification, giftcert verification (Based on the validationMethod field)
相關處理logic 參考：Sales
请求参数
Authorization
在 header 添加参数
apiKey
示例：
apiKey: ********************Body 参数application/json
示例
{
"apiKey": "{{apiKey}}",
"transHdr": {
"txDate": "2024-05-24 16:12:01",
"ledgerDatetime": "2024-05-24 16:12:01",
"storeCode": "BJ001",
"tillId": "01",
"docNo": "S011110119202423"
},
"salesTotal": {
"cashier": "5555",
"netAmount": 1010
},
"salesItem": [
{
"salesLineNumber": 0,
"vipBonusEarn": 0,
"vipBonusRedeem": 0,
"itemCode": "10001111",
"itemOrgId": "000000",
"itemLotNum": "*",
"inventoryType": 0,
"qty": 1,
"itemDiscountApprove": "",
"itemDiscountLess": 0,
"totalDiscountLess": 0,
"netAmount": 1010,
"salesItemRemark": "",
"extendParameter": "",
"vipGradeCenter": "",
"vipBonusCenter": "",
"priceMode": "0",
"salesman": [
"666"
],
"sellingPrice": 1010,
"originalPrice": 1010,
"itemDiscountMode": "0",
"itemDiscountValue": 0
}
],
"salesTender": [],
"validationMethod": 2
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/posservice/rest/salestransaction/salesvalidate' \
--header 'apiKey: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"apiKey": "{{apiKey}}",
"transHdr": {
"txDate": "2024-05-24 16:12:01",
"ledgerDatetime": "2024-05-24 16:12:01",
"storeCode": "BJ001",
"tillId": "01",
"docNo": "S011110119202423"
},
"salesTotal": {
"cashier": "5555",
"netAmount": 1010
},
"salesItem": [
{
"salesLineNumber": 0,
"vipBonusEarn": 0,
"vipBonusRedeem": 0,
"itemCode": "10001111",
"itemOrgId": "000000",
"itemLotNum": "*",
"inventoryType": 0,
"qty": 1,
"itemDiscountApprove": "",
"itemDiscountLess": 0,
"totalDiscountLess": 0,
"netAmount": 1010,
"salesItemRemark": "",
"extendParameter": "",
"vipGradeCenter": "",
"vipBonusCenter": "",
"priceMode": "0",
"salesman": [
"666"
],
"sellingPrice": 1010,
"originalPrice": 1010,
"itemDiscountMode": "0",
"itemDiscountValue": 0
}
],
"salesTender": [],
"validationMethod": 2
}'返回响应
🟢200成功
application/json
Body
示例
{
"asynCode": null,
"asynMessage": null,
"asynStatus": 0,
"availableRefund": null,
"className": "com.techtrans.api.sales.website.SalesValidateResponse",
"errorCode": 0,
"errorLog": null,
"errorMessage": null,
"itemPomotion": [
{
"group": [
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"lineNumber": 0,
"promBonus": [
0,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"promDesci": [
"test",
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"promId": [
"PEOHQO240500001",
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"promLessAmt": [
100,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"promMethodDesci": [
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"promMethodId": [
"1",
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"promPkgCount": [
10,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"promProperty": [
" ",
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
],
"promUseQty": [
0.9901,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null,
null
]
}
],
"orgSales": null,
"promotionCouponIssue": [
{
"actualQty": null,
"couponBatchNum": "HQ020",
"couponNumber": null,
"couponOrgId": null,
"effectDate": null,
"expiryDate": null,
"promId": "PEOHQO240500001",
"promMethodId": "1",
"totalIssuedQty": 1
}
],
"promotionCouponSettle": null,
"promotionGiftcertIssue": [],
"redeemBonus": null,
"refundedSales": null,
"salesItem": [
{
"bonusExpiryDate": null,
"exStk2Sales": null,
"extendParameter": "",
"inventoryType": 0,
"isDeposit": "",
"isWholesale": "",
"itemCode": "10001111",
"itemDiscountApprove": "",
"itemDiscountLess": 0,
"itemDiscountMode": "0",
"itemDiscountValue": 0,
"itemLotNum": "*",
"itemOrgId": "000000",
"netAmount": 1010,
"originalPrice": 1010,
"priceApprove": "",
"priceMode": "0",
"promotionResult": "PEOHQO240500001,1,0.9901,100.0,10.0,0.00,100.000 -BR,;",
"qty": 1,
"refundReasonCode": "",
"salesItemRemark": "",
"salesLineNumber": 0,
"salesman": [
"666"
],
"sellingPrice": 1010,
"serialNumber": "",
"taxAmount1": null,
"taxAmount2": null,
"taxRate1": null,
"taxRate2": null,
"totalDiscountLess": 0,
"vipBonusCenter": null,
"vipBonusEarn": 0,
"vipBonusRedeem": 0,
"vipGradeCenter": null
}
],
"salesQoh": null,
"salesTender": [],
"salesTotal": {
"calculateVipBonus": "",
"cashier": "5555",
"demographicCode": "",
"demographicData": "",
"discountApprove": "",
"discountLess": null,
"discountMode": "",
"discountValue": null,
"extendParameter": "",
"netAmount": 1010,
"netQty": null,
"originalAmount": null,
"priceIncludeTax": "",
"refDocNo": null,
"sellingAmount": null,
"shopTaxGroup": "",
"taxAmount1": null,
"taxAmount2": null,
"vipCode": "",
"vipFamilyId": 0
},
"validateError": null,
"vipBonus": null
}🟢200处理数据失败
🟠404响应失败
修改于 2025-09-30 07:11:06