Ir para o conteúdo principal

OS 91875 - MELHORIA - FROTAS - APIS DO SEM PARAR E RECEBIMENTO AUTOMÁTICO

Objetivo:

As funcionalidades de Integração com o Sem Parar permitem importar e tratar automaticamente informações relacionadas a:

  • Postos
  • Abastecimentos
  • Notas fiscais
  • Faturas

Esses dados são consumidos via API e apresentados em telas de conferência, validação e efetivação, permitindo ao usuário complementar informações obrigatórias e concluir o processo de integração.

Teste realizado após a atualização

01 - Preparação para testes

  • Acessar o módulo Gestão de Frotas
  • Garantir acesso aos menus:
    • Integrações Sem Parar (Postos, Abastecimento, Notas Fiscais, Faturas)
    • Monitoramento de Processos
  • Garantir que a API esteja disponível para consumo
  • Ter dados disponíveis para integração (Sem Parar)

02 - Integração de Postos

Objetivo
Validar a importação e consulta de postos via API do Sem Parar

Cenário 02.01 - Executar integração de postos

  1. Acessar:
    Integrações Sem Parar > Postos
  2. Clicar no botão:
    API de Postos
  3. Clicar em:
    Atualizar

Resultado esperado:

  • Lista de postos carregada
  • Registros exibidos no grid
  • Status exibido como:
    • "Pendente de Cadastro" ou "Ativo".

Cenário 02.02 - Consultar dados do posto

  1. Selecionar um registro na listagem.
  2. Acessar a visualização (lupa)

Resultado esperado:

  • Exibição dos dados:
    • Razão social
    • Nome fantasia
    • Endereço
    • Cidade / UF
    • CNPJ
  • Exibição das abas:
    • Contato
    • Faturamento
    • Cobrança

03 - Integração de Abastecimento

Objetivo
Validar importação, complementação e efetivação dos abastecimentos

Cenário 03.01 - Executar integração de abastecimento

  1. Acessar:
    Integrações Sem Parar > Abastecimento
  2. Informar filtro:
    • Data do abastecimento
  3. Clicar em:
    API de Abastecimento
  4. Clicar em:
    Atualizar

Resultado esperado:

  • Registros exibidos na grid
  • Colunas preenchidas:
    • Combustível
    • Placa
    • Posto
    • Valores
  • Indicadores visuais (vermelho/verde)

Cenário 03.02 - Validar registros pendentes

  1. Identificar registros com indicador 🔴
  2. Verificar colunas:
    • Motorista
    • ASE

Resultado esperado:

  • Registros sem vínculo apresentam indicador vermelho.
  • Necessidade de preenchimento dos dados complementares.

Cenário 03.03 - Preencher dados complementares

  1. Selecionar um registro
  2. Acessar a consulta (lupa)
  3. Ir até:
    Dados Complementares
  4. Informar:
    • Motorista
    • ASE
  5. Confirmar

Resultado esperado:

  • Dados salvos corretamente
  • Registro apto para integração

Cenário 03.04 - Efetivar integração

  1. Selecionar um registro válido
  2. Clicar no ícone de ação
  3. Selecionar:
    Efetivar Integração

Resultado esperado:

  • Registro processado com sucesso
  • Atualização do status
  • Indicador alterado para válido (verde)

Cenário 03.05 - Executar recebimento automático

  1. Selecionar um registro
  2. Clicar na opção:
    Recebimento Automático

Resultado esperado:

  • Processamento iniciado
  • Integração realizada via XML

04 - Monitoramento de Processos

Objetivo 
Validar acompanhamento de execuções das integrações.

Cenário 04.01 - Acessar monitoramento

  1. Acessar:
    Monitoramento > Monitoramento de Processos

Resultado esperado:

  • Exibição dos indicadores:
    • Processado hoje
    • Processando
    • Processado +1 dia

Cenário 04.02 - Validar processamento realizado

  1. Localizar interface:REC_AUT
  2. Verificar registros no histórico.

Resultado esperado:

  • Registro exibido com:
    • Data inicial/final
    • Descrição da interface

Cenário 04.03 - Validar processamento com erro

  1. Acessar um registro com erro
  2. Verificar descrição

Resultado esperado:

  • Mensagem exibida:
    • XML inválido ou corrompido.

Cenário 04.04 - Validar processamento com sucesso

  1. Acessar registro processado com sucesso.

Resultado esperado:

  • Mensagem exibida:
    • Nota fiscal recepcionada com sucesso.

05 - Integração de Notas Fiscais

Objetivo

Validar importação e consulta de notas fiscais.

Cenário 05.01 - Executar integração de notas fiscais

  1. Acessar:
    Integrações Sem Parar > Notas Fiscais
  2. Clicar:
    API de Notas Fiscais
  3. Clicar:
    Atualizar

Resultado esperado:

  • Registros exibidos na grid
  • Informações preenchidas:
    • Nota fiscal
    • Chave eletrônica
    • Valores

Cenário 05.02 - Consultar nota fiscal

  1. Selecionar um registro.
  2. Acessar a consulta

Resultado esperado:

  • Exibição completa:
    • Dados do abastecimento
    • Nota fiscal.
    • Valores
    • Posto
    • Chave eletrônica

06 - Integração de Faturas

Objetivo

Validar importação e consulta de faturas.

Cenário 06.01 - Executar integração de faturas

  1. Acessar:
    Integrações Sem Parar > Faturas
  2. Clicar:
    API de Faturas
  3. Clicar:
    Atualizar

Resultado esperado:

  • Registros exibidos
  • Dados preenchidos:
    • Número da transação
    • Placa
    • Quantidade
    • Valor
    • CPF motorista
    • CNPJ posto

Cenário 06.02 - Consultar fatura

  1. Selecionar um registro.
  2. Acessar a consulta

Resultado esperado:

  • Exibição completa dos dados:
    • Transação
    • Abastecimento
    • Valores
    • Motorista
    • KM
    • CNPJ

Considerações finais

  • Integração depende de:
    • API ativa
    • Dados válidos
  • Abastecimento exige:
    • Complementação (Motorista e ASE)
  • Monitoramento é essencial para:
    • Identificar erros
    • Validar sucesso da integração

4.png

ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.

Voltar ao topo