Como gerar o seu relatório de Dinheiro em conta
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:
| Canais | Descrição |
| Painel do Mercado Pago | Para gerar o relatório pela sua conta Mercado Pago, vá até a seção Relatórios e faturamento e selecione Relatórios de pagamentos e extratos de conta. 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.
| Elemento | Caracterí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ção | Caracterí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 componentes | Caracterí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.
| Atributo | Descrição |
| transaction_id | ID da transação |
| request_date | Data da solicitação |
| generation_date | Data da geração |
| files | Arquivos disponíveis |
| type | Formato do arquivo |
| url | Link de download |
| name | Nome do arquivo |
| status | Status do relatório |
| creation_type | Criação manual ou agendada |
| report_type | Tipo de relatório |
| is_test | Determina se é um teste |
| signature | Assinatura 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)