QCVN 40:2024/BGTVT
NATIONAL TECHNICAL REGULATION ON ROAD MOTOR VEHICLE DRIVING EXAMINATION CENTERS
National technical regulation on road motor vehicle driving examination center
QCVN 40:2024/BGTVT on road motor vehicle driving examination center is written by the Department for Roads of Vietnam, approved by the Ministry of Science and Technology, and issued by the Minister of Transport under Circular No. 49/2024/TT-BGTVT dated November 15, 2024.
QCVN 40:2024/BGTVT replaces QCVN 40:2015/BGTVT issued together with Circular No. 79/2015/TT-BGTVT dated December 10, 2015 of the Minister of Transport.
National technical regulation on road motor vehicle Driving examination center
This Regulation stipulates the technical requirements for infrastructure, vehicles, and equipment for road motor vehicle driving examination centers (hereinafter referred to as “driving examination center”)
This Regulation applies to organizations and individuals involved in the construction and operation of driving examination centers.
In this Regulation, terms below are construed as follows:
1.3.1. Examination yard: refers to an area used for maneuverability exams of driving examination centers.
1.3.2. Driving exam data: includes driving exam results compiled in real-time by the driving exam management software from servers.
1.3.3. Driving exam photos are photos of the examination process recorded by the surveillance camera system.
1.3.4. Minimum driving distance: the minimum distance for driving vehicle to travel to complete maneuverability exams.
1.3.5. API: is a middleware that allows driving exam control software on servers to communicate with driving exam supervision software on monitors.
2.1. Examination yards:
2.1.1. have appropriate dimensions to ensure adequate arrangement of maneuver areas according to the classification of driving examination centers stipulated in Government’s decrees on training and examination for driving licenses
2.1.2. have their areas divided separately, including: examination yards for A1, A, B1 driving licenses; examination yards for B, C1, C, D2, D1, D driving licenses; and examination yards for BE, C1E, CE, D1E, D2E, DE driving licenses.
2.1.3. ensure that vehicles used for examination only move forward in the designated direction; avoid cutting across other lanes (except at signal-controlled intersections), crossing or straddling on lines when changing direction, and backtracking.
2.1.4. Trees shall not be planted on the median of examination yards, which could impact the observation and supervision of examiners in the control room.
2.1.5. Examination yard areas
2.1.5.1 . Grade-1 driving examination centers: ≥ 33.000 m2;
2.1.5.2 . Grade-2 driving examination centers: ≥ 18.000 m2;
2.1.5.3 . Grade-3 driving examination centers: ≥ 3.600 m2;
2.1.6. Minimum driving distance:
2.1.6.1. Grade-1 driving examination centers: ≥ 1.2 km;
2.1.6.2. Grade-2 driving examination centers: ≥ 0.8 km;
2.1.7. Lanes in each examination yard shall have a minimum width of 3.5 m; lanes and designated areas for maneuvers shall be paved with asphalt concrete or cement concrete, ensuring surface quality as follows:
2.1.7.1. For asphalt concrete paved lanes and designated areas for maneuvers: minimum required modulus of elasticity is 110 Mpa;
2.1.7.2. For cement concrete paved lanes and designated areas for maneuvers: minimum required compressive strength is 30 Mpa;
2.1.7.3. Drainage system must prevent waterlogging on lanes and designated areas during rain.
2.1.8. Traffic lights, road signs, road lines and markings must be arranged in compliance with the specifications and standards stipulated in National technical regulations on road signs.
2.1.9. Boundaries of designated areas for maneuvers shall be marked with white lines, with a width of 0.1 m, and a minimum distance of 0.1 m from the curb of designated areas.
2.1.10. Curb of designated areas for maneuvers shall have a minimum height of 0.15 m (except for A1, A maneuvers).
2.1.11. Standard piles in examination yards shall be painted in two colors, white and red, with each color segment being 0.15 m long, a diameter ranging from 20 mm to 25 mm, and a height of 1.6 m; the base of standard piles shall be made of metal to ensure their stability.
2.1.12. Dimensions of designated areas for maneuvers shall be based on the technical specifications of the vehicles used for examination, with a permissible construction deviation of 5%; in cases where vehicles used for examination are replaced or the designated area for maneuvers is used to multiple vehicle categories, the deviation in the dimensions should not exceed 10%.
2.1.13. Category-A1 or -A designated areas for maneuvers
2.1.13.1. Designated area for Figure-8 maneuver (Figure 1)
Dimensions measured in meters
Dimensions |
Category A1 |
Category A |
Outer radius R1 |
3,0 |
3,4 |
Inner radius and radius of the point of contact between two outer circles Ro |
2,3 |
2,5 |
Distance between the centers of two inner circles OO' |
5,7 |
6,3 |
Distance between the center of the inner circle and the point of contact circle OO" = O’O” |
5,3 |
5,9 |
2.1.13.2. Straight line marking (Figure 2).
Dimensions measured in meters
Dimensions |
Symbol |
Category A1 |
Category A |
Length |
Lt |
18,0 |
27 |
Width |
Bt |
0,6 |
0,6 |
Paint color |
|
White |
White |
2.1.13.3. Road with obstacles (Figure 3).
Dimensions measured in meters
Dimensions |
Category A1 |
Category A |
Length of road segment with obstacles (Lt) |
18,0 |
27,0 |
Distance between obstacles |
4,5 |
4,5 |
Width of lane with obstacles |
3,0 |
3,0 |
Length of obstacles |
1,5 |
1,5 |
Width of obstacles |
0,1 |
0,1 |
Paint color of obstacles |
White |
White |
2.1.13.4. Rough road (Figure 4)
Dimensions measured in meters
Dimensions |
Category A1 |
Category A |
Length of rough road segment |
15,0 |
15,0 |
Length of obstacles |
0,9 |
0,9 |
Width of obstacles |
0,2 |
0,2 |
Width of the top of obstacles |
0,1 |
0,1 |
Height of obstacles |
0,05 |
0,05 |
Distance between obstacles |
1,5 |
1,7 |
Material of obstacles |
Hard, non-elastic |
Hard, non-elastic |
Paint color on the surface of obstacles |
White |
White |
2.1.13. Designated areas for Category-B1 maneuvers (Figure 5)
It is a zigzag maneuver, composed of 4 consecutive parallelograms, with the following dimensions:
BCM (m) is the width at the top of the designated area for zigzag maneuvers BCM = bM + 0,6 (m);
bM (m) is the width of the motor vehicle used for examination;
LCM (m) is the total length of the motor vehicle used for examination: LCM = 1,5aM;
aM (m) is the total length of the motor vehicle used for examination.
2.1.15. Designated areas for Category B, C1, C, D2, D1, or D maneuvers
These technical terms are construed as follows:
B1: Width of the rear wheel on the co-driver's side of the vehicle used for driving exam (m);
a: Total length of the vehicle used for driving exam (m);
b: Total width of the vehicle used for driving exam (m);
Rqv: Minimum turning radius of the vehicle used for driving exam with respect to the outer front wheel track (m).
2.1.15.1. Start and Finish (Figure 6)
A straight line perpendicular to the road axis shall be marked on road surface according to the "Stop Line" standard, the phrase of “XUẤT PHÁT” (START) or “KẾT THÚC” (FINISH) shall be marked in front of the line.
Vehicles stop in front of the Start Line, wait for signals and perform necessary maneuvers at the beginning of maneuvers.
Vehicles pass the Finish Line when completing maneuvers.
2.1.15.2. Yielding to pedestrians (Figure 7).
Mark a stop line and pedestrian crosswalk markings (continental markings) and install following signs at pedestrian crosswalks: a stop sign and a pedestrian crosswalk sign to require vehicle to yield to pedestrians.
2.1.15.3. Stopping and starting on a hill (Figure 8)
On a 15-meter long uphill incline with a 10% gradient, a stop line shall be marked at least 6 meters from the ground, and a stop sign shall be installed to require vehicles to stop; "Dangerous Uphill" and "Dangerous Downhill" signs shall be also installed. "Dangerous Uphill" and "Dangerous Downhill" signs shall be also installed.
2.1.15.4. Wheel tracks and square loops (Figure 9)
Wheel track shall be located on the right side in the direction of travel, consisting of 02 parallel bay lines and parallel to the bay axis of the road; after the wheel track maneuver, 02 consecutive square loops are in the opposite direction, where:
Bvb (m) is the width of the wheel track: Bvb = B1 + 0.2 (m);
Lvb (m) is the length of the wheel track: Lvb = a;
Sv (m) is the depth of the square loop: Sv = 1,5a;
Lv (m) is the length of the square loop: Lv = 2,0a;
Bv (m) is the width of the perpendicular road lane: Bv = 2,2b.
2.1.15.5. Intersection (Figure 10)
At an intersection of two two-way roads of the same level, install a traffic light control system, mark a stop line and pedestrian crosswalk markings (continental markings) and install direction sign, intersection ahead sign, and traffic-light intersection ahead sign to require vehicles to stop at the intersection according to the traffic light signal to yield to pedestrians.
2.1.15.6. Driving through winding roads (Figure 11)
The figure consists of two semicircles connected in opposite directions, forming an S-shape, where:
Bqc (m) is the width of the winding road: Bqc = 2,2b;
RN (m) is the outer circle's radius: Rn = Rqv + 1,2 m;
Rtr (m) is the inner circle's radius: Rtr = Rn - Bqc;
Sqc (m) is the distance between the centers of the two semicircles: Sqc = RN + Rtr
2.1.15.7. Category-B and -C1 bay parking (Figure 12).
This area shall be arranged on the right side of the lane (in the direction of travel) with a parking area sign, where:
Ld (m) is the length of the bay parking space: Ld = a + 1.0 (m);
Rd (m) is the width of the bay parking space: Rd = b + 0,6 (m);
Ed (m) is the control distance for reversing into the bay parking space: Ed = 1,2a.
2.1.15.7. Category-B parallel parking (Figure 12).
This area shall be arranged on the right side of the lane (in the direction of travel) with a parking area sign, where:
Lg (m) is the length of the parking space: Lg = 3a/2;
Rg (m) is the width of the parking space: Rg = 5b/4.
2.1.15.7. Category-C, -D1, -D2, or -D parallel parking (Figure 14).
This area shall be arranged on the right side of the lane (in the direction of travel) with a parking area sign, where:
Lg (m) is the length of the parking space: Lg = 5a/3;
Rg (m) is the width of the parking space: Rg = 5b/4.
Figure 14. Illustration diagram of Category-C, -D1, -D2, or -D parallel parking
2.1.15.10. Stopping at railroad crossing (Figure 15)
Arrange 02 railroad tracks, creating a scenario of an intersection between the road and the railroad without barriers and traffic control; arrange a "stop line” marking, a “railway crossing without barrier” sign, a “railway crossing” sign, and a “stop” sign at a minimum distance of 5.0 meters from the outermost rail of the railroad to request stopping at the place where the railroad crosses.
2.1.15.11. Changing gears on a straight road (Figure 16)
On a straight road segment with a minimum length of 100 meters, install the first auxiliary sign "increase gears, increase speed" a minimum of 20 meters from the beginning of the road segment, install the second auxiliary sign "decrease gears, decrease speed", and install the third auxiliary sign “end of decreasing gears, decrease speed” 25 meters from the second auxiliary sign.
Figure 16. Illustration diagram of changing gears on a straight road
2.1.15.12. Dangerous situation
In each driving examination examination yard, in addition to maneuvers, dangerous situations shall also be placed (05 positions for Grade-1 centers and 03 positions for Grade-2 centers) to require examinees to brake and stop vehicle, turn on hazard lights, and turn off hazard lights before proceeding within the specified time.
2.1.15.13. Designated areas for Category BE, D1E, D2E, DE maneuvers (Figure 17)
This area includes 05 standard piles A, B, C, D, and E with equal distances between standard piles AB = BC = CD = DE = LCF = 1.4aE.
Where: aE (m) is the overall length of the motor vehicle used for examination.
2.1.15.14. Designated areas for Category-C1E and –CE maneuvers.
2.1.15.14.1. Driving through a diagram with 05 standard piles (Figure 18)
This area includes 05 standard piles A, B, C, D, and E with equal distances between poles AB = BC = CD = DE = LCF = 1.4aE.
Where: aE (m) is the overall length of the motor vehicle used for examination.
2.1.15.14.2. Bay parking maneuver (Figure 19)
This shall be arranged in the direction of travel with a parking area sign, where:
Ld (m) is the length of the bay parking space:
Ld = overall length of the motor vehicle used for examination (m) + 1.0 (m);
Rd (m) is the width of the bay parking space:
Rd = overall width of the motor vehicle used for examination (m) + 1.0 (m);
Ed (m) is the control distance for reversing into the bay parking space:
Ed = overall length of the motor vehicle used for examination (m) x 1.5.
2.2. Vehicles used for examination:
2.2.1. Any vehicle used for examination, in addition to complying with the regulations in section 2.2 of this Regulation, shall comply with Clause 1 Article 35 of Law on Road Traffic Order and Safety and decrees on driver training and driving examination.
2.2.2. Category A1 vehicles: two-wheeled motorcycles with an engine displacement from 70 cm3 to 125 cm3 or an electric motor power from 6 kW to 11 kW.
2.2.3. Category A vehicles: two-wheeled motorcycles with an engine displacement ≥125 cm3 or an electric motor power ≥ 11 kW.
2.2.4. Category B1 vehicles: three-wheeled motorcycles with an engine displacement ≥105 cm3 , reverse gear, overall length ≤ 3.0 m, overall width ≤ 1.5 m, wheelbase ≤ 2,3 m, minimum turning radius measured from the front wheel track ≤ 3,5 m.
2.2.5. Category B vehicles: automobiles with 03 - 08 seats (excluding the driver's seat), overall length ≥ 4,2 m, overall width ≥ 1,6m, wheelbase ≥ 2,4m, minimum turning radius measured from the front wheel track ≥ 4,9 m.
2.2.6 Category C1 vehicles: trucks with a 4.000 kg – 7.500 kg design gross weight (DGW), overall length ≥ 5,5 m, overall width ≥ 1,7 m, wheelbase ≥ 3 m, minimum turning radius measured from the front wheel track ≥ 5,7 m.
2.2.7. Category C vehicles: trucks with a DGW ≥ 11.000 kg, overall length ≥ 8 m, overall width ≥ 2,2 m, wheelbase ≥ 4,2 m, minimum turning radius measured from the front wheel track ≥ 7,2 m.
2.2.8. Category D1 vehicles: passenger automobiles (including buses) with 8 - 16 seats (excluding the driver's seat) or vehicles designed or modified with fewer seats than the same type of vehicle, equivalent size, and maximum seating capacity, with a overall length ≥ 5,2 m, overall width ≥ 1,9 m, wheelbase ≥ 3,1 m, minimum turning radius measured from the front wheel track ≥ 6,1 m.
2.2.9. Category D2 vehicles: passenger automobiles (including buses) with 16 - 29 seats (excluding the driver's seat) or vehicles designed or modified with fewer seats than the same type of vehicle, equivalent size, and maximum seating capacity, with a overall length ≥ 6,2 m, overall width ≥ 2,0 m, wheelbase ≥ 3,1 m, minimum turning radius measured from the front wheel track ≥ 7,0 m.
2.2.10. Category D vehicles: passenger automobiles (including buses) ≥ 40 seats (excluding the driver's seat) or automobiles designed or modified with fewer seats than the same type of vehicle, equivalent size, and maximum seating capacity, with a overall length ≥ 8,9 m, overall width ≥ 2,4 m, wheelbase ≥ 4,2 m, minimum turning radius measured from the front wheel track ≥ 7,9 m.
2.2.11. Category CE vehicles: tractor-trailers used to transport containers with dimensions of: Length: 6,06 m, Width: 2,44 m, Height: 2,59 m (equivalent to a 20 feet container)
2.2.12. Category BE, C1E, D1E, D2E, or DE vehicles: vehicles with technical specification suitable for the corresponding category of vehicles used for examination (B, C1, D1, D2, and D) with an attached trailer with a DGW ≥ 5000 kg.
2.3.1. Examination equipment and software serving theoretical exams of categories A1, A, B1, B, C1, C, D1, D2, D, BE, C1E, CE, D1E, D2E, and DE include servers, clients, uninterruptible power supplies, computer networks, printers, theoretical exam control software, and theoretical exam software.
2.3.1.1. Any server must:
2.3.1.1.1. have its hardware configuration met the requirements for operating the theoretical exam control software provided by the Department for Roads of Vietnam when all clients are connected during theoretical exams;
2.3.1.1.2. Monitors: minimum size of 19 inches, minimum resolution of 1366 x 768 pixels;
2.3.1.1.3. Operating system: Windows Server 2016 or higher;
2.3.1.1.4. have the theoretical exam control software provided by the Department for Roads of Vietnam installed as per regulations.
2.3.1.1.5. connect to the supervised computer used for theoretical exam according to API in the Appendix attached hereto.
2.3.1.2. Any client must:
2.3.1.2.1. have its hardware configuration met the requirements for operating the theoretical exam supervision software provided by the Department for Roads of Vietnam;
2.3.1.2.2. Monitors: minimum size of 19 inches, minimum resolution of 1366 x 768 pixels;
2.3.1.2.3. Operating system: Windows Server 10 or higher;
2.3.1.2.4. have the theoretical exam operating software provided by the Department for Roads of Vietnam installed as per regulations.
2.3.1.3. have centralized or local uninterruptible power supplies used for computers at theoretical exam rooms to ensure stable power supply without interruption for a minimum of 15 minutes from the time of power grid failure.
2.3.1.4. have computer network in theoretical exam rooms configured in a LAN network model with common RJ-45 connection standards, and be connected to a Switch.
2.3.1.5. have A4 printers to print theoretical exam results.
2.3.1.6. have the antivirus software installed on servers and clients.
2.3.1.7. have mechanisms to protect data, prevent interference and data loss due to random incidents; prevent unauthorized human intervention in exam results; maintain logs of data editing processes.
2.3.2. have examination equipment and software serving simulation exams of category A1, A, B1, B, C1, C, D1, D2, D, BE, C1E, CE, D1E, D2E, DE including servers, clients, uninterruptible power supplies, computer networks, printers, simulation exam control software, and simulation exam software.
2.3.2.1. Any server must:
2.3.2.1.1. have its hardware configuration met the requirements for operating the simulation exam control software provided by the Department for Roads of Vietnam when all clients are connected during simulation exams;
2.3.2.1.2. Monitors: minimum size of 19 inches, minimum resolution of 1366 x 768 pixels;
2.3.2.1.3. Operating system: Windows Server 2016 or higher;
2.3.2.1.4. have the simulation exam control software provided by the Department for Roads of Vietnam installed.
2.3.2.1.5. be enable to connect to the supervised computer used for exam according to API in the Appendix attached hereto.
2.3.2.2. Any client must:
2.3.2.2.1. have its hardware configuration met the requirements for stable operation of the traffic simulation software provided by the Department for Roads of Vietnam;
2.3.2.2.2. Monitors: minimum size of 19 inches, minimum resolution of 1366 x 768 pixels;
2.3.2.2.3. Operating system: Windows Server 10 or higher;
2.3.2.2.4. have the traffic simulation software provided by the Department for Roads of Vietnam installed.
2.3.2.3. have centralized or local uninterruptible power supplies installed for computers at theoretical exam rooms to ensure stable power supply without interruption for a minimum of 15 minutes from the time of power grid failure.
2.3.2.4. have a computer network in theoretical exam rooms configured in a LAN network model with common RJ-45 connection standards, and connected to a Switch.
2.3.2.5. have A4 printers to print theoretical exam results.
2.3.2.6. have an antivirus software installed on servers and clients.
2.3.2.7. have mechanisms to protect data, prevent interference and data loss due to random incidents; prevent unauthorized human intervention in exam results; maintain logs of data editing processes.
2.3.3. Equipment and software for maneuverability exams of categories A and A1 include:
Equipment and software for maneuverability exams of categories A and A1 include devices placed in the control room, devices placed in examination yards, devices on vehicles, and exam management and control software.
2.3.3.1. Devices in examination yards and control rooms must:
2.3.3.1.1. have computers installed with the exam management and control software, hardware configuration ensuring stable operation when all examination vehicles are connected and conducting maneuverability exams with a minimum of 2 vehicles; monitors with a minimum of 19 inches, minimum resolution of 1366 x 768 pixels, using Windows 10 or Windows Server 2016 operating system or higher.
2.3.3.1.2. have a wireless connection system transmitting data to devices, which are installed on vehicles and in examination yards, to report errors, deduct points for violations, ensure bandwidth and speed to accurately assess at least 10 vehicles operating stably without interference.
2.3.3.1.3. accurately report errors and scores; notify all violations of examinees during exams.
2.3.3.1.4. have mechanisms to protect data, prevent interference and data loss due to random incidents; prevent unauthorized human intervention in exam results; maintain logs of data editing processes.
2.3.3.1.5. have mechanisms to monitor the operation status of each device in examination yards and on vehicles used for examination from control rooms. These devices must function independently, and the malfunctions of one device should not affect the operation or cause issues for other devices or the entire system, except for power supply devices.
2.3.3.1.6. automatically notify point deductions for errors, disqualification from the exam, exam results, start and end commands, crossing the boundary line with the wheels by speakers and displays in control rooms and waiting rooms of examinees within a maximum of 3 seconds from the time of violation.
2.3.3.1.7. display content of exams and deducted errors, remaining total points of examinees on screens in waiting rooms.
2.3.3.1.8. have a surveillance camera system connected to severs to automatically store the exam process and time of violations such as putting foot down or having 02 wheels outside of designated areas.
2.3.3.1.9. have a censor system installed in examination yards which operates stably and accurately and is not affected by changes in temperature or humidity.
2.3.3.1.10. have uninterruptible power supply devices to ensure stable power supply for the entire system for a minimum of 15 minutes from the time of power grid failure.
2.3.3.2. Devices on vehicles used for examination must:
2.3.3.2.1. have an on/off switch of automatic scorer installed on each vehicle, which is placed in a sealed box or out of the examinee's reach.
2.3.3.2.2. have at least 20 minutes of exam data restored in cases where these devices lose connection with the sever in the control room.
2.3.3.2.3. automatically deduct points of an examinee if: He/she fails to follow the correct sequence of the exam; he/she fails to complete the exam; he/she operates vehicle crossing over boundary lines of designated areas or obstacle lines; his/her vehicle stalls or overturns.
2.3.3.2.4. use the vehicle's power source, with a voltage level appropriate for the designated voltage level of the vehicle, and have the ability to withstand reverse polarity as specified in Table 5 of this Regulation.
Nominal voltage (V) |
Test voltage for reverse polarity (V) |
06 |
06 ± 0,1 |
12 |
14 ± 0,1 |
24 |
28 ± 0,2 |
2.3.3.2.5. automatically take random photos of each examinee at least 03 times during the driving exam, send captured image data to the control and management software for maneuverability examination for storage and printing them on written reports.
2.3.3.2.6. have a screen installed on each vehicle to display statuses, including: engine status (off, running), ongoing maneuver, points deducted for each violation, and the total points.
2.3.3.2.7. communicate with external software through at least one of the following protocols: RF, COM port (RS232), USB port (2.0 standard or above), or memory card to adjust scoring regulations and facilitate equipment inspection and calibration.
2.3.3.2.8. have the wireless connectivity to receive and transmit data to devices in control rooms and examination yards. This system must operate stably without interference.
2.3.3.3. Examination control and management software must:
2.3.3.3.1. have a user interface and display results in Vietnamese; display real-time parameters and status of devices; display real-time information on waiting room screens such as maneuvers, scores, random photos of examinees during their exams; indicate the connection status with scorer installed on vehicles and examination yards, with an alert system for connection loss or failures.
2.3.3.3.2. It must be able to connect to the supervised computer according to API in the Appendix attached hereto.
2.3.3.3.2. search, access, store, organize, and present data related to lists of examinees who have applied, completed, undergoing, or not yet participated exams; number of learners who have passed or failed the exam.
2.3.3.3.4. have a function to deduct points for violations such as putting foot down or having 02 wheels outside of the designated area.
2.3.3.3.5. provide audible signals for starting signal, error notifications, disqualifications, and results.
2.3.3.3.6. have a function to view and store photos of examinees, photos and videos of examination process, and time of violations.
2.3.4. Equipment and software for maneuverability exams of categories B, C1, C, D2, D1 and D
include devices placed in the control room, devices placed in examination yards, devices on the test vehicle, and exam management and control software.
2.3.4.1. Devices installed in examination yards and control rooms must
2.3.4.1.1. have computers installed with the exam management and control software with hardware configuration, ensuring the stable operation when all examination vehicles are connected during practical driving exams with a minimum of 2 vehicles; monitors with a minimum of 19 inches, minimum resolution of 1366 x 768 pixels, using Windows 10 or Windows Server 2016 operating system or higher.
2.3.4.1.2. have a wireless connection system transmitting data to devices installed on vehicles and in examination yards to report errors, deduct points for violations, ensure bandwidth and speed to accurately assess at least 20 vehicles operating stably without interference.
2.3.4.1.3. accurately report errors and scores; notify violations of examinees during exams.
2.3.4.1.4. have mechanisms to protect data, prevent interference and data loss due to random incidents; prevent unauthorized human intervention in exam results; maintain logs of data editing processes.
2.3.4.1.5. have mechanisms to monitor the operation status of each device in examination yards and on vehicles used for examination. These devices must function independently, and the malfunctions of one device should not affect the operation or cause issues for other devices or the entire system, except for power supply devices.
2.3.4.1.6. deduct points for errors; notify disqualification from the exam, exam results, start and end guidelines.
2.3.4.1.7. Display content of each exam and deducted errors, remaining total points of examinees on screens in exam waiting rooms.
2.3.4.1.8. have an uninterruptible power supply to ensure stable power supply for the entire system for a minimum of 15 minutes from the time of power grid failure.
2.3.4.2. Devices on vehicles used for examination must
2.3.4.2.1. have an on/off switch of automatic scorer installed on vehicles, in a sealed box or out of the examinee's reach.
2.3.4.2.2. store at least 20 minutes of exam data from the time they lose connection with the sever in the control room.
2.3.4.2.3. automatically detect and deduct points in cases where the examinee fails to follow the correct sequence of maneuver, fails to drive according to maneuvers for each vehicle category, fails to passed through the designated maneuvers, and fails to complete the maneuver; fails to fasten seatbelt, turn on and off turn signals; fails to comply with regulations on time taken to cross the starting line, engine speed, and vehicle speed; the vehicle stalls; the vehicle is stopped in an incorrect designated position, the vehicle rolls back; the vehicle exceeds the prescribed time for traversing a slope or wheel tracks; the examinee violates regulations regarding traffic signal lights at intersections, time limit for crossing the intersection, and traffic rules; the examinee changes gears, speed; the examinee violates regulations regarding time limits for maneuver execution.
2.3.4.2.4. use the vehicle's power source, with a voltage level appropriate for the designated voltage level of the vehicle, and have the ability to withstand reverse polarity as specified in Table 6 of this Regulation.
Nominal voltage (V) |
Test voltage for reverse polarity (V) |
12 |
14 ± 0,1 |
24 |
28 ± 0,2 |
36 |
42 ± 0,2 |
2.3.4.2.5. automatically take random photos of each examinee at least 03 times during the driving exam, send captured image data to the control and management software for maneuverability examination for storage and printing them on written reports.
2.3.4.2.6. have a screen installed on each vehicle to display statuses, including: Engine status (off, running), motion status (forward, reverse, stopped), current gear position, starting and ending positions of each maneuver, ongoing maneuver, time taken for each maneuver and total time taken, deductions for each violation, total points.
2.3.4.2.7. have signal lights with 3 colors (green - yellow - red) mounted on the roof and signal lights with 2 colors (green - red) installed inside vehicles used for examination, including:
Starting signal, result notification: green signal light;
Stop signal when encountering a dangerous situation: yellow and red signal lights;
Signal indicating the ongoing test: yellow signal light;
2.3.4.2.8. be able to communicate with external software through at least one of the following protocols: RF, COM port (RS232), USB port (2.0 standard or above), or memory card to adjust scoring regulations and facilitate equipment inspection and calibration.
2.3.4.2.9. After completing each maneuver (within a distance of 5 meters or a time less than 3 seconds), a signal must be given to indicate the end; deducted errors, remaining points, names of maneuver; disqualification.
2.3.4.2.10. have the wireless connectivity to receive and transmit data to devices in control rooms and examination yards. The system must operate stably without interference.
2.3.4.3. Examination control and management software must
2.3.4.3.1. Have a user interface and display results in Vietnamese; display the connection status with the scorers installed on vehicles and examination yards; indicate the connection status with scorers installed on vehicles and examination yards, with an alert system for connection loss or failures.
2.3.4.3.2. Connect to the supervised computer according to API in the Appendix attached hereto.
2.3.4.3.3. Search, access, store, organize, and present data related to lists of examinees who have applied, completed, undergoing, or not yet participated exams; number of learners who have passed or failed the exam.
2.3.3. Equipment and software for maneuverability exams of categories B, C1, C, D2, D1 and D, including:
2.3.5.1. Devices placed in control rooms:
2.3.5.1.1. Severs installed with the exam management and control software must have a dedicated telephone line and hardware configuration to ensure stable operation when all examination vehicles (≥ 2 vehicles) are connected for maneuverability exam; monitors with a minimum screen size of 19 inches, a minimum resolution of 1366 x 768 pixels, using Windows 10 or Windows Server 2016 operating system or higher.
2.3.5.1.2. have a wireless connection system which transmits data to devices installed on vehicles and in examination yards to report errors, deduct points for violations must ensure bandwidth and speed to accurately assess at least 15 vehicles operating stably without interference.
2.3.5.1.3. accurately report errors and points deduction; provide stable and complete notifications; publish content of each exam, deductions, and the remaining total points of examinees.
2.3.5.1.4. have mechanisms to protect data, prevent interference and data loss due to random incidents; prevent unauthorized human intervention in exam results; maintain logs of data editing processes.
2.3.5.1.5. have uninterruptible power supplies to ensure stable power supply for the entire system for a minimum of 15 minutes from the time of power grid failure.
2.3.5.2. Devices on vehicles used for examination must
2.3.5.2.1. have an on/off switch of automatic scorer installed on vehicles used for examination, placed in a sealed box or out of the examinee's reach.
2.3.5.2.2. store at least 48 hours of exam data from the time they lose connection with the sever in the control room.
2.3.5.2.3. automatically detect and deduct points if an examinee commits any violations against regulations related to: fastening seat belt; activating and deactivating turn signals; stalled test vehicle; pulling and releasing handbrake; failing to change gears from 1 to 3 within a distance of 15 meters; using inappropriate gear for vehicle speed; failing to change gears correctly; failing to shift to neutral when stopping the vehicle.
2.3.5.2.4. have a system of buttons for selecting examinee’s registration numbers, guiding examinees, recording and deducting points that are not automatically scored, including: violating traffic rules; encroaching lanes; vehicle jerking; failing to follow examiner's guidance; or causing accidents. The button system is arranged on scorer's screen and on an extended keyboard, ensuring convenience for examiners during scoring process and intervention to ensure safety for examinees. Examiners shall not required examinees to end the exam if the distance has not reached 2.0 km.
2.3.5.2.5. have 01 camera equipped on each vehicle used for examination with the following requirements:
Minimum video resolution: 1280 x 720 pixels; minimum frame rate: 30 frames per second;
Minimum angle of view: 140 degrees;
Supports a memory card of 32 GB or higher, recording a continuous 8-hour video or longer at a resolution of 1280 x 720 pixels, and data transfer to storage devices when the memory card is full;
Communicates via USB ports;
Has image stabilization function;
Has recording function;
Has integrated battery, allowing at least 30 minutes camera operation;
Camera shall be positioned to capture simultaneous photos of the front and the entire seating area of both examinee and examiner inside the vehicle cabin, recording real-time audio;
Provides notification of operational status and warnings in case of device malfunctions.
2.3.5.2.6. use the vehicle's power source, with a voltage level appropriate for the designated voltage level of the vehicle, and have the ability to withstand reverse polarity as specified in Table 7 of this Regulation.
Nominal voltage (V) |
Test voltage for reverse polarity (V) |
12 |
14 ± 0,1 |
24 |
28 ± 0,2 |
36 |
42 ± 0,2 |
2.3.5.2.7. automatically take random photos of each examinee at least 03 times during the driving exam, send captured image data to the control and management software for maneuverability examination for storage and printing them on written reports.
2.3.5.2.8. have a screen on each vehicle to display statuses, including: engine status (off, running); on-going maneuver; maneuver distance covered; deducted points for errors; total points of examinee; signal strength of Global System for Mobile Communications (GSM) network; connection status to server; signal strength of Global Navigation Satellite System (GNSS); and status of data storage memory.
2.3.5.2.9. have a speaker system installed on vehicles used for driving examination to make announcements about start, end, violations, examiner’s guidance, and results during and immediately after completing the required tasks (within 3 seconds).
2.3.5.2.10. have the wireless connectivity to automatically receive online the list of driving examinees from the server located in the control room; collect and transmit data on results, distance, violations, and photos of examinees to the server located in the control room. The system must operate stably without interference, regardless of the distance between the vehicle and the driving examination center. Data is automatically transmitted online to server with a frequency of no more than 30 seconds for publishing on screens on waiting rooms. Exam results shall be printed out when necessary. In case of losing connection with the server due to a transmission interruption, the device shall automatically resend all previously recorded data to the server as soon as the connection is restored or when the vehicle returns to the driving examination center.
2.3.5.2.11. have a printer installed on vehicle to automatically print results immediately upon completion.
2.3.5.2.12. communicate with external software through at least one of the following protocols: RF, COM port (RS232), USB port (2.0 standard or above), or memory card to adjust scoring regulations and facilitate equipment inspection and calibration.
2.3.5.3. Examination control and management software must
2.3.5.3.1. have a user interface and display results in Vietnamese; display the connection status with scorers installed on vehicles, with an alert system for connection loss or failures; display parameters, status, deducted points, total points, random photos of the examinee, and the location of the vehicle on a digital map; display results on screens in waiting rooms;
2.3.5.3.2. automatically update data, list of examinees who passed the exam or examinees who retake on-road exam to devices on vehicles used for on-road examination;
2.3.5.3.3. connect to the Internet upon request; search, access, store, organize, and present data related to lists of examinees who have applied, completed, undergoing, or not yet participated exams; number of learners who have passed or failed the exam;
2.3.5.3.4. have a database synchronizing with the database on the driving examination sever, forming a centralized database.
2.3.5.3.5. automatically print results upon the completion of exam, or reprint results at the driving examination center. Driving examination results of examinees must include full name, registration number, start time and end time of the exam, achieved score, deducted points for errors, and assessment;
2.3.5.3.6. randomly take photos during the test with the start time and total distance traveled by each examinee.
2.3.5.3.7. Accurately locate the position of the vehicle on a digital map.
2.4.1. Areas:
2.4.1.1. Grade-1 centers: ≥250 m2
2.4.1.2. Grade-2 centers: ≥200 m2
2.4.1.3. Grade-3 centers: ≥100 m2
2.4.2. Examination control offices shall be built at the starting or ending point of exams.
2.4.3. Functional rooms:
2.4.3.1. Waiting rooms:
2.4.3.1.1. For Grade-1 centers or Grade-2 centers: seating for examinees and at least 05 screens shall be arranged to display results of theoretical exam, simulation exam, maneuverability exam, and on-road exam and photos of examinee during exams (in case where only 01 screen is used to display information mentioned above, each content area must have a minimum diagonal length of 50 inches);
2.4.3.1.2. For Grade-3 centers: seating for examinees and at least 03 screens shall be arranged to display results of theoretical exam, simulation exam, maneuverability exam, and on-road exam and photos of examinee during exams (in case where only 01 screen is used to display information mentioned above, each content area must have a minimum diagonal length of 50 inches).
2.4.3.2. Examination instruction rooms shall be set up with desks, chairs, and various equipment for examinees to prepare and receive relevant information related to the driving examination.
2.4.3.3. Theoretical examination rooms shall be set up with:
2.4.3.3.1. Air conditioners, sufficient computers and printers for theoretical exams;
2.4.3.3.2. Surveillance cameras;
2.4.3.3.3. Partition walls between computers. Each part measured from the outside edge of the desk shall have a minimum length of 50cm and a minimum height of 60cm.
2.4.3.4. Simulation examination rooms (which may be used as theoretical examination rooms as well if the simulation equipment is also used for theoretical examination) shall be set up with:.
2.4.3.4.1. Air conditioners, sufficient computers and printers for simulation examination;
2.4.3.4.2. Surveillance cameras;
2.4.3.4.3. Partition walls between computers. Each part measured from the outside edge of the desk shall have a minimum length of 50cm and a minimum height of 60cm.
2.4.3.5. Control rooms for the automatic scorers for maneuverability examination shall be:
2.4.3.5.1. Positioned and designed appropriately for device operators to observe all vehicles in examination yards;
2.4.3.5.2. Equipped with driving error signal receivers and scorers, and a communication system;
2.4.3.5.3. Equipped with air conditioners.
2.4.3.6. Examination Council rooms shall be equipped with air conditioners, screen to display monitoring photos from theoretical examination rooms, simulation examination rooms and examination examination yards.
2.5.1. Backup power generator:
may automatically provide power for up to 10 minutes from the time of grid power failure.
2.5.1.1. Generator power:
2.5.1.1.1. Grade-3 centers: ≥10 kVA
2.5.1.1.1. Grade-1 centers and Grade-2 centers: ≥20 kVA
2.5.2. Screens in waiting rooms: ≥ 50 inches
2.5.3. Monitoring equipment includes a surveillance camera system and test result monitoring computers.
2.5.3.1. Surveillance cameras:
2.5.3.1.1. Resolution: 1280 x 720 pixels or higher
2.5.3.1.2. Interactive interface, connection compliant with minimum ONVIF open standards.
2.5.3.1.3. Time-synchronized with the server and operation control computers.
2.5.3.1.4. Video data transmission using open standard protocols for bidirectional real-time data exchange between a server and a websocket.
2.5.3.1.5. The system must ensure security, prevent unauthorized access from external sources.
2.5.3.1.6. Continuous image storage for a minimum of 40 hours, ensuring complete monitoring of theoretical examination rooms, simulation examination rooms, areas for maneuvers, starting and finishing areas of examination examination yards.
2.5.3.2. Monitors shall be:
2.5.3.2.1. connected to theoretical examination server, simulation examination server, computers with software for management and control of maneuverability examination, computers with software for management and control of on-road examination, and information systems serving the management of driving examination at the Department of Transport according to the protocols specified in the Appendix attached herewith.
2.5.3.2.2. installed with the control software for theoretical examination provided by the Department for Roads of Vietnam.
2.5.3.2.3. equipped with a centralized or local uninterruptible power supply to ensure stable power supply without interruption for at least 15 minutes from the time of power grid failure.
2.5.3.2.4. installed with antivirus software and data security solutions.
2.5.3.2.5. Monitors must have mechanisms to protect data, prevent interference and data loss due to random incidents; prevent unauthorized human intervention in exam results; maintain logs of data editing processes.
Motor vehicle garages for testing purposes, accommodations for examination board members, medical rooms and restrooms.
3.1. Responsibilities of regulatory bodies
3.1.1. Department for Roads of Vietnam
Inspect the implementation of this Regulation.
3.1.2. Department of Transport:
3.1.2.1. Inspect the compliance with the technical regulations of this Regulation for issuing or reissuing driver examination licenses.
3.1.2.2. Organize inspections and assessment for the accuracy of automatic scorers if any driver examination center update or change the scoring software; store the scoring software provided by driver examination centers.
3.2.1. Maintain the position or structure of scorers on vehicles and examination examination yards after they have been inspected and calibrated; keep the shape, structure, components, or systems of vehicles used for driving examination unchanged compared to their manufacturer's design.
3.2.2. Maintain the operation of the information system and online transmission lines to directly transmit examination monitoring data to the Department of Transport (the supervisory authority of the driver examination center), the Police Department of the province where the examination center is located for management, inspection, and handling of violations.
3.2.3. Implement regulations on electrical safety, occupational safety, and fire prevention and control.
3.2.4. Only use software, equipment, and motor vehicles which have been inspected, calibrated, and certified as meeting the conditions for driving examination.
3.2.5. Comply with and cooperate with competent authorities in regular and surprise inspections on the compliance with this Regulation.
3.2.6. Send a written report (including the updated software recorded on a sealed CD or USB drive) to the Department of Transport before updating or changing the scoring software.
3.3.1. Road motor vehicle driving examination centers which have issued with a Certificate of eligibility for driving examination operation shall continue to operate and organize examination for categories specified in such certificate and issue the corresponding driver licenses until June 30, 2025, as stipulated in Article 89 of the Law on Road Traffic Order and Safety. From July 1, 2025, these driving examination centers must ensure compliance with the conditions specified in this Regulation to be eligible to operate.
3.3.2. From January 1, 2025, driving examination centers which have met conditions specified in this Regulation shall be eligible to operate as prescribed in Clauses 1, 2, and 3 of Article 57 of the Law on Road Traffic Order and Safety.
In cases where the standards, regulations, legislative documents referenced in this Regulation are amended, supplemented, or replaced, the amendments, supplements or replacements shall be applied./.
APPENDIX
ON DATA TRANSMISSION PROTOCOL BETWEEN DRIVING EXAM SERVERS AND MONITORING SERVERS
1. General requirements
Panel |
Requirement |
API Model |
According to the RESTful API standard, using JSON data type |
Server Information |
Published by the Department for Roads of Vietnam |
Regulations |
- Information and data provided must ensure completeness according to the structure and format specified in this appendix - Information and data provided must be timely, accurate, and complete, and must not be altered or distorted before, during, or after data transmission. |
Data Transmission Protocol |
HTTPS connection protocol uses TLS certificates (specified in Local technical regulation TCCS 01:2020/CATTT) |
Output format |
JSON format Add header: Content-Type: application/json |
Input format |
JSON format Add header: Accept: application/json |
Data standard |
Unicode (UTF-8) (4) |
Time standard |
UNIX time standard (UTC+7 time): Unix time measures time by the number of non-leap seconds that have elapsed since 00:00:00 UTC on 1 January 1970. Counted in seconds. |
Security |
- HTTPS is used for transmission protocol - JWT is used for login and authorization (5) - Only predefined IP addresses are allowed for data transmission. Unregistered IPs shall not be able to connect to the supervision software of the Department of Transport. |
Allowable delay: |
2 minutes |
Maximum supported image size |
512 KB This is the maximum image size that the Department of Transport considers valid. <0} |
Clock synchronization |
NTP Driving examination center shall sync time with the provider's server. |
Returned data has the following common format:
Field |
Description |
Code |
Error code (Value 1 if the request is successful) |
Message |
Detailed information about the error ("Success" or blank if the request is successful) |
Data |
Returned data (Varies depending on each API) |
Extra |
Additional information (if any) |
Exception |
Error occurred (if any) Driving examination center regularly checks the Exception field to see information about the error cause and error code. |
ExceptionMessage |
Detailed description of the Exception (if any) Driving examination center regularly checks the ExceptionMessage field to understand the cause and find resolution for the error. |
Note: Due to the connection time and request processing time, the returned result may require waiting for a certain period (it is recommended to set a timeout of about 10 minutes when sending a request).
2. Requirements for data transmission:
a) HTTP-based security
HTTPS is used for servers participating in the transmission process of driving examination centers and supervision software of the Department of Transport. This is an essential requirement for websites.
b. IP-based security
- Each driving examination center must register its IP-based access control list to the Department of Transport. IPs that are not registered shall not be able to transmit data.
- When there are changes or additional IPs, the Department of Transport must be informed.
c. JWT security
JWT (JSON Web Token) is used to log in and transmit data with the supervision software of the Department of Transport.
- Users log in with their username and password of the data transmission account through the login function (specified in section 2.4.a)
- Server receive the user's request and simultaneously verify the username and password information.
- After verifying the user's information, if correct, the server will return a JWT to the user; otherwise, it will return to step 1.
- Users will use the JWT code to continue using it for subsequent requests on the server's domain.
- The server does not need to recheck user information but only needs to verify the correct JWT provided, thereby increasing the speed of use on the domain and reducing query time.
- The server provides appropriate responses to users.
3. Data transmission process between driving examination centers and the Department of Transport via supervision software
Step 1: Driving examination center registers a user with the Department of Transport. After this step, the driving examination center obtains a user and password to transmit data into the system.
Step 2: Log in to obtain a Token. If the login is successful, driving examination center receives the Token. This is a security code for data transmission. Token has an expiration time. Driving examination center should check if the Token has expired.
Step 3: Initiate the transmission process through the API commands described in this document; review information returned by the system. If the return code is OK, the system has received the data. If an error occurs, driving examination center checks the accompanying error message to identify and resolve the issue.
Step 4: Check the system status periodically during the transmission process. If the system is busy, please wait until the next cycle. Only transmit data when the server returns a ready status.
Step 5: Repeat steps 3 and 4. An system to alert about any error data and check all error data daily must be available to prevent prolonged errors that may affect learners and reporting data to the Department of Transport. The Department of Transport record these errors to evaluate the transmission quality and data from driving examination centers.
Step 6: Daily reconcile data transmitted, error data, and successfully transmitted data to address any issues immediately
● Note:
- Check the clock synchronization between transmission servers and the server of the Department for Roads of Vietnam to avoid time discrepancy.
- Periodically check the transmission status of the server (busy/ready) to avoid overloading.
- Have a monitoring mechanism for transmission to avoid repeating. The server of the Department for Roads of Vietnam may temporarily block a user if it violate transmission regulations such as transmitting false data or excessive data.
4. Data transmission process between supervision software of driving examination centers and driving exam software (Theoretical exam/On-road exam/Simulation exam/Maneuverability exam)
<}0{>
<0
Step 1: Driving examination center shall register users for each subject (Theoretical exam/On-road exam/Simulation exam/Practical exam) with the supervision software. After this step, the driving examination center obtains a user and password to transmit data into the system.
Step 2: The driving examination center logs in to obtain a Token. If the login is successful, driving examination center receives the Token. This is a security code for data transmission. Token has an expiration time. Driving examination center should check if the Token has expired.
Step 3: Initiate the transmission process through the API commands described in this document. Driving examination center reviews information returned by the system. If the return code is OK, the system has received the data If an error occurs, driving examination center checks the accompanying error message to identify and resolve the issue.
4.1. Login and maintain data transmission session
Login function
Panel |
Description |
||||
URL |
api/v1/provider/login |
||||
Method |
POST |
||||
Description |
This API allows driving examination centers to obtain a login token. The token grants communication rights with the supervision software of the Department of Transport |
||||
Input data |
Field |
Data Type |
Character Length |
Required |
Description |
UserName |
String |
20 |
X |
User name |
|
Password |
String |
20 |
X |
User's password |
|
Returned data |
Field |
Data Type |
Character Length |
Required |
Description |
Token |
String |
2000 |
X |
Token code used to authenticate JWT |
● Notes:
- In case of successful login, the system will return the Token field with the current session security code value. The token contains some information related to its expiration, driving examination centers extracts and logs in to create a new token when necessary
- In case of unsuccessful login, the system returns an error code
- Refer to the error status code table for further information
- The system only accepts operations after successful login
a. Logout Function
Panel |
Description |
||||
URL |
api/v1/provider/logout |
||||
Method |
POST |
||||
Description |
This API allows a user to log out from the system |
||||
Header |
Authorization Token (Generated after the login process) |
||||
Input data |
Field |
Data Type |
Character Length |
Required |
Description |
UserName |
String |
20 |
X |
User's login name |
|
Returned data |
Field |
Data Type |
Character Length |
Required |
Description |
|
Code |
Int |
5 |
X |
Command execution status |
● Notes:
- Code = 1 means success
- Refer to the error status status code table for further information
b. ChangePassword Function
Panel |
Description |
||||
URL |
api/v1/provider/changepassword |
||||
Method |
POST |
||||
Description |
This API allows changing the password of a user in the system |
||||
Header |
Authorization Token (Generated after the login process) |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
UserName |
String |
20 |
X |
User's login name |
|
Password |
String |
20 |
X |
User's password |
|
NewPassword |
String |
20 |
X |
New password |
|
Returned data |
Field |
Data Type |
Character Length |
Required |
Description |
|
Code |
Int |
5 |
X |
Command execution status |
c. Getcurrentime Function
Panel |
Description |
||||
URL |
api/v1/server/getcurrentime |
||||
Method |
POST |
||||
Description |
This API allows retrieving the current time information of the server |
||||
Header |
Authorization Token (Generated after the login process) |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
UserName |
String |
20 |
X |
User's login name |
|
Returned data |
Field |
Data Type |
Character Length |
Required |
Description |
|
CurrentTime |
Datetime |
|
X |
Current time of the Server |
4.2. Data Transmission Functions from Department of Transport
a) Examination data
Panel |
Description |
||||
URL |
api/v1/data/exam |
||||
Method |
POST |
||||
Description |
This API allows the transmission of examination data from the supervision software of the Department of Transport to driving examination centers |
||||
Header |
Authorization Token (Generated after the login process) DepartmentTransport: Code of Department of Transport |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
TotalRecords |
Int |
5 |
|
Total number of records |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamName |
String |
255 |
X |
Examination name |
|
CenterID |
String |
10 |
X |
ID of center |
|
ExamDate |
Date |
10 |
X |
Examination date Format: yyyy-mm-dd Example: 2024-01-01 |
|
ExamTime |
Int |
4 |
X |
Examination time Format: hhmm Example: 730; 1400 |
|
DecisionNo |
String |
30 |
|
Decision number |
|
DecisionDate |
Date |
10 |
|
Decision date Format: yyyy-mm-dd Example: 2024-01-01 |
|
DecisionMaker |
String |
255 |
|
Decision maker |
|
BoardExaminers |
List |
|
|
List of members of Examination board Refer to section 2. Examination Board Data |
|
TotalRegister |
Int |
8 |
|
Total number of registered learners |
|
StudentData |
List |
|
X |
List of learners participating in the examination Refer to section 3. Learner Examination Data |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
b) Examination Board Data
Field |
Data Type |
Character Length |
Required |
Description |
BoardExaminers |
List |
|
|
List of members of Examination board |
Position |
Int |
2 |
|
Position: 1. Chairperson of the Examination Board 2. Members, Director of the driving examination center 3. Members, Director of training facility 4. Members, Head of Examination Team 5. Secretary 6. Examiner |
ExaminersName |
String |
100 |
|
Examiner's full name |
c) Data of learners participating in examination
Field |
Data Type |
Character Length |
Required |
Description |
StudentData |
List |
|
X |
List of learners participating in the examination |
StudentId |
String |
30 |
X |
Registration ID |
FullName |
String |
255 |
X |
Full name of learner |
Gender |
Int |
1 |
X |
Gender 0 – Male, 1 – Female, 2 - Other |
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
CountryCode |
String |
3 |
X |
Country code as per the list |
Residence |
String |
255 |
|
Residence |
ResidenceCode |
String |
30 |
X |
Administrative unit code As per the list |
ResidenceManage |
String |
30 |
X |
Management unit code As per the list |
FileNumber |
String |
30 |
|
File number |
RegistrationNo |
String |
30 |
X |
Registration number |
TrainingCode |
String |
5 |
|
Code of training center |
DepartmentTransport |
String |
2 |
X |
Department of Transport As per the list |
Examination yardId |
String |
112 |
|
Course code |
HealthCertificate |
Int |
2 |
|
Health certificate 1: Valid 0: Invalid |
LicenseAvailableNo |
String |
12 |
|
Number of issued driver licenses |
LicenseAvailableType |
String |
5 |
|
Category of issued driver licenses As per the list: A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
LicenseAvailableUnit |
String |
255 |
|
Managing unit of issue driver license |
LicenseAvailableExpired |
Date |
10 |
|
Expiration date of issue driver license Format: yyyy-mm-dd Example: 2024-01-01 |
YearExperience |
Int |
4 |
|
Number of driving years |
KmExperience |
Int |
8 |
|
Safe kilometers driven |
GraduationCertificate |
String |
30 |
|
Graduation certificate number |
VocationalCertificate |
String |
30 |
|
Vocational certificate number |
ExamContent |
Int |
5 |
X |
Examination content As per the list: 1: First-time examination (Theoretical exam + Maneuverability exam + On-road exam) 2: Theoretical exam 3: Theoretical exam + Maneuverability exam 4: Theoretical exam + Maneuverability exam + On-road exam 5: Maneuverability exam + On-road exam 6: On-road exam 7: Maneuverability exam 8: Driver license 11: First-time examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 12: Re-examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 13: Re-examination (Maneuverability exam + On-road exam + Simulation exam) 14: Re-examination (Theoretical exam + Simulation exam) |
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
ReasonExamination |
String |
500 |
|
Examination reason |
ImageData |
String |
|
X |
Photo of learner Base64 Format: JPEG, PNG |
ImageQuality |
Int |
2 |
X |
Photo quality: - 1: true - 0: false |
4.3. Data Transmission Functions from driving examination center’s server to Department of Transport
a. Data transmission of the examination result of each subject from driving examination centers to the Department of Transport via supervision software
Parameter |
Description |
||||
URL |
api/v1/data/result |
||||
Method |
POST |
||||
Description |
This API allows the transmission of the examination result of each subject from driving examination centers to the Department of Transport via supervision software |
||||
Header |
Authorization Token (Generated after the login process) CenterID: Driving examination center’s ID code |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
StudentData |
List |
|
X |
List of learners |
|
StudentId |
String |
30 |
X |
Registration ID |
|
FullName |
String |
255 |
X |
Full name of learner |
|
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
|
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
|
RegistrationNo |
String |
30 |
X |
Registration number |
|
ExamType |
String |
5 |
X |
Examination classification As per the list: + B1: Category B1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + D1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamType |
Int |
2 |
X |
Examination subjects: 1: Theoretical exam 2: Simulation exam 3: Maneuverability exam 4: On-road exam |
|
StartTime |
Instant |
20 |
X |
Start time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
EndTime |
Instant |
20 |
|
End time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
Result |
Int |
5 |
X |
Examination score |
|
ProviderReceiveTime |
Instant |
|
X |
Time when the server provider receives learner data from subjects' servers. Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
TimesExam |
Int |
3 |
X |
Number of examination times of learners |
|
Reason |
String |
500 |
|
Reason for re-examination Required when the student took the examination more than once |
|
ImageData |
String |
|
|
Image of learner Base64 Format: JPEG, PNG |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
b. Data transmission of summary of examination results from driving examination centers to the Department of Transport via supervision software
Parameter |
Description |
||||
URL |
api/v1/data/summary |
||||
Method |
POST |
||||
Description |
This API allows the transmission of summary of examination results from driving examination centers to the Department of Transport via supervision software |
||||
Header |
Authorization Token (Generated after the login process) CenterID ID code of driving examination center |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
StudentData |
List |
|
X |
List of learners |
|
StudentId |
String |
30 |
X |
Registration ID |
|
FullName |
String |
255 |
X |
Full name of learner |
|
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
|
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
|
RegistrationNo |
String |
30 |
X |
Registration number |
|
ExamType |
String |
5 |
X |
Examination classification As per the list: + B1: Category B1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
|
ExamCode |
String |
20 |
X |
Examination code |
|
TheoryResults |
String |
2 |
|
Required to input data for at least one subject, including the exam result field and the Theoretical score DA: Passed RO: Failed |
|
TheoryPoint |
Int |
5 |
|
Theoretical score |
|
SimulationResults |
String |
2 |
|
Simulation exam result DA: Passed RO: Failed |
|
SimulationPoint |
Int |
5 |
|
Simulation exam score |
|
TestRoutesResults |
String |
2 |
|
Maneuverability exam result DA: Passed RO: Failed |
|
TestRoutesPoint |
Int |
5 |
|
Maneuverability exam score |
|
RoadResults |
String |
2 |
|
On-road exam result DA: Passed RO: Failed |
|
RoadPoint |
Int |
5 |
|
On-road exam score |
|
Summary |
String |
5 |
X |
Summary of examination results DA: Passed RO: Failed |
|
Returned Data |
|
|
|
|
|
Code |
Int |
5 |
X |
Command execution status |
c. Transmission of roll call data from driving examination centers to the Department of Transport via supervision software
Parameter |
Description |
||||
URL |
api/v1/data/rollcall |
||||
Method |
POST |
||||
Description |
This API allows the transmission of roll call data from driving examination centers to the Department of Transport via supervision software |
||||
Header |
Authorization Token (Generated after the login process) CenterID ID code of driving examination center |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
StudentData |
List |
|
X |
List of learners |
|
StudentId |
String |
30 |
X |
Registration ID |
|
FullName |
String |
255 |
X |
Full name of learner |
|
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
|
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
|
RegistrationNo |
String |
30 |
X |
Registration number |
|
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
|
ExamCode |
String |
20 |
X |
Examination code |
|
TheoryRollCall |
Int |
5 |
|
At least a value must be entered Theoretical exam roll call 0: Absent 1: Present |
|
SimulationRollCall |
Int |
5 |
|
Simulation exam roll call 0: Absent 1: Present |
|
TestRoutesRollCall |
Int |
5 |
|
Maneuverability exam roll call 0: Absent 1: Present |
|
RoadRollCall |
Int |
5 |
|
On-road exam roll call 0: Absent 1: Present |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
d. Transmission of result cancellation
Parameter |
Description |
||||
URL |
api/v1/data/cancel |
||||
Method |
POST |
||||
Description |
This API allows the transmission of result cancellation |
||||
Header |
Authorization Token (Generated after the login process) CenterID ID code of driving examination center |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
StudentData |
List |
|
X |
List of learners |
|
StudentId |
String |
30 |
X |
Registration ID |
|
FullName |
String |
255 |
X |
Full name of learner |
|
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
|
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
|
RegistrationNo |
String |
30 |
X |
Registration number |
|
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamType |
Int |
2 |
X |
Examination subjects: 1: Theoretical exam 2: Simulation exam 3: Maneuverability exam 4: On-road exam |
|
TimesExam |
Int |
3 |
X |
Number of examination times of learners |
|
Reason |
String |
500 |
X |
Reason for result cancellation |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
4.4. Data transmission functions between central supervision servers and theoretical examination servers
4.4.1. Data transmitted from the central supervision server of a driving examination center to its theoretical examination servers
a) Theoretical examination list data
Parameter |
Description |
||||
URL |
api/v1/data/theoryexam |
||||
Method |
POST |
||||
Description |
This API allows data transmission between the central supervision server of a driving examination center to its theoretical examination servers |
||||
Header |
Authorization Token (Generated after the login process) CenterID ID code of driving examination center |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
ProviderId |
String |
20 |
X |
Provider |
|
TotalRecords |
Int |
5 |
|
Total number of records |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamDate |
Date |
10 |
X |
Examination date Format: yyyy-mm-dd Example: 2024-01-01 |
|
ExamTime |
Int |
4 |
X |
Examination time Format: hhmm Example: 0730; 1400 |
|
DecisionNo |
String |
30 |
|
Decision number |
|
DecisionDate |
Date |
10 |
|
Decision date Format: yyyy-mm-dd Example: 2024-01-01 |
|
DecisionMaker |
String |
255 |
|
Decision maker |
|
BoardExaminers |
List |
|
|
List of members of Examination board Refer to section 2. Examination Board Data |
|
StudentData |
List |
|
X |
List of learners participating in the examination Refer to section 3. Examination Board Data |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
b) Examination Board Data
Field |
Data Type |
Character Length |
Required |
Description |
BoardExaminers |
List |
|
|
List of members of Examination board |
Position |
Int |
2 |
|
Position: 1. Chairperson of the Examination Board 2. Members, Director of the driving examination center 3. Members, Director of the training facility 4. Members, Head of Examination Team 5. Secretary 6. Examiner |
ExaminersName |
String |
100 |
|
Examiner's full name |
c) Data of learners participating in theoretical examination
Field |
Data Type |
Character Length |
Required |
Description |
StudentData |
List |
|
X |
List of learners participating in the examination |
StudentId |
String |
30 |
X |
Registration ID |
FullName |
String |
255 |
X |
Full name of learner |
Gender |
Int |
1 |
X |
Gender 0 – Male, 1 – Female, 2 - Other |
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
CountryCode |
String |
3 |
X |
Country code As per the list |
Residence |
String |
255 |
|
Residence |
ResidenceCode |
String |
30 |
X |
Administrative unit code As per the list |
ResidenceManage |
String |
30 |
X |
Management unit code As per the list |
FileNumber |
String |
30 |
|
File number |
RegistrationNo |
String |
30 |
X |
Registration number |
TrainingCode |
String |
5 |
|
Code of training center |
ExamContent |
Int |
5 |
X |
Examination content As per the list: 1: First-time examination (Theoretical exam + Maneuverability exam + On-road exam) 2: Theoretical exam 3: Theoretical exam + Maneuverability exam 4: Theoretical exam + Maneuverability exam + On-road exam 5: Maneuverability exam + On-road exam 6: On-road exam 7: Maneuverability exam 8: Driver license 11: First-time examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 12: Re-examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 13: Re-examination (Maneuverability exam + On-road exam + Simulation exam) 14: Re-examination (Theoretical exam + Simulation exam) |
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
ReasonExamination |
String |
255 |
|
Examination reason |
ImageData |
String |
|
X |
Image of learner Base64 Format: JPEG, PNG |
ImageQuality |
Int |
2 |
X |
Photo quality: - 1: true - 0: false |
ContentNote |
String |
500 |
|
Note |
4.4.2. Data transmitting theoretical exam results from theoretical examination servers to the central supervision server of a driving examination center
Parameter |
Description |
||||
URL |
api/v1/data/theoryresult |
||||
Method |
POST |
||||
Description |
This API allows updating theoretical exam results from theoretical examination servers to the central supervision server of a driving examination center |
||||
Header |
Authorization Token (Generated after the login process) ProviderId : Provider |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
CenterID |
String |
20 |
X |
ID code of driving examination center |
|
StudentData |
List |
|
X |
List of learners participating in the examination |
|
StudentId |
String |
30 |
X |
Registration ID |
|
FullName |
String |
255 |
X |
Full name of learner |
|
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
|
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
|
RegistrationNo |
String |
30 |
X |
Registration number |
|
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + 1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamType |
Int |
2 |
X |
Examination subjects: 1: Theoretical exam |
|
StartTime |
Instant |
20 |
X |
Start time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
EndTime |
Instant |
20 |
|
End time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
Result |
Int |
5 |
X |
Examination score |
|
ImageData |
String |
|
|
Photo of learner Base64 Format: JPEG, PNG |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
4.5. Data transmission functions between the central supervision server and simulation examination servers
4.5.1. Data transmitted from central supervision servers of driving examination centers to simulation examination servers
a) Simulation examination list data
Parameter |
Description |
||||
URL |
api/v1/data/simulationexam |
||||
Method |
POST |
||||
Description |
This API allows data transmission between central supervision servers of driving examination centers to simulation examination servers |
||||
Header |
Authorization Token (Generated after the login process) CenterID ID code of driving examination center |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
|
ProviderId |
String |
20 |
X |
Provider |
TransactionCode |
String |
255 |
X |
Transaction Code |
|
DateSent |
Date |
20 |
X |
Sending date Format: yyyy-mm-dd’T’hh:mm:ss’Z’ Example: 49/2024/TT-BGTVT |
|
Sender |
String |
255 |
X |
Sender |
|
TotalRecords |
Int |
5 |
|
Total number of records |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamDate |
Date |
10 |
X |
Examination date Format: yyyy-mm-dd Example: 2024-01-01 |
|
ExamTime |
Int |
4 |
X |
Examination time Format: hhmm Example: 730; 1400 |
|
DecisionNo |
String |
30 |
|
Decision number |
|
DecisionDate |
Date |
10 |
|
Decision date Format: yyyy-mm-dd Example: 2024-01-01 |
|
DecisionMaker |
String |
255 |
|
Decision maker |
|
BoardExaminers |
List |
|
|
List of members of Examination board Refer to section 2. Examination Board Data |
|
StudentData |
List |
|
X |
List of learners participating in the examination Refer to section 3. Data of learners taking simulation exam |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
b) Examination Board Data
Field |
Data Type |
Character Length |
Required |
Description |
BoardExaminers |
List |
|
|
List of members of Examination board |
Position |
Int |
2 |
|
Position: 1. Chairperson of the Examination Board 2. Members, Director of the driving examination center 3. Members, Director of the training facility 4. Members, Head of Examination Team 5. Secretary 6. Examiner |
ExaminersName |
String |
100 |
|
Examiner's full name |
c) Data of learners participating in examination
Field |
Data Type |
Character Length |
Required |
Description |
StudentData |
List |
|
X |
List of learners participating in the examination |
StudentId |
String |
30 |
X |
Registration ID |
FullName |
String |
255 |
X |
Full name of learner |
Gender |
Int |
1 |
X |
Gender 0 – Male, 1 – Female, 2 - Other |
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
CountryCode |
String |
3 |
X |
Country code As per the list |
Residence |
String |
255 |
|
Residence |
ResidenceCode |
String |
30 |
X |
Administrative unit code As per the list |
ResidenceManage |
String |
30 |
X |
Management unit code As per the list |
FileNumber |
String |
30 |
|
File number |
RegistrationNo |
String |
30 |
X |
Registration number |
TrainingCode |
String |
5 |
|
Code of training center |
ExamContent |
Int |
5 |
X |
Examination content As per the list: 1. First-time examination (Theoretical exam + Maneuverability exam + On-road exam) 2: Theoretical exam 3: Theoretical exam + Maneuverability exam 4: Theoretical exam + Maneuverability exam + On-road exam 5: Maneuverability exam + On-road exam 6: On-road exam 7: Maneuverability exam 8: Driver license 11: First-time examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 12: Re-examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 13: Re-examination (Maneuverability exam + On-road exam + Simulation exam) 14: Re-examination (Theoretical exam + Simulation exam) |
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
ReasonExamination |
String |
255 |
|
Examination reason |
ImageData |
String |
|
X |
Image of learner Base64 Format: JPEG, PNG |
ImageQuality |
Int |
2 |
X |
Photo quality: - 1: true - 0: false |
Field |
Data Type |
Character Length |
Required |
Description |
ContentNote |
String |
500 |
|
Note |
4.5.2. Data transmitting simulation exam results from simulation examination servers to the central supervision server of a driving examination center
Parameter |
Description |
||||
URL |
api/v1/data/simulationresult |
||||
Method |
POST |
||||
Description |
This API allows updating simulation exam results from theoretical examination servers to the central supervision server of a driving examination center |
||||
Header |
Authorization Token (Generated after the login process) ProviderId : Provider |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
CenterID |
String |
20 |
X |
ID code of driving examination center |
|
DateSent |
Date |
20 |
X |
Sending date Format: yyyy-mm-dd’T’hh:mm:ss’Z’ Example: 2024-01-01T00:00:00Z<0} |
|
StudentData |
List |
|
X |
List of learners participating in the examination |
|
StudentId |
String |
30 |
X |
Registration ID |
|
FullName |
String |
255 |
X |
Full name of learner |
|
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
|
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
|
RegistrationNo |
String |
30 |
X |
Registration number |
|
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamType |
Int |
2 |
X |
Examination subjects: 2: Simulation exam |
|
StartTime |
Instant |
20 |
X |
Start time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
EndTime |
Instant |
20 |
|
End time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
Result |
Int |
5 |
X |
Examination score |
|
ImageData |
String |
|
|
Image of learner Base64 Format: JPEG, PNG |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
4.6. Data transmission functions between the central supervision server and maneuverability examination servers
4.6.1. Data transmitted from central supervision servers of driving examination centers to maneuverability examination servers
a) Data of maneuverability examination list
Parameter |
Description |
||||
URL |
api/v1/data/testroutesexam |
||||
Method |
POST |
||||
Description |
This API allows data transmission between central supervision servers of driving examination centers to maneuverability examination servers |
||||
Header |
Authorization Token (Generated after the login process) CenterID ID code of driving examination center |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
|
ProviderId |
String |
20 |
X |
Provider |
TransactionCode |
String |
255 |
X |
Transaction Code |
|
DateSent |
Date |
20 |
X |
Sending date Format: yyyy-mm-dd’T’hh:mm:ss’Z’ Example: 2024-01-01T00:00:00Z |
|
Sender |
String |
255 |
X |
Sender |
|
TotalRecords |
Int |
5 |
|
Total number of records |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamDate |
Date |
10 |
X |
Examination date Format: yyyy-mm-dd Example: 2024-01-01 |
|
ExamTime |
Int |
4 |
X |
Examination time Format: hhmm Example: 730; 1400 |
|
DecisionNo |
String |
30 |
|
Decision number |
|
DecisionDate |
Date |
10 |
|
Decision date Format: yyyy-mm-dd Example: 2024-01-01 |
|
DecisionMaker |
String |
255 |
|
Decision maker |
|
BoardExaminers |
List |
|
|
List of members of Examination board Refer to section 2. Examination Board Data |
|
StudentData |
List |
|
X |
List of learners participating in the examination Refer to section 3. Data of learners taking the maneuverability exam |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
b) Examination Board Data
Field |
Data Type |
Character Length |
Required |
Description |
BoardExaminers |
List |
|
|
List of members of Examination board |
Position |
Int |
2 |
|
Position: 1. Chairperson of the Examination Board 2. Members, Director of the driving examination center 3. Members, Director of the training facility 4. Members, Head of Examination Team 5. Secretary 6. Examiner |
ExaminersName |
String |
100 |
|
Examiner's full name |
c) Data of learners participating in maneuverability examination
Field |
Data Type |
Character Length |
Required |
Description |
StudentData |
List |
|
X |
List of learners participating in the examination |
StudentId |
String |
30 |
X |
Registration ID |
FullName |
String |
255 |
X |
Full name of learner |
Gender |
Int |
1 |
X |
Gender 0 – Male, 1 – Female, 2 - Other |
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
CountryCode |
String |
3 |
X |
Country code As per the list |
Residence |
String |
255 |
|
Residence |
ResidenceCode |
String |
30 |
X |
Administrative unit code As per the list |
ResidenceManage |
String |
30 |
X |
Management unit code As per the list |
FileNumber |
String |
30 |
|
File number |
RegistrationNo |
String |
30 |
X |
Registration number |
TrainingCode |
String |
5 |
|
Code of training center |
ExamContent |
Int |
5 |
X |
Examination content As per the list: 1. First-time examination (Theoretical exam + Maneuverability exam + On-road exam) 2: Theoretical exam 3: Theoretical exam + Maneuverability exam 4: Theoretical exam + Maneuverability exam + On-road exam 5: Maneuverability exam + On-road exam 6: On-road exam 7: Maneuverability exam 8: Driver license 11: First-time examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 12: Re-examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 13: Re-examination (Maneuverability exam + On-road exam + Simulation exam) 14: Re-examination (Theoretical exam + Simulation exam) |
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
ReasonExamination |
String |
255 |
|
Examination reason |
ImageData |
String |
|
X |
Image of learner Base64 Format: JPEG, PNG |
ImageQuality |
Int |
2 |
X |
Photo quality: - 1: true - 0: false |
ContentNote |
String |
500 |
|
Note |
4.6.2. Data transmitting maneuverability exam results from maneuverability examination servers to the central supervision server of a driving examination center
Parameter |
Description |
||||
URL |
api/v1/data/testroutesresult |
||||
Method |
POST |
||||
Description |
This API allows updating maneuverability exam results from maneuverability examination servers to the central supervision server of a driving examination center |
||||
Header |
Authorization Token (Generated after the login process) ProviderId : Provider |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
CenterID |
String |
20 |
X |
ID code of driving examination center |
|
DateSent |
Date |
20 |
X |
Sending date Format: yyyy-mm-dd’T’hh:mm:ss’Z’ Example: 2024-01-01T00:00:00Z |
|
StudentData |
List |
|
X |
List of learners participating in the examination |
|
StudentId |
String |
30 |
X |
Registration ID |
|
FullName |
String |
255 |
X |
Full name of learner |
|
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
|
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
|
RegistrationNo |
String |
30 |
X |
Registration number |
|
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamType |
Int |
2 |
X |
Examination subjects: 3: Maneuverability exam |
|
StartTime |
Instant |
20 |
X |
Start time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
EndTime |
Instant |
20 |
|
End time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
Result |
Int |
5 |
X |
Examination score |
|
ImageData |
String |
|
|
Image of learner Base64 Format: JPEG, PNG |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
4.7. Data transmission functions between the central supervision server and on-road examination servers
4.7.1. Data transmitted from central supervision servers of driving examination centers to on-road examination servers
a) Data of on-road examination list
Parameter |
Description |
||||
URL |
api/v1/data/roadexam |
||||
Method |
POST |
||||
Description |
This API allows data transmission between central supervision servers of driving examination centers to on-road examination servers |
||||
Header |
Authorization Token (Generated after the login process) CenterID ID code of driving examination center |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
|
ProviderId |
String |
20 |
X |
Provider |
TransactionCode |
String |
255 |
X |
Transaction Code |
|
DateSent |
Date |
20 |
X |
Sending date Format: yyyy-mm-dd’T’hh:mm:ss’Z’ Example: 2024-01-01T00:00:00Z |
|
Sender |
String |
255 |
X |
Sender |
|
TotalRecords |
Int |
5 |
|
Total number of records |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamDate |
Date |
10 |
X |
Examination date Format: yyyy-mm-dd Example: 2024-01-01 |
|
ExamTime |
Int |
4 |
X |
Examination time Format: hhmm Example: 730; 1400 |
|
DecisionNo |
String |
30 |
|
Decision number |
|
DecisionDate |
Date |
10 |
|
Decision date Format: yyyy-mm-dd Example: 2024-01-01 |
|
DecisionMaker |
String |
255 |
|
Decision maker |
|
BoardExaminers |
List |
|
|
List of members of Examination board Refer to section 2. Examination Board Data |
|
StudentData |
List |
|
X |
List of learners participating in the examination Refer to section 3. Data of learners taking the on-road exam |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
b) Examination Board Data
Field |
Data Type |
Character Length |
Required |
Description |
BoardExaminers |
List |
|
|
List of members of Examination board |
Position |
Int |
2 |
|
Position: 1. Chairperson of the Examination Board 2. Members, Director of the driving examination center 3. Members, Director of the training facility 4. Members, Head of Examination Team 5. Secretary 6. Examiner |
ExaminersName |
String |
100 |
|
Examiner's full name |
c) Data of learners participating in on-road examination
Field |
Data Type |
Character Length |
Required |
Description |
StudentData |
List |
|
X |
List of learners participating in the examination |
StudentId |
String |
30 |
X |
Registration ID |
FullName |
String |
255 |
X |
Full name of learner |
Gender |
Int |
1 |
X |
Gender 0 – Male, 1 – Female, 2 - Other |
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
CountryCode |
String |
3 |
X |
Country code As per the list |
Residence |
String |
255 |
|
Residence |
ResidenceCode |
String |
30 |
X |
Administrative unit code As per the list |
ResidenceManage |
String |
30 |
X |
Management unit code As per the list |
FileNumber |
String |
30 |
|
File number |
RegistrationNo |
String |
30 |
X |
Registration number |
TrainingCode |
String |
5 |
|
Code of training center |
ExamContent |
Int |
5 |
X |
Examination content As per the list: 1. First-time examination (Theoretical exam + Maneuverability exam + On-road exam) 2: Theoretical exam 3: Theoretical exam + Maneuverability exam 4: Theoretical exam + Maneuverability exam + On-road exam 5: Maneuverability exam + On-road exam 6: On-road exam 7: Maneuverability exam 8: Driver license 11: First-time examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 12: Re-examination (Theoretical exam + Maneuverability exam + On-road exam + Simulation exam) 13: Re-examination (Maneuverability exam + On-road exam + Simulation exam) 14: Re-examination (Theoretical exam + Simulation exam) |
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
ReasonExamination |
String |
255 |
|
Examination reason |
ImageData |
String |
|
X |
Photo of learner Base64 Format: JPEG, PNG |
ImageQuality |
Int |
2 |
X |
Photo quality: - 1: true - 0: false |
ContentNote |
String |
500 |
|
Note |
4.7.2. Data transmitting on-road exam results from theoretical examination servers to the central supervision server of a driving examination center
Parameter |
Description |
||||
URL |
api/v1/data/roadresult |
||||
Method |
POST |
||||
Description |
This API allows updating on-road exam results from on-road examination servers to the central supervision server of a driving examination center |
||||
Header |
Authorization Token (Generated after the login process) ProviderId : Provider |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
CenterID |
String |
20 |
X |
ID code of driving examination center |
|
DateSent |
Date |
20 |
X |
Sending date Format: yyyy-mm-dd’T’hh:mm:ss’Z’ Example: 2024-01-01T00:00:00Z |
|
StudentData |
List |
|
X |
List of learners participating in the examination |
|
StudentId |
String |
30 |
X |
Registration ID |
|
FullName |
String |
255 |
X |
Full name of learner |
|
DateOfBirth |
Date |
10 |
X |
Date of birth Format: yyyy-mm-dd Example: 2024-01-01 |
|
CCCDID |
String |
50 |
X |
ID/Citizen ID/ Passport |
|
RegistrationNo |
String |
30 |
X |
Registration number |
|
ExamType |
String |
5 |
X |
Examination classification As per the list: + A1: Category A1 + A: Category A + B1: Category B1 + B: Category B + C1: Category C1 + C: Category C + D2: Category D2 + D1: Category D1 + D: Category D + BE: Category BE + C1E: Category C1E + CE: Category CE + D2E: Category D2E + D1E: Category D1E + DE: Category DE |
|
ExamCode |
String |
20 |
X |
Examination code |
|
ExamType |
Int |
2 |
X |
Examination subjects: 4: On-road exam |
|
StartTime |
Instant |
20 |
X |
Start time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
EndTime |
Instant |
20 |
|
End time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
Result |
Int |
5 |
X |
Examination score |
|
ImageData |
String |
|
|
Image of learner Base64 Format: JPEG, PNG |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
Code |
Int |
5 |
X |
Command execution status |
4.8. Functions to check system status
Parameter |
Description |
||||
URL |
api/v1/server/getserverstatus |
||||
Method |
POST |
||||
Description |
This API allows to get current system status. Depending on the operational status of system, this function will return whether the system is ready to receive data. |
||||
Header |
Authorization Token (Generated after the login process) CenterID ID code of driving examination center |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
UserName |
String |
20 |
X |
User's login name |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
|
State |
Int |
1 |
X |
Current system status |
StateMessage |
String |
255 |
X |
message about the current system status |
|
NextUpdateTime |
Datetime |
|
X |
Next update time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
List of system status:
- State = 1. The system is operating normally Ready to receive data.
- State = 2. The system is busy. Please check the next update cycle.
4.9. Data reconciliation
Check the number of successful transmissions within a time range
Parameter |
Description |
||||
URL |
api/v1/server/getstatistic |
||||
Method |
POST |
||||
Description |
This API allows retrieving statistical results of data transmission from the driving examination center |
||||
Header |
Authorization Token (Generated after the login process) CenterID ID code of driving examination center |
||||
Input |
Field |
Data Type |
Character Length |
Required |
Description |
ExamCode |
String |
20 |
|
Examination code |
|
TimeFrom |
Instant |
|
X |
Starting time Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
TimeTo |
Instant |
|
X |
Ending time (time range should not exceed 7 days from TimeFrom) Format: yyyy-mm-dd’T’hh:mm:ss’Z’ |
|
Returned Data |
Field |
Data Type |
Character Length |
Required |
Description |
NumberOfSuccess |
Int |
5 |
X |
Total number of successful sessions received within the corresponding time range to the query conditions Example: f only CenterID is passed, the system returns the number of successful transmission sessions within the requested time range. If additional information such as ExamCode is passed, the system will provide detailed results based on the query conditions. |
Ý kiến bạn đọc
Nhấp vào nút tại mỗi ô tìm kiếm.
Màn hình hiện lên như thế này thì bạn bắt đầu nói, hệ thống giới hạn tối đa 10 giây.
Bạn cũng có thể dừng bất kỳ lúc nào để gửi kết quả tìm kiếm ngay bằng cách nhấp vào nút micro đang xoay bên dưới
Để tăng độ chính xác bạn hãy nói không quá nhanh, rõ ràng.