> ## 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

<Info>
  Esta página cubre los locales de Toast conectados a través de StreamOrders. Los locales nuevos se conectan directamente a Toast: vea
  [Toast](/es/orders/pos/toast).
</Info>

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.

<Info>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.</Info>

## 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

## Proceso de configuración

<Steps>
  <Step title="Inicie la verificación KYC">Envíe los documentos de verificación del negocio</Step>
  <Step title="Conecte a través de StreamOrders">Abra StreamOrders desde el panel de Maple y vincule su local de Toast</Step>
  <Step title="Seleccione los locales">Elija qué locales conectar en StreamOrders</Step>
  <Step title="Configure los pagos">Defina los métodos de pago y las reglas</Step>
  <Step title="Pruebe la integración">Haga pedidos de prueba para verificar la configuración</Step>
</Steps>

## 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.</Warning>

### Enviar los documentos

1. Vaya a **Orders Module** → **Setup**
2. Haga clic en **Start KYC Verification**
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. Maple no inicia sesión en Toast directamente.

1. Vaya a **Orders Module** → **POS Integration**
2. Seleccione **Toast** entre las opciones
3. Haga clic en **Open StreamOrders**
4. En StreamOrders, autorice a Maple, conecte su local de Toast y elija qué locales conectar
5. 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.
</Tip>

## 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

* Cambios en el menú: normalmente de 5 a 10 minutos, según StreamOrders los transmita
* Artículos agotados (86): normalmente más rápido, en cuestión de minutos

<Note>Los cambios en el menú deben hacerse en Toast. Los cambios se sincronizan con Maple automáticamente.</Note>

## 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](/es/orders/config/payment-methods) para saber cómo funcionan los enlaces de pago de Maple.
</Note>

### 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).
</Warning>

## 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.</Tip>

## 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

<AccordionGroup>
  <Accordion title="Los artículos del menú no aparecen">
    * Verifique que los artículos estén activos en Toast - Revise los ajustes de visibilidad del menú - Espere de 5 a 10
      minutos para la sincronización - Comuníquese con soporte si persiste
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="Se muestran precios incorrectos">
    * Actualice los precios en Toast - Espere la sincronización (de 5 a 10 minutos) - Revise si hay promociones activas
    * Verifique los niveles de precio
  </Accordion>
</AccordionGroup>

## 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>

<Tip>**Administración de modificadores**: Limite los modificadores a las opciones esenciales para reducir la complejidad.</Tip>

<Tip>**Pruebas periódicas**: Haga pedidos de prueba cada mes para asegurarse de que todo funcione sin problemas.</Tip>

## Recursos de soporte

* **Soporte de Toast**: Para problemas específicos del POS
* **Soporte de Maple**: [hello@maple.inc](mailto:hello@maple.inc)
* **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

<CardGroup cols={2}>
  <Card title="Configurar pagos" icon="credit-card" href="/es/orders/config/payment-methods">
    Configure el procesamiento de pagos
  </Card>

  <Card title="Ajustes de entrega" icon="truck" href="/es/orders/config/delivery">
    Configure las zonas de entrega
  </Card>

  <Card title="Administración del menú" icon="utensils" href="/es/orders/config/menu-management">
    Administre su menú
  </Card>

  <Card title="Salir en vivo" icon="rocket" href="/es/going-live">
    Lance el servicio a sus clientes
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.