Recursos para IA
Crear una nueva configuración

Crea columnas y notificadores de entrega para un reporte de Otras operaciones. En caso de éxito, la solicitud devuelve una respuesta con el estado 201.

POST

https://api.mercadopago.com/v1/reporting/operations/{reportId}/config
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.
Body
structure
object

REQUERIDO

Estructura de columnas del reporte.
notifiers
array

REQUERIDO

Lista de notificadores utilizados para informar que el reporte está disponible o para entregar el archivo generado. Incluye al menos un notificador y define su tipo y los datos de conexión correspondientes.
Response parameters
structure
object
Estructura del reporte creada a partir de la solicitud de configuración.
notifiers
array
Notificadores creados y asociados a la estructura del reporte.
Errors

400Campos inválidos o notificador mal formado.

validation_error

Uno o más campos de la configuración son inválidos, o un notificador está mal formado. Revisa los campos obligatorios y verifica que data contenga los atributos requeridos para el type de notificador seleccionado. 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.

409Ya existe una configuración.

configuration_already_exists

Ya existe una configuración activa para el reportId indicado. Consúltala mediante GET /config y actualízala con PUT /config/{structureId} en lugar de crear una nueva configuración.

Request
curl -X POST \
    'https://api.mercadopago.com/v1/reporting/operations/{reportId}/config'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********550113-12*********b4773884a*********e8df16347*********786' \
    -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": [
    {
      "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": 0
  },
  "notifiers": [
    {
      "id": "11112222-aaaa-bbbb-cccc-333344445555",
      "type": "webhook",
      "status": "ACTIVE",
      "version": 0
    }
  ]
}