Gerenciamento de Orders de Carrinho

Importante:
O carrinho de compras está disponível na Argentina, Brasil, México, Chile, Colômbia e Uruguai.

Com o carrinho de compras, os compradores podem tirar mais proveito do frete. Quando eles estiverem visitando suas publicações, nós recomendaremos seus outros produtos para eles adicionarem ao carrinho. Se comprarem vários produtos de você, os compradores podem obter frete grátis ou descontos no frete.


Consultar o pack_id

Com a estrutura atual do JSON de Orders, as informações de envio não estão mais disponíveis, estará apenas a identificação e, então, as informações adicionais devem ser procuradas no recurso /shipments.Pode-se obter o ID do pacote desde o campo “pack_id”em orders.

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/2053577644

Resposta:

{
    "id": 2053577644,
    "date_created": "2019-06-13T09:20:02.000-04:00",
    "date_closed": "2019-06-13T09:20:08.000-04:00",
    "last_updated": "2019-06-13T09:20:08.000-04:00",
    "manufacturing_ending_date": null,
    "feedback": {
        "sale": null,
        "purchase": null
    },
    "mediations": [],
    "comments": null,
    "pack_id": 2000000101334825,
    "pickup_id": null,
    "order_request": {
        "return": null,
        "change": null
    },
    "fulfilled": null,
    "total_amount": 9.99,
    "paid_amount": 9.99,
    "coupon": {
        "id": null,
        "amount": 0
    },
    "expiration_date": "2019-07-11T09:20:08.000-04:00",
    "order_items": [
        
            "item": {
                "id": "MLB1226730704",
                "title": "Produto Teste - Não Ofertar",
                "category_id": "MLB11742",
                "variation_id": null,
                "seller_custom_field": null,
                "variation_attributes": [],
                "warranty": "12 months",
                "condition": "new",
                "seller_sku": null
            },
            "quantity": 1,
            "unit_price": 9.99,
            "full_unit_price": 9.99,
            "currency_id": "BRL",
            "manufacturing_days": null
        
    ],
    "currency_id": "BRL",
    "payments": [
        
            "id": 4863317779,
            "order_id": 2053577644,
            "payer_id": 419067349,
            "collector": {
                "id": 419059118
            },
            "card_id": null,
            "site_id": "MLB",
            "reason": "Produto Teste - Não Ofertar",
            "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": 9.99,
            "taxes_amount": 0,
            "shipping_cost": 0,
            "coupon_amount": 0,
            "overpaid_amount": 0,
            "total_paid_amount": 9.99,
            "installment_amount": null,
            "deferred_period": null,
            "date_approved": "2019-06-13T09:20:07.000-04:00",
            "authorization_code": null,
            "transaction_order_id": null,
            "date_created": "2019-06-13T09:20:07.000-04:00",
            "date_last_modified": "2019-06-13T09:20:07.000-04:00"
        
    ],
    "shipping": {
        "id": 27987243797
    },
    "status": "paid",
    "status_detail": null,
    "tags": [
        "test_order",
        "pack_order",
        "paid"
    ],
    "buyer": {
        "id": 419067349,
        "nickname": "TT763866",
        "email": "ttest.6hqmq6+2-ogiydkmzvg43tmobx@mail.mercadolivre.com",        },
        "first_name": "Test",
        "last_name": "Test",
        "billing_info": {
            "doc_type": "CPF",
            "doc_number": "78525276200"
        
    },
    "seller": {
        "id": 419059118,
        "nickname": "TETE8288849",
        "email": "ttest.hpz2z6q+2-ogiydkmzvg43tmobs@mail.mercadolivre.com",
        "phone": {
            "area_code": "01",
            "extension": "",
            "number": "1111-1111",
            "verified": false
        },
        "alternative_phone": {
            "area_code": "",
            "extension": "",
            "number": ""
        },
        "first_name": "Test",
        "last_name": "Test"
    },
    "taxes": {
        "amount": null,
        "currency_id": null
    
}

A resposta não retorna o campo total_amount_with_shipping que deve ser calculado. Para entender a que se refere cada um dos parâmetros, faça a seguinte chamada:

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

Cálculo do total_amount_with_shipping

Veja como calcular o valor total com frete em /orders.


Considerações

  • A tag "pack_order" é gerada automaticamente para poder discriminar se a ordem é associada a um carrinho e não poderá ser removida pelo comprador nem pelo vendedor.
  • O campo "pack_id" mostra o número do pacote ao qual a ordem pertence.
  • Caso a ordem não esteja associada a um Carrinho de Compras e a transação seja sob a modalidade "combinar com o vendedor", você não receberá mais o status to be agreed, mas o shipping ID virá diretamente como null. Isso indicará que você deve entrar em contato com o comprador para combinar a forma de envio.
  • Você só terá a ID do envio, e terá que procurar as informações nos novos recursos de Shipping. (As orders que possui o mesmo ID de envio e "pack_id" pertencem ao mesmo carrinho de compras)
  • Existe a possibilidade de que, ainda existindo uma ordem, o envio demore a ser criado. Nesses casos, a ID será nula até sua criação. Quando isso acontecer, você será notificado.
  • As tags “delivered/not delivered” não serão mais adicionadas automaticamente. Somente existirá a marca caso o integrador realize um PUT com a tag definida.
  • As orders em status paid serão canceladas se o pagamento for rejeitado ou devolvido. Caso isso aconteça, você receberá uma notificação para poder conhecer a alteração no status da ordem.
Importante:
A Ordem continuará mostrando o campo "seller_custom_field", mas apresentará a informação de SKU.
1- SELLER_SKU de atributos de variação
2- seller_custom_field de variação
3- SELLER_SKU de atributos de item
4- seller_custom_field de item.

Consulta de vendas de um carrinho

Com este recurso poderá recuperar todas as vendas de um mesmo pacote (pack_id) que corresponda ao vendedor da consulta (owner do token).

Chamada:

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

Exemplo:

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

Resposta:

{
   "id": 2000003508553677,
   "status": "released",
   "status_detail": null,
   "date_created": "2022-04-08T17:00:48.000-0400",
   "last_updated": "2022-04-08T17:02:07.000-0400",
   "family_pack_id": null,
   "buyer": {
       "id": 266272126
   },
   "shipment": {
       "id": 41297142475
   },
   "orders": [
       {
           "id": 2000003508897196
       },
       {
           "id": 2000003508911076
       }
   ]
}

Campos da resposta

ID: identificador do pacote.

status: status do pacote.

  • filling: a venda está paga e o pacote criado, começa a criação de orders y envio.
  • filled: já estão criadas as orders e envios do pacote.
  • released: tudo está pago, orders e envio, é o status mais visto.
  • status_detail: detalhe dos estados, mostra o motivo de um cancelamento.

    family_pack_id: cuando un pack se divide se generan nuevos packs. Un pack ‘hijo’ guarda en este campo el ID del pack ‘padre’.



    Conoce más sobre Gerenciar orders.


    Seguinte: Envios.

banner footer

Inscreva-se em nosso Newsletter

ou registre-se para receber as últimas notícias sobre nossa API