Ir para o conteúdo principal

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

Objetivo:

ValidarAs 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 completo de abastecimento de veículos no sistema, contemplando:

  • Cadastro de produtos combustíveis
  • Controle de estoque
  • Registro de abastecimento interno
  • Registro de abastecimento externo
  • Importaçintegração via planilha
  • Geração de relatórios

Garantindo que todas as validações, integrações e regras de negócio estejam sendo aplicadas corretamente.o.

Teste realizado após a atualização

01 - ABASTECIMENTO INTERNO

Preparação para testes

Antes de iniciar o processo, validar os seguintes pontos:

  • ProdutoAcessar combustívelo cadastrado commódulo CódigoGestão ANP.de Frotas
  • Garantir acesso aos menus:
    • Menu:Integrações CorporativoSem >Parar Produtos(Postos, eAbastecimento, ServiçosNotas >Fiscais, CadastroFaturas)
    • Monitoramento de Produto

      image.png

    • Aba: Combustível

      image.png

      Processos
  • ProdutoGarantir deveque possuira estoqueAPI esteja disponível.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:

  • Menu:Lista Estoquede >postos Consulta > Estoque
carregada
  • CasoRegistros nãoexibidos hajano estoque:grid
  • Status exibido como:
    • Realizar"Pendente inventáriode doCadastro" produtoou no módulo correspondente.

      image.png


      "Ativo".

    • Cenário 01:02.02 Registro- manualConsultar dedados abastecimentodo internoposto

    Passos

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

    Resultado esperado:

    • Gestão de Frotas > ManutençExibição >dos Controledados: de
        Abastecimentos
      • Razão >social
        • Abastecimento
      • Nome Interno
        fantasia

        • image.png

      • Endereço
      • Cidade / UF
      • CNPJ
    • CliqueExibição emdas Inserir

      image.png

    • Preencha os campos obrigatórios:abas:
      • VeículoContato
      • AlmoxarifadoFaturamento
      • Motorista
      • Produto
      • Data do abastecimento
      • Quantidade
      • Km ou Horímetro
      • ASE (quando aplicável)
    • Clique em Confirmar

      • Validações

      • Veículo:
        • Deve estar ativo e com status Liberado
      • Produto:
        • Deve possuir Código ANP ou código específico permitido
      • Data:
        • Não pode ser superior à data/hora atual
      • Quantidade:
        • Obrigatória
      • Km/Horímetro:
        • Deve ser maior que o valor anterior
      • Estoque:
        • Deve existir saldo suficiente no almoxarifado
      • Sistema valida:
        • Registro duplicado
        • Permissão de quantidade fracionada
        • Centro de custo (conforme cadastro do veículo)

      Resultado esperado

      • Registro inserido com sucesso.
      • Geração automática de requisição de abastecimento
      • Registro disponível na listagem.

      Cenário 02: Impressão da requisição

      Passos

      1. Após salvar, clicar em Imprimir
      2. Acessar:
        • Relatórios > Em processamento
      3. Localizar o relatório
      4. Realizar o download

      Resultado esperado

      • Relatório de requisição gerado corretamente contendo:
        • Veículo
        • Produto
        • Quantidade
        • Centro de custoCobrança

      03 - Integração de Abastecimento

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

      Cenário 03:03.01 Importaç- Executar integração de abastecimento interno via planilha

      Passos

      1. Acesse:Acessar:
        Integrações Sem Parar > Abastecimento
      2. Informar filtro:
        • AbastecimentoData Internodo abastecimento
      3. CliqueClicar emem:
        API Importarde PlanilhaAbastecimento
      4. BaixeClicar o modeloem:
        Atualizar
      5. Preencha
      os

      Resultado campos:esperado:

      • VeículoRegistros exibidos na grid
      • AlmoxarifadoColunas preenchidas:
        • Combustível
        • DataPlaca
        • ProdutoPosto
        • QuantidadeValores
      • Km/HorímetroIndicadores 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. Anexe o arquivo (.xlsx)
      6. Clique em Confirmar

      Resultado

      Validaçõesesperado:

      • ApenasDados 1salvos arquivo por enviocorretamente
      • FormatoRegistro obrigatório:apto .xlsx
        • para
      • Aplicam-se as mesmas validações do cadastro manual.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 esperadoesperado:

      • Registro inseridoprocessado corretamente.com sucesso
      • GeraçAtualização dedo relatório de importaçãostatus
      • MensagemIndicador dealterado sucessopara noválido relatório(verde)

      02Cenário 03.05 - ABASTECIMENTOExecutar EXTERNOrecebimento automático

      1. Selecionar um registro
      2. Clicar na opção:
        PreparaçãoRecebimento paraAutomático
        3. testes

      AntesResultado do processo, validar:esperado:

      • CadastroProcessamento iniciado
      • Integração realizada via XML

      04 - Monitoramento de tipoProcessos

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

      Cenário 04.01 - Acessar monitoramento

      1. Acessar:
        Monitoramento > Monitoramento de Processos

      Resultado esperado:

      • Menu:Exibição Cadastrosdos >indicadores: Tipo
          de
        • Processado comprovantehoje
          • de
        • Processando
          • abastecimento
        • Processado

          image.png

          +1 dia

      Cenário 01:04.02 Cadastro- deValidar tipoprocessamento de comprovanterealizado

      Passos

      1. AcesseLocalizar o menu de comprovantes
      2. Clique em interface:Inserir
        image.png
        REC_AUT
      3. Informe:Verificar registros no histórico.

      Resultado esperado:

      • Registro exibido com:
        • Data inicial/final
        • Descrição
        • Ativo
          • da
        • Uso de chave eletrônica (quando necessário)interface

      Cenário 04.03 - Validar processamento com erro

      1. CliqueAcessar emum Confirmar
        image.png
        registro com erro
      2. Verificar descrição

      Resultado esperadoesperado:

      • TipoMensagem deexibida: comprovante
          cadastrado
        • 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 02:05.01 Registro- manualExecutar integração de abastecimentonotas externofiscais

      Passos

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

      Resultado esperado:

      • GestãoRegistros deexibidos Frotasna >grid
        • Manutenção
      • Informações >preenchidas: Controle
          de
        • Nota Abastecimentosfiscal
          • >
        • Chave Abastecimentoeletrônica
          • Externo

          image.png

        • Valores

      Cenário 05.02 - Consultar nota fiscal

      1. CliqueSelecionar emum Inserir

        image.png

        image.png

        registro.
      2. PreenchaAcessar osa campos:consulta

      Resultado esperado:

      • VeículoExibição completa:
        • Dados do abastecimento
        • TipoNota fiscal.
        • Valores
        • Posto
        • Chave eletrônica

      06 - Integração de comprovanteFaturas

      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. DataClicar:
        API dode ticketFaturas
      3. ProdutoClicar:
        Atualizar

      Resultado esperado:

      • Registros exibidos
      • Dados preenchidos:
        • Número da transação
        • Placa
        • Quantidade
        • Valor por litro
        • ParceiroCPF 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/HorímetroKM
        • ASE
      • Clique em Confirmar

        • Validações

        • Tipo de comprovante:
          • Obrigatório
        • Data:
          • Deve conter hora/minuto/segundo
          • Não permite 00:00:00
        • Produto:
          • Deve possuir código ANP
        • Valor por litro:
          • Obrigatório
        • Quantidade:
          • Obrigatória
        • Parceiro:
          • Obrigatório
        • Valor abastecido:

          • Calculado automaticamente:

            Valor = (Valor litro × Quantidade) - Desconto

          • Pode ser ajustado manualmente
        • Chave eletrônica:
          • Obrigatória quando aplicável.
        • Sistema valida:
          • Duplicidade
          • Conciliação automática (quando houver chave)CNPJ

        ResultadoConsiderações esperadofinais

        • Registro inserido com sucesso.
        • Mensagem de confirmaçIntegração exibida.
          • depende
        • Registro disponível na listagem.

        Cenário 03: Importação de abastecimento externo via planilha

        Passos

        1. Acesse:de:
          • AbastecimentoAPI Externoativa
          • Dados válidos
        2. CliqueAbastecimento em Importar Planilha
        3. Baixe o modelo
        4. Preencha os dados:exige:
          • Veículo
            • Complementação
          • Tipo(Motorista dee comprovante
          • Data
          • Produto
          • Quantidade
          • Valor
          • Parceiro
          • Motorista
          • Km/Horímetro
          • ASEASE)
        5. ImportarMonitoramento oé arquivo
          6. essencial

        Validações

        para:
        • MesmasIdentificar regras do cadastro manualerros
        • ValidaçValidar sucesso da integração de chave eletrônica
        • Validação de parceiro

        Resultado esperado

        • Registros inseridos corretamente
        • Relatório de importação gerado
        • Mensagem de sucesso apresentada

        Observações gerais

        • Existem melhorias em andamento para abastecimento interno e externo.
        • Ajustes futuros serão documentados em novos roteiros, conforme alinhado.

        4.png

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

    Voltar ao topo