Crear una nueva configuración - Todas las transacciones - Mercado Pago Developers
Crear una nueva configuración

Este endpoint permite la configuración de campos específicos para personalizar las preferencias antes de iniciar el proceso de creación de reportes. Las configuraciones se aplicarán en la generación de reportes posteriormente. Importante: Después de crear la configuración, no será posible utilizar este endpoint para crear una nueva. Para aplicar cambios en la configuración del reporte, actualiza la configuración ya existente a través del endpoint 'Actualizar configuraciones'. En caso de éxito, la solicitud devolverá una respuesta con estado 200.

POST

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

Campo con los detalles de las columnas que deben incluirse en el reporte. Encuentra todos los valores posibles en la sección Glosario (https://www.mercadopago.com/developers/es/docs/reports/account-money/report-fields).
file_name_prefix
string

REQUERIDO

Prefijo que compone el nombre del reporte una vez generado y listo para su descarga. 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
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.
columns
array

REQUERIDO

Campo con los detalles de las columnas que deben incluirse en el reporte. Encuentra todos los valores posibles en la sección Glosario (https://www.mercadopago.com/developers/es/docs/reports/account-money/report-fields).
Errors

400Error.

Invalid file_name_prefix

Prefijo de nombre de archivo no válido.

Invalid include_withdraw

Ejecución inválida incluir de la retirada.

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

Archivo de configuración no válido.

Invalid report_language

Idioma del reporte no válido.

401No autorizado.

Invalid token

Token inválido.

409Conflicto.

Duplicated id

El registro ya existe.

Request
curl -X POST \
    '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",
  "scheduled": false,
  "columns": [
    {
      "key": "EXTERNAL_REFERENCE"
    }
  ],
  "report_translation": "es",
  "header_language": "es",
  "frequency": {
    "hour": 0,
    "value": 1,
    "type": "monthly"
  }
}