Actualizar un pedido
API operation: Open the endpoint in Scalar
Usa PUT /orders/{order} para actualizar un pedido. La operación pública actual es Order.update.put.
El parámetro de ruta de tipo entero es {order}.
La operación admite actualizaciones específicas por rol para administradores, administradores de negocio, repartidores, administradores de repartidores, clientes y empresas de repartidores autenticadas. Los campos aceptados y las transiciones de estado dependen del solicitante y de la configuración del proyecto; sigue el esquema de solicitud de la operación y la política de autorización aplicable.
Para una transición de aceptación con status=8, incluye external_driver_id y external_driver_name. Otras transiciones permitidas tienen sus propios requisitos. Trata la autenticación de una empresa de repartidores como una credencial y no la incluyas en ejemplos.
const response = await ordering.orders(orderId).save(changes);
Esta sintaxis de SDK es histórica. Confirma el paquete y la versión antes de usarla.
Referencia de OpenAPI
Operación: PUT /orders/{order}
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
order | integer | Sí | — |
Parámetros de encabezado
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
User-Agent | string | No | — |
X-Forwarded-For | string | No | — |
X-Internal-Product-X | string | No | — |
X-APP-X | string | No | — |
Campos del cuerpo de la solicitud
| Nombre | Tipo | Obligatorio |
|---|---|---|
business_id | integer | No |
comment | string | null | No |
customer | string | No |
customer_id | integer | No |
delivered_at | any | No |
delivered_in | integer | No |
delivery_datetime | string | No |
delivery_position | integer | null | No |
delivery_type | integer | No |
delivery_zone_id | integer | null | No |
delivery_zone_price | number | No |
driver_company_id | integer | null | No |
driver_id | integer | null | No |
driver_tip | number | No |
eta_drive_time | integer | No |
eta_time | integer | No |
external_driver_id | string | No |
external_driver_name | string | No |
external_driver_phone | any | No |
external_driver_photo | string | No |
external_id | string | No |
fraud_message | string | null | No |
fraud_status | string | null | No |
location | object | string | No |
manual_driver_assignment_comment | string | null | No |
meta_location | string | No |
mode | string | No |
offer_id | integer | No |
order_group_id | integer | null | No |
pay_data | string | No |
paymethod_id | integer | No |
prepared_in | integer | No |
priority | any | No |
products | string | No |
reasons | string | No |
refund_data | any | No |
reject_reason | string | No |
spot_number | number | No |
status | integer | string | No |
track_url | string | null | No |
vehicle | string | No |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta exitosa. El contenido de result varía según la operación y se devuelve como JSON. |
| 400 | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código. |
| 401 | Envelope de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error para el código declarado por la operación. Consulta result para ver los detalles disponibles. Envelope de error: el proyecto no existe o no tiene una suscripción activa. |
| 404 | Respuesta vacía: la versión de API solicitada no está admitida. |
| 429 | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key. |
| 500 | Respuesta de error para el código declarado por la operación. Consulta result para ver los detalles disponibles. Respuesta de error: falló la búsqueda o inicialización del proyecto. |
| 503 | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on_error = closed (cabecera Retry-After: 1). |