> ## Documentation Index
> Fetch the complete documentation index at: https://malga-develop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Oct 06, 2023 - Novas queries na Analytics API! ✅

export const AuthorProfile = ({author}) => <div className="flex flex-row gap-3 items-center">
    {author.image && <img src={author.image} className="w-10 h-10 rounded-full m-0" />}
    <div>
      <a href={author.url}>{author.name}</a>
      <br />
      <span>{author.title}</span>
    </div>
  </div>;

export const paulo = {
  name: "Paulo Chaves",
  title: "Data Engineer",
  url: "https://github.com/paulosdchaves",
  image: "https://github.com/paulosdchaves.png"
};

<AuthorProfile author={paulo} />

Estamos felizes em anunciar os novos cálculos disponíveis para consulta na **Analytics API**
, que trazem métricas para análise da performance dos pagamentos da sua loja,
como a taxa de aprovação, o total financeiro e o volume de cobranças por status,
método, provedor e motivos de perda.

Criamos três grupos de queries para facilitar a consulta através do [Playground](https://graphql.malga.io) GraphQL e da API: [Charges](https://docs.malga.io/docs/analytics-api/queries/charges), [Authorization Rate](https://docs.malga.io/docs/analytics-api/queries/authorization-rate) e [Dashboard](https://docs.malga.io/docs/analytics-api/queries/dashboard). Confira:

<img src="https://mintcdn.com/malga-develop/kN-6S-4zQ_uG4PGR/assets/images/release/2023-10-06/1.png?fit=max&auto=format&n=kN-6S-4zQ_uG4PGR&q=85&s=4a452d7110a271194a4f9ecba47d4398" alt="GraphiQL" width="1839" height="930" data-path="assets/images/release/2023-10-06/1.png" />

➡️ [Charges](https://docs.malga.io/docs/analytics-api/queries/charges) - <b>informações sobre as cobranças</b>

No grupo <b>Charges</b>, disponibilizamos diversas queries com informações sobre as cobranças:

* <b>allCharges</b> - Retorna todas as cobranças

* <b>charge</b> - Retorna informações de uma cobrança pelo seu identificador único

* <b>chargesByDeclinedCode</b> - Retorna as cobranças com status failed pelo declined
  code

* <b>totalCharges</b> - Retorna o número de cobranças e o total financeiro de um
  período, provedor ou método de pagamento

➡️ [Authorization Rate](https://docs.malga.io/docs/analytics-api/queries/authorization-rate) - <b>informações sobre a taxa de aprovação</b>

No grupo <b>Authorization Rate</b> disponibilizamos as informações de taxa de autorização, que corresponde ao percentual de cobranças aprovadas em relação ao total de cobranças processadas (somando pré-autorizadas, autorizadas e com falha). Confira as queries disponibilizadas:

* <b>totalAuthorizationRate</b> - Retorna o percentual total de cobranças aprovadas

* <b>byInterval</b> - Retorna o percentual de cobranças aprovadas (preauthorized
  / authorized) no intervalo selecionado

* <b>byProviderType</b> - Retorna o percentual de cobranças aprovadas por provedor

* <b>byPaymentMethod</b> - Retorna o percentual de cobranças aprovadas por método
  de pagamento

➡️ [Dashboard](https://docs.malga.io/docs/analytics-api/queries/dashboard) - <b>informações adicionais</b>

O grupo de consultas Dashboard disponibiliza informações para o [Painel de Dados](https://dashboard.malga.io) da Malga, que também estão disponíveis para consulta pela Analytics API:

* <b>providersResume</b> - Retorna a taxa de autorização, o total financeiro e volume
  de cobranças por provedor de pagamento

* <b>chargeCurrencies</b> - Retorna as moedas em que a empresa processa pagamentos

Além dos novos grupos e consultas, disponibilizamos a listagem de valores para os argumentos: <code>paymentMethod</code>, <code>providerType</code> e <code>status</code>;

<Info>
  Realizando uma request na Analytics API
  Para acessar os dados, insira as suas <b>credenciais de produção Malga</b> (<code>Api-Key</code> e <code>client-Id</code>) no Headers do Playground, conforme a [documentação](https://docs.malga.io/docs/analytics-api/authentication);

  Com a criação dos **grupos de queries**, agora é necessário enviar o nome do grupo (ex. Charges) na requisição, junto com o nome da query.

  **Link de acesso ao** [Playground Analytics API](https://graphql.malga.io)
</Info>

Se tiver alguma dúvida em seu acesso ou na utilização da API, avise o nosso time de atendimento.

**Até mais! 🚀**