Criar relatório

Este endpoint permite a criação manual de um novo relatório dentro de um intervalo de datas específico. Em caso de sucesso, a requisição retornará uma resposta com o status 202.

POST

https://api.mercadopago.com/v1/account/settlement_report
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Body
begin_date
string

OBRIGATÓRIO

Este campo indica a data e hora de início do intervalo para o relatório, no fuso horário UTC (indicado pela 'Z' no final, que significa 'Zulu time' ou tempo coordenado universal).
end_date
string

OBRIGATÓRIO

Este campo indica a data e hora de término do intervalo para o relatório, no fuso horário UTC (indicado pelo 'Z' no final, que significa 'Zulu time' ou Tempo Coordinado Universal).
Response parameters
id
number
Este campo indica o identificador único da tarefa de criação do relatório.
account_id
number
Identificador único da conta associada ao relatório.
begin_date
string
É a data e hora de início do intervalo do relatório, no fuso horário UTC (indicado pelo 'Z' no final, que significa 'Zulu time' ou tempo coordenado universal).
created_from
string
Este campo indica como o relatório foi gerado, sendo 'manual' para relatórios gerados manualmente e 'schedule' para relatórios programados.
Erros

400Requisição inválida.

invalid_begin_date

Você deve especificar o parâmetro 'begin_date'.

invalid_end_date

Você deve especificar o parâmetro 'end_date'.

end_date_before_begin_date

A data de início deve ser anterior à data de término.

401Não autorizado.

Invalid token

Token inválido.

Request
curl -X POST \
    'https://api.mercadopago.com/v1/account/settlement_report'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
    -d '{
  "begin_date": "2019-05-01T00:00:00Z",
  "end_date": "2019-06-01T00:00:00Z"
}'
Response
{
  "id": 99336983670,
  "account_id": 167345291,
  "begin_date": "2022-08-01T03:00:00Z",
  "created_from": "manual",
  "currency_id": "ARS",
  "end_date": "2022-08-08T02:59:59Z",
  "generation_date": "2024-02-16T15:55:22.258-04:00",
  "is_reserve": false,
  "is_test": false,
  "last_modified": "2024-02-16T15:55:22.261-04:00",
  "report_id": 17012160,
  "retries": 0,
  "status": "pending",
  "sub_type": "null",
  "user_id": 123456789,
  "format": "CSV",
  "report_type": "settlement"
}