> ## Documentation Index > Fetch the complete documentation index at: https://docs.maple.inc/llms.txt > Use this file to discover all available pages before exploring further. # Toast a través de StreamOrders > Para locales de Toast conectados a través de StreamOrders > [!NOTE] > > Esta página cubre los locales de Toast conectados a través de StreamOrders. Los locales nuevos se conectan directamente a Toast: vea [Toast](https://docs.maple.inc/es/orders/pos/toast.md). Conecte Maple con su sistema POS (punto de venta) Toast a través de StreamOrders, el servicio de retransmisión de pedidos de Maple. Los pedidos tomados por teléfono o SMS aparecen en su sistema Toast. > [!NOTE] > > Los pagos con tarjeta se procesan a través de Stripe y requieren verificación del negocio (KYC). Stripe define cuánto tarda la revisión, y algunos negocios esperan unos días. ## Requisitos previos Antes de comenzar, asegúrese de contar con lo siguiente: - ✅ Acceso de administrador a Toast - ✅ Un plan Maple Pro, que incluye pedidos por teléfono e integraciones con POS - ✅ Documentación del negocio para KYC - ✅ Información de la cuenta bancaria - ✅ Un local de Toast que pueda conectar a StreamOrders - ✅ **Toast Restaurant Management Suite** en su cuenta de Toast (necesario para las integraciones) - ✅ Una computadora con navegador web (la configuración no se puede hacer solo desde un teléfono) ## Proceso de configuración 1. ### Inicie la verificación KYC Envíe los documentos de verificación del negocio 2. ### Conecte a través de StreamOrders Abra StreamOrders desde el panel de Maple y vincule su local de Toast 3. ### Seleccione los locales Elija qué locales conectar en StreamOrders 4. ### Configure los pagos Defina los métodos de pago y las reglas 5. ### Pruebe la integración Haga pedidos de prueba para verificar la configuración ## Paso 1: verificación KYC ### Documentos requeridos - Registro del negocio (LLC, Corp, etc.) - Carta del EIN o del número de identificación fiscal - Identificación oficial con fotografía del propietario - Estado de cuenta bancario o cheque anulado - Comprobante de la dirección del negocio > [!WARNING] > > Stripe define cuánto tarda la revisión KYC, y algunos negocios esperan unos días. Comience con anticipación para evitar retrasos. ### Enviar los documentos 1. Haga clic en **Orders** en la barra lateral y continúe con el paso **Payment Processing** 2. Elija el país donde está registrado su negocio y luego inicie **Verify Your Business Entity** 3. Cargue los documentos requeridos 4. Complete la información del propietario 5. Envíe para revisión ## Paso 2: conectar Toast a través de StreamOrders Toast se conecta a través de StreamOrders. Puede conectarlo usted mismo con los pasos siguientes o pedir al equipo de Maple que lo configure por usted (consulte [Pida a Maple que configure Toast por usted](#pida-a-maple-que-configure-toast-por-usted)). 1. Haga clic en **Orders** en la barra lateral y continúe con el paso **Select POS** (o abra la configuración del local y vaya a **Integrations**) 2. Seleccione **Toast (via StreamOrders)** y haga clic en **Continue with Toast (via StreamOrders)** 3. Si se le pide, ingrese el nombre completo y un número de contacto del propietario del comercio (su celular personal, no el número del local) y haga clic en **Save & Continue** 4. Haga clic en **Open StreamOrders** 5. En StreamOrders, autorice a Maple, conecte su local de Toast y elija qué locales conectar 6. Regrese al panel de Maple y haga clic en **I completed this step** > [!TIP] > > Necesita permisos de administrador de Toast para conectar Toast en StreamOrders. Comuníquese con el administrador de Toast si no tiene acceso. ### Pida a Maple que configure Toast por usted Agregue a Maple como empleado en Toast y el equipo de Maple terminará la conexión, normalmente en aproximadamente un día hábil. 1. En el panel de Toast, haga clic en **Employees** y luego en **Add New Employee**. 2. Ingrese **First Name** `Maple`, **Last Name** `Onboarding` y **Email** `onboarding@maple.inc` (exactamente). Use cualquier **POS Access Code** que no use otro empleado y elija un puesto no remunerado, sin tarifa de pago, para que Maple no entre en su nómina. 3. Haga clic en **Add**, actualice la página, haga clic en el ícono de edición junto a **Maple Onboarding** y abra **Jobs and Permissions**. 4. Active los permisos **4.5** y **4.14** (menú), **6.2** (Web Setup: Publishing), **6.3** y **6.4** (informes), **6.6** (impresoras) y **8.4**, y haga clic en **Save**. Los números de Toast pueden variar, así que revise la lista completa. 5. Avise a su especialista de incorporación que agregó al empleado. Maple solo recibe estos permisos, no sus datos financieros ni de nómina. ## Paso 3: configurar los locales ### Un solo local 1. Su local se completará automáticamente 2. Verifique que la información sea correcta 3. Active el procesamiento de pedidos 4. Defina los tiempos de preparación predeterminados ### Varios locales 1. Se mostrarán todos los locales 2. Active o desactive cada local 3. Configure los ajustes de cada local: - Tiempos de preparación - Métodos de pago - Zonas de entrega (si aplica) - Horario de atención ## Paso 4: sincronización del menú Su menú de Toast se sincroniza con Maple automáticamente a través de StreamOrders: ### Qué se sincroniza automáticamente - ✅ Todos los artículos del menú y sus precios - ✅ Modificadores y opciones - ✅ Categorías y organización - ✅ Artículos marcados como agotados (86) - ✅ Cambios de precio - ✅ Horarios de disponibilidad - ✅ Horarios del menú - Los artículos ocultos de Toast no se sincronizan ### Tiempos de sincronización - Los cambios en el menú, incluidos los artículos agotados (86), normalmente llegan a Maple en menos de 5 minutos, a menudo antes, según StreamOrders los transmita - Para enviar un cambio de inmediato, [resincronice en StreamOrders](#resincronizar-en-streamorders) > [!NOTE] > > Los cambios en el menú deben hacerse en Toast. Los cambios se sincronizan con Maple automáticamente. ### Elegir qué se sincroniza No necesita sincronizar todos sus menús de Toast ni subir un archivo de menú. Dígale a su especialista de incorporación los nombres exactos de los menús que quiere sincronizar: - **Incluya** los menús para pedidos por teléfono y para recoger (por ejemplo, Food, Beverages o un menú de Online Ordering). Un solo menú de Online Ordering con todos los artículos relevantes puede sincronizarse por sí solo. - **Excluya** los menús creados para plataformas de terceros (como un menú solo para Grubhub), los menús internos (como Crew Takeout) y las categorías que no quiera que se pidan por teléfono (como Liquor). Maple respeta la **Channel Visibility** de Toast a nivel de menú, categoría y artículo. Lo que esté oculto para **Online Ordering Partners** no se sincroniza y no se puede pedir por teléfono. Para cambiarlo, en **Menu Builder** haga clic en el menú **⋯** junto al menú, la categoría o el artículo, elija **Edit**, ajuste **Online Ordering Partners** en **Channel Visibility** y luego haga clic en **Save** y **Publish**. Ocultar es útil para especiales del día, bebidas alcohólicas y artículos solo para el local. Maple también respeta las reglas de pedidos programados configuradas en Toast. ### Resincronizar en StreamOrders Los locales en StreamOrders no tienen el botón **Resync Menu** en la página **Menus** de Maple. Para resincronizar de inmediato: 1. En **Menu Builder** de Toast, haga clic en **Save** y **Publish** para sus cambios. 2. En Maple, abra la configuración de su local, vaya a **Integrations** y haga clic en **Open StreamOrders**. 3. Haga clic en el ícono azul de actualizar junto al logotipo de Toast y luego en **Publish** (o en la marca de verificación verde). Si StreamOrders no se abre, pida al soporte de Maple que resincronice por usted. > [!WARNING] > > Los cambios hechos en Maple, como nombres de artículos, descripciones u horarios del menú, se sobrescriben en la siguiente sincronización. Haga los cambios permanentes en Toast. El horario del local es la excepción: configúrelo tanto en Toast como en **My Location** en Maple. ### Consejos de menú para Toast - Agregue descripciones detalladas en Toast (ingredientes, tamaños como “pizza personal de 10 pulgadas”, datos dietéticos). La IA las usa para responder preguntas. - Agregue grafías y pronunciaciones alternativas en la descripción de los artículos con nombres poco comunes (por ejemplo, “Thanduri Chicken”) para que la IA reconozca lo que dicen las personas que llaman. - Un grupo de modificadores con un mínimo de **1** en Toast es obligatorio, y la IA lo pregunta. Con un mínimo de **0** es opcional: la IA no lo pregunta, pero lo agrega si la persona que llama lo menciona. ## Paso 5: configuración de pagos ### Métodos de pago Configure qué tipos de pago aceptar: - **Tarjetas de crédito/débito**: Se pagan mediante el enlace de pago seguro de Maple, que se envía al cliente por SMS y es procesado por su proveedor de pagos de Maple (Stripe de forma predeterminada). El cliente paga antes de que el pedido se envíe a Toast. - **Pago en el local**: Pedidos para recoger, si está activado. Los pedidos a domicilio pueden pagarse al recibirlos solo cuando los entregan sus propios repartidores. - **Tarjetas de regalo**: No compatible - **Cuentas de la casa**: No compatible > [!NOTE] > > Esta integración no usa Toast Hosted Checkout, y los pagos con tarjeta no se liquidan en su cuenta de Toast. Vea [Métodos de pago](https://docs.maple.inc/es/orders/config/payment-methods.md) para saber cómo funcionan los enlaces de pago de Maple. ### Reglas de pago Defina cuándo pagan los clientes: | Tipo de pedido | Opciones de pago | | -------------------------- | ---------------------------------------------------------------------------------- | | **A domicilio** | Pago por adelantado; pago al recibir solo cuando entregan sus propios repartidores | | **Para recoger** | Pagar ahora o pagar en el local | | **Para comer en el local** | No aplica | > [!WARNING] > > **El pago al recibir requiere que el efectivo esté activado en StreamOrders.** Para los pedidos con pago al recibir (pago en el local) que se envían a Toast a través de StreamOrders, debe activar **cash** (efectivo) como método de pago aceptado para entregas a domicilio en StreamOrders. De lo contrario, Toast rechaza el pedido (`decision_failed` / “payment method declined”) y nunca llega a la cocina. Vea [StreamOrders: accepted payment methods](https://help.streamorders.com/en/articles/13441016). ## Paso 6: ajustes del flujo de pedidos ### Tiempos de preparación Defina tiempos de preparación realistas según el tipo de pedido: - Pedidos para recoger: predeterminado de 15 a 20 minutos - Pedidos a domicilio: predeterminado de 30 a 45 minutos - Pedidos grandes: ajuste automático ### Confirmación del pedido Configure los ajustes de confirmación: - Active la lectura del pedido al cliente - Defina el método de confirmación (número o correo electrónico) - Configure el envío de recibos ### Solicitudes especiales Defina cómo manejar: - Avisos de alergias - Preparaciones especiales - Modificaciones personalizadas - Notas para la cocina ## Paso 7: pruebas Antes de salir en vivo, pruebe a fondo: ### Lista de verificación de pruebas 1. **Haga un pedido de prueba** - Llame a su número de Maple - Pida algunos artículos con modificaciones - Verifique que el pedido aparezca en Toast 2. **Revise los detalles del pedido** - Artículos y cantidades correctos - Modificaciones registradas - Precios exactos - Pago procesado correctamente 3. **Pruebe casos límite** - Artículos agotados (86) manejados correctamente - Pedidos grandes - Solicitudes especiales - Distintos métodos de pago > [!TIP] > > Use el modo de capacitación de Toast para hacer pruebas sin afectar el inventario ni los reportes reales. ## Salir en vivo ### Lista de verificación de lanzamiento - ✅ El personal está capacitado para los pedidos nuevos que aparecen - ✅ La cocina sabe de los pedidos de Maple - ✅ El número de teléfono está actualizado en el sitio web y en Google - ✅ Los pedidos de prueba fueron exitosos - ✅ El procesamiento de pagos está verificado ### Estrategia de lanzamiento gradual 1. Comience con un horario limitado 2. Supervise de cerca los primeros pedidos 3. Reúna los comentarios del personal 4. Ajuste la configuración según sea necesario 5. Amplíe al horario completo ## Administrar pedidos ### En Toast POS Los pedidos de Maple aparecen como: - Pedidos estándar de Toast, enviados a través de StreamOrders - Todas las funciones normales de Toast están disponibles - Los reportes incluyen los pedidos de Maple ### Desconectar Toast - Toast se conecta a través de StreamOrders, así que desconecte Toast en StreamOrders - Los problemas con la conexión entre StreamOrders y Toast también se resuelven en StreamOrders, no en Maple ### En el panel de Maple Vea y administre: - Grabaciones y transcripciones de llamadas - Historial de pedidos - Motivos de los pedidos fallidos - Información de los clientes - Métricas de rendimiento ## Problemas comunes y soluciones **Los artículos del menú no aparecen** - Verifique que los artículos estén activos en Toast - Revise los ajustes de visibilidad del menú - Revise la **Channel Visibility**: el artículo puede estar oculto para **Online Ordering Partners** - Asegúrese de haber hecho clic en **Save** y en **Publish** en Toast, y luego [resincronice en StreamOrders](#resincronizar-en-streamorders) - Espere hasta 5 minutos para la sincronización - Comuníquese con soporte si persiste **La IA no reconoce un artículo por su nombre** Agregue nombres alternativos y grafías fonéticas a la descripción del artículo en Toast y luego resincronice. **Open StreamOrders no abre una pestaña** Conéctese desde Toast: en Toast, vaya a **Integrations** → **Browse and Purchase Integrations**, busque **Stream** (no “Maple”), haga clic en **Add** y otorgue acceso de empleado. Haga clic en el ícono de engranaje de la integración de Stream, copie el **Merchant ID** (también llamado Venue ID) y envíelo a su especialista de incorporación o al [soporte de Maple](https://docs.maple.inc/es/need-help.md) para terminar de vincular su local. **No encuentra Integrations en Toast** Busque “integrations” en el cuadro de búsqueda de Toast, o en **General Settings** → **Integrations**. Si sigue sin aparecer, verifique que su cuenta de Toast tenga **Restaurant Management Suite**. Después de comprarlo, actualice la página y revise su correo de confirmación; el cambio puede tardar un momento en aparecer. **Los pedidos no aparecen en Toast** - Verifique que la integración esté activa - Revise que Toast esté en línea - Confirme que el local esté seleccionado - Revise los registros de errores en el panel **Fallas en los pagos** - Verifique los ajustes de pago - Revise la conexión con el procesador - Revise los motivos de rechazo - Confirme los datos de la tarjeta del cliente **Se muestran precios incorrectos** - Actualice los precios en Toast - Espere la sincronización (hasta 5 minutos) o resincronice en StreamOrders - Revise si hay promociones activas - Verifique los niveles de precio ## Funciones avanzadas ### Centros de ingresos - No se utilizan - Los pedidos se registran mediante la opción de consumo (dining option) configurada para recoger o a domicilio ### Lealtad - No compatible - Las tarjetas guardadas no son compatibles ### Pedidos de catering Para pedidos grandes o con anticipación: - Tiempos de preparación más largos - Requisitos de depósito - Instrucciones especiales - Pedidos programados ## Mejores prácticas > [!TIP] > > **Optimización del menú**: Mantenga los nombres de los artículos claros y fáciles de pronunciar para los pedidos por voz. > [!TIP] > > **Administración de modificadores**: Limite los modificadores a las opciones esenciales para reducir la complejidad. > [!TIP] > > **Pruebas periódicas**: Haga pedidos de prueba cada mes para asegurarse de que todo funcione sin problemas. ## Recursos de soporte - **Soporte de Toast**: Para problemas específicos del POS - **Soporte de Maple**: - **Estado de la integración**: Revise el panel para ver el estado en tiempo real - **Documentación**: [Toast API Docs](https://doc.toasttab.com) ## Próximos pasos - [Configurar pagos](https://docs.maple.inc/es/orders/config/payment-methods.md): Configure el procesamiento de pagos - [Ajustes de entrega](https://docs.maple.inc/es/orders/config/delivery.md): Configure las zonas de entrega - [Administración del menú](https://docs.maple.inc/es/orders/config/menu-management.md): Administre su menú - [Salir en vivo](https://docs.maple.inc/es/going-live.md): Lance el servicio a sus clientes