Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 24/06/2026

Gerenciar orders

Uma order é um pedido realizado por um cliente em um anúncio com uma série de condições que ele irá escolher no fluxo de compra online (checkout). Estas condições são detalhadas na order, que será replicada nas contas do comprador e do vendedor. A order contém muitas informações a serem preenchidas sobre o produto e a possibilidade de reservar e/ou descontar estoque. Saiba mais sobre o fluxo de gerenciamento de orders simples e de carrinho, pagamentos e envios.


Receba uma ordem

Quando uma nova ordem é criada no usuário, os detalhes podem ser consultados através de uma solicitação ao recurso de order. Além disto recomendamos ativar o novo tópico de orders feedback para estar atualizado sobre os feedbacks recebidos.
Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/2000003508419013

Resposta:

{
   "id": 2000003508897196,
   "date_created": "2022-04-08T17:01:30.000-04:00",
   "date_closed": "2022-04-08T17:01:33.000-04:00",
   "last_updated": "2022-04-08T17:03:32.000-04:00",
   "manufacturing_ending_date": null,
   "comment": null,
   "pack_id": 2000003508553677,
   "pickup_id": null,
   "order_request": {
       "return": null,
       "change": null
   },
   "fulfilled": null,
   "mediations": [],
   "total_amount": 50,
   "paid_amount": 50,
   "coupon": {
       "id": null,
       "amount": 0
   },
   "order_items": [
       {
           "item": {
               "id": "MLB2608564035",
               "title": "Camiseta Basica",
               "category_id": "MLB31447",
               "variation_id": 174390848694,
               "seller_custom_field": null,
               "variation_attributes": [
                   {
                       "id": "SIZE",
                       "name": "Tamanho",
                       "value_id": "2282666",
                       "value_name": "M"
                   },
                   {
                       "id": "COLOR",
                       "name": "Cor",
                       "value_id": "52049",
                       "value_name": "Preto"
                   }
               ],
               "warranty": "Sem garantia",
               "condition": "new",
               "seller_sku": null,
               "global_price": null,
               "net_weight": null
           },
           "quantity": 1,
           "requested_quantity": {
               "value": 1,
               "measure": "unit"
           },
           "picked_quantity": null,
           "unit_price": 50,
           "currency_id": "BRL",
           "manufacturing_days": null,
           "sale_fee": 12,
           "listing_type_id": "gold_special"
       }
   ],
   "currency_id": "BRL",
   "payments": [
       {
           "id": 21463688923,
           "order_id": 2000003508897196,
           "payer_id": 266272126,
           "collector": {
               "id": 478055419
           },
           "card_id": null,
           "site_id": "MLB",
           "reason": "Camiseta Basica",
           "payment_method_id": "account_money",
           "currency_id": "BRL",
           "installments": 1,
           "issuer_id": null,
           "atm_transfer_reference": {
               "company_id": null,
               "transaction_id": null
           },
           "coupon_id": null,
           "activation_uri": null,
           "operation_type": "regular_payment",
           "payment_type": "account_money",
           "available_actions": [
               "refund"
           ],
           "status": "approved",
           "status_code": null,
           "status_detail": "accredited",
           "transaction_amount": 50,
           "transaction_amount_refunded": 0,
           "taxes_amount": 0,
           "shipping_cost": 0,
           "coupon_amount": 0,
           "overpaid_amount": 0,
           "total_paid_amount": 50,
           "installment_amount": null,
           "deferred_period": null,
           "date_approved": "2022-04-08T17:01:32.000-04:00",
           "authorization_code": null,
           "transaction_order_id": null,
           "date_created": "2022-04-08T17:01:32.000-04:00",
           "date_last_modified": "2022-04-08T17:01:44.000-04:00"
       }
   ],
   "shipping": {
       "id": 41297142475
   },
   "status": "paid",
   "status_detail": null,
   "tags": [
       "no_shipping",
       "test_order",
       "not_delivered",
       "pack_order",
       "paid"
   ],
   "feedback": {
       "buyer": null,
       "seller": null
   },
   "context": {
       "channel": "marketplace",
       "site": "MLB",
       "flows": []
   },
   "buyer": {
       "id": 266272126,
  },
   "seller": {
       "id": 478055419,
   },
   "taxes": {
       "amount": null,
       "currency_id": null,
       "id": nullnotas
   }
}
Notas:
- Para obter os detalhes de feedback é necessário fazer uma chamada ao recurso /feedbacks/$feedback_id com o id informado na ordem.
-Também pode ser consumida a informação dos feedbacks usando o recurso /orders/$order_id/feedback.
- É possível obter as informações do vendedor consultando a API de user utilizando o access_token.

