Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 23

1. Search API URL

url : /vbs/driver/search

DriverSearchSo is ModelAttribute on backend side where request params in url will be picked from url and mapped to entity values of DriverSearchSo in backend side (frontend has to side params which are present in below DriverSearchSo only)

sample url : /vbs/driver/searchDriver?driverIdOrName=123&contactNumber=12312...

HTTP Method : POST GET

Expand
titleRequest
Code Block
DriverSearchSo {
	

...

String driverIdOrName; // optional
  	

...

String emailId; // optional
  	

...

String linkedClientCode; // optional
  	

...

String contactNumber; // optional
  	

...

List<String> spSubLocationCodes; //  spSubLocationCode {"DPWVAN", "AOLADT1"}
  	

...

String spLocationCode; // spLocationCode ""
  	

...

List<String> status; // optional
  	

...

String driverTerminalLocationStatus; // optional siteStatus
  	

...

String portDriverId; // siteId
  	

...

String clientCode; // MANDATORY where logged in user is trucking company
  	

...

boolean isAdmin; // optional
}

Expand
titleResponse
Code Block
ListResponseSO<DriverSearchresponseSo> {
	List<DriverSearchResponseSo> list;
	Long totalRecords;
}
Expand
titleDriverSearchResponseSo
Code Block
DriverSearchResponseSo {
	
private Long driverId; private String firstName; private String lastName; private LocalDate dateOfBirth; private String addressLine; private String country; private String state; private String city; private String pincode; private String emailId; private String countryCode; private String contactNumber; private String driverStatus; private String clientCode;
Long driverId;
    String firstName;
    String lastName;
    LocalDate dateOfBirth;
    String addressLine;
    String country;
    String state;
    String city;
    String pinCode;
    String emailId;
    String countryCode;
    String contactNumber;
    String driverStatus;
    String clientCode;
}

2. Cancel Driver API

HTTP METHOD : DELETE
URI : /driver/cancel/{driverIds}
example : /vbs/driver/cancel/123,354?remarks=Cancelling%20the%20driver

Expand
titleFor Reference

(see container appt cancel api for reference- https://meatest-community.cargoes.com/vbs/swagger-ui.html#/container-appointment-controller/CA Cancel)

Path variable : 
driverIds (List<Long>)

@ModelAttribute as Query String :
  remarks: "these are remarks" (String)

Expand
titleSuccess Response 200

[

  {

    "driverId" : 123,

    "firstName" : "Xyz",

    "lastName" : "abc",

“processingRemarks” : “Successfully cancelled“

  }

]

Processing remarks in response can be “Successfully cancelled“ / “Already cancelled“ / “No data present or ownership issues.“.

3. Csv Download Driver API

HTTP METHOD : GET
URI : /driver/downloadCSV
example : /vbs/driver/downloadCSV?driverIdOrName=123&contactNumber=12312

Expand
titleFor Reference

(see container appointment csv download api for reference - https://meatest-community.cargoes.com/vbs/swagger-ui.html#/container-appointment-controller/CA_CSV Download)
(Sample api which is called and file is downloaded on the mea test env for container appt csv download - https://meauat-community.cargoes.com/vbs/containerappointment/downloadCSV?ccsIdOrContNoOrContApptNo=&apptDateFrom=02%2F03%2F2023+00%3A00&apptDateTo=08%2F03%2F2023+10%3A59&lineId=MSC%2CCMA%2CCOS&appointmentType=DOE%2CDOM&truckingCompanyId=&truckingCompanyName=&subContractCompanyId=&subContractCompanyName=&bookingNo=&status=&truckVisitAppointmentNo=&clientCode=AFC00000003&site=AOLADT1)

Expand
title@ModelAttribute as Query string:

driverIdOrName
spSubLocationCodes (of type List<String>)
spLocationCode
driverStatuses (of type List<String>)
emailId
contactNumber
clientCode (this is for logged in user)
linkedClientCode
portDriverId
driverTerminalLocationStatus
isAdmin

Success Response 200 content type as text/csv

4. View API URL

url : /vbs/driver/{driverId}

sample url : /vbs/driver/1

HTTP Method : GET

Expand
titleResponse
Code Block
DriverDetailSo {
	Long driverId;
    String firstName;
    String lastName;
    LocalDate dateOfBirth;
    String addressLine;
    String country;
    String state;
    String city;
    String pincode;
    String emailId;
    String countryCode;
    String contactNumber;
    String driverStatus;
    String defaultClientCode;
    String remarks;
    List<DriverTerminalLocationSo> driverTerminalLocations;
    List<DriverTruckingCompanySo> driverTruckingCompanies;
    List<DriverDocumentSo> driverDocuments;
}

Expand
titleDriverTerminalLocationSo
Code Block
DriverTerminalLocationSo {
   String spLocationCode;
   String spSubLocationCode;
   String portDriverId;
   LocalDate validUpto;	
}

Expand
titleDriverTruckingCompanySo
Code Block
DriverTruckingCompanySo {
	String clientCode;
    boolean defaultClient;
}

Expand
titleDriverDocumentSo
Code Block
DriverDocumentSo {
	String documentId;
    String documentType;
    String documentNumber;
    LocalDate expiryDate;
    String documentName;
}

5. Download Document API URL

url : /vbs/document/{documentId}

sample url : /vbs/document/48418155

HTTP Method : GET

Expand
titleResponse
Code Block
DownloadDocumentResponseSo {
	Long documentId;
    String documentType;
    String documentNumber;
    LocalDate expiryDate;
    byte[] file;
    String message;
}