TaxRis Gateway Manager
Dashboard
dev
-
Invoices
0
Approved
0
Platform Clients
0
Gateway
Not set
Recent TaxRis
ໃບກຳກັບລ່າສຸດ
| Serial | Buyer | Total | Status | Invoice No. |
|---|
Activity
Logs
Gateway Response
ຜົນການສົ່ງ
{}
Verification
ກວດສອບສະຖານະ
Credit / Cancel
Red Invoice & Cancel
{}
External Platforms
API Clients
Integration
Platform API Reference
POST /api/platform.php?action=issue_invoice
POST /api/platform.php?action=query_invoice_result
POST /api/platform.php?action=query_tax_list
Headers: X-Client-Id, X-Api-Key, Content-Type: application/json
{
"payload": {
"issueCode": "1234567890",
"data": {
"serialNum": "32_char_unique_id",
"issueType": 0,
"issueCode": "1234567890",
"supplierCode": "1234567890",
"buyerCode": "8765678987656",
"totalNetAmount": "100.00",
"totalTaxAmount": "10.00",
"partyList": [],
"lineList": [],
"taxList": []
}
}
}
Integration Manual
ຄູ່ມືໃຫ້ platform ອື່ນເຊື່ອມ TaxRis
1. ສ້າງ API Client
ໄປທີ່ໜ້າ Platform API, ສ້າງ Client ໃໝ່, ເລືອກ environment, ກຳນົດ issueCode ທີ່ອະນຸຍາດ. ລະບົບຈະສະແດງ API key ຄັ້ງດຽວ ຕ້ອງເກັບໄວ້ທັນທີ.
2. Headers ທີ່ platform ຕ້ອງສົ່ງ
Content-Type: application/json X-Client-Id: cli_xxxxxxxxxxxxxxxx X-Api-Key: taxris_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3. ອອກ TaxRis
POST ໄປທີ່ endpoint ນີ້. Platform ບໍ່ຕ້ອງເຮັດ HMAC ເອງ, SmartTechnology TaxRis Gateway ຈະເຊັນ HMAC ແລະສົ່ງຕໍ່ໄປ TaxRis ໃຫ້.
POST /api/platform.php?action=issue_invoice
{
"payload": {
"issueCode": "1234567890",
"data": {
"serialNum": "550e8400e29b41d4a716446655440000",
"issueType": 0,
"issueCode": "1234567890",
"supplierCode": "1234567890",
"buyerCode": "8765678987656",
"totalNetAmount": "100.00",
"totalTaxAmount": "10.00",
"remarks": "Invoice from partner platform",
"partyList": [
{ "sn": 1, "partyType": "001", "code": "1234567890", "name": "SmartTechnology" },
{ "sn": 2, "partyType": "003", "code": "8765678987656", "name": "Customer Co., Ltd." }
],
"taxList": [
{ "sn": 1, "taxType": "001", "taxAmount": "10.00" }
],
"lineList": [
{
"sn": 1,
"description": "Service fee",
"unitPrice": "100.00",
"quantity": "1",
"unit": "service",
"taxExcludingAmount": "100.00",
"taxAmount": "10.00",
"taxIncludingAmount": "110.00",
"taxList": [
{ "sn": 1, "taxType": "001", "taxRate": "0.1", "taxAmount": "10.00" }
]
}
],
"allowanceList": []
}
}
}
4. ກວດສອບສະຖານະ TaxRis
POST /api/platform.php?action=query_invoice_result
{
"issueCode": "1234567890",
"serialNum": "550e8400e29b41d4a716446655440000"
}
5. ດຶງອັດຕາພາສີ
POST /api/platform.php?action=query_tax_list
{ "issueCode": "1234567890" }
Response
ຮູບແບບຄຳຕອບ
ທຸກ response ຈະກັບໃນຮູບແບບ JSON:
{
"success": true,
"data": {
"ok": true,
"status": 200,
"body": {
"requestId": "...",
"success": true,
"errorCode": "0",
"errorMsg": "",
"data": []
}
}
}
ຖ້າ `success=false`, ໃຫ້ platform ອ່ານ `message`, `data.status`, `data.body.errorCode`, ແລະ `request_id` ເພື່ອຕິດຕາມບັນຫາ.
{}