Cambiar el estado de un pedido

Descripción

Le cambia el estado a un pedido

Método: updateOrderStatus
Parámetros:
- orderId: ID del pedido
- orderStatus: El nuevo estado del pedido. Puede ser: delivering, done o cancelled
- reasonMessage: Texto de explicación de la cancelación. Lo verá el cliente y será considerado solo si orderStatus es cancelled. Si no está definido, su valor por defecto será: El pedido fue cancelado por el local.. Opcional
- category: Categoría del rechazo. Si no está definido, su valor por defecto será API. Usado para categorizar las devoluciones a clientes y será considerado solo si orderStatus es cancelled. Opcional
- reason: Razón del rechazo. Solo uso interno, no será expuesto al cliente. Si no está definido, su valor por defecto será Rejected by integration through API. Usado para categorizar las devoluciones a clientes y será considerado solo si orderStatus es cancelled. Opcional
Respuesta:
- Order: El pedido Order

NOTA 1: Si se cancela un pedido, el sistema generará una devolución automatica siempre y cuando el medio de pago lo permita. Los pedidos con entrega en el local o con pago en efectivo no generan devoluciones.

NOTA 2: Se podrán ver los campos reason, reasonMessage y category en el objeto cancellationInfo de los pedidos cancelados, tanto para aquellos que no generen devoluciones, como para aquellos pedidos cancelados que si generen devoluciones.

NOTA 3: Se podrán ver los campos amount, reason, reasonMessage y category de los pedidos cancelados con devoluciones en la lista devolutions

NOTA 4: Si se cancela un pedido, este NO debe tener despachos activos. Si esto ocurre la petición será rechazada con el siguiente error:

{
    "status": "error",
    "error": "El pedido no se puede cancelar porque esta activo"
}

Ejemplo

Llamada

POST /api/v1/updateOrderStatus Content-Type: application/json

{
  "orderId": "xabAso2p3pKkLMTuz",
  "orderStatus": "delivering"
}

Respuesta

{
  "status": "ok",
  "data": {
    <Order>
  }
}