Recursos para IA
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
string
OBRIGATÓRIO
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
shipment_id
string
OBRIGATÓRIO
Shipment ID do pedido.
Body
status
string
Este campo indica o status do pedido, que deve ter o valor "canceled" para este endpoint.
cancellation_reason
object
Motivo do cancelamento que foi recuperado do endpoint de motivos de cancelamento.
Response parameters
status
string
Status of the order after its cancellation. The Status value that will be returned is "canceled".
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"
}