YOM puede delegar en el sistema del cliente la validación del pedido mínimo. Cuando un comercio o un vendedor confirma un pedido, YOM envía una solicitud HTTP POST al endpoint del cliente con el detalle del Commerce y del Order. El cliente responde si el pedido cumple o no con el mínimo, y opcionalmente cuál es el monto mínimo exigido.
<aside> 📝
El cliente solo debe exponer el endpoint en la ruta estándar e informar a YOM su dominio. No se requiere ninguna otra configuración.
</aside>
POST <tu_dominio>/webhooks/yom/order/calculate-minimum-total
Encabezados que envía YOM
Content-Type: application/jsonx-auth-token: {identificador del cliente en YOM}origin: legacy.youorder.meCuerpo de la solicitud
{
"commerce": { ... },
"order": { ... }
}
La entidad order.
| Campo | Tipo | Carácter | Descripción | Ejemplos |
|---|---|---|---|---|
_id |
🆔 ObjectId | 🟢 Requerido | Identificador del Pedido en YOM. | |
| *\No es estable en la llamada previa a la confirmación. | "6712fa9b8c1d2e3f40567890" |
|||
domain |
📝 Texto | 🟢 Requerido | Dominio del cliente al que pertenece el pedido. | "cliente.youorder.me" |
status |
📝 Texto | 🟢 Requerido | Estado del pedido al momento de la validación. | "pending" |
type |
📝 Texto | 🟢 Requerido | Tipo de pedido. | |
"order" → pedido |
||||
"quote" → cotización |
"order" |
|||
shippingAddress |
📝 Objeto | 🟢 Requerido | Dirección de despacho del pedido. | |
products |
🔡 Lista de Objetos → OrderProduct | 🟢 Requerido | Líneas del pedido. Ver detalle abajo. | |
pricing |
📝 Objeto → OrderPricing | 🟢 Requerido | Totales del pedido. Ver detalle abajo. | |
commerceId |
📝 Texto | ⚪ Opcional | Identificador del Comercio en YOM. | "65f0a1b2c3d4e5f601234567" |
commerceName |
📝 Texto | ⚪ Opcional | Nombre del Comercio. | "Almacén Doña Rosa" |
externalId |
📝 Texto | ⚪ Opcional | Código del Comercio en el sistema del cliente. | "CLI-004512" |
sellerId |
🔡 Lista de Textos | ⚪ Opcional | Identificadores del o los Vendedores asociados al pedido. | ["186"] |
externalSellerIds |
🔡 Lista de Textos | ⚪ Opcional | Códigos del Vendedor en el sistema del cliente. | ["V-0186"] |
receiptType |
📝 Texto | ⚪ Opcional | Tipo de documento solicitado. | |
"boleta" · "factura" · "none" (por defecto) |
"factura" |
|||
orderDate |
📅 Fecha | ⚪ Opcional | Fecha de creación del pedido en formato ISO 8601. | "2026-08-10T14:22:05.113Z" |
distributionCenterId |
🆔 ObjectId | ⚪ Opcional | Centro de distribución asociado al pedido. | "650a1b2c3d4e5f6a7b8c9d99" |
distributionCenterName |
📝 Texto | ⚪ Opcional | Nombre del Centro de distribución. | "CD Santiago" |
coupon |
📝 Objeto | ⚪ Opcional | Cupón aplicado al pedido. | |
sellerDiscounts |
🔡 Lista de Objetos | ⚪ Opcional | Descuentos aplicados por el Vendedor. | |
observation |
📝 Texto | ⚪ Opcional | Observación del pedido. | "Entregar por la mañana" |
Cada línea de order.products.
| --- | --- | --- | --- | --- |
El objeto order.pricing.
| --- | --- | --- | --- | --- |
La entidad commerce.