CGS - APISUL - Integração de SMP via plano de viagem

Modificado em Qui, 5 Jun na (o) 3:58 PM


1. Informações gerais

 

Objetivo: 

 

Realizar integração de SMP - Solicitação de Monitoramento Preventivo junto à GR Apisul.


Detalhes:

 

  • Módulo: Cargas (CGS).

  • Caminho de acesso: 
    Cadastro > Parâmetros > Integrações de Softwares - Apisul
    Cadastro > Trafego > Rotas

    Operacional > Plano de Viagem > Plano de Viagem


Informações adicionais:


2. Parametrização


Para integrar o módulo de Cargas (CGS) com a Gerenciadora de Risco Apisul, é necessário realizar o cadastro de parametrização acessando o seguinte caminho no sistema Cadastro > Parâmetros > Integração de Software > Apisul

Campos a serem preenchidos:

  • Token:
    Informado pela Gerenciadora de Risco Apisul. É um dado obrigatório para autenticação da comunicação com o serviço.

  • CNPJ Emitente (opcional):
    Caso informado, o sistema considerará este CNPJ como padrão para emissão.
    Se o campo não for preenchido, será utilizado o CNPJ da filial emitente do Plano de Viagem.

  • Endereço de Serviço:
    URL fornecida pela Apisul, responsável por receber as requisições de SMP.

  • Integrar SMP via:
    Marque a opção "Plano de Viagem", indicando que a geração da SMP deve ocorrer automáticamente no momento da gravação do plano.




3. Funcionamento


Após realizar as configurações necessárias, ao emitir o Plano de Viagem, o sistema apresentará uma mensagem em tela perguntando se deseja enviar a SMP para a Apisul.

  • Ao clicar em “Sim”, o sistema realiza imediatamente a comunicação da SMP, utilizando os dados informados no Plano de Viagem.

  • Ao clicar em “Não”, o sistema apenas grava o Plano de Viagem, sem realizar a integração com a Apisul naquele momento.



Caso a gerenciadora de risco negue a geração da SMP, será apresentado o motivo da rejeição dita pela Apisul:

Na aba "Integrações" armazenaremos as informações do envio da seguinte maneira:


Em caso de necessidade encaminhar o XML de Envio ou o Retorno à Apisul, ao clicar com o botão direito do mouse disponibilizamos a ação, assim com a possibilidade de "Reenvio":


Ao integrar com Sucesso, atualizamos o status de envio em tela, e armazenamos o número da SMP para conferência no portal da Gerenciadora de Risco:



4. Regras


Tipo de Carga

O "Tipo de Carga" enviado para a Apisul é determinado com base no produto vinculado ao documento associado ao Plano de Viagem.

Durante a integração:

  • O sistema verifica o campo “Referência GR” do produto.

  • Caso este campo esteja preenchido, sua descrição será priorizada como tipo de carga.

  • Se o campo estiver em branco, será considerada a descrição padrão do produto.


Data/hora de saída:

A data de início da viagem, é considerada do campo "Data/Hora Saída" em tela:


OBS: E também é obrigatório o preenchimento do campo Data/Hora previsão de chegada, em caso de não preenchimento do campo, o sistema apresentará a seguinte modelo de crítica na integração com a Apisul.

Exemplo da crítica


Tipo de veículo:

Para identificar se o veículo é agregado ou não, enviamos o tipo do veículo a partir do "Tipo de Frota" configurado:


Valor da Carga na Integração com a Apisul

Na integração dos documentos com a Apisul, é obrigatório que todos os pontos enviados possuam um valor de carga maior que zero.

Para atender a essa exigência, o sistema distribui o valor total da carga entre os pontos enviados, de forma que o primeiro ponto receba a maior parte do valor e o segundo ponto o valor restante, garantindo que a soma dos valores represente o total da carga.

Exemplo:
Se o documento possui valor de carga de R$ 1,00, o sistema poderá enviar:

  • Primeiro ponto: R$ 0,99

  • Segundo ponto: R$ 0,01
    Totalizando os R$ 1,00 correspondentes ao valor integral da carga.




5. Fechamento de SMP

Atualmente, o sistema permite realizar o fechamento de uma SMP via sistema, será necessário acessar o plano daquela respectiva SMP
ao consultar o plano, o sistema habilitará o campo "Data/Hora de Chegada" para preenchimento. 

Após informar a chegada, vá até a aba "Despesas de Viagem > Fechamento" e preencha os dados necessários.
Uma vez completados os campos obrigatórios, o botão "Gravar" será habilitado


Ao clicar em "Gravar", o sistema realizará uma consulta automática ao portal da Apisul para verificar o status atual da SMP

  • Se o status da SMP for “Em Viagem”

    O sistema concluirá o fechamento da SMP tanto no sistema quanto na Apisul
    Registrando na Apisul também

  • Caso o status da SMP seja “Encerrada” e "finalizado"

    O sistema não permitirá o fechamento e exibirá as mensagens de retorno correspondentes.


  • Caso o status da SMP seja “Cancelada” ou "não aprovada"

    O sistema não permitirá o fechamento e exibirá as mensagens de retorno correspondentes

6. Cancelamento de SMP

Atualmente, o sistema oferece dois métodos para cancelamento de SMP:

  1. Cancelamento via Portal Apisul:
    Acesse o portal da Apisul, localize e selecione a SMP desejada



Clicando no ícone


e selecionando o status da SMP como cancelada


Observação:
 
O registro de status será permitido apenas para SMPs com status diferente de “Não Aprovada”. SMPs com esse status não poderão ter o status atualizado no sistema. 


2. Cancelamento via Globus:
O segundo método é pelo Globus, realizando a exclusão do plano de viagem.


Ao realizar a exclusão, o sistema realiza a alteração do status da SMP para cancelada automaticamente.







Se algum auxílio ou esclarecimento for necessário, conte conosco através de nossos canais de atendimento. 


Telefone: (11) 5018-2525.

Portal do Cliente: https://portaldocliente.praxio.com.br/


#PodeContar


Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo