Itegração Locker

---
title: Itegração Locker
slug: itegracao-locker
sistema:
  - Teorema Auditor [18]
categoria: user_manual
tipo: how-to
autor: Andreia Burko Bley
setor: Qualidade
modulo: Auditor
versao_doc: 01
revisao: Willian Neri Almeida
aprovado_em: 04/2024
versao_pipeline: 2.5.2
publico: "analistas e gestores que utilizam o Teorema Auditor"
keywords:
  - Auditor
  - Looker Studio
  - Google Sheets
  - consulta
  - tarefa
  - integração
  - relatório
  - dashboard
chamado: ""
ultima_revisao: "2026-06-12"
---

## Visão Geral

A integração entre o Teorema Auditor e o Looker Studio permite extrair dados do banco de dados via consultas configuradas no Auditor, enviá-los automaticamente para o Google Sheets e, a partir daí, gerar relatórios e dashboards no Looker Studio. O fluxo cobre a criação de consultas, configuração de tarefas com detalhes de destino no Google Sheets e a montagem de relatórios visuais.

Links de referência:

- Google Sheets: <https://docs.google.com/spreadsheets/u/0/>
- Looker Studio: <https://lookerstudio.google.com/>
- E-mail do Auditor para compartilhamento: `auditor@worksheets-auditor.iam.gserviceaccount.com`

## Acessar o Módulo Auditor

Acesse o módulo Auditor e insira suas credenciais de login.

![Tela de login do Teorema Auditor com campos de usuário e senha e botão Login](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-01.png)

## Criar uma Consulta

Após o login, no menu lateral acesse **Consultas**.

![Dashboard do Teorema Auditor 2.0 com menu lateral destacando o item Consultas](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-02.png)

Clique no botão **Nova Consulta** no canto superior direito da tela de listagem de consultas.

![Listagem de consultas no Auditor com botão Nova Consulta destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-03.png)

Selecione o tipo **Banco de Dados** no campo Tipo Consulta. O formulário exibe os campos Nome, Apelido, Tipo Consulta, Conexão e o editor de Código SQL.

![Formulário de nova consulta com campos Nome, Tipo Consulta definido como Banco de Dados, Conexão e editor de código SQL](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-04.png)

Preencha o campo **Nome**, selecione o **Tipo Consulta** (Banco de Dados), escolha a **Conexão** e clique em **Salvar**.

![Formulário de nova consulta preenchido com nome "teste", tipo Banco de Dados, conexão selecionada e botão Salvar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-05.png)

Após salvar, clique em **Executar** para testar a consulta.

![Tela de consulta salva com painel Testar consulta e botão Executar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-06.png)

O resultado da consulta será exibido no painel direito com o código SQL final e os dados retornados.

![Resultado da execução da consulta exibindo código SQL final e dados em formato JSON no painel Resultado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-07.png)

## Criar uma Tarefa

No menu lateral, acesse **Tarefas**.

![Dashboard do Teorema Auditor 2.0 com menu lateral destacando o item Tarefas](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-08.png)

A tela de listagem de tarefas exibe as tarefas existentes com colunas Id, Descrição, Grupo, Agendamento e Ações.

![Listagem de tarefas com colunas Id, Descrição, Grupo, Agendamento e Ações](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-09.png)

Na tela de nova tarefa, clique em **Adicionar Consulta**.

![Formulário de nova tarefa com aba Dados da tarefa aberta e botão Adicionar Consulta destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-10.png)

No modal **Adicionar consulta**, selecione a consulta criada anteriormente na lista.

![Modal Adicionar consulta com lista de consultas disponíveis e a consulta "teste" selecionada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-11.png)

Confirme a seleção clicando em **Salvar**.

![Modal Adicionar consulta com a consulta "teste" selecionada e botão Salvar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-12.png)

## Configurar o Detalhe da Tarefa (Google Sheets)

Acesse a aba **Detalhes** da tarefa e clique em **Criar Detalhes**.

![Aba Detalhes da tarefa com tabela vazia e botão Criar Detalhes destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-13.png)

No modal **Adicionar detalhe**, preencha os campos: selecione a consulta, defina o Tipo como **Google Sheets** e clique em **Salvar**.

![Modal Adicionar detalhe com campos Consulta, Tipo Google Sheets e seção Configurar Google Sheets com campos Id da tabela, Nome da tabela e Método de atualização](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-14.png)

## Criar a Planilha no Google Sheets

Acesse o Google Sheets e clique em **Planilha em branco** para criar uma nova planilha.

![Google Sheets com opções de modelos; o item Planilha em branco está destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-15.png)

> **Nota:** O nome da planilha é apenas para referência interna. O que o Auditor utiliza é o **nome da aba**. Nomeie a aba corretamente, pois é ela que será enviada ao Auditor.

![Planilha Google Sheets com anotações indicando que o nome da planilha é só para conhecimento e que o nome da aba é o que será enviado ao Auditor](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-16.png)

Insira na planilha as colunas de acordo com os campos definidos na consulta (exemplo: `codigo` e `descricao`).

![Planilha Google Sheets com colunas "codigo" e "descricao" na primeira linha e aba nomeada "teste"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-17.png)

## Compartilhar a Planilha com o Auditor

Clique em **Compartilhar** no canto superior direito da planilha.

![Planilha Google Sheets com botão Compartilhar visível no canto superior direito](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-18.png)

No modal de compartilhamento, adicione o e-mail do Auditor (`auditor@worksheets-auditor.iam.gserviceaccount.com`).

![Modal Compartilhar "teste" com campo de e-mail para adicionar pessoas](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-19.png)

Defina a função como **Editor**.

![Modal Compartilhar "teste" com o e-mail do Auditor adicionado e papel definido como Editor](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-20.png)

Desmarque a opção **Notificar pessoas** (opcional) e clique em **Compartilhar**.

![Modal Compartilhar "teste" com opção Notificar pessoas desmarcada e botão Compartilhar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-21.png)

## Obter o ID da Planilha

O link e as instruções de configuração estão disponíveis em **Auditor > Tarefa > Nova Tarefa > Detalhes > aba Help**. A aba Help exibe o formato esperado para a planilha e instrui a compartilhá-la com o e-mail do Auditor como Editor.

![Modal Adicionar detalhe com aba Help aberta mostrando instruções de configuração do Google Sheets, formato das colunas e orientação para compartilhar com o e-mail do Auditor](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-22.png)

O ID da planilha é a sequência alfanumérica presente na URL do Google Sheets, entre `/spreadsheets/d/` e `/edit`. Copie esse ID para usar no campo correspondente no Auditor.

![Planilha Google Sheets com a URL visível na barra de endereço do navegador indicando onde localizar o ID da planilha](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-23.png)

## Preencher o Detalhe com o ID e Nome da Tabela

No modal **Adicionar detalhe**, preencha:

1. **Id da tabela**: cole o ID da planilha obtido na URL.
2. **Nome da tabela**: informe o nome exato da aba da planilha (exemplo: `teste`).
3. **Método de atualização**: selecione **Recriar Tabela** (substitui os dados a cada envio) ou **Atualizar Tabela** (adiciona linhas abaixo dos dados existentes). Clique em **Salvar**.

![Modal Adicionar detalhe com campos Id da tabela preenchido, Nome da tabela "teste" e Método de atualização com opção Recriar Tabela selecionada; botão Salvar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-24.png)

Na tela de detalhes da tarefa, o detalhe aparece na lista com Tipo Google Sheets e consulta vinculada. Clique em **Salvar**.

![Aba Detalhes da tarefa com detalhe listado mostrando Tipo Google Sheets e consulta "teste"; botão Salvar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-25.png)

## Executar a Tarefa

Com todas as configurações salvas, clique em **Executar** na barra de ações da tarefa.

![Tela de dados da tarefa com consulta "teste" vinculada e botão Executar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-26.png)

Após a execução, os dados são gravados na planilha Google Sheets conforme a estrutura definida na consulta.

![Planilha Google Sheets com dados preenchidos a partir da execução da tarefa do Auditor](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-27.png)

## Criar um Relatório no Looker Studio

Acesse o Looker Studio e clique em **Relatório em Branco**.

![Looker Studio com painel de Recentes e modelos; item Relatório em Branco destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-28.png)

O sistema solicitará a integração de uma fonte de dados. Selecione **Planilhas Google**.

![Painel Adicionar dados ao relatório no Looker Studio com lista de Google Connectors e Planilhas Google destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-29.png)

O sistema carregará automaticamente as planilhas vinculadas à conta Gmail do usuário conectado. Selecione a planilha desejada na lista.

![Painel Adicionar dados ao relatório com lista de planilhas disponíveis em "De minha propriedade" e a planilha "teste" selecionada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-30.png)

Selecione a planilha e a página (aba) correspondente, confirme as opções e clique em **Adicionar**.

![Painel de configuração da fonte de dados Planilhas Google com campos Planilha e Página selecionados e botão Adicionar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-31.png)

O Looker Studio gera automaticamente uma tabela com os dados da planilha vinculada ao Google Sheets.

![Relatório gerado no Looker Studio com tabela exibindo colunas codigo, descrição e Record Count com dados preenchidos](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-32.png)

## Exemplos de Projetos no Looker Studio

### Controle Financeiro

O Looker Studio permite criar dashboards de controle financeiro integrados com os dados do Auditor, incluindo:

- **Dashboard de Faturamento**: visualização de receitas por período, mapa de distribuição por estado, comparativo matriz/filial e gráficos de barras por mês.
- **Análise de Fluxo de Caixa**: acompanhamento de contas a pagar e receber com concentração de vencimentos e comparativo efetivo/não efetivo.
- **Demonstrativo de Resultados (D.R.E.)**: resultado do exercício com filtros por centro, custo e período financeiro.
- **Monitoramento de Orçamento**: comparativo de gastos reais com orçamento planejado.

![Dashboard de Faturamento no Looker Studio com mapa do Brasil, totais de produção e receita, filtros de período e gráfico de linha mensal](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-33.png)

![Dashboard de Faturamento Mensal com totais de notas, filtros de nota fiscal, cliente e mês, gráfico de barras por mês e tabela de clientes](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-35.png)

![Dashboard de Contas a Pagar com totais Efetivo, Não Efetivo e Total, gráfico de concentração por dia de vencimento e tabela de fornecedores](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-36.png)

![Dashboard de Contas a Receber com totais Recebido, A Receber Total, A Vencer e Vencidos, gráfico de barras por data e tabela de clientes](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-37.png)

![Dashboard D.R.E. com filtros de filial e período, gráfico de pizza e tabela de resultado do exercício](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-38.png)

![Dashboard financeiro com indicadores de receber em aberto, gráfico de barras horizontais por cliente, tabela de documentos com vencimento e valor](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-39.png)

![Dashboard financeiro com totais de receber em aberto e gráfico de barras por cliente com filtros de período e empresa](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-40.png)

![Dashboard financeiro com indicadores de receber em aberto, tabela de documentos e gráfico de barras por cliente com filtro de período](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-41.png)

![Dashboard financeiro com indicadores de receber em aberto detalhados, gráfico de barras horizontais e tabela de documentos com vencimento](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-42.png)

### Controle de Ordens de Serviço (OS)

Dashboards para acompanhamento de Ordens de Serviço (OS) permitem visualizar:

- **Desempenho de OS**: tempo médio de conclusão, taxa de conclusão dentro do prazo e tipos de serviço mais comuns.
- **Apontamento de Colaboradores**: horas trabalhadas por colaborador, horas por tipo de trabalho e status das OS.
- **Análise de Produtividade**: eficiência e tempo médio de execução por funcionário.
- **Monitoramento em Tempo Real**: status das OS em andamento com atualizações automáticas.

![Dashboard de Ordem de Serviço com totais de OS abertas, finalizadas e fechadas, gráfico de barras por mês e tabela de documentos por cliente](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-43.png)

![Dashboard de apontamento de colaboradores em OS com totais de tempo alocado, valor serviço e mecânico, tabela de OS por funcionário e gráfico de rentabilidade por colaborador](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-44.png)

### Controle de Chamados

Dashboards de chamados permitem acompanhar métricas de suporte, incluindo:

- **Desempenho da Equipe**: tempo médio de resposta, resolução e distribuição de chamados por tipo e atendente.
- **Monitoramento em Tempo Real**: status dos chamados abertos e fechados com comparativo de semanas.

![Dashboard de chamados com totais de abertos e fechados por semana, gráfico de pizza por sistema e tipo, e gráfico de barras por atendente](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-45.png)

![Dashboard detalhado de chamados com indicadores Abertos hoje, Ontem e Total, gráficos de pizza por sistema e tipo, e gráfico de barras por cliente](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-46.png)

### Controle de Clientes

Dashboards de clientes permitem visualizar métricas de vendas e comportamento, incluindo:

- **Perfil de Clientes**: distribuição por vendedor, análise de frequência e volume de compras.
- **CRM**: acompanhamento de interações e atividades de relacionamento.

![Dashboard de clientes com totais de Venda, Cliente e Média, gráficos de pizza por cliente e por vendas, e gráfico de barras com comparativo cliente/venda](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-47.png)

### Controle de Pedidos

Dashboards de pedidos permitem acompanhar volume, status e desempenho, incluindo:

- **Visão Geral de Pedidos**: total de pedidos, valor comercial e expedição, com status por tipo (validado, programado, bonificação etc.).
- **Análise Semanal**: comparativo de pedidos e volumes com a semana anterior.

![Dashboard de pedidos com totais de expedição, comercial e produção, tabela de status por tipo, gráfico de pedidos programados e indicador de faturamento do dia](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-48.png)

![Dashboard de pedidos semanais com totais de pedidos e volumes, comparativo com semana anterior, tabela por data com pedidos e volumes e gráfico de barras por dia da semana](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-49.png)

### Integração com Power BI

O Looker Studio pode ser configurado para complementar análises do Power BI. Os passos incluem:

- **Conexão de Dados**: estabelecer conexão com as fontes de dados utilizadas pelo Power BI via integração direta ou exportação em formatos compatíveis.
- **Sincronização de Metadados**: garantir consistência entre os metadados das duas plataformas.
- **Dashboards Complementares**: desenvolver visualizações adicionais no Looker Studio que agreguem perspectivas às análises existentes no Power BI.

![Dashboard de faturamento geral no Looker Studio com indicadores de total de itens, imposto, margem bruta e grupo de produto, com filtros de gerente, setor e representante](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-50.png)

![Dashboard detalhado de pedidos com totais de pedidos, quantidade, preço médio e pedidos faturados, tabela por representante e filtros por variante](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/itegracao-locker/itegracao-locker-51.png)

## Informações do documento

> Autor: Andreia Burko Bley
> Setor: Qualidade
> Módulo: Auditor
> Chamado:
> Versão do Sistema: 23.07a
> Versão do documento: 01
> Revisão: Willian Neri Almeida
> Aprovado em: 04/2024

---

> 📎 **Arquivos originais:** [Manual Integração Auditor com Looker Studio.docx](https://drive.google.com/uc?export=download&id=15tVjhs4OchUnw02oggZVR6bXi2AQtQ0p) · [Apresentação WMS.pdf](https://drive.google.com/uc?export=download&id=1fOEsK9ewRKRTjg6kz3IXQmCOSrcHZxSt) · [Manual Integração Auditor com Looker Studio.pdf](https://drive.google.com/uc?export=download&id=1T4MEzRT0EfdBnFiL8-z-XrsDx8F7Nggu)