SMPModeloIntegracao |
![]() |
¹. Não informar o nome da rota se tiver o recurso "Novo Rotograma" habilitado. 2. Motorista não é obrigatório em viagens logísticas.
Observações:
1) O envio da Data Prevista de fim de viagem deve ser realizado através da estrutura de <pontos>, onde o sistema assumirá a data do campo "PrevisaoChegada" do último ponto informado.
2) Para cálculo automático da data prevista de fim de viagem o cliente deve possuir o recurso "Calcula Previsão Chegada", desde que o campo "PrevisaoChegada" do último ponto não seja informado.
3) NomeRota: Se preenchida esta tag, o sistema utilizará uma rota fixa (previamente cadastrada), do contrário será gerada uma rota de forma dinâmica, baseada nos pontos informados na lista de pontos conforme a ordem recebida.
4) Processo para geração do Plano de Gerenciamento de Viagem (PGV)
Para SMPs monitoradas pelo gerenciamento de riscos é realizado processo de "Aceite de SMP ", no qual é feita uma checagem sistemica das regras do Plano de Gerenciamento de Riscos (PGR) configurados para o Projeto do cliente.
Diante disto é fundamental que a SMP seja enviada com 30 minutos de antecedência.
A leitura e principalmente a tratativa dos retornos gerados pela integração também são muito importantes para o bom andamento do processo.
Os retornos da integração são gerados no momento da requisição, mas também podem ser acessados através de tela Auditoria Integração.
Ao enviar uma SMP via integração o sistema retorna informação de Sucesso ou Erro na geração da mesma: * Em caso de "Erro" devem ser verificados as inconsistências geradas e sinalizar ao usuário que está emitindo a SMP para que o mesmo possa realizar os devidos ajustes e reenviar a requisição. Neste caso a SMP não é salva na base de dados da Apisul. * Em caso de "Sucesso" a SMP é gerada e o número da mesma é informado. Este é o número de controle da viagem, não significa que o veículo está liberado para seguir viagem. A liberação de SMP para seguir viagem é gerado através de eventos e, para que a SMP seja liberada sem riscos, é necessário a implementação do metodo BuscaSMP utilizando a informação da propriedade [SMP.Status], baseando-se nas seguintes regras: 1. Viagem Aguardando Liberação: Este status é o início do processo, onde a viagem foi cadastrada na APISUL e está em processo de validação das regras exigidas pelo PGR. a. Abaixo os status da APISUL que significam este processo e serão retornados na consulta: i. Ag. Leitura ii. Em Espera iii. Em Aprovação iv. Pendente v. Em processamento vi. Em Validação b. Este processo de liberação pode levar até 30 minutos; c. Indicamos colocar a consulta automática da mudança de status a cada 2 minutos, assim facilitando o processo do usuário. d. Quando viagem não for liberada em até 30 minutos usuário deve entrar em contato com a central da APISUL para verificar o motivo da pendência de liberação.
2. Viagem liberada: Este status significa que a viagem foi liberada para Monitoramento. a. Abaixo os status da APISUL que significam este processo e serão retornados na consulta: i. Em Viagem ii. Em Monitoramento iii. Logística
3. Viagem Encerrada: Este status significa que a viagem foi monitorada e finalizada. a. Abaixo os status da APISUL que significam este processo e serão retornados na consulta: i. Encerrada ii. Finalizada
4. Viagem Reprovada: Este status significa que na viagem foi realizado o processo de validação e por algum motivo de GR foi recusada. Indica que não terá monitoramento pelo APISUL a. Abaixo os status da APISUL que significam este processo e serão retornados na consulta: i. Cancelada ii. Não Aprovada iii. Recusada
O envio do Projeto é obrigatorio e crucial para o processo de Aceite de SMP, é baseado nos dados do Projeto que são aplicadas e realizadas as regras de gerenciamento de riscos.
5) Reprogramação de viagem ( Complemento de Carga )
O Processo de reprogramação só pode ser realizado quando o veículo estiver parado em local seguro. Seu envio deve ser feito com pelo menos 10 minutos de antecedência à qualquer movimentação do veículo.
Consiste em Finalizar a SMP corrente e enviar uma nova que a substitua.
6) No envio dos pontos, deve ser observado a obrigatoriedade do envio das informações de coordenadas ou endereço, cidade, estado e pais para cada ponto.
7) Na vinculação de motoristas à SMP, deve ser observado a situação dos motoristas estando como "Liberado", caso o cliente possua o recurso "Controla Situação de Motorista" habilitado.
|