Cancelar pedidohttps://api.mercadopago.com/proximity-integration/shipments/{shipment_id}/cancel
Este 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
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
Path
shipment_id
Shipment ID do pedido.string
OBRIGATÓRIO
Body
status
Este campo indica o status do pedido, que deve ter o valor "canceled" para este endpoint.string
cancellation_reason
Motivo do cancelamento que foi recuperado do endpoint de motivos de cancelamento.object
Response parameters
status
Status of the order after its cancellation. The Status value that will be returned is "canceled".string
Erros
400Erro
400
Conflict-error - This order cannot be canceled due to its current status.
401Erro
401
Unauthorized - Access Token is invalid
403Erro
403
Forbidden - User cannot access this resource
424Erro
424
Not Found - Failed to get some information of the order
500Erro
500
Internal server error
Request
curl -X PUT \
'https://api.mercadopago.com/proximity-integration/shipments/{shipment_id}/cancel'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-d '{
"status": "canceled",
"cancellation_reason": {
"id": "CS7452",
"value": "out_of_stock",
"message": "Me falta alguno de los productos."
}
}'Response
{
"status": "canceled"
}