Overview
Configuração

Freshbooks

Automatize o provisionamento de usuários do FreshBooks e assegure dados atualizados dos colaboradores.

Folha de pagamentoProvisionamento de identidade

O FreshBooks é um software de contabilidade popular baseado em nuvem, desenvolvido para pequenas empresas e freelancers, que oferece recursos de faturamento, controle de despesas, controle de tempo e relatórios. Ao integrar o FreshBooks ao ADManager Plus, as organizações podem simplificar e automatizar os processos de gerenciamento de usuários relacionados às suas contas FreshBooks. Essa integração garante que os dados dos usuários sejam mantidos consistentes e atualizados, reduzindo o esforço manual e minimizando erros.

Criação automática de usuário:

Crie contas do FreshBooks automaticamente para novos colaboradores durante o processo de integração. Isso garante que os novos contratados possam acessar o FreshBooks imediatamente para gerenciar suas tarefas, como relatórios de despesas e acompanhamento de tempo.

Atualização de dados do usuário:

Mantenha as informações do usuário do FreshBooks sincronizadas com os detalhes armazenados no Active Directory. Quando os dados de um colaborador (ex.: departamento, função ou informações de contato) são atualizados no AD, a integração garante que essas mudanças sejam refletidas na conta do FreshBooks.

Documento de configuração: Integração do Freshbooks com o ADManager Plus

Pré-requisitos:

O Freshbooks usa o OAuth 2.0 para autorizar solicitações de API.

Requer client_id e client_secret para autorização.

Privilégios:

Importar usuários (ação de entrada): A conta utilizada na autorização deve ter permissão para ler todas as contas de usuário.

Para executar qualquer ação ou consulta no Freshbooks (ação de saída): A conta usada deve ter permissão para realizar a ação desejada.

Nota: O ADManager Plus é disponibilizado com um conjunto pré-configurado de APIs que auxiliam na execução de ações básicas com a integração. Se a ação que você precisa não estiver disponível, consulte a referência de API do Freshbooks para obter os detalhes de API necessários para a configuração de webhooks de entrada e saída para executar as ações requeridas.

Configuração de autorização

LogFaça login no ADManager Plus e acesse Directory/Application Settings.
Selecione Application Integrations.
Em Enterprise Applications, pesquise em clique em Freshbooks.
Ative o botão Enable Freshbooks Integration.
Na página Freshbooks Configuration, clique em Authorization.
Execute as etapas para gerar um client_id e um client_secret do Freshbooks, e cole-os nos respectivos campos de valor.
Clique em Configure.

Configuração de webhook de entrada

Os webhooks de entrada permitem que você obtenha dados do usuário diretamente do Freshbooks e os envie para o ADManager Plus. O mapeamento de atributos definido aqui poderá ser selecionado como fonte de dados ao configurar automatizações. Para configurar um webhook de entrada para o Freshbooks:

Em Inbound Webhook, clique em Freshbooks Endpoint Configuration.
Na guia Endpoint Configuration, você encontrará um endpoint pré-configurado, o ENDPOINT DE USUÁRIOS do Freshbooks, com campos para a URL do endpoint, Método de API, Cabeçalhos e Parâmetros para obter contas de usuário do Freshbooks. Se você desejar usar esse endpoint pré-configurado, {business_id} pelo business ID de sua conta FreshBooks no campo Endpoint URL. No entanto, se você desejar usar um novo endpoint para importar usuários, você poderá configurar um usando o botão + Add API endpoint e preenchendo os campos obrigatórios de acordo com as referências de API do Freshbooks. Clique aqui para saber como.

Nota:

O par chave-valor da API já vem pré-configurado como cabeçalho para autenticar as solicitações de API, conforme definido durante a configuração de autorização.
Macros: É possível adicionar macros na configuração do endpoint para alterá-lo dinamicamente por meio do componente de seleção de macros.
Consulte as referências de API do Freshbooks e configure cabeçalhos e parâmetros adicionais, se necessário. Na guia Settings, a opção Repeat calling this endpoint será configurada para buscar 30 registros por chamada. Isso será repetido até que nenhum token de próxima página seja recebido.

Após concluir, clique em Test & Save. A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Após verificar se os parâmetros desejados foram retornados, clique em Proceed.