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

# Configuración de entregas a domicilio

> Configure zonas de entrega, tarifas y proveedores para su restaurante

Maple admite pedidos a domicilio con una configuración flexible de zonas, tarifas y administración de repartidores. Puede usar una red de proveedores de servicio de entrega (DSP) de terceros, su propia flota de repartidores (BYOF) o una combinación de ambas.

## Modos de entrega

<Tabs>
  <Tab title="Maple Fleet (DSP)" icon="truck">
    Maple Fleet conecta su restaurante con una red de proveedores de servicio de entrega (DSP), entre ellos DoorDash Drive y Uber Direct. Maple se encarga automáticamente de la asignación de repartidores, el seguimiento y las actualizaciones de estado.

    **Cómo funciona:**

    * El cliente hace un pedido a domicilio a través de Maple
    * Maple solicita una cotización de entrega a la red de DSP
    * Se asigna un repartidor y se le envía a su restaurante
    * El cliente recibe actualizaciones de estado en tiempo real por SMS
    * Las tarifas de entrega y las propinas se manejan a través de Maple

    **Ideal para:** Restaurantes sin repartidores propios, o como capacidad adicional en horas pico.
  </Tab>

  <Tab title="Bring Your Own Fleet (BYOF)" icon="user-group">
    Use a sus propios repartidores. Maple se encarga de tomar el pedido y envía los detalles de entrega a su equipo.

    **Cómo funciona:**

    * El cliente hace un pedido a domicilio a través de Maple
    * El pedido se envía a su POS con los detalles de entrega
    * Su equipo administra la asignación y el despacho de repartidores
    * Usted define sus propias zonas de entrega y tarifas

    **Opciones de configuración:**

    * Establezca una tarifa de entrega predeterminada para todos los pedidos BYOF
    * Defina zonas de entrega para controlar su área de cobertura
    * Opcionalmente, acepte propinas en los pedidos a domicilio

    **Ideal para:** Restaurantes con personal de reparto propio que quieren seguir usando a sus repartidores.
  </Tab>

  <Tab title="Híbrido" icon="arrows-split-up-and-left">
    Combine BYOF para entregas cercanas con la red de DSP para pedidos a mayor distancia o de capacidad adicional.

    **Cómo funciona:**

    * Defina zonas BYOF para las áreas que cubren sus repartidores
    * Los pedidos fuera de sus zonas BYOF se enrutan automáticamente a la red de DSP
    * Respaldo sin interrupciones cuando su flota no está disponible

    **Ideal para:** Restaurantes que quieren manejar internamente las entregas cercanas y, a la vez, ampliar su radio de entrega.
  </Tab>
</Tabs>

## Configuración de la entrega a domicilio

<Steps>
  <Step title="Active la entrega a domicilio">
    Vaya a la configuración de entregas en su panel de Maple y seleccione su modelo de entrega (Maple Fleet o BYOF).
  </Step>

  <Step title="Configure las zonas de entrega">
    Defina las áreas geográficas en las que ofrece entrega a domicilio. Puede crear zonas de polígono (formas
    personalizadas) o zonas de círculo (basadas en un radio).
  </Step>

  <Step title="Establezca tarifas y mínimos">
    Configure las tarifas de entrega, los montos mínimos de pedido y los tiempos estimados de entrega de cada zona.
  </Step>

  <Step title="Pruebe la entrega">
    Haga un pedido de prueba a domicilio para verificar la cobertura de zonas, el cálculo de tarifas y el enrutamiento del pedido.
  </Step>
</Steps>

## Zonas de entrega

Las zonas de entrega definen hasta dónde puede entregar su restaurante. Cada zona tiene su propia tarifa, monto mínimo de pedido y tiempo estimado de entrega.

### Tipos de zona

| Tipo de zona | Descripción | Ideal para |
| - | - | - |
| **Polygon** | Forma dibujada a mano en un mapa | Áreas de cobertura precisas, límites de la ciudad |
| **Circle** | Zona basada en un radio alrededor de su local | Configuraciones simples, cobertura uniforme en todas direcciones |

**Las zonas de polígono** le permiten dibujar un límite libre en el mapa. Úselas cuando su área de entrega siga calles, autopistas u otros límites irregulares.

**Las zonas de círculo** definen un radio (en millas) con centro en la ubicación de su local. El sistema genera el límite automáticamente; solo debe indicar la distancia. Son útiles cuando quiere una cobertura uniforme en todas direcciones.

<Info>
  Ambos tipos de zona funcionan igual durante el pedido. Cuando un cliente indica una dirección de entrega, Maple
  verifica si está dentro del límite de la zona. En las zonas de círculo, el límite es una aproximación del radio que
  usted establece.
</Info>

### Configuración de la zona

Para cada zona de entrega, configure lo siguiente:

| Configuración | Descripción |
| - | - |
| **Delivery fee** | Tarifa fija que se cobra al cliente por la entrega |
| **Minimum order** | Los pedidos por debajo de este monto no se pueden hacer a domicilio |
| **Estimated time** | Tiempo estimado de entrega que se muestra a los clientes al hacer el pedido |
| **Zone priority** | Cuando las zonas se superponen, prevalecen las de mayor prioridad |

<Info>
  Puede crear varias zonas con distintas tarifas y mínimos. Por ejemplo, una tarifa menor para las áreas cercanas y una
  tarifa mayor para las zonas más lejanas.
