Relatórios de conciliação

O Mercado Pago fornece relatórios para conciliar suas transações com os seus sistemas internos. Temos dois relatórios para necessidades distintas.

Relatório de dinheiro em conta (Settlement Report)

Contém todos os eventos de pagamento (aprovados, devolvidos, em mediação e estornos) que afetam o saldo de sua conta no Mercado Pago no período solicitado.

Relatório de dinheiro disponível (Bank Report)

Contém os detalhes dos pagamentos que foram liberados e estão disponíveis para serem sacados para sua conta bancária. O relatório pode ser solicitado para um período específico ou sempre que uma retirada é efetuada.

Este relatório é geralmente utilizado para conciliar uma retirada para a conta bancária. Assim, para cada retirada, um Bank Report é gerado especificando as respectivas transações.

Como são utilizados?

Ambos os relatórios podem ser gerados manualmente (indicando um intervalo específico de datas) ou de forma programada.

Consulte o glossário dos relatórios.

Uso manual

Relatório de dinheiro disponível (Bank Report)

1. Para gerar um relatório:

Faça o POST para a API especificando as datas de início e término da seguinte forma:

Curl

curl -X POST \
    -H 'accept: application/json' \
    -H 'content-type: application/json' \
    'https://api.mercadopago.com/v1/account/bank_report?access_token=ACCESS_TOKEN' \
    -d '{
            "begin_date": "2015-05-01T00:00:00Z",
            "end_date": "2015-06-01T00:00:00Z"
    }'

Php

<?php

$request =

$mp = new MP("ACCESS_TOKEN");

$request = array(
        "uri" => "/v1/account/bank_report",
        "data" => array(
            "begin_date" => "2015-05-01T00:00:00Z",
            "end_date" => "2015-06-01T00:00:00Z"
        )
    );

$mp->post($request);

?>

Você receberá um HTTP STATUS 202 (Accepted) como resposta, e o relatório será gerado de forma assíncrona.

2. Busca:

Para verificar se o relatório foi gerado, você terá que fazer uma consulta à API da seguinte forma:

Curl

curl -G \
    -H 'accept: application/json' \
    -d 'access_token=ACCESS_TOKEN' \
    'https://api.mercadopago.com/v1/account/bank_report/list'

Php

<?php

// SDK Version >= 0.5.0

$mp = new MP("ACCESS_TOKEN");

$request = array(
        "uri" => "/v1/account/bank_report/list"
    );

$mp->get($request);

?>

Você receberá como resposta:

Json

[
    {
        "id": 1234,
        "user_id": 130379930,
        "begin_date": "2015-05-01T00:00:00Z",
        "end_date": "2015-06-01T00:00:00Z",
        "file_name": "BK-TEST-1234567890123.csv",
        "created_from": "manual",
        "date_created": "2016-01-20T10:07:53.000-04:00"
    },
    {
        ...
    }
]
3. Download

Utilizando o atributo file_name, você poderá fazer o download do relatório na URL a seguir:

Plain

https://api.mercadopago.com/v1/account/bank_report/:file_name?access_token=ACCESS_TOKEN

Relatório de dinheiro em conta (Settlement Report)

1.Para gerar um relatório:

Faça o POST para a API especificando as datas de início e término da seguinte forma:

Php

<?php

// SDK Version >= 0.5.0

$mp = new MP("ACCESS_TOKEN");

$request = array(
        "uri" => "/v1/account/settlement_report",
        "data" => array(
            "begin_date" => "2015-05-01T00:00:00Z",
            "end_date" => "2015-06-01T00:00:00Z"
        )
    );

$mp->post($request);

?>

Você receberá um HTTP STATUS 202 (Accepted) como resposta e o relatório será gerado de forma assíncrona.

2. Busca:

Para verificar se o relatório foi gerado, você terá que fazer uma consulta à API da seguinte forma:

Php

<?php

// SDK Version >= 0.5.0

$mp = new MP("ACCESS_TOKEN");

$request = array(
        "uri" => "/v1/account/settlement_report/list"
    );

$mp->get($request);

?>

Você receberá como resposta:

Json

[
    {
        "id": 1234,
        "user_id": 130379930,
        "begin_date": "2015-05-01T00:00:00Z",
        "end_date": "2015-06-01T00:00:00Z",
        "file_name": "SR-TEST-1234567890123.csv",
        "created_from": "manual",
        "date_created": "2016-01-20T10:07:53.000-04:00"
    },
    {
        ...
    }
]
3. Download

Utilizando o atributo file_name, você poderá fazer o download do relatório na URL a seguir:

Plain

https://api.mercadopago.com/v1/account/settlement_report/:file_name?access_token=ACCESS_TOKEN

Uso programado

Os relatórios de conciliação também podem ser gerados automaticamente.

Relatório de dinheiro disponível (Bank Report)

1. Para gerar um relatório:

Programe para gerar um relatório automaticamente utilizando a frequência no recurso de configuração. Atualize o atributo scheduled na configuração para true:

Plain

POST /v1/account/bank_report/schedule

Interrompe a geração automática do relatório. Atualize o atributo scheduled na configuração para false:

Plain

DELETE /v1/account/bank_report/schedule

2. Download

Faça o download do arquivo especificado:

Plain

GET /v1/account/bank_report/:file_name

Relatório de dinheiro em conta (Settlement Report)

1. Para gerar um relatório:

Programe para gerar um relatório automaticamente utilizando a frequência no recurso de configuração. Atualize o atributo scheduled na configuração para true:

Plain

POST /v1/account/settlement_report/schedule

Interrompa a geração automática do relatório. Atualize o atributo scheduled na configuração para false:

Plain

DELETE /v1/account/settlement_report/schedule

2. Download

Faça o download do arquivo especificado:

Plain

GET /v1/account/settlement_report/:file_name

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.