Inicio
Documentación
Recursos
Certificaciones
Comunidad

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Crear una nueva configuración - Liberaciones - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Crear una nueva configuración

POST

https://api.mercadopago.com/v1/account/release_report/config
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'.
Parámetros para la solicitud
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 Glossário (https://www.mercadopago.com.co/developers/es/docs/checkout-pro/additional-content/re...Ver más
file_name_prefix
string

REQUERIDO

Prefijo que compone el nombre del reporte a ser generado y descargado. 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.
Parámetros de respuesta
file_name_prefix
string
Prefijo que compone el nombre del reporte una vez generado y listo para su descarga.
notification_email_list
array
Campo que contiene un grupo de destinatarios de correo electrónico que recibirán notificaciones cuando un reporte esté listo y disponible para su descarga.
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 las transacciones de retiro realizadas al final del intervalo de fechas especificado en el reporte han sido incluidas.
Errores

400Error.

Invalid file_name_prefix

Prefijo de nombre de archivo invá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

Archivo de configuración no válido.

Invalid report_language

Idioma del reporte no válido.

Invalid notification_email_list

Lista de correos electrónicos para notificación no válida.

401Unauthorized.

invalid token

Token inválido.

409Conflict.

Duplicated id

El registro ya existe.

Solicitud
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
}'
Respuesta de ejemplo
{
  "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"
  }
}