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 : GET

Expand
titleRequest
Code Block
DriverSearchSo {
	private String driverIdOrName; // optional
  	private String emailId; // optional
  	private String linkedClientCode; // optional
  	private String contactNumber; // optional
  	private List<String> spSubLocationCodes; //  spSubLocationCode {"DPWVAN", "AOLADT1"}
  	private String spLocationCode; // spLocationCode ""
  	private List<String> status; // optional
  	private String driverTerminalLocationStatus; // optional siteStatus
  	private String portDriverId; // siteId
  	private String clientCode; // MANDATORY where logged in user is trucking company
  	private boolean isAdmin; // optional
}

...

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 pincodepinCode;
   	private String emailId;
   	private String countryCode;
	private    String contactNumber;
   	private String driverStatus;
	private    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>)

...

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;
}