Criar uma nova configuração - Liberações - Mercado Pago Developers
Criar uma nova configuração

Este endpoint permite a configuração de campos específicos para personalizar as preferências antes de dar início ao processo de criação dos relatórios. As definições serão aplicadas na criação de relatórios posteriormente. Importante: Após criar a configuração, não será possível utilizar este endpoint para criar uma nova. Para aplicar mudanças na configuração do relatório, atualize uma configuração já existente através do endpoint 'Atualizar configurações'

POST

https://api.mercadopago.com/v1/account/release_report/config
Request parameters
Body
columns
array

OBRIGATÓRIO

Campo com os detalhes das colunas que deverão ser incluídas no relatório. Encontre todos os valores possíveis na seção Glossário (https://www.mercadopago.com.br/developers/pt/docs/checkout-pro/additional-content/reports/...Ver mais
file_name_prefix
string

OBRIGATÓRIO

Prefixo que compõe o nome do relatório uma vez gerado e pronto para download, não permitindo valores vazios ou nulos.
frequency
object

OBRIGATÓRIO

Este campo indica a frequência com a qual o relatório deve ser gerado, podendo ser diária, semanal ou mensal.
sftp_info
object
Este campo fornece os dados de conexão necessários para que possamos acessar seu servidor. Ele é opcional, e somente deverá ser enviado caso queira receber os relatórios via SFTP.
Response parameters
file_name_prefix
string
Prefixo que compõe o nome do relatório uma vez gerado e pronto para download, não permitindo valores vazios ou nulos.
notification_email_list
array
Campo que contém um grupo de destinatários de e-mail que receberão notificações quando um relatório estiver pronto e disponível para download. Certifique-se de incluir o e-mail associado à sua conta do Mercado Pago para ...Ver mais
display_timezone
string
Este campo define a data e a hora exibidas nos relatórios. Na ausência de uma configuração específica de fuso horário, o sistema adota por padrão o valor GMT-04. Para fusos horários sujeitos ao horário de verão, ajustes ...Ver mais
include_withdrawal_at_end
boolean
Este campo indica se as transações de saque realizadas no final do intervalo de datas especificado no relatório foram incluídas.
Erros

400Erro.

Invalid file_name_prefix

Prefixo de nome de arquivo inválido.

Invalid execute_after_withdrawal

Execução inválida após a retirada.

Invalid columns

Colunas inválidas.

Invalid frequency

Frequência inválida.

Invalid sftp info

Informações SFTP inválidas.

Invalid webhook

Webhook inválido.

Invalid file config

Arquivo de configuração inválido.

Invalid report_language

Idioma do relatório inválido.

Invalid notification_email_list

Lista de e-mails para notificação inválida.

401Unauthorized.

invalid token

Token inválido.

409Conflict.

Duplicated id

O registro já existe.

Request
curl -X POST \
    'https://api.mercadopago.com/v1/account/release_report/config'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-7*********635832-03*********2ffa6c013*********0a90fa2cd*********120' \
    -d '{
  "columns": [
    {
      "key": "SOURCE_ID"
    }
  ],
  "file_name_prefix": "conciliation-settlement-report",
  "frequency": {
    "hour": 0,
    "value": 1,
    "type": "monthly"
  },
  "sftp_info": {
    "server": "sftp.myserver.com",
    "password": "mypassword",
    "remote_dir": "/myfolder",
    "port": 22,
    "username": "username"
  },
  "separator": ";",
  "display_timezone": "GMT-04",
  "report_translation": "es",
  "notification_email_list": [
    {}
  ],
  "include_withdrawal_at_end": false,
  "check_available_balance": false,
  "compensate_detail": false,
  "execute_after_withdrawal": false,
  "scheduled": false
}'
Response
{
  "file_name_prefix": "release-report-USER_ID",
  "notification_email_list": [
    {}
  ],
  "display_timezone": "GMT-04",
  "include_withdrawal_at_end": true,
  "scheduled": false,
  "execute_after_withdrawal": false,
  "columns": [
    {
      "key": "SOURCE_ID"
    }
  ],
  "report_translation": "es",
  "frequency": {
    "hour": 0,
    "value": 1,
    "type": "monthly"
  }
}