1. Informações gerais
Objetivo: |
Realizar integração de SMP - Solicitação de Monitoramento Preventivo junto à GR Apisul. |
Detalhes: |
|
Informações adicionais:
|
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:
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
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo