Inicio
Documentação
Recursos
Certificações
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

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

Busca inteligente powered by OpenAI 

Criar uma nova configuração

POST

https://api.mercadopago.com/v1/account/release_report/config
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'.
Parâmetros de requisição
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.
Parâmetros de resposta
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.

Requisição
curl -X POST \
    'https://api.mercadopago.com/v1/account/release_report/config'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
    -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
}'
Resposta de exemplo
{
  "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"
  }
}