1. Sales
V8STD
  • Index
  • Inventory
    • TrfRsAdj
      POST
    • GRConfirm
      POST
    • ItemStockOnHand
      POST
    • GRUpdate
      POST
    • QtyAdj
      POST
    • TrfRsOut
      POST
    • QtyAdjConfirm
      POST
    • StkCntUpdate
      POST
    • GoodsReturnUpdate
      POST
    • GoodsReturnConfirm
      POST
    • TrfRsIn
      POST
    • TrfReqConfirm
      POST
    • TrfReq
      POST
    • POUpdate
      POST
    • POStatusChange
      POST
    • TrfRsConfirm
      POST
  • Inventory Enquiry
    • enq_TrfRsOsNote
      POST
    • enq_TrfRs
      POST
  • Master
    • itemSearchTTPos
      POST
  • Master Export
    • barCodeExport
      POST
    • storeExport
      POST
    • staffExport
      POST
    • ReasonExport
      POST
    • itemPriceExport
      POST
    • itemMasterExport
      POST
    • tenderExport
      POST
  • Master Import
    • itemPriceImport
    • barcodeImport
    • itemMasterImport
    • staffImport
  • Sales
    • salesTransStd
      POST
    • salesValidate
      POST
    • salesVoid
      POST
    • salesMemoStdEnquiry
      POST
  • Vip
    • vipBonusAdjustVipStd
    • vipSearchVipStd
    • vipMasterBasicCreateVipStd
    • vipBonusEnquiryVipStd
  • Device Login
    • Get_APIKEY
  1. Sales

salesTransStd

测试中
POST
/posservice/rest/salestransaction/std
salesTransStd 標準版銷售接口
該接口用於接入銷售單據,接口傳入字段會先經過接口驗證是否可用才能生成系統處理的銷售單據。
This interface is used to access the sales document. The incoming fields of the interface are verified by the interface before generating the sales document processed by the system.

请求参数

Authorization
在 header 添加参数
apiKey
示例:
apiKey: ********************
Body 参数application/json

示例
{
    "transHdr": {
        "txDate": "2024-05-24",
        "ledgerDatetime": "2024-05-24 11:59:06",
        "programName": "TTPOS",
        "storeCode": "BJ001",
        "tillId": "01",
        "docType": "S",
        "staffCode": "5555",
        "vipCode": null,
        "docNo": "S011110119202427",
        "voidDocNo": null,
        "txSerial": 26,
        "orgPrefix": "HQ",
        "docLockSequence": 0,
        "version": 0,
        "txAttrib": null
    },
    "apiKey": "{{apiKey}}",
    "signature": "",
    "docKey": "20240024,BJ001,01,S011110119202427",
    "transHeader": {
        "txDate": "2024-05-24",
        "ledgerDatetime": "2024-05-24 11:59:06",
        "programName": "TTPOS",
        "storeCode": "BJ001",
        "tillId": "01",
        "docType": "S",
        "staffCode": "5555",
        "vipCode": null,
        "docNo": "S011110119202427",
        "voidDocNo": null,
        "txSerial": 26,
        "orgPrefix": "HQ",
        "docLockSequence": 0,
        "version": 0,
        "txAttrib": null
    },
    "salesTotal": {
        "cashier": "5555",
        "vipCode": null,
        "vipFamilyId": 0,
        "demographicCode": "AB",
        "demographicData": "MQ",
        "netQty": 1,
        "originalAmount": 20.5,
        "sellingAmount": 20.5,
        "discountApprove": "",
        "discountMode": "",
        "discountValue": 0,
        "discountLess": 0,
        "taxAmount1": 0,
        "taxAmount2": 0,
        "netAmount": 20.5,
        "priceIncludeTax": "",
        "shopTaxGroup": "",
        "extendParameter": "",
        "calculateVipBonus": ""
    },
    "salesItem": [
        {
            "salesLineNumber": 0,
            "salesman": [
                "666"
            ],
            "vipGradeCenter": "",
            "vipBonusCenter": "000000",
            "vipBonusEarn": 0,
            "vipBonusRedeem": 0,
            "itemCode": "10001111",
            "itemOrgId": "000000",
            "itemLotNum": "*",
            "serialNumber": "",
            "isDeposit": 0,
            "isWholesale": 0,
            "inventoryType": 0,
            "qty": 1,
            "exStk2Sales": 0,
            "originalPrice": 20.5,
            "sellingPrice": 20.5,
            "priceMode": 0,
            "priceApprove": "",
            "itemDiscountApprove": "",
            "itemDiscountMode": "",
            "itemDiscountValue": 0,
            "itemDiscountLess": 0,
            "totalDiscountLess": 0,
            "promotionResult": "",
            "taxAmount1": 0,
            "taxAmount2": 0,
            "taxRate1": 0,
            "taxRate2": 0,
            "netAmount": 20.5,
            "salesItemRemark": "",
            "refundReasonCode": "",
            "extendParameter": "",
            "bonusExpiryDate": null
        }
    ],
    "salesTender": [
        {
            "tenderLineNum": 0,
            "baseCurrencyCode": "RMB",
            "tenderCode": "CH",
            "tenderType": 0,
            "tenderCategory": 4,
            "payAmount": 20.5,
            "baseAmount": 20.5,
            "excessAmount": 0,
            "extendParameter": ""
        }
    ],
    "vipBonusLedger": null,
    "couponIssue": null,
    "couponSettle": null,
    "giftCertRewardIssue": null,
    "giftCertSalesIssue": null,
    "giftCertSettle": null,
    "salesMobilePay": null,
    "refundItem": null,
    "refundTender": null,
    "orgSalesMemo": null
}

