Recursos para IA
Buscar em pedidos comerciaishttps://api.mercadopago.com/merchant_orders/search
Encontre todas as informações dos pedidos gerados através de filtros específicos e por um intervalo de datas específico. Somente serão trazidos os dados dos últimos 90 dias (3 meses) e, caso queira buscar dados mais antigos, utilize o GET de "Obter pedido".
GET
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.
Query
status
string
Status do pedido.
preference_id
string
Identificação da preferência de pagamento associados à ordem
application_id
string
Id do aplicativo
payer_id
string
Identificador de pagador
Response parameters
elements
array
Contém os dados do pedido.
next_offset
number
Campo numérico usado para paginar a resposta.
total
number
Total de resultados da pesquisa.
Erros
400Erro
ds_search_query
invalid query.
401Erro
invalid_token
invalid_token.
invalid_caller_id
invalid caller_id
Request
curl -X GET \
'https://api.mercadopago.com/merchant_orders/search?status=12123adfasdf123u4u&preference_id=12123adfasdf123u4u&application_id=12123adfasdf123u4u&payer_id=12123adfasdf123u4u&sponsor_id=12123adfasdf123u4u&external_reference=12123adfasdf123u4u&site_id=12123adfasdf123u4u&marketplace=12123adfasdf123u4u&date_created_from=12123adfasdf123u4u&date_created_to=12123adfasdf123u4u&last_updated_from=12123adfasdf123u4u&last_updated_to=12123adfasdf123u4u&items=12123adfasdf123u4u&limit=12123adfasdf123u4u&offset=12123adfasdf123u4u'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
Response
{
"elements": [
{
"id": 9999999999,
"status": "closed",
"external_reference": "default",
"preference_id": "Preference identification",
"payments": [
{
"id": 9999999999,
"transaction_amount": 1,
"total_paid_amount": 1,
"shipping_cost": 0,
"currency_id": "BRL",
"status": "approved",
"status_detail": "accredited",
"date_approved": "2019-04-02T18:35:35.000Z",
"date_created": "2019-04-02T18:35:34.000Z",
"last_modified": "2019-04-02T18:35:35.000Z",
"amount_refunded": 0
}
],
"shipments": [
{
"id": 99999999999,
"shipment_type": "shipping",
"shipping_mode": "me2",
"status": "delivered",
"items": [
{
"id": "not specified",
"description": "shipment item description",
"quantity": 1,
"dimensions": "1.0x10.0x23.0100.0"
}
],
"date_created": "2019-04-02T18:20:46.000Z",
"last_modified": "2019-04-12T19:36:48.000Z",
"date_first_printed": "2019-04-02T18:35:40.000Z",
"service_id": 999,
"sender_id": 999999999,
"receiver_id": 999999999,
"receiver_address": {
"id": 9999999999,
"address_line": "address line",
"city": {
"name": "City Name"
},
"state": {
"id": "AR-X",
"name": "state name"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": 0,
"longitude": 0,
"comment": "shipment comment",
"contact": "shipment contact",
"phone": 9999999999,
"zip_code": 9999,
"street_name": {
"en": "Street name",
"pt": "Nome da rua",
"es": "Nombre de la calle"
},
"street_number": 999
},
"shipping_option": {
"id": 999999999,
"cost": 0,
"currency_id": "BRL",
"shipping_method_id": 99999,
"estimated_delivery": {
"date": "2019-04-11T03:00:00.000Z"
},
"name": "Normal a domicilio",
"list_cost": 0,
"speed": {
"handling": 72,
"shipping": 72
}
}
}
],
"collector": {
"id": 999999999
},
"marketplace": "NONE",
"date_created": "2018-09-14T17:11:31.000Z",
"last_updated": "2018-09-14T17:11:43.000Z",
"shipping_cost": 0,
"total_amount": 5,
"site_id": "MLA",
"paid_amount": 5,
"refunded_amount": 0,
"payer": {
"id": 999999999,
"email": "test@testuser.com"
},
"items": [
{
"id": "item id",
"category_id": "item category",
"currency_id": "BRL",
"description": "item description",
"picture_url": "item picture url",
"title": "item title",
"quantity": 1,
"unit_price": 5
}
],
"additional_info": "additional information",
"application_id": "10000000000000000",
"order_status": "paid"
}
],
"next_offset": 1,
"total": 1
}