Actualizar configuraciones

Este endpoint actualiza las configuraciones predeterminadas de tus reportes. Ten en cuenta que al actualizar una configuración, será necesario ejecutar el endpoint 'Crear reporte' y luego 'Descargar reporte'. En caso de éxito, la solicitud devolverá una respuesta con estado 200.

PUT

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

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Body
columns
array

REQUERIDO

Campo con los detalles de las columnas que se incluirán en el reporte, basado en los valores definidos en el request. Encuentra todos los valores posibles en la sección Glosario (https://www.mercadopago.com/developers/es...Ver más
file_name_prefix
string

REQUERIDO

Prefijo que compone el nombre del reporte una vez generado y listo para descargar. No permite valores vacíos o nulos.
frequency
object

REQUERIDO

Este campo indica la frecuencia con la que debe generarse el reporte, pudiendo ser diaria, semanal o mensual.
sftp_info
object
Este campo proporciona los datos de conexión necesarios para que podamos acceder a tu servidor. Es opcional y solo debe enviarse si deseas recibir los reportes a través de SFTP.
Response parameters
file_name_prefix
string
Prefijo que compone el nombre del reporte una vez generado y listo para su descarga. No permite valores vacíos o nulos.
display_timezone
string
Este campo define la fecha y hora mostradas en los reportes. En ausencia de una configuración específica de zona horaria, el sistema adopta por defecto el valor GMT-04. Para zonas horarias sujetas al horario de verano, s...Ver más
include_withdrawal_at_end
boolean
Este campo indica si deben incluirse las transacciones de retiro realizadas al final del intervalo de fechas especificado en el reporte.
scheduled
boolean
Campo informativo que indica si ya existen reportes programados en la cuenta del usuario. Será 'true' si la generación automática está activada, y 'false' si está desactivada.
Errors

400Error.

Invalid file_name_prefix

Prefijo de nombre de archivo no válido.

Invalid execute_after_withdrawal

Ejecución inválida después de la retirada.

Invalid columns

Columnas no válidas.

Invalid frequency

Frecuencia no válida.

Invalid SFTP info

Información SFTP no válida.

Invalid webhook

Webhook no válido.

Invalid file config

Configuración de archivo no válida.

Invalid report_language

Idioma del reporte no válido.

401Unauthorized.

invalid token

Token no válido.

Request
curl -X PUT \
    'https://api.mercadopago.com/v1/account/release_report/config'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
    -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",
  "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",
  "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"
  }
}