</Info>

## Instrucciones de recogida

Si usa la red Maple Fleet (DSP), puede dar instrucciones de recogida a los repartidores. Estas instrucciones le indican al repartidor dónde y cómo recoger el pedido en su restaurante.

Vaya a la configuración de entregas de su local e ingrese las instrucciones de recogida en el área de texto. Ejemplos:

* "Enter through the side door on Oak Street"
* "Ask for the online order at the front counter"
* "Ring the buzzer and say you're picking up a delivery order"

## Pago de los pedidos a domicilio

<Warning>
  Los pedidos a domicilio requieren pago con tarjeta por adelantado, excepto cuando los entregan sus propios
  repartidores: en ese caso el cliente puede pagar al recibir, en los sistemas POS que admiten pago en el local. Las
  entregas de Maple Fleet siempre requieren pago con tarjeta por adelantado.
</Warning>

El pago de los pedidos a domicilio se procesa a través de su proveedor de pagos configurado (Stripe, Gravity o Shift4) antes de enviar el pedido a su POS. La tarifa de entrega se suma automáticamente al total del pedido según la dirección de entrega del cliente y la configuración de sus zonas.

<Warning>
  **Locales de Toast en StreamOrders: el pago al recibir requiere que el efectivo esté habilitado en StreamOrders.** Si
  acepta pedidos con pago al recibir (pago en el local) enviados a Toast a través de StreamOrders, debe habilitar el
  **efectivo** (cash) como método de pago aceptado para entregas en StreamOrders. De lo contrario, Toast rechaza el
  pedido (`decision_failed` / "payment method declined") y nunca llega a la cocina. Consulte [StreamOrders: accepted
  payment methods](https://help.streamorders.com/en/articles/13441016).
</Warning>

### Facturación de la tarifa de entrega

La forma en que se liquida la tarifa de entrega depende de su procesador de pagos:

* **Comercios con Stripe:** Maple cobra la tarifa de entrega directamente.
* **Comercios sin Stripe:** La tarifa de entrega se agrega como una partida en el pedido, de modo que usted la cobra en la caja y Maple se la factura después. Es un traspaso neto cero, no un cargo adicional.

## Flujo del pedido a domicilio

<Steps>
  <Step title="El cliente hace el pedido">
    El cliente llama o envía un mensaje de texto a Maple y solicita entrega a domicilio. La IA recopila su dirección de entrega.
  </Step>

  <Step title="Validación de la dirección">
    Maple verifica si la dirección está dentro de sus zonas de entrega y calcula la tarifa de entrega.
  </Step>

  <Step title="Confirmación del pedido">
    La IA confirma con el cliente el pedido, la tarifa de entrega y el tiempo estimado de entrega.
  </Step>

  <Step title="Procesamiento del pago">El cliente paga por adelantado con tarjeta. La tarifa de entrega está incluida en el total.</Step>
  <Step title="Pedido enviado a la cocina">El pedido se envía a su sistema POS para su preparación.</Step>

  <Step title="Despacho del repartidor">
    En los pedidos de Maple Fleet, se asigna y despacha un repartidor automáticamente. En BYOF, su equipo se encarga del despacho.
  </Step>

  <Step title="Actualizaciones de estado">
    El cliente recibe actualizaciones por SMS a medida que avanza la entrega (repartidor asignado, pedido recogido, en camino, entregado).
  </Step>
</Steps>

## Solución de problemas

<AccordionGroup>
  <Accordion title="La entrega a domicilio no está disponible para la dirección de un cliente">
    Es posible que la dirección del cliente esté fuera de sus zonas de entrega configuradas. Revise los límites de sus
    zonas en el panel y amplíelos si es necesario. La IA informará al cliente y le ofrecerá recoger el pedido como alternativa.
  </Accordion>

  <Accordion title="La tarifa de entrega se muestra de forma incorrecta">
    Verifique la configuración de tarifas de cada zona de entrega. Si las zonas se superponen, se usa la tarifa de la zona de mayor prioridad.
  </Accordion>

  <Accordion title="A los pedidos de Maple Fleet no se les asigna un repartidor">
    Asegúrese de que la configuración de Maple Fleet esté completa y de que el territorio de entrega esté configurado
    para su zona. Durante los períodos de alta demanda, la disponibilidad de repartidores puede ser limitada. Comuníquese
    con el soporte de Maple si la asignación falla de forma constante.
  </Accordion>
</AccordionGroup>

## Acceso anticipado

¿Le interesa la entrega con Maple Fleet? Estamos trabajando con socios seleccionados.

<Card title="Solicitar acceso a Maple Fleet" icon="truck" href="mailto:aidan@maple.inc?subject=%5BCOMPANY%20NAME%5D%20-%20Maple%20Delivery%20Early%20Access">
  Escríbanos para comenzar con la entrega de Maple Fleet
</Card>

## Siguientes 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="Administración del menú" icon="utensils" href="/es/orders/config/menu-management">
    Administre su menú
  </Card>

  <Card title="Resumen de pedidos" icon="cart-shopping" href="/es/orders/overview">
    Volver al resumen de pedidos
  </Card>

  <Card title="Salir en vivo" icon="badge-check" href="/es/going-live">
    Ponga en marcha su IA de Maple
  </Card>
</CardGroup>


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