Recursos para IA
Actualizar configuraciones

Actualiza las columnas, la configuración del archivo de salida, la zona horaria de visualización y los notificadores de entrega de un reporte de Otras operaciones configurado previamente. El tipo de reporte se indica mediante reportId y la estructura de la configuración se identifica mediante structureId. En caso de éxito, la solicitud devuelve una respuesta con el estado 200.

PUT

https://api.mercadopago.com/v1/reporting/operations/{reportId}/config/{structureId}
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
reportId
string

REQUERIDO

Tipo de reporte de Otras operaciones.
activities_collection: Reporte de cobros.
activities_after_collection: Reporte poscobro.
activities_withdraw: Reporte de retiros.
structureId
string

REQUERIDO

UUID de la estructura devuelto al crear la configuración mediante POST /config.
Body
structure
object

REQUERIDO

Estructura actualizada del reporte. Debe incluir el nombre y las columnas; envía file_format y display_timezone solo cuando quieras actualizar esas configuraciones.
notifiers
array
Este array es opcional. Envíalo para agregar notificadores de entrega o actualizar la configuración de los existentes.
Response parameters
structure
object
Estructura del reporte devuelta después de actualizar la configuración.
notifiers
array
Notificadores actualizados y asociados a la estructura del reporte.
Errors

400Campos inválidos.

validation_error

Uno o más campos de la configuración son inválidos. Revisa los campos de la estructura y los datos de los notificadores; al actualizar un notificador existente, incluye su id. Luego, vuelve a enviar la solicitud.

401Access Token inválido.

invalid_token

El Access Token es inválido, está vencido o no tiene permisos de escritura. Verifica el token enviado en el header Authorization y sus alcances. Luego, vuelve a enviar la solicitud.

404Configuración no encontrada.

configuration_not_found

No se encontró una configuración para el structureId indicado. Consulta la configuración activa mediante GET /config, verifica structure.id y vuelve a enviar la actualización.

Request
curl -X PUT \
    'https://api.mercadopago.com/v1/reporting/operations/{reportId}/config/{structureId}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
    -d '{
  "structure": {
    "name": "collections-structure",
    "columns": [
      {
        "key": "date_created"
      }
    ],
    "file_format": {
      "column_separator": ",",
      "decimal_separator": ".",
      "date_format": "yyyy-MM-dd",
      "name": "activities_collection",
      "prefix": "activities_"
    },
    "display_timezone": "GMT-05"
  },
  "notifiers": [
    {
      "id": "11112222-aaaa-bbbb-cccc-333344445555",
      "data": {
        "server": "sftp.myserver.com",
        "port": 22,
        "username": "username",
        "password": "mypassword",
        "remote_dir": "/myfolder"
      },
      "description": "Webhook delivery"
    }
  ]
}'
Response
{
  "structure": {
    "id": "aaaabbbb-1111-2222-3333-ccccddddeeee",
    "name": "collections-structure",
    "columns": [
      {
        "key": "date_created"
      }
    ],
    "notifiers": [
      "11112222-aaaa-bbbb-cccc-333344445555"
    ],
    "scheduled": false,
    "version": 1
  },
  "notifiers": [
    {
      "id": "11112222-aaaa-bbbb-cccc-333344445555",
      "type": "webhook",
      "status": "ACTIVE",
      "version": 1
    }
  ]
}