Cancelar pedido/proximity-integration/shipments/{shipment_id}/cancelEste endpoint cancela um pedido, alterando seu status. Pode ser adicionado um motivo para o cancelamento, bastando apenas verificar se o motivo do cancelamento está disponível para o status atual.
PUT
Produtos relacionados:
Parâmetros de requisição
shipment_idstring
Localização: pathShipment ID do pedido.OBRIGATÓRIO
cancellation_reason
Localização: bodyMotivo do cancelamento que foi recuperado do endpoint de motivos de cancelamento.object
status
Localização: bodyEste campo indica o status do pedido, que deve ter o valor "cancelled" para este endpoint.string
Parâmetros de resposta
status
Localização: bodyStatus of the order after its cancellation. The Status value that will be returned is "cancelled".string
Solicitação
curl
curl -X PUT \
'https://api.mercadopago.com/proximity-integration/shipments/{shipment_id}/cancel' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"status": "cancelled",
"cancellation_reason": {
"id": "CS7452",
"value": "out_of_stock",
"message": "Me falta alguno de los productos."
}
}'
Resposta
json
{
"status": "cancelled"
}
Erros
400bad_request
400
401bad_request
401 Unauthorized - Access Token is invalid
403bad_request
403 Forbidden - User cannot access this resource
424bad_request
424 Not Found - Failed to get some information of the order
500bad_request
500 Internal server error