Introduction
OpenTech brings several innovative solutions to the market to help control goods movement and transportation processes. The solutions developed by the company guarantee integration with the main technologies used in the sector, and thus optimize the IT resources already available to the client.
The aim of this manual is to guide customers through the process of integrating the information stored in their application with the data needed to make OpenTech's systems work. In order to provide a basis for the content to be explored, the main solutions marketed by the company will be presented: the Integrated Logistics System (SIL) and Risk Management (GR).
SIL is a tool that offers complete automation and systemic control of logistics processes, gathering a series of data on journeys, vehicle fleets, loads and documents, times and distances. Based on this data, valuable characteristics can be extracted, increasing quality control, on-time deliveries and the assertiveness of the operation.
OpenTech's GR for freight transportation has many features that help reduce risks, making the cargo and the driver safer. This solution includes a secondary profile search for those who will be transporting the cargo, with checks on the driver's registration details, professional history and suitability. The vehicles also undergo a thorough assessment to guarantee the quality of the service and the safety of the cargo. In addition, travel routes are defined in advance and can be monitored 24 hours a day.
In order to use the functionalities of the above systems, it is essential to register drivers and vehicles. The integration Web Service has various methods for this, and the choice of method to use depends directly on the contracted solution. In order to show the appropriate method for each case, the following diagram has been drawn up:
| Functionality | Does not have registration service | Has registration service |
|---|---|---|
| Driver registration | sgrAddRapidPersonalPhysicsV3 | sgrGeneratePersonalPhysicsV4 |
| Vehicle Registration | sgrAddVehiculoRapidoCompV5 | sgrGerarVeiculoV8 |
As soon as you register a professional or a vehicle for a customer who has a search, you need to send this data to the search so that the OpenTech team can confirm and classify the driver/vehicle. There are two types of survey, normal and express, and the method used to send them also varies depending on the solution, as can be seen below:
| Functionality | Normal search | Express search |
|---|---|---|
| Driver registration | sgrEnviaSearchPFV2 | sgrEnviaSearchExpressPF |
| Vehicle registration | sgrEnviaSearchVeicV2 | sgrEnviaSearchExpressVeic |
If you have any doubts about the type of search or any other type of service, we recommend contacting your account manager, who has access to each client's contract and can check the services available.
Another very important feature is the creation of a trip, called a Shipment Authorization (AE), which is available to customers who have contracted SIL or Tracking. There are two different methods for generating the authorization: sgrGerarAEv9 or sgrCriarAEv4. The sgrCreateAEv4 method is the simplest to implement, as it does not require the creation of many “from-to” tables, however, it can only be used for trips within the country. If there is a possibility of trips to MERCOSUR, for example, then the sgrGerarAEv9 method should be implemented .
The methods listed in this manual are necessary for integration. However, the fundamental method for using the Web Service is sgrLogin, which is used to retrieve the access key required in the other methods. In order to be able to fill in the parameters required to execute the methods mentioned above, several other methods have been created that return the necessary information. All of them will be presented and detailed below.