Visão Geral
Este artigo descreve como configurar a ação Buscar OS do conector Argo no Ligaí. Essa funcionalidade permite que o robô busque ordens de serviço (OS) reservadas no Argo, com base em filtros como empresa, período, número da OS e status, retornando os dados e informações complementares conforme configurado.
Quando Utilizar esta Ação
A ação Buscar OS deve ser integrada ao fluxo quando houver necessidade de:
- Consultar ordens de serviço já emitidas e reservadas no Argo.
- Filtrar OS por empresa, data de viagem, número, produtos, status de viagem, despesa ou adiantamento.
- Recuperar informações complementares de uma OS (clientes, alocações, aprovadores, campos gerenciais, entre outros) para processar em etapas seguintes do fluxo.
Pré-requisitos
Antes de configurar esta ação, é obrigatório que a agência possua credenciais válidas do Argo e que elas estejam corretamente cadastradas no Ligaí.
Após obter as credenciais junto à Argo, elas devem ser cadastradas no Ligaí conforme instruções disponíveis em:
Credenciais de acesso
Passo a Passo de Configuração
1. Adicionar a etapa Argo no robô
- Acesse o menu Meus Robôs.
- Abra o robô desejado.
- Selecione o conector Argo.
- Escolha a ação Buscar OS.
2. Autenticação
Para que o robô tenha permissão de buscar OS, é necessário preencher as credenciais de acesso à Argo:
- Credencial: Seleção da credencial previamente cadastrada no Ligaí para a agência.
- Usuário (obrigatório): Usuário de acesso à Argo.
- Senha (obrigatório): Senha associada ao usuário informado.
- APP: Client ID (obrigatório): Identificador do aplicativo (Client ID) utilizado na integração com a Argo.
- APP: Client Secret (obrigatório): Código secreto associado ao Client ID informado.
- Reseller/URL (obrigatório): URL do reseller ou ambiente utilizado para o processamento da integração.
3. Filtros
- Corp: Identificação da empresa (corporação) para filtro de busca.
- Filtro de Datas: Seleção do tipo de filtro de data a ser aplicado na busca (ex: período, data específica).
- Data a partir de (EX: DD/MM/YYYY): Data inicial do período de busca (quando aplicável ao filtro de datas selecionado).
- Data até (EX: DD/MM/YYYY): Data final do período de busca (quando aplicável ao filtro de datas selecionado).
- Número da OS: Número específico da ordem de serviço a ser buscada.
Este campo aceita um número de OS ou uma lista separada por ponto-e-vírgula.
- Produtos: Filtro de produtos vinculados à OS (dropdown com opções predefinidas).
- Status da Viagem: Filtro pelo status da viagem associado à OS (dropdown com opções predefinidas).
- Status da Despesa: Filtro pelo status de despesas vinculadas à OS (dropdown com opções predefinidas).
- Status do Adiantamento: Filtro pelo status de adiantamentos vinculados à OS (dropdown com opções predefinidas).
4. Opcionais
Ative os toggles abaixo para incluir dados complementares na resposta da busca:
- Busca dados dos CLIENTES?: Ativa a inclusão de informações de clientes vinculados à OS.
- Busca ADIAMAMENTOS e DESPESAS?: Ativa a inclusão de dados de adiantamentos e despesas.
- Busca ALOCAÇÕES?: Ativa a inclusão de informações sobre alocações de recursos.
- Busca APROVADORES?: Ativa a inclusão de dados dos aprovadores da OS.
- Busca CAMPOS GERENCIAIS?: Ativa a inclusão de campos customizados/gerenciais.
- Busca CARTÕES DE CRÉDITO?: Ativa a inclusão de informações de cartões de crédito utilizados.
- Busca COMENTÁRIOS?: Ativa a inclusão de comentários registrados na OS.
- Busca DADOS DA SOLICITAÇÃO?: Ativa a inclusão de dados da solicitação original.
- Busca EMISSORES?: Ativa a inclusão de informações de emissores de bilhetes.
- Busca FEES?: Ativa a inclusão de taxas e fees da OS.
- Busca JUSTIFICATIVAS?: Ativa a inclusão de justificativas registradas.
- Busca MENOR TARIFA?: Ativa a inclusão de informações sobre a menor tarifa encontrada.
- Busca MOTIVOS VIAGEM?: Ativa a inclusão de motivos de viagem registrados.
- Busca PASSAGEIROS?: Ativa a inclusão de informações detalhadas dos passageiros.
- Busca RESERVAS?: Ativa a inclusão de dados de reservas vinculadas à OS.
- Busca SOLICITANTES?: Ativa a inclusão de informações dos solicitantes da OS.
5. Salvar a Configuração
- Após o preenchimento dos blocos necessários, clique no botão azul Confirmar na parte inferior da tarefa.
- Lembre-se de clicar em Salvar na barra superior do robô para gravar as alterações no fluxo de automação.
Erros Comuns e Como Proceder
- Nenhuma OS Encontrada: Se a combinação de filtros for muito restritiva ou não corresponder a nenhuma OS cadastrada, a busca retornará vazia. Revise os filtros aplicados e relaxe as restrições se necessário.
- Formato de Data Inválido: Certifique-se de utilizar o formato DD/MM/YYYY para as datas. Datas em outros formatos causarão erro de validação.
- Número da OS Inválido: Se o número informado não corresponder a nenhuma OS existente, a busca retornará vazia. Verifique se o número foi digitado corretamente.
- Falha de Autenticação: Verifique se as credenciais informadas no bloco Autenticação estão corretas e ativas, especialmente Usuário, Senha, APP: Client ID e APP: Client Secret.
- Erro 429 – "Current rate exceeds the maximum rate for this API": Esse erro ocorre especificamente no sistema Argo e está relacionado ao limite de requisições (hits) permitido pela API.
Para entender sobre o Limite de Hits Excedido no Sistema Argo, consulte: Erro 429 - Limite Excedido de Hits