Recursos para IA
Atualizar configurações

Atualiza as colunas, as configurações do arquivo de saída, o fuso horário de exibição e os notificadores de entrega de um relatório de Outras operações configurado previamente. O tipo de relatório é indicado pelo reportId, e a estrutura da configuração é identificada pelo structureId. Em caso de sucesso, a requisição retorna uma resposta com status 200.

PUT

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

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
reportId
string

OBRIGATÓRIO

Tipo de relatório de Outras operações.
activities_collection: Relatório de cobranças.
activities_after_collection: Relatório pós-cobrança.
activities_withdraw: Relatório de retiradas.
structureId
string

OBRIGATÓRIO

UUID da estrutura retornado ao criar a configuração com POST /config.
Body
structure
object

OBRIGATÓRIO

Estrutura atualizada do relatório. Deve incluir o nome e as colunas; envie file_format e display_timezone somente quando quiser atualizar essas configurações.
notifiers
array
Este array é opcional. Envie-o para adicionar notificadores de entrega ou atualizar a configuração dos existentes.
Response parameters
structure
object
Estrutura do relatório retornada após a atualização da configuração.
notifiers
array
Notificadores atualizados e associados à estrutura do relatório.
Erros

400Campos inválidos.

validation_error

Um ou mais campos da configuração são inválidos. Verifique os campos da estrutura e os dados dos notificadores; ao atualizar um notificador existente, inclua seu id. Depois, envie a requisição novamente.

401Access Token inválido.

invalid_token

O Access Token é inválido, expirou ou não tem permissão de escrita. Verifique o token enviado no header Authorization e seus escopos. Depois, envie a requisição novamente.

404Configuração não encontrada.

configuration_not_found

Nenhuma configuração foi encontrada para o structureId informado. Consulte a configuração ativa com GET /config, verifique structure.id e envie a atualização novamente.

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
    }
  ]
}