Visão Geral

Este artigo explica como configurar o conector OpenTrips, na ação Listar Despesas, dentro de um robô no LIGAí. Esta etapa permite que o robô recupere uma lista detalhada de despesas de viagem a partir da plataforma OpenTrips.

Quando Utilizar esta Ação

Utilize a ação Listar Despesas quando houver a necessidade de:

  • Extrair relatórios de gastos de viagens para auditoria ou faturamento.

  • Automatizar a conciliação financeira de despesas lançadas pelos colaboradores.

  • Filtrar gastos por usuário, empresa ou período específico.

Pré-requisitos

Antes de configurar a etapa no robô, é necessário possuir as credenciais de acesso à API do OpenTrips (Login e API Key). Sem esses dados, o robô não conseguirá autenticar para listar as informações.

Passo a Passo de Configuração

1. Adicionar a etapa OpenTrips no robô

  • Acesse o menu Meus Robôs.

  • Abra o robô desejado.

  • Selecione o conector OpenTrips.

  • Escolha a ação Listar Despesas.

2. Autenticação

Na seção Autenticação, preencha os campos obrigatórios para garantir o acesso aos dados:

  • Login (Email) - Endereço de e-mail utilizado para acesso à plataforma
  • Senha - Senha correspondente ao login informado
  • API Key (x-api-key) - Chave de autenticação técnica fornecida pelo OpenTrips.

3. Filtros Obrigatórios (escolha um)

Para realizar a busca, o sistema exige que ao menos um dos identificadores abaixo seja preenchido para filtrar os resultados:

  • ID do Usuário - Identificador único do usuário para filtrar suas despesas específicas
  • ID da Empresa - Identificador da empresa para filtrar despesas de todos os colaboradores vinculados
  • ID do Relatório de Viagem (travelReportId) - Identificador de um relatório de viagem específico

4. Filtros Opcionais

Utilize estes campos para refinar ainda mais a sua busca:

  • ID do Status Filtra as despesas pelo estado atual (Ex: Pendente, Aprovado).
  • Data de Início / Data de Fim Delimita o período das despesas. O formato aceito é YYYY-MM-DD.

5. Salvar a Configuração

Após configurar os filtros desejados:

  • Clique em Confirmar (botão azul na parte inferior da tarefa).

  • Em seguida, clique em Salvar no robô.

Erros Comuns e Como Proceder

  • 401 Unauthorized: O Login ou a API Key informados estão incorretos.

  • Nenhum Filtro Informado: O robô falhará se você não preencher pelo menos um campo da seção "Filtros Obrigatórios".

  • Formato de Data Inválido: Certifique-se de que as datas de início e fim seguem estritamente o padrão Ano-Mês-Dia (Ex: 2024-12-31).