Cómo usar el validador
- En Excel o Google Sheets, selecciona las celdas de tu tabla de envíos, incluida la fila de encabezado, y cópialas.
- Pégalas en el cuadro de arriba. También puedes abrir un archivo CSV o TXT, con punto y coma o coma.
- Lee la lista: cada error muestra la fila, la columna, qué está mal y, cuando se puede, la sugerencia.
- Usa "Corregir" para aplicar lo que no cambia el sentido de la tabla y copia el resultado de vuelta al modelo de VTEX.
El encabezado debe tener los nombres del modelo oficial (ZipCodeStart, ZipCodeEnd, WeightStart y los demás). Si tu tabla viene de un operador logístico con otros nombres de columna, renombra la primera fila antes de pegar.
Qué revisa el validador y de dónde sale cada regla
Las reglas vienen del modelo de envíos que describe VTEX (shipping rate template, en el centro de ayuda). El validador separa lo que VTEX documenta, que aparece como error, de lo que no documenta, que aparece como aviso:
- Código postal: hasta 8 caracteres, solo letras y números. Guion, punto y espacio son error. Los rangos numéricos van de 0000000 a 99999999.
- Polígono: cuando hay PolygonName, el código postal inicial y el final deben ser 0. Código postal y polígono en la misma fila es error.
- Plazo (TimeCost): formato DD.HH:MM:SS. Cuatro días y medio son 04.12:00:00.
- País (Country): código ISO de 3 letras en mayúsculas, como MEX.
- Peso y costos: números decimales; peso inicial mayor que el final es error.
- Tamaño: hasta 65.536 filas por hoja y 10 MB por archivo.
- Avisos (no documentados por VTEX): rangos que se superponen, filas repetidas, coma como separador decimal y cero a la izquierda perdido en el código postal.
Las 12 columnas del modelo de envíos
ZipCodeStartyZipCodeEnd: inicio y fin del rango de código postal.PolygonName: nombre del polígono de geolocalización, en lugar del rango de código postal.WeightStartyWeightEnd: peso mínimo y máximo del rango, en la misma unidad de los SKU.AbsoluteMoneyCost: costo fijo del envío.PricePercent: adicional en porcentaje sobre el precio (10 = 10%), sumado al costo fijo.PriceByExtraWeight: adicional por el peso total del pedido, sumado al costo fijo.MaxVolume: volumen máximo, en la unidad de volumen de los SKU.TimeCost: plazo de entrega en DD.HH:MM:SS.Country: país, con código ISO de 3 letras.MinimumValueInsurance: seguro adicional, sumado al envío solo cuando el adicional por precio es menor que este valor.
Plazo en DD.HH:MM:SS
El plazo son días, horas, minutos y segundos separados por punto y dos puntos: 04.12:00:00 es cuatro días y doce horas. Cuando el plazo del operador viene en días, la sección "Plazo en días al formato de VTEX" convierte en los dos sentidos, y el botón "Corregir" convierte las celdas que traen solo el número de días.
Los errores que más traban la carga
- Código postal copiado con guion o espacio en medio. El modelo acepta solo letras y números.
- Cero a la izquierda borrado por Excel (01000 se vuelve 1000), lo que cambia el rango sin avisar.
- Plazo escrito como "4 días" o "4,5" en lugar de 04.12:00:00.
- País en minúsculas o con el nombre completo ("México") en lugar de MEX.
- Fila de polígono con código postal lleno.
VTEX solo avisa después de la carga: si la planilla tiene un error, la descripción llega por correo. Validar antes ahorra esa vuelta.
Qué no hace el validador
- No genera el archivo .xls: VTEX recibe el modelo oficial guardado como .xls o .zip, y el resultado de aquí se pega en él.
- No sabe qué columnas exige VTEX: la página oficial no lo dice. Avisa cuando una columna del modelo no aparece.
- No compara los valores con el contrato con el operador logístico.
- No decide si una superposición de rangos es intencional: solo muestra dónde está.
¿Tu tienda también necesita captar contactos? Conoce la ruleta de descuentos para VTEX, con app oficial en la VTEX App Store.
Preguntas frecuentes sobre la planilla de envíos de VTEX
¿Qué es la planilla de envíos de VTEX?
Es el modelo donde describes el costo y el plazo de entrega por rango de código postal y de peso: rangos de código postal o polígono, peso, costo fijo y adicionales, volumen, plazo y país. Descargas el modelo al crear la política de envío, lo llenas y lo subes.
¿Dónde descargo el modelo oficial de VTEX?
En el Admin, en Shipping > Shipping strategy > Shipping policies. Al crear una política (Create shipping policy) o editar una existente, la sección Upload shipping rates tiene el botón para descargar el modelo de la planilla.
¿En qué formato guardo la planilla?
Como .xls o .zip, y la carga se hace en la sección Upload shipping rates de la política de envío.
¿Cuál es el límite de filas y de tamaño del archivo?
Cada hoja acepta hasta 65.536 filas y el archivo puede pesar hasta 10 MB. Puedes usar varias hojas, siempre que cada una quede dentro del límite. Si el archivo sigue siendo grande, comprímelo en .zip; si aun así se pasa, divídelo en dos archivos y crea otra política de envío para el segundo.
¿Cuántos caracteres acepta el código postal?
Hasta 8, solo letras y números, sin caracteres especiales. Los rangos numéricos van de 0000000 a 99999999 y los de solo letras, de AAAAAAAA a ZZZZZZZZ. La propia página de VTEX escribe el máximo alfabético con nueve Z para un límite de 8 caracteres; confírmalo con tu operador logístico.
¿Puedo dejar el guion en el código postal?
No. El código postal acepta solo letras y números, así que "1000-001" debe quedar "1000001". El botón "Corregir" lo hace.
¿Por qué Excel borra el cero a la izquierda del código postal?
Porque trata la celda como número, y un número no tiene cero a la izquierda: 01000 se vuelve 1000. El rango cambia sin avisar. Da formato de texto a la columna antes de pegar, o usa la opción de completar con ceros a la izquierda después de validar.
¿Cómo lleno el plazo de entrega (TimeCost)?
En el formato DD.HH:MM:SS: días, horas, minutos y segundos. Cuatro días y medio son 04.12:00:00. El validador marca como error cualquier otro formato y sugiere la conversión cuando la celda trae solo el número de días.
¿Cómo convierto días a DD.HH:MM:SS?
La parte entera son los días y la fracción se vuelve horas: 0,5 día son 12 horas. Por eso 4,5 días son 04.12:00:00 y 1,25 días son 01.06:00:00. La sección de plazo de la herramienta convierte en los dos sentidos.
¿Qué es PolygonName y cuándo usarlo?
Es el identificador de un polígono de la función de geolocalización de VTEX, que se usa en lugar del rango de código postal. Llena PolygonName solo cuando no uses código postal.
¿Qué pongo en el código postal cuando la fila usa polígono?
Código postal inicial y final iguales a 0. El validador marca como error la fila con polígono y código postal distinto de 0, y sugiere el 0.
¿Cuál es la unidad del peso y del volumen?
La misma que usas en el registro de los SKU. El peso (WeightStart y WeightEnd) y el adicional por peso (PriceByExtraWeight) usan la unidad de peso del SKU, como gramo o kilo; el volumen (MaxVolume) usa la unidad de volumen del SKU, como cm³ cuando las dimensiones están en centímetros.
¿Cómo funcionan el costo fijo y los adicionales?
AbsoluteMoneyCost es el costo fijo. PricePercent (porcentaje sobre el precio) y PriceByExtraWeight (adicional por el peso total del pedido) se suman a él.
¿Para qué sirve MinimumValueInsurance?
Es un valor de seguro adicional, sumado al costo del envío, y solo aplica cuando el adicional por precio es menor que ese valor mínimo.
¿Cómo informo el país?
Con el código ISO de 3 letras en mayúsculas, como MEX para México. "México" o "mx" no valen. El botón "Corregir" pasa a mayúsculas cuando son 3 letras.
¿Qué pasa si la planilla tiene un error?
VTEX envía un correo describiendo el error después de la carga, y la confirmación puede tardar según el volumen de datos. Validar antes evita esa vuelta.
¿VTEX acepta rangos de código postal que se superponen?
La página oficial no lo dice. El validador muestra como aviso las filas del mismo país cuyos rangos de código postal y de peso se cruzan, para que confirmes si es intencional. Los rangos que solo se tocan en el peso (de 0 a 1 y de 1 a 2) no se marcan.
¿VTEX acepta coma o punto como separador decimal?
La página oficial pide números decimales y no especifica el separador. El validador avisa cuando encuentra coma decimal; revisa cómo el modelo descargado guarda los decimales. El botón "Corregir" cambia coma por punto, así que revisa el resultado.
¿Qué columnas son obligatorias?
La página de VTEX no marca columnas como obligatorias u opcionales. El validador avisa cuando una columna del modelo no aparece y solo trata como error lo que la documentación describe.
¿Puedo pegar una tabla de mi operador logístico?
Puedes, siempre que el encabezado use los nombres del modelo de VTEX (ZipCodeStart, ZipCodeEnd, WeightStart y los demás). Si la tabla del operador trae otros nombres de columna, renombra la primera fila. La herramienta revisa el formato, no el contenido del contrato.
¿La herramienta genera el archivo .xls para subir a VTEX?
No. Entrega el texto corregido, que pegas en el modelo oficial descargado de VTEX y guardas como .xls o .zip. También puedes descargar un CSV con punto y coma.
¿Sirve para tiendas de México, Colombia, Argentina, Chile y Perú?
Sí. El modelo de VTEX acepta códigos postales de hasta 8 caracteres con letras y números y la columna Country con el código de 3 letras, así que las reglas valen para cualquier país. Usa MEX, COL, ARG, CHL o PER.
¿Los datos de mi planilla se envían a algún servidor?
No. La lectura y la validación ocurren en tu navegador. La herramienta no envía ni guarda nada.
Otras herramientas para tiendas online
En el navegador, sin enviar nada, también puedes:
Otras herramientas gratuitas
Todas funcionan en el navegador, sin registro y sin subir tus archivos:
- Generador de link de WhatsApp: Crea enlaces wa.me con mensaje predefinido y úsalos en tu sitio, en Instagram o en anuncios.
- Generador de códigos QR: Crea códigos QR para enlaces, WhatsApp, Instagram, Google Reviews, contactos y otros destinos.
- Calculadora de premios para ruleta: Descubre qué premios poner en tu ruleta de descuentos, según el rubro, el ticket promedio y el objetivo.
- Redimensionar imágenes: Redimensiona imágenes por píxeles o porcentaje, recorta, ajusta la calidad y descarga varias a la vez en ZIP.
- Convertir imagen: Convierte imágenes entre JPG, PNG y WebP sin cambiar el tamaño en píxeles, con calidad ajustable y descarga en ZIP.
- Imagen a PDF: Une una o varias imágenes en un solo PDF, una por página, en el orden que elijas.