Assign Driver to Job Sheet
Assigning Waybills to Drivers#
The interface allows waybills to be assigned to drivers.Configuration Instructions#
oTMS provides Web Service interfaces in both production and testing environments, where the testing environment is primarily used for integration testing. In both environments, API account credentials must be assigned by the oTMS system administrator before they can be used.Important Notes#
Please use the public interfaces reasonably. If abnormal calls or any issues affecting system performance are detected, we will impose restrictions on the API account calls, or even deactivate them.
Call Limitations#
Currently, the call limit for this interface is set to a maximum of 10 requests per second per company.Request
Basic Authorization. If not empty, this value will be used for authentication. Otherwise, the username and password in the request message will be used.
Body Params application/xml
Version number of the request
Username. Used for API caller authentication. If the Authorization header is not empty, this value will be ignored.
Password. Used for API caller authentication. If the Authorization header is not empty, this value will be ignored.
jobSheets
array[object (JobSheetAssignment) {6}]
optionalList of job sheets to assign drivers. The maximum number of assignments per request is 100.
Driver's mobile phone number
Whether to ignore whether the vehicle type matches the order. Default is false.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jobSheetAssignmentRequest version="0.1" login="login" password="password">
<jobSheets>
<jobSheet sequence="1">
<jobSheetNumber>JSVIAOCIBJ000015</jobSheetNumber>/////The order needs to include loading information
<externalShipmentId></externalShipmentId>
<truckPlate>N12041</truckPlate>
<driverMobile>+622412041</driverMobile>
</jobSheet>
</jobSheets>
</jobSheetAssignmentRequest>
Request samples
curl --location --request PUT 'https://login.otms.com/ws/jobsheet/driver' \
--header 'Authorization;' \
--header 'Content-Type: application/xml' \
--data-raw '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jobSheetAssignmentRequest version="0.1" login="login" password="password">
<jobSheets>
<jobSheet sequence="1">
<jobSheetNumber>JSVIAOCIBJ000015</jobSheetNumber>/////The order needs to include loading information
<externalShipmentId></externalShipmentId>
<truckPlate>N12041</truckPlate>
<driverMobile>+622412041</driverMobile>
</jobSheet>
</jobSheets>
</jobSheetAssignmentRequest>'
Responses
jobSheets
array[object (JobSheetAssignmentResult) {6}]
optionalDetailed information about job sheet assignment results
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jobSheetAssignmentResponse version="0.1">
<responseCode></responseCode>
<jobSheets>
<jobSheet sequence="1">
<jobSheetNumber>JSVIAOCIBJ000015</jobSheetNumber>
<externalShipmentId></externalShipmentId>
<status>SUCCEED</status>
<code>100</code>
<msg>Success</msg>
</jobSheet>
</jobSheets>
</jobSheetAssignmentResponse>
Modified at 2025-06-06 02:46:48