> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/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} alt={author.name} 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](/analytics/queries/charges), [Authorization Rate](/analytics/queries/authorization-rate) e [Dashboard](/analytics/queries/dashboard). Confira:

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

➡️ [Charges](/analytics/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](/analytics/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](/analytics/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](/analytics/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! 🚀**