Actualizar configuraciones - Todas las transacciones - Mercado Pago Developers
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/settlement_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

Detalles de las columnas que deben incluirse en el reporte. Consulta todos los valores posibles en la sección Glosario.
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, que puede 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 permitiendo 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
Indica si se deben incluir las transacciones de retiro realizadas al final del intervalo de fechas.
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 del retiro.

Invalid columns

Columnas inválidas.

Invalid frequency

Frecuencia invá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.

401No autorizado.

Invalid token

Token inválido.

Request
curl -X PUT \
    'https://api.mercadopago.com/v1/account/settlement_report/config'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
    -d '{
  "columns": [
    {
      "key": "EXTERNAL_REFERENCE"
    }
  ],
  "file_name_prefix": "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",
  "header_language": "es",
  "scheduled": false,
  "include_withdraw": false,
  "refund_detailed": false,
  "shipping_detail": false,
  "coupon_detailed": false,
  "show_chargeback_cancel": false,
  "show_fee_prevision": false
}'
Response
{
  "file_name_prefix": "settlement-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"
  }
}