YOM puede delegar en el sistema del cliente la aprobación de nuevos comercios. Cuando un vendedor completa en la aplicación de YOM el formulario de alta de un comercio, YOM envía una solicitud HTTP POST al endpoint del cliente con las respuestas del formulario. El cliente responde si aprueba, rechaza u observa la solicitud y, si la aprueba, entrega los datos con los que se crea el Comercio en YOM.
<aside> 📝
El cliente debe exponer el endpoint e informar a YOM su URL completa. El formulario de alta (preguntas y opciones) se configura junto con YOM durante la implementación.
</aside>
approved → el comercio se crea en YOM con los datos entregados y queda disponible para tomar pedidos.rejected → la solicitud se rechaza y el comercio no se crea.observations → la solicitud requiere correcciones; el vendedor las ve en la aplicación, corrige y vuelve a enviar.pending → la solicitud quedó recibida y en revisión en el sistema del cliente.pending se cierra cuando el comercio llega a YOM a través de la carga habitual de Comercios.POST <url_informada_por_el_cliente>
Encabezados que envía YOM
Content-Type: application/jsonx-auth-token: {identificador del cliente en YOM}origin: legacy.youorder.meCuerpo de la solicitud
{
"commerceRequest": { ... }
}
La solicitud de creación de comercio.
| Campo | Tipo | Carácter | Descripción | Ejemplos |
|---|---|---|---|---|
_id |
🆔 ObjectId | 🟢 Requerido | Identificador de la solicitud en YOM. Se recomienda usarlo como clave de idempotencia. | "66fd1a2b3c4d5e6f7a8b9c0d" |
domain |
📝 Texto | 🟢 Requerido | Dominio del cliente al que pertenece la solicitud. | "cliente.youorder.me" |
status |
📝 Texto | 🟢 Requerido | Estado de la solicitud al momento del envío. | "pending" |
form |
🔡 Lista de Objetos → FormAnswer | 🟢 Requerido | Respuestas del formulario de alta. Ver detalle abajo. | |
tempId |
📝 Texto | ⚪ Opcional | Identificador temporal de la solicitud generado por la aplicación. Se mantiene si el vendedor reenvía la solicitud. | "lead-9f3a1c" |
requestNum |
🔢 Número | ⚪ Opcional | Número correlativo de la solicitud. | 783 |
externalSellerId |
📝 Texto | ⚪ Opcional | Código del Vendedor que creó la solicitud en el sistema del cliente. | "V015" |
source |
📝 Objeto | ⚪ Opcional | Origen de la solicitud: sourceType (por ejemplo "seller") y sourceExternalId (código del vendedor). |
{"sourceType": "seller", "sourceExternalId": "V015"} |
createdBy |
📝 Texto | ⚪ Opcional | Usuario que creó la solicitud. | "[email protected]" |
createdAt |
📅 Fecha | 🟢 Requerido | Fecha de creación de la solicitud en formato ISO 8601. | "2026-10-02T14:32:00.000Z" |
Cada elemento de commerceRequest.form. Las preguntas dependen del formulario configurado para el cliente.