Além disso, recomendamos ativar o novo tópico de orders feedback para estar atualizado sobre os feedbacks recebidos.


Campos de resposta:

id: identificador único da ordem.
date_created: data de criação da ordem.
date_closed: data de confirmação da ordem. Quando uma ordem muda pela primeira vez de status é definida como: confirmed / paid e descontada do estoque do item.
expiration_date: prazo limite para o usuário qualificar. Após essa data, o feedback se torna visível, os pagamentos são emitidos (caso houver) e os encargos são criados.
status: status da ordem. Ver os valores possíveis.
status_detail: detalhe do status.
code: código do status.
description: descrição do status.
comprador: informações do comprador.
vendedor: informações do vendedor.
order_items: publicações na ordem.

  • item: publicação específica.
  • quantity: quantidade de itens comprados.
  • sale_fee: comissão de vendas.
  • unit_price: preço unitário.
  • gross_price: O atributo gross_price é um campo que representa o valor original que o cliente teria pago por todas as unidades do item sem descontos. Esse campo permite visualizar claramente o impacto dos descontos aplicados em cada pedido.

payments: pagamentos relacionados à order.
feedback: ID de feedback relacionadas à order.
context: detalhe das características da criação de uma order.

  • channel: os canais de venda que hoje tem este item. valores possíveis: proximity | mp-channel | marketplace.
  • site: ID do site onde se originou a compra (MLA, MLB, MLM, etc)
  • flows: é uma lista de características da origem da compra. Valores possíveus: b2b | cbt | subscription | reservation | catalog, contract | supermarket | 3x_campaign | high_concurrency | lite.
  • shipping: ID do envio para esta order.
    total_amount: valor total da order.
    currency_id: ID de moeda.
    tags: lista das tags adicionadas pelo MeLi ou vendedor, tais como entregue, pago, com desconto, sem envio, b2b.
    taxes: valor com a soma dos impostos a serem pagos pelo pedido.
    cancel_detail: detalhe do cancelamento da venda.

    • group: agrupamento lógico de cancelamento (mediations, fiscal, buyer, fraud, item, shipment, delivery, seller, internal).
    • code: código da causa do cancelamento.
    • description: descrição da causa do cancelamento.
    • requested_by: quem solicita o cancelamento (buyer, seller, Mercado Livre).
    • date: data do cancelamento.

    Nota: O campo gross_price está disponível no objeto order_items de cada pedido e representa o preço total bruto considerando a quantidade de unidades.


    Como é calculado?

    O gross_price é calculado pela seguinte fórmula:

      
    gross_price = (unit_price + discounts.full) × quantity
      
    

    Componentes da fórmula

    Campo Tipo Descrição
    unit_price Number Preço unitário do item após aplicar os descontos.
    discounts.full Number Desconto unitário aplicado ao item (sempre expresso por unidade).
    quantity Number Quantidade de unidades do item no pedido.
    gross_price Number Valor total original sem descontos para todas as unidades do item.


    Características importantes

    • Sem descontos: Quando não há descontos aplicados, o gross_price coincide com o total pago (unit_price × quantity).
    • Moeda: O gross_price é expresso na mesma moeda que o unit_price (definida no campo currency_id).
    • Cálculo por item: Cada item em order_items tem seu próprio valor de gross_price.

    Exemplo de resposta com gross_price

    Chamada:

      curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID
    

    Resposta:

      {
      "id": 2000003456789012,
      "status": "paid",
      "status_detail": null,
      "date_created": "2026-01-05T10:30:00.000-03:00",
      "date_closed": "2026-01-05T10:32:15.000-03:00",
      "order_items": [
        {
          "item": {
            "id": "MLM823798303",
            "title": "Versace Pour Homme 100ml Edt Spray"
          },
          "quantity": 2,
          "unit_price": 440.00,
          "discounts": [
            {
              "amounts": {
                "full": 341.00,
                "seller": 341.00
              }
            }
          ],
          "gross_price": 1562.00,
          "currency_id": "MXN"
        }
      ],
      "total_amount": 880.00,
      "currency_id": "MXN",
      "buyer": {
        "id": 123456789
      },
      "seller": {
        "id": 987654321
      },
      "payments": [
        {
          "id": 12345678901,
          "transaction_amount": 880.00,
          "currency_id": "MXN",
          "status": "approved",
          "date_created": "2026-01-05T10:31:00.000-03:00",
          "date_last_modified": "2026-01-05T10:32:00.000-03:00"
        }
      ],
      "shipping": {
        "id": 43210987654321
      },
      "tags": [
        "paid",
        "not_delivered"
      ]
    }
    

    Discriminação do cálculo no exemplo

    Cálculo passo a passo:

      // Dados do exemplo
    unit_price = 440.00        // Preço unitário COM desconto aplicado
    discounts.full = 341.00    // Desconto unitário
    quantity = 2               // Quantidade de unidades
    
    // Aplicação da fórmula
    gross_price = (unit_price + discounts.full) × quantity
    gross_price = (440.00 + 341.00) × 2
    gross_price = 781.00 × 2
    gross_price = 1562.00      // Preço bruto total sem descontos
    

    Considerações

    • O campo gross_price pode não estar presente em pedidos antigos criados antes da implementação desse atributo.
    • Quando não há descontos aplicados (discounts.full = 0), o valor de gross_price será igual a unit_price × quantity.
    • O gross_price é expresso na mesma moeda indicada no campo currency_id do item.
    • O campo discounts.seller indica a parcela do desconto assumida pelo vendedor, útil para campanhas cofinanciadas.

    Notas:
    - Lembre-se de que as comissões são calculadas no momento da acreditação do pagamento, ou seja, quando o pedido fica visível para o vendedor e não quando o pedido é criado.
    - Vendas que tiveram falha no pagamento, podem ter o meio de envio original da compra alterado, já que pode ocorrer uma uma nova compra. Para estes casos onde a compra original tinha un envio associado, e na nova compra, o comprador optar por entrega a combinar, o status do envio ficará em status: cancelled e substatus: closed_by_user, e a venda precisará ser cancelada.
    - Para obter as informações de envio é necessário fazer uma chamada ao recurso /shipments/shipping.id com o id informado na order. Visite nosso guia de shipments..
    - As vendas sempre são atualizadas, mesmo no caso de fraude, e você poderá reconhecê-la pela tag "fraud_risk_detected" e também te enviaremos uma notificação no tópico "orders". - O array “context” traz informação sobre modo/fluxo de geração de compra e pode servir para análise dos vendedores.


    Alertas de fraude (frenados de envíos)

    Após a aprovação de um pagamento, devido ao relacionamento com bancos e emissoras de cartão, podemos receber alertas de que o pedido em questão se trata de uma fraude e que para evitar perda financeira, a mercadoria não deve ser enviada ao comprador.
    Neste caso, o pedido é marcado com a tag "fraud_risk_detected" e enviamos uma notificação no topic "orders_v2" com o ID deste pedido.
    Após identificado, o pedido deve ser cancelado. Caso o vendedor já tenha enviado a mercadoria, será necessário comprovar o envio através site do Mercado Livre ou Mercado Pago.


    Cálculo do total_amount_with_shipping

    Com a resposta obtida na chamada a GET /orders/:id e na GET /shipments/:shipping_id, ambas com o header x-format-new: true, deve realizar o seguinte cálculo:

    total_amount_with_shipping = total_amount + taxes.amount + lead_time.cost

    *Na mesma moeda do item.

    O total_amount e taxes.amount se o obtém através do recurso /orders, já o lead_time.cost se obtém em /shipments.

    Importante:
    Nos casos em que taxes.currency_id é diferente de items.currency_id é necessário realizar a conversão.

    Chamada:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/currency_conversions/search?from=$CURRENCY_ID&to=$CURRENCY_ID

    Exemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/currency_conversions/search?from=ARS&to=BRL

    Resposta:

    {
      "ratio": 0.0704988
    }

    Informações dos produtos em orders

    Esta pesquisa mostrará todas as informações dos produtos que estão nesse mesmo pedido:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID/product
    Nota:
    Para os pedidos do Fulfillment, o IMEI está sendo trazido também direto na Nota Fiscal.

    Resposta:

    {
      "attributes": [
            {
                "name": "IMEI",
              "value": "111",
                "id": 1
          },
            {
                "name": "IMEI",
              "value": "222",
                "id": 2
          },
            {
                "name": "entry_date",
              "value": "01/01/2001",
                "id": 3
          }
      ]
    }
    Nota:
    Para visualizar os pedidos dentro de um carrinho de compras, é necessário utilizar o recurso /packs. Favor observar que o recurso /orders pode incluir muitos produtos da mesma publicação em termos de quantidades.

    Obter descontos aplicados em uma venda

    Utilize o recurso /discounts para revisar os detalhes de todos os descontos que impactaram uma venda. Considere que os descontos podem vir desde uma campanha (promoção), cupom ou cashback, e que uma venda pode ter mais de um desconto aplicado.
    Lembre-se que atualmente são salvas orders criadas até 12 meses, e se realizar uma busca como vendedor, serão filtradas ordens canceladas.


    Chamada:

    curl -X GET -H ‘Authorization: Bearer $ACCESS_TOKEN’ https://api.mercadolibre.com/orders/$ORDER_ID/discounts

    Exemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/2000003508419013/discounts

    Resposta:

    {
          "details": [
              {
                  "type": "coupon",
                  "coupon": {
                      "id": 569290732
                  },
                  "supplier": {
                      "meli_campaign": "P-MLA4944001"
                  },
                  "items": [
                      {
                          "quantity": 1,
                          "amounts": {
                              "total": 446.7,
                              "seller": 0
                          },
                          "id": "MLA922971037"
                      }
                  ]
              },
              {
                  "type": "discount",
                  "supplier": {
                      "offer_id": "MLA922971037-abc123",
                      "funding_mode": "sale_fee"
                  },
                  "items": [
                      {
                          "quantity": 1,
                          "amounts": {
                              "total": 446.7,
                              "seller": 0
                          },
                          "id": "MLA922971037"
                      }
                  ]
              },
              {
                  "type": "cashback",
                  "items": [
                      {
                          "element_id": 1,
                          "quantity": 1,
                          "id": "MLB1881365644",
                          "amounts": {
                              "total": 5.4,
                              "seller": 0
                          }
                      }
                  ],
                  "supplier": {
                      "campaign_id": "10116144"
                  },
                  "cashback": {
                      "id": "2251800174114906"
                  },
                  "counter_currency": {
                      "currency_id": "MCN",
                      "value": 15.6784541
                  }
              }
          ]
      }

    Campos da resposta

    Cada desconto pode ter os seguintes campos dentro do atributo details, dependendo do type:

    • coupon.id: identificador do cupom.
    • supplier: provedor da campanha.
      • meli_campaign: campanha de descontos associada ao cupom.
      • offer_id: identificador da oferta, útil para recuperar o nome da campanha.
      • funding_mode: tipo de promoção obtida pela IPA. Por exemplo, sale_fee.
    • ítems: itens aos que aplicam o cupom.
      • id: identificador do item.
      • quantity: quantidade de itens alcançados pelo desconto.
      • amounts: valores de cupom.
        • total: porção do desconto associado ao item (p * q).
        • seller: porção do desconto por conta do vendedor (p * q).
    Nota:
    • Tenha em mente que o recurso /orders/$id/discounts inclui apenas descontos aplicados ao preço (excluindo taxas adicionais e reembolsos posteriores), cupons e cashbacks.

    Consultar orders

    Você pode usar a funcionalidade /search do recurso /orders para realizar buscas filtradas. Note que search não realiza nenhuma ação se não é seguido por um filtro.


    Lembre-se que os pedidos criados são salvos por até 12 meses e se você pesquisar como vendedor, continuará a filtrar os pedidos cancelados.


    Chamada:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search


    Filtrar orders

    Para filtrar seus pedidos com o status de contas "paid" com os seguintes filtros:

    item: ID o título
    tags: pode haver vários estados separados por ','
    tags.not: pode haver vários estados separados por ','
    q: é um campo genérico que permite pesquisar por:

    • ID da order
    • ID do item
    • título do item
    • nickname da contraparte

    order.status: pode haver vários estados separados por ','
    order.date_last_updated.from : data da última modificação da order
    order.date_last_updated.to: data da última modificação da order
    order.date_created.from
    order.date_created.to
    order.date_closed.from
    order.date_closed.to
    mediations.stage: pode haver vários estados separados por ','
    mediations.status: pode haver vários estados separados por ','
    feedback.status: pode haver vários estados separados por ','
    feedback.sale.rating: pode haver vários estados separados por ','
    feedback.sale.fulfilled
    feedback.purchase.rating: pode haver vários estados separados por ','
    feedback.purchase.fulfilled

    Nota:
    O filtro "q" não considera os valores first_name, last_name e email ao pesquisar uma orden.

    Exemplo para filtrar pedidos por status:

    curl  -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?seller=$SELLER_ID&order.status=paid

    Exemplo para pesquisar por vários critérios:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?seller=89660613&q=2032217210

    Exemplo para filtrar pedidos por data:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'  https://api.mercadolibre.com/orders/search?seller=$SELLER_ID&order.date_created.from=2015-07-01T00:00:00.000-00:00&order.date_created.to=2015-07-31T00:00:00.000-00:00
    Nota:
    Usa até a hora e descarta a informação dos minutos, segundos e milissegundos.

    Exemplo de resposta:

    {
    	"query": "2032217210",
    	"results": [{
    		"seller": {
    			"nickname": "VENDASDKMB",
    			"id": 239432672
    		},
    		"payments": [{
    			"reason": "Kit Com 03 Adesivo Spray 3m 75 Cola Silk Sublimação 300g",
    			"status_code": null,
    			"total_paid_amount": 129.95,
    			"operation_type": "regular_payment",
    			"transaction_amount": 129.95,
    			"date_approved": "2019-05-22T03:51:07.000-04:00",
    			"collector": {
    				"id": 239432672
    			},
    			"coupon_id": null,
    			"installments": 1,
    			"authorization_code": "008877",
    			"taxes_amount": 0,
    			"id": 4792155710,
    			"date_last_modified": "2019-05-22T03:51:07.000-04:00",
    			"coupon_amount": 0,
    			"available_actions": [
    				"refund"
    			],
    			"shipping_cost": 0,
    			"installment_amount": 129.95,
    			"date_created": "2019-05-22T03:51:05.000-04:00",
    			"activation_uri": null,
    			"overpaid_amount": 0,
    			"card_id": 203453778,
    			"status_detail": "accredited",
    			"issuer_id": "24",
    			"payment_method_id": "master",
    			"payment_type": "credit_card",
    			"deferred_period": null,
    			"atm_transfer_reference": {
    				"transaction_id": "135292",
    				"company_id": null
    			},
    			"site_id": "MLB",
    			"payer_id": 89660613,
    			"marketplace_fee": 14.290000000000001,
    			"order_id": 2000003508419013,
    			"currency_id": "BRL",
    			"status": "approved",
    			"transaction_order_id": null
    		}],
    		"fulfilled": true,
    		"buying_mode": "buy_equals_pay",
    		"taxes": {
    			"amount": null,
    			"currency_id": null
    		},
    		"order_request": {
    			"change": null,
    			"return": null
    		},
    		"feedback": {
    			"sale": null,
    			"purchase": null
    		},
    		"shipping": {
    			"id": 27968238880
    		},
    		"date_closed": "2019-05-22T03:51:07.000-04:00",
    		"id": 2032217210,
    		"manufacturing_ending_date": null,
    		"hidden_for_seller": false,
    		"order_items": [{
    			"item": {
    				"seller_custom_field": null,
    				"condition": "new",
    				"category_id": "MLB33383",
    				"variation_id": null,
    				"variation_attributes": [],
    				"seller_sku": null,
    				"warranty": "Garantia de 1 ano fabricante",
    				"id": "MLB1054990648",
    				"title": "Kit Com 03 Adesivo Spray 3m 75 Cola Silk Sublimação 300g"
    			},
    			"quantity": 1,
    			"differential_pricing_id": null,
    			"sale_fee": 14.29,
    			"listing_type_id": "gold_special",
    			"base_currency_id": null,
    			"unit_price": 129.95,
    			"base_exchange_rate": null,
    			"currency_id": "BRL",
    			"manufacturing_days": null
    		}],
    		"date_last_updated": "2020-02-14T02:55:49.811Z",
    		"last_updated": "2019-05-28T15:16:04.000-04:00",
    		"comments": null,
    		"pack_id": null,
    		"shipping_cost": 0,
    		"date_created": "2019-05-22T03:51:05.000-04:00",
    		"pickup_id": null,
    		"status_detail": null,
    		"tags": [
    			"delivered",
    			"paid"
    		],
    		"buyer": {
    			"id": 89660613
    		},
    		"total_amount": 129.95,
    		"paid_amount": 129.95,
    		"mediations": [],
    		"currency_id": "BRL",
    		"status": "paid"
    	}],
    	"sort": {
    		"id": "date_asc",
    		"name": "Date ascending"
    	},
    	"available_sorts": [{
    		"id": "date_desc",
    		"name": "Date descending"
    	}],
    	"filters": [],
    	"paging": {
    		"total": 1,
    		"offset": 0,
    		"limit": 50
    	},
    	"display": "complete"
    }


    Ordenar uma order

    Neste caso, você deve adicionar "sort" com o ID disponível da ordem que quiser aplicar, por exemplo: “date_desc”

    curl  -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?seller={seller_id}&order.status=paid&sort=date_desc
    
    Notas:
    Por default, uma ordem date_asc já vem aplicada. A data segundo a qual é organizada é:
    - Sellers por date_closed.
    - Buyers por date_created.

    Status da order

    Os status da order são:
    confirmed Status inicial de uma order; ainda sem ter sido paga.
    payment_required O pagamento da order deve ter sido confirmado para exibir as informações do usuário.
    payment_in_process Há um pagamento relacionado à order, mais ainda não foi aprovado.
    partially_paid A order tem um pagamento associado creditado, porém, insuficiente.
    paid A order tem um pagamento associado aprovado.
    partially_refunded A order tem devoluções paciais de seus pagamentos.
    pending_cancel Quando a order foi cancelada mas temos dificultdade para devolver o pagamento.
    cancelled Por alguma razão, a order não foi completada.*
    invalid A order foi invalidada por vir de um comprador malicioso.

    Notas:
    Uma order pode ser cancelada pelos seguintes motivos:
    - Requeria aprovação do pagamento para descontar do estoque, mas, no tempo de processo de aprovação, o item foi pausado/finalizado por falta de estoque, portanto, o pagamento é retornado ao comprador.
    - Requeria pagamento, mas, após certo tempo, não foi paga, por isso é automaticamente cancelada.
    - Após uma transação ter sido efetuada, o vendedor é proibido no site por alguma razão.
    - Se por alguma razão o vendedor qualificar a operação como não concretizada, a order assume o "status = confirmed". Caso exista um pagamento aprovado, este será automaticamente devolvido. Lembre que uma order não concretizada pelo vendedor será visualizada como "Cancelada" por front e por api terá "status = confirmed".


    Referência de códigos de erro

    Error_code Mensagem de erro Descrição Possível solução
    order_not_found Pedido não encontrado. $order_id incorreto. O pedido não foi encontrado; verifique se o order_id é o correto.
    empty_order_id O ID do pedido deve ser preenchido, ele não pode ficar incompleto. $order_id nulo. O parâmetro order_id não pode ser nulo; consulte a URL utilizada.
    invalid_order_id ID do pedido inválido. $order_id incorreto. O parâmetro order_id deve ser um número inteiro. (Para buscar seus pedidos, consulte esse assunto).
    not_identified_user Usuário não identificado. Usuário não identificado. Enviar seu token.
    not_owned_order O usuário não pode acessar ao pedido. $seller ou $buyer incorreto. Para visualizar um pedido, seu token de acesso deve ser gerado a partir do vendedor ou do comprador.
    caller.id.invalid El caller.id no coincide con el comprador ni el vendedor. $seller o $buyer incorrectos. Para ver uma order, deve utilizar um ID do vendedor ou do comprador.
    feedback_not_found O feedback não existe. Erro de resposta. Verifique se existe feeedback para dar uma resposta.
    invalid_fulfilled O parâmetro "concluído"deve ser verdadeiro ou falso. Erro ao enviar feedback. Consulte o parâmetro $fulfilled; ele deve ser booleano (elimine as aspas) e verifique se o parâmetro $reason não é nulo, em caso de $fulfilled: falso.
    reply_time_expired Tempo de resposta expirado. Há um período de 14 dias para responder ao feedback. Erro ao dar resposta sobre o feedback. A resposta pode ser enviada durante os 14 dias posteriores à data do feedback.
    reply_already_exists Já existe resposta para o feedback. Erro ao dar resposta sobre o feedback. O feedback só aceita uma resposta.

    Referências de código de resposta HTTP

    Orders começarão a devolver o código http 206 quando não for possível obter algum dado. Tenha em conta que na maioria dos casos a informação recebida será suficiente para que você possa seguir trabalhando.
    No header de resposta X-Content-Missing estarão disponibilizados os nomes dos campos que podem não conter informações. São eles: "location", "geolocation" e/ou "seller_address".

    Chamada:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID

    Resposta:

    < HTTP/1.1 206 Partial Content> X-Content-Missing: buyer, feedback
    {
      "id": 768570754,
      "status": "paid",
      "status_detail": null,
      "date_created": "2013-05-27T10:01:50.000-04:00",
      "date_closed": "2013-05-27T10:04:07.000-04:00",
      "order_items": - [
      - {
        "item": - {
          "id": "MLB12345678",
          "title": "Samsung Galaxy",
          "variation_id": null,
          "variation_attributes": [
          ],
        },
        "quantity": 1,
        "unit_price": 499,
        "currency_id": "BRL",
      },
      ],
      "total_amount": 499,
      "currency_id": "BRL",
      "buyer": - { },
      },
      "seller": - {
      "id": "123456789",
      },
      "payments": - [
      - {
        "id": "596707837",
        "transaction_amount": 499,
        "currency_id": "BRL",
        "status": "approved",
        "date_created": null,
        "date_last_modified": null,
      },
      ],
      "feedback": - { },
      "shipping": - {
      "id": 20676482441
      
      },
      "tags": - [
      "paid",
      "not_delivered",
      ],
    }
    


    Seguinte:
    Orders de carrinho