Errores

Los errores se devuelven con el código HTTP correspondiente y un cuerpo JSON uniforme:

{
  "error": {
    "code": "not_found",
    "message": "No existe un pedido con ese id para este restaurante"
  }
}

HTTP	`code`	Cuándo
400	`invalid_request`	Parámetro faltante o con formato inválido
401	`unauthorized`	API key ausente, mal formada o revocada
403	`forbidden`	La llave no tiene el permiso de escritura que exige el endpoint
404	`not_found`	El recurso no existe o pertenece a otro restaurante
409	`location_closed`	No se pueden crear pedidos con la sucursal cerrada
409	`location_inactive`	La sucursal está desactivada en el panel
409	`insufficient_stock`	Un producto del pedido no tiene stock suficiente (el mensaje detalla cuál)
409	`illegal_transition`	El cambio de estado no sigue el flujo de cocina
409	`managed_by_integrator`	El pedido lo gestiona una integración POS (Toteat/Justo/Rockeat)
409	`state_conflict`	El pedido cambió de estado entre tu lectura y tu escritura; vuelve a consultarlo
409/503	`payment_unavailable`	No se pudo iniciar el pago online (ej: Fintoc no habilitado); el pedido queda cancelado
429	`rate_limited`	Se excedió el límite de peticiones; ver header `Retry-After`
500	`internal_error`	Error nuestro; reintenta con backoff

Un recurso de otro restaurante responde 404, no 403: la API no revela la existencia de datos ajenos.