Introdução
A OpenTech traz para o mercado diversas soluções inovadoras para auxiliar no controle dos processos de movimento e transporte de mercadorias. As soluções desenvolvidas pela empresa garantem a integração com as principais tecnologias utilizadas no segmento, e com isso proporcionam a otimização dos recursos de TI já disponíveis no cliente.
Este manual tem por objetivo orientar o cliente nesse processo de integração, entre as informações armazenadas em sua aplicação, e os dados necessários para dar funcionalidade aos sistemas da OpenTech. Para que se tenha uma base do conteúdo a ser explorado, serão apresentadas as principais soluções comercializadas pela empresa: o Sistema Integrado de Logística (SIL) e o Gerenciamento de Risco (GR).
O SIL é uma ferramenta que oferece completa automatização e controle sistêmico dos processos logísticos, reunindo uma série de dados sobre as viagens, frotas de veículos, cargas e documentos, tempos e distâncias. Com base nesses dados, valiosas características podem ser extraídas, aumentando o controle da qualidade, a pontualidade nas entregas e a assertividade da operação.
O GR do transporte de cargas da OpenTech conta com muitos recursos que influem na redução dos riscos, trazendo mais segurança para a carga e para o motorista. Essa solução inclui pesquisa de perfil secundário de quem irá transportar a carga, com checagem de dados cadastrais, histórico profissional e idoneidade do motorista. Também os veículos passam por uma criteriosa avaliação para garantir a qualidade do serviço e a segurança da carga. Além disso, são previamente definidas as rotas da viagem, que pode contar com o monitoramento 24 horas.
Para que se passe a utilizar as funcionalidades dos sistemas acima, é essencial o cadastro de motoristas e veículos. O Web Service de integração dispõe de diversos métodos para isso, e a escolha do método ser empregado depende diretamente da solução contratada. A fim de mostrar o método adequado para cada caso, foi elaborado o esquema a seguir:
| Funcionalidade | Não possui serviço de cadastro | Possui serviço de cadastro |
|---|---|---|
| Cadastro motorista | sgrAdicionarPessoaFisicaRapidoV3 | sgrGerarPessoaFisicaV4 |
| Cadastro veículo | sgrAdicionarVeiculoRapidoCompV5 | sgrGerarVeiculoV8 |
Assim que for realizado o cadastro de um profissional ou de um veículo, para um cliente que possua pesquisa, é preciso enviar esses dados para a pesquisa, para que a equipe da OpenTech faça as confirmações e classifique o motorista/veículo. Existem dois tipos de pesquisa, a normal e a expressa, e o método utilizado para esse envio também varia conforme a solução, como pode ser visto abaixo:
| Funcionalidade | Pesquisa normal | Pesquisa expressa |
|---|---|---|
| Cadastro motorista | sgrEnviaPesquisaPFV2 | sgrEnviaPesquisaExpressaPF |
| Cadastro veículo | sgrEnviaPesquisaVeicV2 | sgrEnviaPesquisaExpressaVeic |
No caso de dúvidas em relação ao tipo de pesquisa ou qualquer outra modalidade de serviço, recomenda-se entrar em contato com o gerente de conta, que tem acesso ao contrato de cada cliente e pode verificar os serviços disponíveis.
Outra funcionalidade muito importante é a criação da viagem, denominada Autorização de Embarque (AE), e disponível para os clientes que contratarem o SIL ou o Rastreamento. Para gerar a autorização, têm-se dois métodos distintos: sgrGerarAEv9 ou sgrCriarAEv4. O método é o sgrCriarAEv4 mais simples para implementar, pois não demanda a criação de muitas tabelas "de-para", entretanto, ele somente pode ser utilizado para viagens dentro do país. Se houver possibilidade de ocorrer viagens para o MERCOSUL, por exemplo, deve ser então implementado o método sgrGerarAEv9.
Os métodos que serão relacionados neste manual são necessários para a integração. Porém, o método fundamental para a utilização do Web Service é o sgrLogin, utilizado para recuperar a chave de acesso requerida nos demais métodos. Para que se consiga preencher os parâmetros exigidos para a execução dos métodos citados acima, foram criados diversos outros métodos que retornam as informações necessárias. Todos eles serão apresentados e detalhados a seguir.