Enlazar a un comercio dentro de su portal
Las direcciones web estables del portal del comercio a las que una integración, un correo o un agente de IA puede enviar al dueño de una tienda, y las reglas que las acompañan.
A veces la respuesta correcta para un comercio no es una llamada a la API sino una página: "abre tu horario", "revisa esta aprobación", "agrega tu primer producto". Cada pantalla del portal del comercio tiene una dirección web que nombra exactamente esa pantalla, así que puedes enviar al dueño de una tienda directo a ella desde tu propia app, un correo, un mensaje de chat o la respuesta de un agente de IA.
La forma de un enlace
https://www.ryde.us.com/merchant/{store-id}/{screen}/{object-id}?{view-state}
https://www.ryde.us.com/merchant/64b7f0c2a1e4d5f6a7b8c9d0/settings/hours
https://www.ryde.us.com/merchant/64b7f0c2a1e4d5f6a7b8c9d0/menu/new
https://www.ryde.us.com/merchant/64b7f0c2a1e4d5f6a7b8c9d0/money/day?date=2026-10-03- {store-id} es el id de cuenta de la tienda, de 24 caracteres hexadecimales: el mismo id que aparece en la página pública de la tienda, /stores/{store-id}. Nunca un nombre ni un slug.
- La ruta nombra un OBJETO: una pantalla y, opcionalmente, un registro de esa pantalla. new es un id como cualquier otro y significa "el formulario para agregar".
- La consulta (query) nombra el ESTADO DE LA VISTA: una pestaña, un filtro, un carril, una búsqueda, una fecha. Elige lo que se muestra; nunca cambia ni concede nada.
Destinos en los que puedes confiar
| Ruta después de /merchant/{store-id} | Abre |
|---|---|
| (none) | El inicio de la tienda: las ventas de hoy y el interruptor Abierto. |
| /orders | La cola de pedidos. ?lane= elige un carril en el diseño de teléfono (new, accepted, preparing, ready, out, done, problem). |
| /orders/{order-id} | Un pedido. |
| /menu | El catálogo. |
| /menu/new · /menu?add=1 | El formulario Agregar producto. Las dos formas funcionan. |
| /menu/{product-id} | El editor de ese producto. |
| /inventory | El inventario. ?filter=all muestra todos los productos en lugar de los que necesitan atención. |
| /settings/{section} | Una sección de la configuración de la tienda: status, photos, details, notifications, cash-drawer, taxes, e-cf, table-service, video, payments, waiver, location, service-area, hours, ryde-one. |
| /money/{tab} | Dinero: earnings, reports, transactions, payouts, cash, shifts, day. /money/day?date=AAAA-MM-DD abre el cierre de ese día de la tienda. |
| /staff · /staff/new | La lista del equipo y el formulario Agregar empleado. |
| /approvals/{request-id} | Una solicitud de aprobación que espera al propietario. |
| /integrations/{key} | El panel de un conector. |
| /accounting · /accounting/reports | El inicio de Contabilidad y sus reportes, cuando Contabilidad está activada para la tienda. |
| /payroll · /payroll/employees · /payroll/run | El inicio de Nómina, los empleados y las corridas de nómina, cuando Nómina está activada para la tienda. |
| /verification | La verificación de contacto y del acuerdo. |
Un id que el portal no encuentra nunca es una página en blanco: el comercio llega a la lista de esa pantalla con un aviso breve.
Las reglas
- Un enlace no es una API. Abre una página para una persona; no realiza ninguna acción, y nada en él es un contrato para que un programa lo llame. Para cambiar datos, usa las operaciones de la referencia de la API.
- Un enlace no lleva credenciales. Nunca pongas en él un token, un código ni una contraseña. Si el comercio no ha iniciado sesión, inicia sesión primero y llega a la misma página.
- El portal vuelve a comprobar los permisos cada vez. Un enlace solo abre lo que la persona con la sesión iniciada puede ver: un empleado que entró con su PIN ve solo lo que su rol permite, y las páginas de Contabilidad o Nómina solo se abren donde ese producto está activado.
- Los nombres de la consulta son estado de la vista. Pueden ganar valores con el tiempo; un valor desconocido vuelve a la vista por defecto de la pantalla en lugar de fallar.
- Son direcciones web. En un teléfono abren el portal web en el navegador; no son enlaces directos a la app móvil de Ryde.
No adivines una ruta que no esté en esta página. Dentro del portal, el menú y su buscador no forman parte de la dirección a propósito: qué sección del menú está abierta y lo que se escribió en "Buscar en el menú" nunca están en un enlace.