Instância de retrocompatibilidade e novas notificações

Iniciado o trabalho da primeira fase de implantação da nova funcionalidade de Carrinho de Compras, haverá uma instância de retrocompatibilidade que permitirá usar os novos recursos e também os já existentes.
Isto permitirá implantar as mudanças de maneira progressiva sem gerar interrupções nem afetar a disponibilidade da integração.
Leve em conta que os novos recursos não só serão aplicáveis para Carrinho de Compras, mas também serão a nova modalidade para orders e shipments em geral. Isso quer dizer que, caso você trabalhe com outros sites que não tenham essa modalidade, também perceberá o impacto.

Conteúdo:

Funcionamento de retrocompatibilidade

Como na fase de Beta Testing existirá a possibilidade de trabalhar simultaneamente com todos os recursos disponíveis, você deverá implementar o seguinte header cada vez que fizer uma request para a API, a fim de poder consumir os novos recursos adaptados ao Carrinho de Compras:

curl -H "x-format-new:true" https://api.mercadolibre.com/orders/{Order_id}?access_token=ACCESS_TOKEN

Nota: Caso você queira obter o formato anterior, não terá que enviar a linha “x-format-new: true”.

Novas notificações

Com a nova funcionalidade de Carrinho de Compras, será possível trabalhar com duas notificações novas, que você deverá ativar dentro do Application Manager:
orders_v2: Você receberá a novidade quando uma nova ordem for criada ou quando o json for alterado em uma ordem já existente.
shipments: Você receberá a novidade quando um novo envio for criado ou houver uma atualização em um já existente.

Nota: Lembre que se você decidir trabalhar com “orders_v2” sem anular os anteriores “created_orders” e/ou “orders”, começará a receber a mesma novidade de uma ordem replicada em cada um deles. Sugerimos que, ao começar a ouvir os novos topics, descarte os velhos relacionados a ordens, a fim de simplificar o processo.
Se quiser saber mais sobre o funcionamento de todos os topics disponíveis, pode consultar este tutorial.

Acesse os detalhes

Após receber uma notificação sobre um topic, você deverá realizar a request para o recurso respectivo para acessar os detalhes e conferir se é uma operação nova ou tem que atualizar uma já existente no seu sistema.

orders_v2

Notification response:

{
    "resource": "/orders/139876",
    "user_id": 1234,
    "topic": "orders_v2",
    "received": "2011-10-19T16:38:34.425Z",
    "sent" : "2011-10-19T16:40:34.425Z",
}

Com essas informações, você poderá realizar um GET para o recurso de orders:

curl -H "x-format-new:true" https://api.mercadolibre.com/orders/{Order_id}?access_token=ACCESS_TOKEN

shipments

Notification response:

{
    "resource": "/shipments/139876",
    "user_id": 1234,
    "topic": "shipments",
    "received": "2011-10-19T16:38:34.425Z",
    "sent" : "2011-10-19T16:40:34.425Z",
}

Com essas informações, você poderá realizar um GET para o recurso de shipments:

curl -H "x-format-new:true" https://api.mercadolibre.com/shipments/{shipment_id}?access_token=ACCESS_TOKEN

Nota: Para trabalhar com as novas notificações, você terá que desativar as que usava anteriormente para orders. Lembre que se você quer ouvir todas as notificações, em alguns casos, vai recebê-las mais de uma vez.

Seguinte: Gerenciamento de Ordens.

Qualifique entre 1 e 5