Consultas e validações
Após a criação do relatório, é possível validar a estrutura e as notificações efetuando uma chamada GET à nossa API, conforme orientações a seguir. Isso se aplica a ambos os tipos de relatórios.
Para efetuar solicitações GET a Structures, Notifier, Event e Statement, é preciso incluir o
TOKEN
no header da solicitação. Além disso, ao realizar solicitações GET por ID a Structures, Notifier, Event e Statement, é obrigatório enviar os seguintes parâmetros correspondentes: structure_id
, notifier_id
, event_id
e statement_id
.GET Structures
curl
curl --location --request GET 'https://api.mercadopago.com/v1/reports/marketplace_sellers_sales/structures' \
--header 'Authorization: Bearer {{TOKEN}}'
Resposta
json
[
{
"id": {{structure_id}},
"version": 0,
"date_created": "2023-07-19T19:34:33Z",
"date_last_updated": "2023-07-19T19:34:33Z",
"display_timezone": "GMT-03",
"name": "Structure marketplace",
"file_format": {
"prefix": "marketplace",
"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
},
{
//more structures
}
]
GET Structure por ID
curl
curl --location --request GET 'https://api.mercadopago.com/v1/reports/marketplace_sellers_sales/structures/:structure_id' \
--header 'Authorization: Bearer {{TOKEN}}'
Respuesta
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
}
GET Notifiers
curl
curl --location --request GET 'https://api.mercadopago.com/v1/reports/notifiers' \
--header 'Authorization: Bearer {{TOKEN}}'
Resposta
json
[
{
"id": {{notifier_id}},
"type": "email",
"data": {
"recipients": [
"test@mercadolibre.com"
]
},
"description": null,
"version": 0,
"status": "ACTIVE",
"is_pii_data": true
},
{
... // more responses
}
]
GET Notifier por ID
curl
curl --location --request GET 'https://api.mercadopago.com/v1/reports/notifiers/:notifier:id' \
--header 'Authorization: Bearer {{TOKEN}}'
Respuesta
json
{
"id": {{notifier_id}},
"type": "email",
"data": {
"recipients": [
"test@mercadolibre.com"
]
},
"description": null,
"version": 0,
"status": "ACTIVE",
"is_pii_data": true
}
GET Events
curl
curl --location --request GET 'https://api.mercadopago.com/v1/reports/marketplace_sellers_sales/events' \
--header 'Authorization: Bearer {{TOKEN}}'
Resposta
json
[
{
"id": {{event_id}},
"type": "frequency",
"data": {
"period": "daily",
"value": 1,
"hour": 20,
"skip_non_working_days": false
},
"description": "Mail diario a las 20:00",
"structure_id": {{structure_id}},
"notifiers": [
{{notifier_id}}
],
"status": "ACTIVE",
"version": 1
},
{
... // more responses
}
]
GET Event por ID
curl
curl --location --request GET 'https://api.mercadopago.com/v1/reports/marketplace_sellers_sales/events/:event_id' \
--header 'Authorization: Bearer {{TOKEN}}'
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}}
}
GET Statements
curl
curl --location --request GET 'https://api.mercadopago.com/v1/reports/marketplace_sellers_sales/statements' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{TOKEN}}'
Resposta
json
{
"id": {{statement_id}},
"date_start": "2023-07-18T00:00:00Z",
"date_end": "2023-07-20T19:00:00Z",
"date_created": "2023-07-21T17:25:25.764122Z",
"created_by": "automatic",
"description": "statement de pruebas",
"report": {
"id": "marketplace_sellers_sales",
"name": "Marketplace OP",
"topic": "financial_statements",
"version": "1"
},
"files": [
{
"type": "json",
"url": "https://api.mercadopago.com/v1/reporting/reports/marketplace_sellers_sales/statements/{{statement_id}}/download?format=json"
},
{
"type": "csv",
"url": "https://api.mercadopago.com/v1/reporting/reports/marketplace_sellers_sales/statements/{{statement_id}}/download?format=csv"
}
],
"event": null,
"origin": {
"type": "date_range",
"data": {
"date_end": "2023-07-20T19:00:00Z",
"date_start": "2023-07-18T00:00:00Z"
}
},
"report_extra_data": {},
"structure": {
"id": {{structure_id}},
"version": 0
},
"notifiers": [
{
"id": {{notifier_id_1}},
"version": 0,
"type": "email",
"data": {}
},
{
"id": {{notifier_id_n}},
"version": 0,
"type": "ftp",
"data": {}
}
],
"status": "available",
"reason_code": {
"code": ""
}
}
GET Statement por ID
curl
curl --location --request GET 'https://api.mercadopago.com/v1/reports/marketplace_sellers_sales/statements/:statement_id' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{TOKEN}}'
Respuesta
json
{
"id": {{statement_id}},
"date_start": "2023-07-18T00:00:00Z",
"date_end": "2023-07-20T19:00:00Z",
"date_created": "2023-07-21T17:25:25.764122Z",
"created_by": "automatic",
"description": "statement de pruebas",
"report": {
"id": "marketplace_sellers_sales",
"name": "Marketplace OP",
"topic": "financial_statements",
"version": "1"
},
"files": [
{
"type": "json",
"url": "https://api.mercadopago.com/v1/reporting/reports/marketplace_sellers_sales/statements/{{statement_id}}/download?format=json"
},
{
"type": "csv",
"url": "https://api.mercadopago.com/v1/reporting/reports/marketplace_sellers_sales/statements/{{statement_id}}/download?format=csv"
}
],
"event": null,
"origin": {
"type": "date_range",
"data": {
"date_end": "2023-07-20T19:00:00Z",
"date_start": "2023-07-18T00:00:00Z"
}
},
"report_extra_data": {},
"structure": {
"id": {{structure_id}},
"version": 0
},
"notifiers": [
{
"id": {{notifier_id_1}},
"version": 0,
"type": "email",
"data": {}
},
{
"id": {{notifier_id_n}},
"version": 0,
"type": "ftp",
"data": {}
}
],
"status": "available",
"reason_code": {
"code": ""
}
}