> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riqra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Envíos y cobertura

> Convierte la cobertura por localidad de Legacy en métodos de envío, zonas reutilizables, tarifas y plazos por zona.

En Riqra Legacy no configurabas los envíos desde el panel. La cobertura, los costos, los patrones de entrega y los tipos de envío se cargaban por ti a pedido, y cada cambio pasaba por soporte. La cobertura era la lista de localidades que atendías, cada una con su costo de envío y, a veces, su propio patrón de entrega. La tienda tenía un patrón propio, una hora máxima de pedido y un calendario de atención. Los tipos de envío se habilitaban para toda la tienda o solo para clientes específicos.

En la nueva plataforma administras todo esto tú, desde el panel.

La nueva plataforma reparte ese trabajo en cinco piezas. Las cuatro primeras viven en **[Configuración → Envío](https://app.riqra.com/settings/shipping/methods)**.

| Pieza                                                                | Qué resuelve                                                                                                                                             |
| -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Método de envío                                                      | Cómo llega el pedido: **Delivery**, **Recojo en local** o **Recojo en agencia**.                                                                         |
| Zona                                                                 | Un grupo de divisiones geográficas con nombre, reutilizable en varios métodos.                                                                           |
| Tarifa y plazo por zona                                              | Cuánto cuesta y en cuántas horas llega un pedido que cae en esa zona, definidos dentro de cada método.                                                   |
| Programación de entrega                                              | Días que reciben pedidos, días de entrega, hora de corte, horarios y días bloqueados.                                                                    |
| [Política comercial](/plataforma/politicas-comerciales/introduccion) | Qué métodos de envío ve cada grupo de clientes. Vive en **[Configuración → Políticas comerciales](https://app.riqra.com/settings/commercial-policies)**. |

El cliente ya no tiene tipos de envío asignados en su ficha. Ve los métodos activos que permite la política comercial que le corresponde: la de su segmento, la de su empresa o sucursal, o la predeterminada.

## En qué se convierte cada parte de la cobertura

| En Riqra Legacy                                   | En la nueva plataforma                                                                                                                                 |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Tipo de envío a domicilio                         | Método de tipo Delivery, con una ubicación de origen.                                                                                                  |
| Recojo en tienda                                  | Método de tipo Recojo en local. Cada tienda es una [ubicación](/plataforma/inventario/ubicaciones) agregada como punto de recojo.                      |
| Recojo en agencia o entrega con transportista     | Método de tipo Recojo en agencia, o couriers dentro de un método de delivery. **Flete por pagar** cubre el envío que el cliente paga al transportista. |
| Localidad atendida y su costo                     | La localidad es una división dentro de una zona. El costo se define en el método, por zona.                                                            |
| Etiqueta de la cobertura                          | Nombre de la zona.                                                                                                                                     |
| Patrón de entrega de la cobertura                 | Plazo de la zona, en horas, dentro del método.                                                                                                         |
| Patrón de entrega de la tienda                    | Plazo de las zonas que no tenían patrón propio.                                                                                                        |
| Patrón de entrega por cliente o territorio        | Todos los clientes de una zona reciben el mismo plazo.                                                                                                 |
| Patrón de recojo de cada tienda                   | **Recojo desde**, un solo valor por método de recojo.                                                                                                  |
| Costo por peso y localidad                        | Tarifa **Por kg** con tramos de peso, por zona.                                                                                                        |
| Otras fórmulas de costo                           | La zona se importa con costo fijo y ajustas la tarifa a mano.                                                                                          |
| Recargo porcentual                                | La localidad no se importa. Crea su zona y su tarifa a mano.                                                                                           |
| Hora máxima de pedido                             | **Pedidos hasta las**, en la programación de entrega.                                                                                                  |
| Días máximos para elegir fecha                    | **Días a mostrar**.                                                                                                                                    |
| Calendario de atención: atiende y entrega por día | **Días que reciben pedidos** y días de entrega, con hora de corte por día.                                                                             |
| Rangos horarios de entrega                        | Horarios de la programación. Si existían en Legacy, elegir uno es obligatorio en el checkout.                                                          |
| Fechas bloqueadas de entrega y de atención        | **Días bloqueados**: **Sin reparto** y **Cerrado**.                                                                                                    |
| Tipos de envío habilitados por cliente            | Métodos de envío permitidos por una política comercial.                                                                                                |
| Geocercas en KML                                  | No se migran. Puedes importar el KML a mano en **Áreas**; lee [Áreas en el mapa](#areas-en-el-mapa).                                                   |

<Note>
  La migración crea las zonas, el método de delivery, el método de recojo con sus puntos, los couriers y sus métodos, y los días bloqueados a partir de los datos de Legacy. La programación de entrega solo se crea si tu tienda pedía una fecha de entrega en el checkout. El equipo de migración te indicará qué datos no pudo convertir y necesitan que los completes a mano.
</Note>

## Cómo se arma la cobertura

En Legacy, cada localidad atendida llevaba su propio costo. En la nueva plataforma, las localidades con la misma tarifa y el mismo plazo forman una zona, y la zona se agrega al método con esa tarifa y ese plazo.

<Steps>
  <Step title="Revisa la ubicación de origen">
    Cada método de delivery despacha desde una [ubicación](/plataforma/inventario/ubicaciones) activa. La migración usa la ubicación predeterminada.
  </Step>

  <Step title="Revisa las zonas">
    Ve a **[Configuración → Envío → Zonas](https://app.riqra.com/settings/shipping/zones)**. Una zona agrupa divisiones geográficas de cualquier nivel. En Perú, un departamento, una provincia o un distrito; en Chile, una región o una comuna. Elegir un departamento cubre todos sus distritos.
  </Step>

  <Step title="Revisa la tarifa y el plazo de cada zona">
    Abre el método de delivery en **[Configuración → Envío → Métodos](https://app.riqra.com/settings/shipping/methods)**. Cada zona agregada al método tiene su tarifa (**Fijo**, **Por kg** o **Por tramo de peso**) y su plazo en horas. La misma zona puede tener otra tarifa en otro método.
  </Step>

  <Step title="Revisa la programación de entrega">
    En el mismo método, confirma los días que reciben pedidos, los días de entrega, la hora de corte, los horarios y **Días a mostrar**. Los días bloqueados se administran para toda la organización en **[Configuración → Envío → Días bloqueados](https://app.riqra.com/settings/shipping/blackouts)**.
  </Step>

  <Step title="Confirma que el método quedó activo">
    La migración activa los métodos que crea. Si en el panel un método aparece inactivo, le falta la ubicación de origen, una zona con al menos una división o un punto de recojo en una ubicación activa, y el método muestra el motivo. Corrígelo y actívalo.
  </Step>
</Steps>

Dentro de un método, dos zonas no pueden incluir la misma división. La cobertura de Legacy podía listar la misma localidad dos veces con nombres distintos, como Lima y Cercado de Lima. La migración conserva la tarifa de la división y, entre coberturas del mismo nivel, la más baja. Revisa la tarifa de esas localidades en la zona donde quedaron.

No hay una zona comodín. Cada zona enumera sus divisiones y una dirección fuera de todas las zonas no recibe ninguna opción de delivery. Para cubrir el resto del país, crea una zona con las regiones o departamentos que faltan.

## Tarifas

Cada zona dentro de un método tiene una de tres tarifas.

* **Fijo.** Gratis o un monto único. Equivale a la cobertura de Legacy con costo fijo por localidad.
* **Por kg.** Tramos de peso, cada uno con una tarifa por kilo. Es el mismo cálculo del costo por peso y localidad de Legacy.
* **Por tramo de peso.** Tramos de peso, cada uno con un monto único.

En las dos tarifas por peso, el tramo se elige con el peso exacto del pedido. Cada tramo cubre hasta un peso máximo y el último queda abierto. En **Por kg**, la tarifa se multiplica por el peso redondeado a kilos enteros. Un pedido de 7.5 kg usa el tramo de hasta 10 kg y paga 8 kilos. Un pedido menor a 0.5 kg paga 0.

El peso del pedido es la suma de cantidad por peso de cada variante. Si alguna variante del carrito no tiene peso, el método con tarifa por peso no se ofrece para ese carrito. Los métodos con tarifa fija y el recojo no se ven afectados. Completa el peso de tus variantes antes de publicar. Si tu tienda cobraba por peso, el equipo de migración te indicará cuántos productos publicados no lo tienen.

Un tramo siempre tiene un monto mayor a cero. Para una zona gratis, usa la tarifa Fijo sin monto. Una cobertura de Legacy podía tener una escalera de peso con tramos gratis y tramos con costo en la misma localidad. Esa combinación no cabe en una sola zona, así que la migración no la convierte. Crea su zona y sus tramos a mano.

### Reglas de costo que cambian

* **Tramos por subtotal.** Define una tarifa por zona. El costo ya no depende del monto del pedido.
* **Envío gratis a partir de un monto.** Crea una [promoción](/plataforma/migracion/promociones) de tipo Envío gratis con un requisito mínimo de monto.
* **Recargo porcentual sobre el pedido.** La migración no convierte esas localidades. Crea sus zonas con una tarifa fija.
* **Peso volumétrico.** Las tarifas por peso usan el peso de la variante.
* **Cotización en línea con un transportista.** Las tarifas se definen en el panel.

## Plazo de entrega

En Legacy, el plazo de un pedido se resolvía en cadena. Primero el patrón del cliente, luego el del territorio, luego el de la cobertura y por último el de la tienda. En la nueva plataforma, el plazo de un delivery depende de la dirección. Cada zona del método tiene su plazo en horas, obligatorio, y `0` promete entrega el mismo día. La migración toma el patrón de la cobertura y, si no tenía, el de la tienda.

Los patrones absolutos de Legacy, como `1,4` para entregar lunes y jueves, no se convierten. Esas zonas quedan con el plazo general de la tienda. Para reproducir un día fijo de entrega, marca solo ese día como día de entrega en la programación del método.

El plazo de una zona no puede superar los **Días a mostrar** de la programación y el panel rechaza el guardado si lo hace. El plazo se compara en días, redondeado hacia arriba. Con 14 días a mostrar, una zona con plazo de 336 horas se guarda, y una con 360 horas necesita que amplíes ese valor antes de guardarla.

El tiempo de recojo no depende de la dirección. En un método de recojo, **Recojo desde** fija el tiempo mínimo entre el pedido y el recojo, y aplica a todos sus puntos de recojo.

En Legacy, cada tienda tenía su propio patrón y su propio horario de recojo. La migración conserva el patrón cuando todas las tiendas coinciden y usa 24 horas para una tienda sin patrón. Si tus tiendas tenían tiempos u horarios distintos, crea un método de recojo por cada grupo de tiendas que coincida.

## Áreas en el mapa

En Legacy, las geocercas se dibujaban en Google My Maps, se exportaban en KML y se enviaban a soporte para cargarlas con un patrón y un costo de entrega por polígono. En la nueva plataforma, **[Configuración → Envío → Áreas](https://app.riqra.com/settings/shipping/areas)** permite dibujar polígonos en el mapa o importar un archivo KMZ/KML, y exportarlos para editarlos en otra herramienta. Un área admite hasta 20 000 vértices.

Las áreas solo dibujan tu cobertura en un mapa. No tienen tarifa, no se agregan a un método y el checkout no las consulta. La cobertura que cobra y ofrece delivery es la de las zonas por división geográfica. Si tu cobertura de Legacy estaba definida por geocercas, tradúcela a zonas con las divisiones que esos polígonos cubren, y conserva los polígonos como áreas para consultarlos.

<Warning>
  Importar un KML no configura tarifas ni cobertura. El checkout solo ofrece delivery a las direcciones que caen en una zona del método.
</Warning>

## Qué métodos ve cada cliente

En Legacy, un tipo de envío se habilitaba para toda la tienda o solo para ciertos clientes, siempre a pedido. La nueva plataforma no asigna métodos a clientes. La [política comercial](/plataforma/politicas-comerciales/crear-una-politica) acepta todos los métodos de envío activos o solo los que selecciones.

Si en Legacy un grupo de clientes tenía acceso a un tipo de envío que el resto no, crea una política con esos métodos y un segmento para ese grupo. El equipo de migración te indicará qué clientes tenían tipos de envío propios.

En el checkout, el comprador ve los métodos activos de su política, en el orden en que los ordenaste en **[Configuración → Envío → Métodos](https://app.riqra.com/settings/shipping/methods)**. Si su dirección no cae en ninguna zona, solo ve las opciones de recojo, si tienes alguna activa.

## Métodos incompletos

Un método sin ubicación de origen, sin zonas o sin puntos de recojo no se puede activar y el panel muestra el motivo. Si desactivas la ubicación de origen de un delivery, o todas las ubicaciones de recojo de un método, el método pasa a inactivo por sí solo y desaparece del checkout hasta que lo corrijas y lo vuelvas a activar.

Un método seleccionado por una política comercial no se puede eliminar. Cambia la política primero.

## Diferencias que requieren adaptación

| Comportamiento de Riqra Legacy                            | Tratamiento en la nueva plataforma                                                                                                        |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Costo definido localidad por localidad                    | Las localidades con la misma tarifa y el mismo plazo forman una zona. La tarifa se define por zona dentro del método.                     |
| La misma localidad con dos nombres y dos costos           | Una división pertenece a una sola zona por método. Se conserva la tarifa de la división y, entre coberturas del mismo nivel, la más baja. |
| Plazo por cliente o territorio                            | Todos los clientes de una zona reciben el mismo plazo.                                                                                    |
| Patrón de entrega con días fijos                          | Marca solo esos días como días de entrega en la programación.                                                                             |
| Escalera de peso con tramos gratis y tramos con costo     | Una zona es gratis o cobra en todos sus tramos.                                                                                           |
| Tramos por subtotal, recargo porcentual, peso volumétrico | Define tarifas fijas o por peso por zona.                                                                                                 |
| Envío gratis a partir de un monto                         | Promoción de tipo Envío gratis con requisito mínimo.                                                                                      |
| Producto sin peso en una tienda con costo por peso        | El método por peso no se ofrece para carritos que lo incluyan. Completa los pesos.                                                        |
| Tipo de envío habilitado por cliente                      | Política comercial con los métodos seleccionados y un segmento para ese grupo.                                                            |
| Patrón y horario de recojo por tienda                     | Un método de recojo tiene una sola programación. Crea un método por cada grupo de tiendas con el mismo tiempo y horario.                  |
| Geocercas con costo y patrón                              | Las áreas se conservan como mapa. La cobertura y la tarifa se definen en zonas por división.                                              |
| Delivery express con integración de última milla          | No está disponible.                                                                                                                       |

<Tip>
  Completa las tareas de esta área en la [lista antes de publicar](/plataforma/migracion/lista-de-revision).
</Tip>
