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

# Importa zonas de envío

> Crea o cambia en bloque las divisiones geográficas de tus zonas de envío a partir de una tarifa de transportista.

Con este archivo creas [zonas de envío](https://docs.riqra.com/plataforma/envios/zonas.md) y defines sus divisiones geográficas en bloque. Es el primer paso para configurar el envío a partir de la tarifa de un transportista: primero se importan las zonas y después las [tarifas](https://docs.riqra.com/plataforma/transferencia-de-datos/importar-tarifas-de-envio.md), que solo hacen referencia a zonas ya existentes.

## Dónde importar

Ve a **[Configuración → Envío → Zonas](https://app.riqra.com/settings/shipping/zones)** y haz clic en **Importar**. Descarga la plantilla con **Descargar plantilla** en el diálogo de importación. Necesitas permiso para editar métodos de envío.

## Formato del archivo

Una fila por cada división de una zona. Las filas con el mismo nombre de zona forman una sola zona. Las dos columnas son obligatorias.

| Columna | Cómo completarla |
| - | - |
| `zona` | Nombre de la zona. Se compara con tus zonas sin distinguir mayúsculas de minúsculas, pero sí tildes. Un nombre que no existe crea una zona nueva. |
| `division` | División geográfica de la zona: su nombre o su ruta completa, de cualquier nivel que tenga el país de tu tienda. No distingue mayúsculas ni tildes. |

| `zona` | `division` |
| - | - |
| `Lima Metropolitana` | `Lima / Lima / Miraflores` |
| `Lima Metropolitana` | `Lima / Lima / San Isidro` |
| `Lima Metropolitana` | `Callao` |
| `Costa norte` | `La Libertad` |
| `Costa norte` | `Lambayeque / Chiclayo` |

La ruta completa va de la división mayor a la menor, separada por `/`: **Departamento / Provincia / Distrito** en Perú y **Región / Provincia / Comuna** en Chile. Si una zona incluye una provincia o región completa, escribe esa división: cubre todo lo que contiene.

## Nombre o ruta completa

Escribe el nombre solo cuando identifica una única división. Si el mismo nombre existe en más de un lugar, la fila falla con el mensaje **es ambigua: escribe la ruta completa** y las rutas posibles.

Cuando el valor coincide con la ruta completa de una división, se elige esa división. Por eso un nombre de primer nivel como `Lima` o `Valparaíso` es siempre el departamento o la región, nunca el distrito o la comuna del mismo nombre. Para el distrito escribe `Lima / Lima / Lima`.

## Reglas

* El archivo reemplaza las divisiones de cada zona que nombra. La zona queda con exactamente las divisiones del archivo; las que tenía y no aparecen se quitan.
* Las zonas que no aparecen en el archivo no cambian. La importación nunca elimina una zona ni cambia su nombre; eso se hace desde el panel.
* Una zona nueva se agrega después de las existentes, en el orden del archivo, con el nombre tal como está escrito en su primera fila.
* Una zona cuyas divisiones ya coinciden con el archivo no cambia, así que puedes volver a subir una exportación sin efectos.
* Repetir una división dentro de la misma zona marca error en ambas filas. Una misma división puede estar en zonas distintas.
* Si dos zonas guardadas tienen nombres que solo se distinguen por mayúsculas, las filas con ese nombre fallan con **Zona ambigua**. Renombra una de ellas desde el panel.
* Si la tienda no tiene país configurado, todas las filas fallan.

> [!WARNING]
>
> Este archivo reemplaza, no actualiza. Cada zona que aparece en el archivo queda con exactamente las divisiones del archivo. Cambiar las divisiones de una zona afecta a todos los métodos que la usan.

## Zonas compartidas entre métodos

Una zona puede estar en varios métodos de envío, y dentro de un método dos zonas no pueden cubrir la misma división. La importación comprueba esta regla en cada método que usa una zona que el archivo cambia. Si el cambio dejaría una división en dos zonas de un mismo método, la fila falla con un mensaje como:

`Se solapa con la zona Trujillo y alrededores en el método Delivery Express: La Libertad / Trujillo / Trujillo, La Libertad / Trujillo / Huanchaco`

El mensaje nombra la otra zona, el método y hasta tres divisiones en conflicto. Corrige el archivo para que las zonas del método no compartan divisiones, o incluye en el archivo las dos zonas con sus divisiones ya separadas. Las zonas nuevas no pertenecen a ningún método, así que no generan este error.

Si alguna fila tiene errores, no se aplica ninguna. Descarga el **reporte de errores** (tu mismo archivo con la columna `errores`), corrígelo y vuelve a subirlo. Lee [Reporte de errores](https://docs.riqra.com/plataforma/transferencia-de-datos/reporte-de-errores.md).

Al terminar, el trabajo muestra cuántas zonas se crearon, cuántas se actualizaron y cuántas no cambiaron.

## Exportar

En **Zonas**, haz clic en **Exportar**. El archivo tiene una fila por cada división de cada zona, con las zonas en el orden de la lista y las divisiones ordenadas por ruta completa. La columna `division` siempre trae la ruta completa. Una provincia que elegiste entera aparece como esa provincia; una provincia con divisiones excluidas aparece como las divisiones que quedan cubiertas.


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