นำส่งข้อมูลขอเสียอากรแสตมป์เป็นตัวเงิน สำหรับตราสารอิเล็กทรอนิกส์
Post /stamp/SubmitFiling
สำหรับนำส่งข้อมูลการขอเสียอากร URL: https://sample.rd.go.th/stamp/SubmitFiling
Request Header
| Name | Type | Required | Description |
|---|---|---|---|
| Content-type | String | Required | Content type of request payload Value: - application/json |
| X-auth-token | String | Required | Access token Value: - TokenId from Response API1 |
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
| eInstrument | Object | Required | Root element |
| sender | Object | Required | รายละเอียดผู้นำส่ง |
| id | String(20) | Required | รหัสผู้นำส่ง |
| senderRole | String(1) | Required | สิทธิ์ของผู้นำส่ง 1 = เป็นผู้มีหน้าที่เสียอากร (Direct) 2 = ผู้ให้บริการตัวแทน |
| rdForm | String | Required | ข้อมูลแบบแสดงรายการที่อยู่ในรูปแบบ JWS (JSON Web Signature) |
Example Request
POST https://sample.rd.go.th/stamp/SubmitFiling
Header
{
"Content-type": "application/json",
"X-auth-token": "TbDd2e5HoQ0q0YhJ4hS2rLVWchNS5ilKb4Xmi5PIghWJjOc1OeB"
}
Body
{
"eInstrument": {
"sender": {
"id": "XYZ00001",
"senderRole": "1"
},
"rdForm": "ewogICJyZEZvcm0iOiB7CiAgICAiZG9jRGV0YWlsIjogewogICAgICAiZm9ybUNv
ZGUiOiAiUE5EeHgiLAogICAgICAidmVyc2lvbiI6ICIwMS4wMS4wMSIKICAgIH0sCiAgICAiZm9
ybURldGFpbCI6IHsKICAgICAgInRheFBheWVySW5mbyI6IHsKICAgICAgICAidGF4UGF5ZXJJRC
I6ICIwMTA1NVgzMDA1ODJYIiwKICAgICAgICAiYnJhbmNoTm8iOiAwLAogICAgICAgICJicmFuY
2hUeXBlIjogIlYiCiAgICAgIH0sCiAgICA.gICJ0YXhEZXRhaWwiOiB7CiAgICAgICAgInNlbmR
ObyI6IDAsCiAgICAgICAgInRheFllYXIiOiAiMjU2ICAgICAgICAgICAgIm1vbyI6ICLguKvguK
HguLnguYgiLAogICAgICAgICAgICAic29pIjogIuC4i-C4rogICAgICAgICAgInBhaWREZXRhaW
wiOiBbCiAgICAgICAgICAgIHsKICAgICAgICAgICAgICAiZGF0ZSI6ICIyNTYxLTExLTAzIiwKI
CAgICAgICAgICAgICAidHlwZSI6ICLguITguYjguLLguYDguIrguYjguLLg.uK3guLLguITguLL
guKMiLAogICAgICAgICAgICAgICJyYXRlIjogMywKICAgICAgICAgICAgICAiYW1vduKfguLLgu
KEiLAogICAgICAgICAgICAgICJyYXRlIjogMywKICAgICAgICAgICAgICAiYW1vdW50ICn0="
}
}
ตารางข้อมูล rdForm
| Name | Type | Required | Description |
|---|---|---|---|
| documentDetail | Object | Required | Document Detail |
| requestId | String(35) | Required | รหัสการร้องขอ (unique) |
| formType | String(5) | Required | ประเภทแบบ Value: OS9 |
| typeCode | String(2) | Required | ลักษณะตราสาร Value: 4 = ลักษณะตราสาร 4 จ้างทำของ 5 = ลักษณะตราสาร 5 กู้ยืมเงิน หรือการตกลงให้เบิกเงินเกินบัญชีจากธนาคาร 7 = ลักษณะตราสาร 7 ใบมอบอำนาจ 8 = ลักษณะตราสาร 8 ใบมอบฉันทะสำหรับให้ลงมติในที่ประชุมของบริษัท 17 = ลักษณะตราสาร 17 ค้ำประกัน |
| version | String(10) | Required | เวอร์ชันของแบบขอเสียอากรแสตมป์ |
| transAmount | Number | Required | จำนวนตราสารที่ส่งในครั้งนี้ |
| instInfo | Object | Required | รายละเอียดตราสาร |
| id | String(50) | Required | หมายเลขอ้างอิงตราสารอิเล็กทรอนิกส์ |
| contractNo | String(50) | Optional | เลขที่สัญญา |
| creationDate | Date | Optional | วันที่จัดทำสัญญา |
| effectiveDate | Date | Optional | วันที่เริ่มสัญญา |
| expireDate | Date | Optional | วันที่สิ้นสุดสัญญา |
| sendFormType | String(1) | Required | ประเภทการยื่นตราสาร 1 = ยื่นปกติ 2 = ยื่นเพิ่มเติม (กรณียื่นเพิ่มเติมสัญญาฉบับเดิม) |
| relateInstInfo | Object | Optional | รายละเอียดตราสารยื่นเพิ่มเติมสัญญาฉบับเดิม |
| id | String(50) | Required | หมายเลขอ้างอิงตราสารอิเล็กทรอนิกส์ฉบับเดิม |
| contractNo | String(50) | Optional | เลขที่สัญญาฉบับเดิม |
| creationDate | Date | Optional | วันที่จัดทำสัญญาฉบับเดิม |
| instAmount | Decimal(13,2) | Optional | มูลค่าของตราสาร (ไม่รวมภาษีมูลค่าเพิ่ม) ลักษณะตราสาร 4 = มูลค่าสินจ้าง ลักษณะตราสาร 5 = จำนวนเงินที่กู้ยืมหรือให้เบิกเกินบัญชี |
| taxPayer | Object | Required | ข้อมูลผู้ยื่นขอเสียอากรแสตมป์ |
| specifiedTaxRegistration | Object | Required | ข้อมูลการลงทะเบียนผู้เสียภาษีอากร |
| id | String(13) | Required | เลขประจำตัวผู้เสียอากรของผู้ยื่นขอเสียอากรแสตมป์ |
| branchNo | String(5) | Optional | เลขที่สาขา |
| branchType | String(1) | Required | ประเภทสาขา V = สาขา VAT หรือเป็นทั้งสาขา VAT และ SBT, S = สาขา SBT, O = สำนักงานใหญ่ หรือ ไม่ได้จด VAT และ SBT |
| relationship | String(1) | Required | ในฐานะ (ความเกี่ยวข้องกับสัญญา) ตราสาร 4 1 = ผู้รับจ้าง 2 = ผู้ว่าจ้าง ตราสาร 5 1 = ผู้ให้กู้ 2 = ผู้กู้ ตราสาร 7 1 = ผู้มอบอำนาจ 2 = ผู้รับมอบอำนาจ ตราสาร 8 1 = ผู้มอบฉันทะ 2 = ผู้รับมอบฉันทะ ตราสาร 17 1 = ผู้ค้ำ 2 = ลูกหนี้/ผู้รับจ้าง |
| party | Object | Required | ข้อมูลรายละเอียดคู่สัญญา |
| specifiedTaxRegistration | Object | Required | ข้อมูลการลงทะเบียนผู้เสียภาษีอากร |
| id | String(13) | Required | เลขประจำตัวผู้เสียอากรของคู่สัญญา |
| titleName | String(70) | Optional | คำนำหน้าชื่อคู่สัญญา |
| name | String(70) | Required | ชื่อคู่สัญญา |
| surname | String(70) | Optional | นามสกุลคู่สัญญา |
| branchNo | String(5) | Optional | เลขที่สาขาของคู่สัญญา |
| branchType | String(1) | Required | ประเภทสาขา V = สาขา VAT หรือเป็นทั้งสาขา VAT และ SBT, S = สาขา SBT, O = สำนักงานใหญ่ หรือ ไม่ได้จด VAT และ SBT |
| postalTradeAddress | Object | Required | ข้อมูลที่อยู่คู่สัญญา |
| buildingName | String(70) | Optional | ชื่ออาคาร |
| roomNo | String(16) | Optional | ห้องเลขที่ |
| floorNo | String(16) | Optional | ชั้นที่ |
| villageName | String(70) | Optional | หมู่บ้าน |
| buildingNumber | String(16) | Optional | บ้านเลขที่ |
| moo | String(70) | Optional | หมู่ที่ |
| soiName | String(70) | Optional | ซอย |
| junctionName | String(70) | Optional | แยก |
| streetName | String(70) | Optional | ถนน |
| citySubDivisionName | String(70) | Optional | ชื่อตำบล |
| cityName | String(70) | Required | ชื่ออำเภอ |
| countrySubDivisionName | String(70) | Required | ชื่อจังหวัด |
| postCode | String(20) | Optional | รหัสไปรษณีย์ |
| countryId | CountryIDType | Required | รหัสประเทศ ใช้ตาม ISO 3166-1 CountryCode Value : TH = ประเทศไทย |
| totalParty | Number | Required | จำนวนคู่สัญญา |
| attachDetail | Object | Optional | รายละเอียดเพิ่มเติม |
| detail1 | String(clob) | Optional | รายละเอียดเพิ่มเติมที่ 1 ของตราสาร ตราสาร 4 = งานที่รับจ้าง ตราสาร 5 = หลักประกัน ตราสาร 7 = รายละเอียดการมอบอำนาจ (วัตถุประสงค์) ตราสาร 8 = รายละเอียดการมอบฉันทะ (วัตถุประสงค์) |
| detail2 | String(500) | Optional | รายละเอียดเพิ่มเติมที่ 2 ของตราสาร ตราสาร 8 = ชื่อบริษัทที่เข้าประชุม |
| detail3 | String(500) | Optional | รายละเอียดเพิ่มเติมที่ 3 ของตราสาร ตราสาร 8 = ชื่อบริษัทที่เข้าประชุม |
| detail4 | String(500) | Optional | รายละเอียดเพิ่มเติมที่ 4 ของตราสาร ตราสาร 8 = เวลาที่ประชุม |
| date | Date | Optional | ตราสาร 8 = วันที่ประชุม |
| amount | Decimal(13,2) | Optional | จำนวนเงินที่เกี่ยวข้องกับสัญญา ตราสาร 4 = จำนวนเงินค้ำประกันตามสัญญา |
| number | Number | Optional | ตราสาร 4 = จำนวนงวดงาน ตราสาร 8 = ประชุมครั้งที่ |
| actionType | String(1) | Optional | เงื่อนไขสัญญา ตราสาร 7 1 = มอบอำนาจให้บุคคลคนเดียวหรือหลายคนกระทำการครั้งเดียว 2 = มอบอำนาจให้บุคคลคนเดียวหรือหลายคนร่วมกระทำการมากกว่าครั้งเดียว 3 = มอบอำนาจให้กระทำการมากกว่าครั้งเดียว โดยบุคคลหลายคนต่างคนต่างกระทำกิจการแยกกันได้ ตราสาร 8 1 = มอบฉันทะสำหรับการประชุมครั้งเดียว 2 = มอบฉันทะสำหรับการประชุมมากกว่าครั้งเดียว ตราสาร 17 1 = กรณีที่มิได้จำกัดจำนวนเงินไว้ 2 = จำนวนเงินไม่เกิน 1,000 บาท 3 = จำนวนเงินเกิน 1,000 บาท แต่ไม่เกิน 10,000 บาท 4 = จำนวนเงินเกิน 10,000 บาท ขึ้นไป |
| relateParty | Object | Optional | ผู้เกี่ยวข้องกับคู่สัญญาเพิ่มเติม |
| specifiedTaxRegistration | Object | Required | ข้อมูลการลงทะเบียนผู้เสียภาษีอากร |
| id | String(13) | Required | เลขประจำตัวผู้เกี่ยวข้องกับคู่สัญญาเพิ่มเติม |
| titleName | String(70) | Optional | คำนำหน้าชื่อของคู่สัญญาเพิ่มเติม |
| name | String(70) | Required | ชื่อของคู่สัญญาเพิ่มเติม |
| surname | String(70) | Optional | นามสกุลของคู่สัญญาเพิ่มเติม |
| branchNo | String(5) | Optional | เลขที่สาขาของคู่สัญญาเพิ่มเติม |
| branchType | String(1) | Required | ประเภทสาขา V = สาขา VAT หรือเป็นทั้งสาขา VAT และ SBT, S = สาขา SBT, O = สำนักงานใหญ่ หรือ ไม่ได้จด VAT และ SBT |
| relateContract | Object | Optional | ผู้เกี่ยวข้องกับสัญญา ตราสาร 5 = ผู้ค้ำประกัน (ถ้ามี) ตราสาร 8 = ผู้ถือหุ้นในต่างประเทศ กรณีเป็นการมอบฉันทะแบบ ค ตราสาร 17 = รายการ เจ้าหนี้/ผู้ว่าจ้าง |
| specifiedTaxRegistration | Object | Required | ข้อมูลการลงทะเบียนผู้เสียภาษีอากร |
| id | String(13) | Optional | เลขประจำตัวผู้เกี่ยวข้องกับสัญญา |
| titleName | String(70) | Optional | คำนำหน้าชื่อของผู้เกี่ยวข้องกับสัญญา |
| name | String(70) | Required | ชื่อของผู้เกี่ยวข้องกับสัญญา |
| surname | String(70) | Optional | นามสกุลของผู้เกี่ยวข้องกับสัญญา |
| branchNo | String(5) | Optional | เลขที่สาขาของผู้เกี่ยวข้องกับสัญญา |
| branchType | String(1) | Optional | ประเภทสาขา V = สาขา VAT หรือเป็นทั้งสาขา VAT และ SBT, S = สาขา SBT, O = สำนักงานใหญ่ หรือ ไม่ได้จด VAT และ SBT |
| payment | Object | Required | รายละเอียดการชำระเงิน |
| dutyAmount | Decimal(13,2) | Required | ค่าอากรแสตมป์ |
| surchargeAmount | Decimal(13,2) | Required | เงินเพิ่ม |
| fineAmount | Decimal(13,2) | Optional | ค่าปรับอาญา |
| totalAmount | Decimal(13,2) | Required | รวมอากร เงินเพิ่ม และค่าปรับอาญา |
| summary | Object | Required | รวมรายการรับชำระ |
| totalDuty | Decimal(13,2) | Required | รวมอากร |
| totalSurcharge | Decimal(13,2) | Required | รวมเงินเพิ่ม |
| totalFine | Decimal(13,2) | Optional | รวมค่าปรับอาญา |
| totalPayment | Decimal(13,2) | Required | รวมต้องชำระทั้งสิ้น (อากร+เงินเพิ่ม+ค่าปรับอาญา) |
| payer | Object | Required | ผู้ชำระเงิน |
| specifiedTaxRegistration | Object | Required | ข้อมูลการลงทะเบียนผู้เสียภาษีอากร |
| id | String(13) | Required | เลขประจำตัวผู้เสียอากรของผู้ชำระเงิน |
| responsePaymentType | String(1) | Required | รายการที่ร้องขอรายละเอียดการชำระเงิน 1 = QRPayment อย่างเดียว 2 = PayInSlip อย่างเดียว 3 = เอาเฉพาะข้อมูลชุดชำระ 4 = ทั้งหมด (1-3) |
Example rdForm
{
"documentDetail": {
"requestId": "rdtest201908200041001",
"formType": "OS9",
"typeCode": "7",
"version": "01.00.0001",
"transAmount": 1
},
"instInfo": [
{
"id": "rdtest201908200041001",
"contractNo": "",
"creationDate": "2019-08-20",
"effectiveDate": "2019-08-20",
"expireDate": null,
"sendFormType": "1",
"relateInstInfo": null,
"instAmount": null,
"taxPayer": {
"specifiedTaxRegistration": {
"id": "1111111111119"
},
"branchNo": "0",
"branchType": "O",
"relationship": "2"
},
"party": {
"specifiedTaxRegistration": {
"id": "1212121212121"
},
"titleName": "นาย",
"name": "",
"surname": "",
"branchNo": "0",
"branchType": "O",
"postalTradeAddress": {
"buildingName": "",
"roomNo": "",
"floorNo": "",
"villageName": "",
"buildingNumber": "",
"moo": "",
"soiName": "",
"junctionName": "",
"streetName": "ถนนเพชรเกษม",
"citySubDivisionName": "หาดใหญ่",
"cityName": "หาดใหญ่",
"countrySubDivisionName": "สงขลา",
"postCode": "90110",
"countryId": "TH"
},
"totalParty": 1
},
"attachDetail": {
"detail1": "สัญญาแต่งตั้งตัวแทนนายหน้า",
"detail2": null,
"detail3": null,
"detail4": null,
"date": null,
"amount": null,
"number": null,
"actionType": "2"
},
"payment": {
"dutyAmount": 30,
"surchargeAmount": 0,
"fineAmount": 0,
"totalAmount": 30
}
}
],
"summary": {
"totalDuty": 30,
"totalSurcharge": 0,
"totalFine": 0,
"totalPayment": 30,
"payer": {
"specifiedTaxRegistration": {
"id": "1111111111119"
}
},
"responsePaymentType": "2"
}
}
Response
| Name | Type | Description |
|---|---|---|
| eInstrument | Object | Root Element |
| responseCode | String | รหัสข้อความของกรมสรรพากร |
| responsMessage | String | รายละเอียดข้อความ |
| rdForm | Object | Element ข้อความตอบกลับการนำส่งข้อมูลตราสารอิเล็กทรอนิกส์ |
| requestId | String | รหัสการร้องขอ (unique) |
| apiRefNo | String | รหัสผู้นำส่ง |
| instInfo | Object | ตราสารที่นำส่ง |
| id | String | หมายเลขอ้างอิงตราสารอิเล็กทรอนิกส์ |
| refNo | String | หมายเลขอ้างอิงของแบบ อ.ส.9 |
| specifiedTaxRegistration | Object | ข้อมูลการลงทะเบียนผู้เสียภาษีอากร |
| id | String | เลขประจำตัวผู้เสียอากรของผู้ยื่นขอเสียอากรแสตมป์ |
| paymentInfo | Object | ข้อมูลการชำระเงินค่าอากรแสตมป์ |
| ref1 | String | Reference 1 (เลขประจำตัวผู้เสียอากรแสตมป์) |
| ref2 | String | Reference 2 (รหัสควบคุมหรือรหัสข้อความชำระเงินของกรมสรรพากร) |
| expireDate | Date | วันสุดท้ายของการชำระเงิน |
| totalAmount | Decimal | รวมจำนวนเงินที่ต้องชำระ (อากร+เงินเพิ่ม+ค่าปรับอาญา) |
| totalDuty | Decimal | อากร |
| totalSurcharge | Decimal | เงินเพิ่ม |
| totalFine | Decimal | ค่าปรับอาญา |
| payInSlipFile | Base64Binary | ไฟล์ Pay In Slip เพื่อนำไปชำระที่หน่วยรับชำระของกรมสรรพากร |
| qrPayment | Base64Binary | QR Code สำหรับจ่ายเงิน |
Example Response
กรณีจำนวนตราสารที่ส่งมีค่าน้อยกว่าหรือเท่ากับ 50 ตราสาร
{
"eInstrument": {
"responseCode": "I07000",
"responsMessage": "ทำรายการเรียบร้อย",
"rdForm": {
"requestId": "Test123400003",
"apiRefNo": "20190916000000007181",
"instInfo": [
{
"id": "Test123400001",
"refNo": "P0900022091",
"specifiedTaxRegistration": {
"id": "1111111111119"
}
},
],
"paymentInfo": {
"ref1": "1111111111119",
"ref2": "160051308330972",
"expireDate": "2019-09-16",
"totalAmount": 20000.0,
"totalDuty": 20000.0,
"totalSurcharge": 0.0,
"totalFine": 0.0,
"payInSlipFile": "",
"qrPayment": ""
}
}
}
}
กรณีจำนวนตราสารที่ส่งมีค่ามากกว่า 50 ตราสาร
{
"eInstrument": {
"responseCode": "I07001",
"responsMessage": "ได้รับข้อมูลเรียบร้อยแล้ว รอตรวจสอบความถูกต้องของข้อมูล",
"rdForm": {
"requestId": " testcase345678920001",
"apiRefNo": "20190916000000007182",
"instInfo": null,
"paymentInfo": null
}
}
}
Response Code
| Business Code | Description |
|---|---|
| I07000 | สำเร็จ |
| I07001 | ได้รับข้อมูลเรียบร้อยแล้ว รอตรวจสอบความถูกต้องของข้อมูล |
| E07000 | ไม่สำเร็จ |
| E07104 | กรุณาเข้าสู่ระบบอีกครั้ง เนื่องจาก Token ID หมดอายุ |
| E07108 | ไม่สามารถทำรายการได้ เนื่องจากข้อมูลซ้ำ |
