Gerar relatório - Dinheiro em conta - Mercado Pago Developers

Como gerar o seu relatório de Dinheiro em conta

Atenção
Gerencie suas vendas com código QR de um jeito fácil. Criamos novas colunas que permitem que você identifique as carteiras digitais ou os bancos que seus clientes utilizam ao pagarem com um código QR do Mercado Pago. Atualize suas preferências de configuração no painel ou via API para incluir as colunas nos seus relatórios.
O relatório somente irá gerar informações após configuração do relatório ter sido feita e este seja executado a primeira vez.

Desse modo, a primeira execução terá um relatório vazio. Não é possível gerar o relatório com informações retroativas à data da configuração e primeira execução.

Canais de geração

Há duas formas de gerar um relatório de Dinheiro em conta:

CanaisDescrição
Painel do Mercado Pago
É muito rápido e simples. Para gerar a partir da sua conta do Mercado Pago, vá até seus Relatórios e selecione uma opção de Relatórios.

No painel é possível efetuar customizações e programar a geração automática do relatório.

Siga o passo a passo para gerar relatórios a partir do painel.

Integração via API
Programa a frequência do seu relatório de acordo com as suas necessidades. Pode ser tanto de forma manual como de forma programada.

Como no painel, também é possível efetuar customizações no relatório.

Leia a documentação para gerar relatórios por API.


Características técnicas do relatório

Considere as seguintes informações técnicas sempre que for gerar, programar e configurar seus relatórios.

Programação do relatório

Programe como e com que frequência você quer gerar seus relatórios.

ElementoCaracterísticas
Programação
- Diária
- Semanal
- Mensal

Geração
- Manual


- Automática

Estrutura do relatório

Saiba as características dos elementos que compõem seu relatório.

Elemento ou açãoCaracterísticas
Detalhes das tabelas
Os detalhes das tabelas compreendem as informações de, no mínimo, 1 dia.

Ordem das colunas
Fixa

Período máximo
Relatórios com dados de até 60 dias.

Moeda
Local (com base no país onde está cadastrada a conta do Mercado Pago)

Fuso horário das colunas:
GMT-3 (Horário de Brasília)

Tome como referência o lugar de onde o relatório é baixado.

Seleção de datas via API
Formato do fuso horário: UTC / GMT-0

Seleção de datas via web
Deve ter como base o fuso horário da conta do usuário.
Por exemplo, a conta do usuário cadastrada no Brasil corresponde ao fuso horário de São Paulo.

Exportação do relatório

Todas as opções disponíveis na hora de baixar seu relatório.

Ações e componentesCaracterísticas
Formato do nome do arquivo
Quando o relatório é programado ou manual:
"<prefixo-configurável>-<yyyy-MM-dd-hhmmss>.<formato>"
Exemplo: minhaloja-2019-05-28-104010.csv

Formatos de download
.csv, .xlsx

Dica: baixe o relatório em .csv para importar os dados e usá-los em outros aplicativos. Baixe-o em .xlsx para ler as informações nas tabelas da planilha.

Arquivo
Os relatórios gerados ficam salvos na sua conta do Mercado Pago.

Configuração disponível via API
- Colunas a gerar por relatório
- Prefixo do arquivo para identificá-lo facilmente
- Envio por SFTP
- Separador de colunas (ponto ou ponto e vírgula)
- Notificação por e-mail

Notificações

Webhook

Webhook (também conhecido como "retorno de chamada web"), é um método simples que permite que um aplicativo ou sistema forneça informações em tempo real toda vez que um evento acontece, ou seja, é uma maneira de receber dados entre dois sistemas de forma passiva, por meio de um HTTP POST. No caso dos relatórios usados na reconciliação, uma notificação é enviada ao usuário que tiver configurado este serviço quando seus arquivos forem gerados.

AtributoDescrição
transaction_idID da transação
request_dateData da solicitação
generation_dateData da geração
filesArquivos disponíveis
typeFormato do arquivo
urlLink de download
nameNome do arquivo
statusStatus do relatório
creation_typeCriação manual ou agendada
report_typeTipo de relatório
is_testDetermina se é um teste
signatureAssinatura digital da notificação

Senha para criptografia

Para garantir o processo de notificação ao sistema, será enviado no corpo da mensagem (payload) um atributo chamado "signature" para validar que a notificação Webhook teve origem no Mercado Pago e que não se trata de uma imitação.

A signature é criada ao unir o transaction_id com a senha criptografada na seção "Notificação por Webhook" e o generation_date do relatório. Assim que os valores forem vinculados, eles são criptografados usando o algoritmo BCrypt da seguinte maneira:

signature = BCrypt(transaction_id + '-' + password_for_encryption + '-' + generation_date)

Para validar que foi o Mercado Pago quem emitiu a notificação, é necessário usar a função de verificação oferecida pelo algoritmo do BCrypt para a linguagem desejada.

Exemplo Java:

BCrypt.checkpw(transaction_id + '-' + password_for_encryption + '-' + generation_date, payload_signature)

Tenha em mãos o Glossário do relatório de Dinheiro em conta para consultá-lo quando precisar ou queira conferir algum termo técnico.
Nota
Tenha em mãos o Glossário do relatório de Dinheiro em conta para consultá-lo quando precisar ou queira conferir algum termo técnico.