YOM can delegate minimum order validation to the customer's system. When a commerce or a seller confirms an order, YOM sends an HTTP POST request to the customer's endpoint with the details of the Commerce and the Order. The customer responds whether or not the order meets the minimum, and optionally what the required minimum amount is.
<aside> 📝
The customer only needs to expose the endpoint at the standard path and tell YOM its domain. No other configuration is required.
</aside>
POST <tu_dominio>/webhooks/yom/order/calculate-minimum-total
Headers YOM sends
Content-Type: application/jsonx-auth-token: {identificador del cliente en YOM}origin: legacy.youorder.meRequest body
{
"commerce": { ... },
"order": { ... }
}
The order entity.
| Field | Type | Requirement | Description | Examples |
|---|---|---|---|---|
_id |
🆔 ObjectId | 🟢 Required | Order identifier in YOM. | |
| *\It is not stable in the call that precedes confirmation. | "6712fa9b8c1d2e3f40567890" |
|||
domain |
📝 Text | 🟢 Required | Domain of the customer the order belongs to. | "cliente.youorder.me" |
status |
📝 Text | 🟢 Required | Order status at the time of validation. | "pending" |
type |
📝 Text | 🟢 Required | Order type. | |
"order" → order |
||||
"quote" → quote |
"order" |
|||
shippingAddress |
📝 Object | 🟢 Required | Delivery address for the order. | |
products |
🔡 List of Objects → OrderProduct | 🟢 Required | Order line items. See details below. | |
pricing |
📝 Object → OrderPricing | 🟢 Required | Order totals. See details below. | |
commerceId |
📝 Text | ⚪ Optional | Commerce identifier in YOM. | "65f0a1b2c3d4e5f601234567" |
commerceName |
📝 Text | ⚪ Optional | Commerce name. | "Almacén Doña Rosa" |
externalId |
📝 Text | ⚪ Optional | Commerce code in the customer's system. | "CLI-004512" |
sellerId |
🔡 List of Texts | ⚪ Optional | Identifiers of the Seller(s) associated with the order. | ["186"] |
externalSellerIds |
🔡 List of Texts | ⚪ Optional | Seller codes in the customer's system. | ["V-0186"] |
receiptType |
📝 Text | ⚪ Optional | Type of document requested. | |
"boleta" · "factura" · "none" (default) |
"factura" |
|||
orderDate |
📅 Date | ⚪ Optional | Order creation date in ISO 8601 format. | "2026-08-10T14:22:05.113Z" |
distributionCenterId |
🆔 ObjectId | ⚪ Optional | Distribution center associated with the order. | "650a1b2c3d4e5f6a7b8c9d99" |
distributionCenterName |
📝 Text | ⚪ Optional | Distribution center name. | "CD Santiago" |
coupon |
📝 Object | ⚪ Optional | Coupon applied to the order. | |
sellerDiscounts |
🔡 List of Objects | ⚪ Optional | Discounts applied by the Seller. | |
observation |
📝 Text | ⚪ Optional | Order observation. | "Entregar por la mañana" |
Each order.products line item.
| --- | --- | --- | --- | --- |
The order.pricing object.
| --- | --- | --- | --- | --- |
The commerce entity.