YOM Docs

Creación de comercios

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>

Flujo


  1. El vendedor completa el formulario de alta en la aplicación de YOM.
  2. YOM envía la solicitud al endpoint del cliente.
  3. El cliente responde con el estado de la solicitud:
  4. Una solicitud en pending se cierra cuando el comercio llega a YOM a través de la carga habitual de Comercios.

Endpoint


POST <url_informada_por_el_cliente>

Encabezados que envía YOM

Cuerpo de la solicitud

{
  "commerceRequest": { ... }
}

Campos


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"

FormAnswer

Cada elemento de commerceRequest.form. Las preguntas dependen del formulario configurado para el cliente.