请求示例代码

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/std' \
--header 'apiKey: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transHdr": {
        "txDate": "2024-05-24",
        "ledgerDatetime": "2024-05-24 11:59:06",
        "programName": "TTPOS",
        "storeCode": "BJ001",
        "tillId": "01",
        "docType": "S",
        "staffCode": "5555",
        "vipCode": null,
        "docNo": "S011110119202427",
        "voidDocNo": null,
        "txSerial": 26,
        "orgPrefix": "HQ",
        "docLockSequence": 0,
        "version": 0,
        "txAttrib": null
    },
    "apiKey": "{{apiKey}}",
    "signature": "",
    "docKey": "20240024,BJ001,01,S011110119202427",
    "transHeader": {
        "txDate": "2024-05-24",
        "ledgerDatetime": "2024-05-24 11:59:06",
        "programName": "TTPOS",
        "storeCode": "BJ001",
        "tillId": "01",
        "docType": "S",
        "staffCode": "5555",
        "vipCode": null,
        "docNo": "S011110119202427",
        "voidDocNo": null,
        "txSerial": 26,
        "orgPrefix": "HQ",
        "docLockSequence": 0,
        "version": 0,
        "txAttrib": null
    },
    "salesTotal": {
        "cashier": "5555",
        "vipCode": null,
        "vipFamilyId": 0,
        "demographicCode": "AB",
        "demographicData": "MQ",
        "netQty": 1,
        "originalAmount": 20.5,
        "sellingAmount": 20.5,
        "discountApprove": "",
        "discountMode": "",
        "discountValue": 0,
        "discountLess": 0,
        "taxAmount1": 0,
        "taxAmount2": 0,
        "netAmount": 20.5,
        "priceIncludeTax": "",
        "shopTaxGroup": "",
        "extendParameter": "",
        "calculateVipBonus": ""
    },
    "salesItem": [
        {
            "salesLineNumber": 0,
            "salesman": [
                "666"
            ],
            "vipGradeCenter": "",
            "vipBonusCenter": "000000",
            "vipBonusEarn": 0,
            "vipBonusRedeem": 0,
            "itemCode": "10001111",
            "itemOrgId": "000000",
            "itemLotNum": "*",
            "serialNumber": "",
            "isDeposit": 0,
            "isWholesale": 0,
            "inventoryType": 0,
            "qty": 1,
            "exStk2Sales": 0,
            "originalPrice": 20.5,
            "sellingPrice": 20.5,
            "priceMode": 0,
            "priceApprove": "",
            "itemDiscountApprove": "",
            "itemDiscountMode": "",
            "itemDiscountValue": 0,
            "itemDiscountLess": 0,
            "totalDiscountLess": 0,
            "promotionResult": "",
            "taxAmount1": 0,
            "taxAmount2": 0,
            "taxRate1": 0,
            "taxRate2": 0,
            "netAmount": 20.5,
            "salesItemRemark": "",
            "refundReasonCode": "",
            "extendParameter": "",
            "bonusExpiryDate": null
        }
    ],
    "salesTender": [
        {
            "tenderLineNum": 0,
            "baseCurrencyCode": "RMB",
            "tenderCode": "CH",
            "tenderType": 0,
            "tenderCategory": 4,
            "payAmount": 20.5,
            "baseAmount": 20.5,
            "excessAmount": 0,
            "extendParameter": ""
        }
    ],
    "vipBonusLedger": null,
    "couponIssue": null,
    "couponSettle": null,
    "giftCertRewardIssue": null,
    "giftCertSalesIssue": null,
    "giftCertSettle": null,
    "salesMobilePay": null,
    "refundItem": null,
    "refundTender": null,
    "orgSalesMemo": null
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "asynCode": null,
    "asynMessage": null,
    "asynStatus": 0,
    "className": "com.techtrans.api.sales.website.SalesTransStdResponse",
    "errorCode": 0,
    "errorLog": null,
    "errorMessage": null,
    "salesDocNo": "S011110119202427"
}
🟢200处理数据失败
🟠404响应失败
修改于 2024-09-25 09:08:43
上一页
Sales
下一页
salesValidate
Built with