Através da Exportação de Cobranças no Dashboard Malga, é possível extrair o arquivo em formato .csv com os detalhes das transações e pagamentos da loja. Além do recurso no Dashboard, é possível realizar a extração através da API Reports. Acessando o menu de Cobranças, através do ícone de exportação na lateral direita da tela, é possível configurar o relatório a ser exportado selecionando:
  • Período de criação da cobrança, equivalente à venda na loja, inserindo a data inicial e final (obrigatório);
  • Tipo de relatório, entre as opções de relatório simples ou completo; 🔗(obrigatório);
  • Filtros de status da cobrança, método de pagamento e subconta (opcionais);
Após as configurações e a solicitação de exportação, o pedido é recebido pela Malga e, após o processamento, o arquivo é enviado para o e-mail cadastrado no Dashboard, garantindo a segurança das informações. Exportar cobranças > Menu Cobranças
Além da filtragem em Exportar Cobranças, também é possível realizar a exportação do relatório .csv com os filtros aplicados através da listagem de Cobranças (por método, status e subconta) ou removê-los na configuração da exportação, refletindo as transações selecionadas;
Características do Relatório Exportado
Formato de Relatório.csv utf-8
Idiomapt-br e eng-us
OrdenaçãoPela data de criação da cobrança mais recente
Período das InformaçõesD-1 (cobranças processadas até o dia anterior)
TamanhoAté 40 mil linhas
Dados do RelatórioExtrair cobranças de todo o período em que o cliente processou pagamentos na Malga, em range máximo de 6 meses na seleção do filtro de período
Exportação de TestesExportação no ambiente de testes do Dashboard, através do menu de Cobranças em sandbox
Disponibilidade do Arquivo para DownloadO arquivo exportado fica disponível por 30 dias em nosso servidor, tendo seu acesso expirado após esse período
FILTRO DE PERÍODO DE COBRANÇAS A exportação de cobranças permite a geração de relatórios do tipo simples e completo com o range máximo de período de até 31 dias de cobranças realizadas. Cada arquivo .csv gerado possui até 40 mil linhas, com o envio dos links para download no e-mail, visando facilitar a análise gerencial das informações;
RelatórioDados PrincipaisAPI ReportsCaracterística
SimplesCobrança, pagamento, recusa, clientereport type [transactions]Contempla dados para análise do último status da cobrança e podem ser consultados aqui
CompletoCobrança, pagamento, recusa, cliente e histórico completo das transaçõesreport type [transaction_history]Contempla todos os dados para análise do histórico de operações e podem ser consultados aqui
EXEMPLOS DE RELATÓRIOAtravés dos links abaixo, é possível baixar exemplos dos relatórios e conferir o formato e dados disponíveis em cada tipo:Relatório simples - link para download 🔗Relatório completo - link para download 🔗

Passo a passo para exportar dados pelo Dashboard

1

Faça login no Dashboard Malga e acesse a área de Cobranças;
2

Clicando no botão de Exportar cobranças, na lateral direita da listagem, é aberto o menu para configuração do relatório com o filtro de período e a seleção do tipo de relatório;
3

Selecione o período pela data de criação da cobrança e o tipo de relatório que deseja exportar, entre o relatório simples (confira os dados deste relatório aqui 🔗) e o relatório completo (confira os dados disponíveis aqui 🔗);
4

Caso necessário, utilize os filtros adicionais opcionais de status da cobrança, método de pagamento e subconta, para configuração do arquivo;
5

Clique em Solicitar exportação para confirmar o seu pedido de relatório na Malga;
6

Após o processamento, os arquivos serão enviados para o e-mail cadastrado no Dashboard;
7

Acesse sua caixa de e-mail e realize o download dos arquivos .csv através dos links contidos no e-mail da Malga, com o título [Cobranças - período das cobranças exportadas | Malga];
8

Faça o download dos arquivos e abra na ferramenta utilizada para análise e edição da planilha .csv;
9

Caso você realize a exportação com filtros que não retornem cobranças no período indicado (arquivo vazio), enviaremos um e-mail com a orientação para realizar uma nova exportação;
Email com o link para download do relatório
ENVIO DOS ARQUIVOS POR E-MAILO tempo de espera para recebimento dos arquivos no seu e-mail pode variar, conforme o período selecionado para exportação das cobranças e o tipo de relatório. Informaremos pelo e-mail sobre o processamento da sua solicitação;Caso ainda não possua acesso ao Dashboard, realize o cadastro através link, e se precisar de ajuda na configuração da sua conta, acione o nosso time através do suporte@malga.io ;

Exportando dados pela API

Além do recurso no Dashboard, é possível exportar os relatórios em .csv através da API de reports. Consulte a documentação e detalhes das requisições em nossa documentação. Abaixo exibimos um exemplo de requisição feita para a API Reports Malga , de acordo com o [type] e especificações do arquivo a ser exportado:
curl --location --request POST 'https://api.malga.io/v1/reports' \
--header 'X-Client-Id: <your_x_client_id>' \
--header 'X-Api-key: <your_x_api_key>' \
--header 'accept-language: pt-BR' \
--header 'X-User-Timezone: America/Sao_Paulo' \
--header 'Content-Type: application/json' \
--data-raw '{
  "fields": "all",
  "sendTo": "test@test.com",
  "type": "transactionsHistory",
  "filters": {
    "transactionStatus": ["charged_back"],
    "transactionSourcePaymentMethod": ["pix"],
    "transactionCreatedAt": {
      "gte": "2024-03-01T03:00:00.000Z",
      "lte": "2024-03-31T02:59:59.999Z"
    }
  }
}'
Ciclo de vida de uma exportação da API Reports: