Custom orders
Usa Custom orders para configurar los ajustes numéricos que devuelve el plugin custom_order. Esta pantalla de ajustes es independiente de Orders → Create custom order y no envía un pedido.
Antes de empezar
En la interfaz documentada, la categoría aparece únicamente después de que Dashboard identifica que el plugin Custom Order está instalado para el proyecto. También se necesita el acceso de administrador requerido para la configuración global. Si falta la categoría, Dashboard puede redirigir al listado de plugins; ese síntoma por sí solo no permite determinar si la causa es la instalación, el acceso o la configuración devuelta.
El plugin proporciona su propio esquema. Los nombres y descripciones de campos, valores iniciales, tipos numéricos, unidades, monedas, validación y disponibilidad pueden variar por proyecto. Usa las etiquetas y valores que devuelve Dashboard en vez de considerar fijo el ejemplo histórico siguiente.
Configurar los ajustes numéricos devueltos
- Abre Settings y selecciona Custom orders cuando aparezca.
- Antes de cambiar un valor, revisa cada campo devuelto y su descripción.
- Introduce valores acordes con la protección operativa que quieres configurar.
- Selecciona Save y confirma el resultado devuelto antes de realizar otro cambio.
El ejemplo histórico de esquema devuelto contiene estas claves globales exclusivas para administradores:
- Maximum order weight (kg) (
max_weight) — Límite de peso de un pedido. - Delivery fee per km ($) (
delivery_fee_multiplier) — Valor de una tarifa basada en distancia. - Maximum delivery distance (km) (
max_distance) — Límite de distancia para la elegibilidad de entrega.
En la interfaz documentada, los campos numéricos indican un mínimo de 0. Los ajustes de números enteros usan un incremento de 1 y los decimales, uno de 0.01. Cuando no hay un valor editado, el marcador de posición muestra el valor devuelto por el plugin.
Comportamiento al guardar y validación
La acción Save documentada convierte cada valor local mostrado con parseFloat(value) || 0 y envía todos los ajustes mostrados juntos en una solicitud al endpoint de configuración del plugin. Por eso, un valor local vacío o no numérico puede enviarse como 0; no uses un campo vacío para indicar «sin límite». La validación del plugin, la persistencia y el resultado operativo son independientes del comportamiento local del campo.
Mientras la solicitud está pendiente, el formulario documentado se deshabilita. Un aviso de éxito o una respuesta de error solo informa del resultado local de la solicitud; por sí solo, no demuestra que haya cambiado un flujo de pedidos visible para clientes.
Cómo se relacionan estos ajustes con el flujo de pedidos
El flujo histórico describe a un cliente que inició sesión y usa la acción Custom order para indicar ubicaciones de recogida y entrega, instrucciones, una lista de artículos y un valor declarado. Presenta este flujo para solicitudes fuera de la entrega estándar, como recoger llaves olvidadas, comprar un artículo específico o hacer una entrega especial. También describe una tarifa basada en distancia, una vista de seguimiento y un flujo de gestión de pedidos donde un operador puede revisar la solicitud y asignar un conductor.
Esos comportamientos operativos son independientes. Esta página de ajustes no demuestra que una acción esté visible, se calcule una tarifa, haya un mapa o vista de seguimiento ni que se pueda asignar un pedido. Valida el flujo completo con Crear un pedido personalizado en un entorno de prueba aprobado.
El video puede mostrar una interfaz anterior; confirma los campos y resultados en el proyecto que operas.
Al guardar se envían juntos los ajustes del plugin que aparecen. Revisa todos los valores antes de guardar y no infieras un resultado de pedido, pago, ubicación, datos de cliente o proveedor a partir de la respuesta de configuración.
Guía relacionada: Crear un pedido personalizado