# MD for: https://www.mercadopago.com.uy/developers/es/docs/checkout-pro/additional-content/reports/sales-report/modifications.md \# Modifications If, after reviewing structure configurations, notifications, or events, you wish to make changes, use the specified endpoints below. > WARNING > > Important > > Please note that \*\*it is not possible\*\* to modify manually generated reports (statements). ## PUT Structure > When making a PUT request to Structures, remember to include the following mandatory parameters: \`display\_timezone\`, \`name\`, \`file\_format\`, and \`columns\`. \`\`\`curl curl --location --request PUT 'https://api.mercadopago.com/v1/reports/marketplace\_sellers\_sales/structures/{{structure\_id}}' \\ --header 'Authorization: Bearer {{TOKEN}}' \\ --header 'Content-Type: application/json' \\ --data-raw '{ "display\_timezone": "GMT-05", "name": "Structure 2 marketplace", "file\_format": { "prefix": "mkp-", "column\_separator": ";", "decimal\_separator": "." }, "columns": \[ { "key": "COLLECTOR", "alias": "" }, { "key": "COLLECTOR\_NICKNAME", "alias": "" }, { "key": "PAYMENT", "alias": "" }, { "key": "STATUS\_DESCRIPTION", "alias": "" }, { "key": "STATUS\_DETAIL", "alias": "" }, { "key": "PURCHASE\_ORDER", "alias": "" }, { "key": "PAYMENT\_METHOD\_TYPE", "alias": "" }, { "key": "TRANSACTION\_AMOUNT", "alias": "" }, { "key": "DATE\_CREATED", "alias": "" }, { "key": "DATE\_APPROVED", "alias": "" }, { "key": "MARKETPLACE\_FEE\_AMOUNT", "alias": "" }, { "key": "MERCADOPAGO\_FEE\_AMOUNT", "alias": "" }, { "key": "TOTAL\_PAID\_AMOUNT", "alias": "" }, { "key": "NET\_RECEIVED\_AMOUNT", "alias": "" } \] }' \`\`\` #### Response \`\`\`json { "id": {{structure\_id}}, "version": 1, "date\_created": "2023-07-19T19:34:33Z", "date\_last\_updated": "2023-09-13T17:54:38Z", "display\_timezone": "GMT-03", "name": "Structure marketplace", "file\_format": { "prefix": "marketplace-op", "column\_separator": ";", "decimal\_separator": "." }, "columns": \[ { "key": "COLLECTOR", "alias": "" }, { "key": "COLLECTOR\_NICKNAME", "alias": "" }, { "key": "PAYMENT", "alias": "" }, { "key": "STATUS\_DESCRIPTION", "alias": "" }, { "key": "STATUS\_DETAIL", "alias": "" }, { "key": "PURCHASE\_ORDER", "alias": "" }, { "key": "PAYMENT\_METHOD\_TYPE", "alias": "" }, { "key": "TRANSACTION\_AMOUNT", "alias": "" }, { "key": "DATE\_CREATED", "alias": "" }, { "key": "DATE\_APPROVED", "alias": "" }, { "key": "MARKETPLACE\_FEE\_AMOUNT", "alias": "" }, { "key": "MERCADOPAGO\_FEE\_AMOUNT", "alias": "" }, { "key": "TOTAL\_PAID\_AMOUNT", "alias": "" }, { "key": "NET\_RECEIVED\_AMOUNT", "alias": "" } \], "file\_config": null, "report\_translation": null, "include\_withdraw": null, "refund\_detailed": null, "show\_fee\_prevision": null, "coupon\_detailed": null, "show\_chargeback\_cancel": null } \`\`\` ## PUT Event > When making a PUT request to Event, remember to include the following mandatory parameters: \`type\`, \`data\` (\`period\`, \`value\`, \`hour\`), \`description\`, \`structure\_id\`, and \`notifiers\`. \`\`\`curl curl --location --request PUT 'https://api.mercadopago.com/v1/reports/marketplace\_sellers\_sales/events/{{event\_id}}' \\ --header 'Authorization: Bearer {{TOKEN}}' \\ --header 'Content-Type: application/json' \\ --data-raw '{ "type": "frequency", "data": { "period": "daily", "value": 0, "hour": 0 }, "description": "test event", "structure\_id": {{structure\_id}}, "notifiers": \[{{notifier\_id}}\], "status": "ACTIVE", "version": 0 }' \`\`\` #### Respuesta \`\`\`json { "id": {{event\_id}}, "type": "frequency", "data": { "period": "daily", "value": 0, "hour": 11, "skip\_non\_working\_days": false }, "description": "Evento para envĂ­o los viernes ", "structure\_id": {{structure\_id}}, "notifiers": \[ {{notifier\_id}} \], "status": "ACTIVE", "version": 1, "user\_id": {{user\_id}} } \`\`\` ## PUT Notifier ### Email > When making a PUT request to Notifier Email, remember to include the following mandatory parameters: \`type\`, \`data\` (\`recipients\`), and \`description\`. \`\`\`curl curl --location --request PUT 'https://api.mercadopago.com/v1/reports/notifiers/{{notifier\_id}}' \\ --header 'Authorization: Bearer {{TOKEN}}' \\ --header 'Content-Type: application/json' \\ --data-raw '{ "type": "email", "data": { "recipients": \["test@mercadolibre.com"\] }, "description": "test notifier email" }' \`\`\` #### Response \`\`\`json { "id": {{notifier\_id}}, "type": "email", "data": { "recipients": \[ "test@mercadolibre.com" \] }, "description": null, "version": 1, "status": "ACTIVE", "is\_pii\_data": true } \`\`\` ### SFTP > When making a PUT request to Notifier SFTP, remember to include the following mandatory parameters: \`type\`, \`data\` (\`ip\`, \`port\`, \`password\`, \`protocol\`, \`username\`, \`remote\_dir\`), and \`description\`. \`\`\`curl curl --location --request PUT 'https://api.mercadopago.com/v1/reports/notifiers/{{notifier\_id}}?type=ftp' \\ --header 'Authorization: Bearer {{TOKEN}}' \\ --header 'Content-Type: application/json' \\ --data-raw '{ "type": "ftp", "data": { "ip": "test.files.com", "port": 22, "password": "test", "protocol": "SFTP", "username": "test@mercadolibre.com", "remote\_dir": "/" }, "description": "test notifier sftp" }' \`\`\` #### Response \`\`\`json { "id": {{notifier\_id}}, "type": "ftp", "data": { "ip": "test.files.com", "port": 22, "password": "test", "protocol": "SFTP", "username": "test@mercadolibre.com", "remote\_dir": "/" }, "description": "test notifier sftp 1", "version": 1, "status": "ACTIVE", "is\_pii\_data": false } \`\`\`