Módulo de Carga de Tarifarios de Logística (próximamente)

Este módulo permite a cada seller cargar y mantener los tarifarios de costos de envío de sus logísticas y servicios configurados. La información cargada tiene dos usos principales: el cálculo del costo real de envío de cada pedido (independientemente de lo que pagó el comprador) y la carga de la matriz logística en las plataformas que lo requieren, como VTEX y Mercado Envíos 1.

Estructura del tarifario

Cada tarifario se organiza en dos niveles: una cabecera con la configuración general y las restricciones del servicio, y un conjunto de filas que definen el costo según el destino y el peso del envío.

Cabecera del tarifario

La cabecera identifica el tarifario y define las restricciones dimensionales y de peso que aplican a ese servicio en particular. Cada tarifario está vinculado a un servicio específico de una logística (por ejemplo: Andreani Normal, Andreani Flex 24hs), lo que permite que una misma logística tenga tarifarios distintos por cada servicio que ofrece.

Los campos que se configuran en la cabecera son:

• Nombre: identificación descriptiva del tarifario.
• Servicio: servicio de logística al que corresponde.
• Altura máxima por bulto (cm).
• Anchura máxima por bulto (cm).
• Longitud máxima por bulto (cm).
• Suma máxima de dimensiones (cm): algunos servicios limitan la suma largo + ancho + alto.
• Peso máximo por bulto (gramos).
• Factor de aforo (cm³/kg): divisor para el cálculo del peso aforado. Si se configura en el tarifario, tiene precedencia sobre el factor configurado en la logística. Valor típico: 5000 para envíos terrestres.

Filas del tarifario

Cada fila define el costo de envío para una combinación de rango de código postal de destino y rango de peso. La evaluación busca la fila cuyo rango de CP y rango de peso coincidan con el pedido a cotizar.

Los campos de cada fila son:

• CP inicio / CP fin: rango de código postal de destino (comparación lexicográfica).
• Peso mínimo / Peso máximo (gramos): rango de peso del envío. Se utiliza el mayor entre el peso real y el peso aforado.
• Costo: costo base del envío en moneda local para ese tramo.
• Costo por kg excedente: cargo adicional por cada kilogramo que supere el peso máximo del tramo.
• Plazo de entrega (días hábiles): utilizado para la carga de matriz logística en plataformas como VTEX.
• Volumen máximo (cm³): restricción de volumen opcional para ese tramo.
• Valor mínimo: costo mínimo de envío aplicable en ese tramo.

Cálculo del costo de envío

Determinación del peso a cotizar

El sistema calcula el peso aforado del paquete usando el factor de aforo configurado en el tarifario (o en la logística si el tarifario no lo tiene definido):

peso_aforado (g) = (largo_cm × ancho_cm × alto_cm / factor_aforo) × 1000

El peso que se utiliza para buscar la fila del tarifario es el mayor entre el peso real del producto y el peso aforado calculado:

peso_a_cotizar = MAX(peso_real_g, peso_aforado_g)

Búsqueda de la fila aplicable

Con el código postal de destino del pedido y el peso a cotizar, el sistema busca la fila del tarifario que cumpla simultáneamente:

• El código postal de destino está dentro del rango cp_inicio / cp_fin.
• El peso a cotizar está dentro del rango peso_min / peso_max.

Cálculo del costo final

Una vez identificada la fila, el costo se calcula de la siguiente forma:

• Si el peso a cotizar no supera el peso_max de la fila: se aplica directamente el costo base.
• Si hay excedente y está configurado el costo_kg_excedente: se suma el cargo proporcional al excedente en kg.
• El resultado final no puede ser inferior al valor_minimo configurado en la fila, si está definido.

Usos del tarifario

Costo real de envío por pedido

El sistema calcula el costo real que le cobra la transportadora al seller por cada envío, independientemente del costo de envío que haya abonado el comprador al momento de la compra. Esto permite al seller conocer el margen real de cada venta y detectar desvíos entre el costo cobrado al comprador y el costo real del despacho.

Carga de matriz logística en plataformas

Algunas plataformas de e-commerce requieren que el seller cargue su propia matriz de costos y plazos de envío para poder calcular el costo de envío en el checkout. Este módulo permite generar y cargar esa matriz automáticamente desde el tarifario configurado, evitando la carga manual. Las plataformas soportadas en esta versión son:

• VTEX: carga de tarifario con costos, plazos y restricciones dimensionales por rango de CP.
• Mercado Envíos 1: carga de tabla de costos por zona y peso para logística propia del seller.

Consideraciones importantes

Unidades de medida

• Peso: gramos (entero).
• Dimensiones: centímetros (entero).
• Volumen: cm³ (entero).
• Factor de aforo: cm³/kg (entero divisor).
• Costos: moneda local (decimal).

Relación con el módulo de reglas de asignación

El tarifario no determina qué logística se usa para cada pedido — eso lo resuelve el módulo de reglas de asignación automática. El tarifario entra en juego una vez que la logística y el servicio ya fueron asignados, para calcular el costo real del envío o para alimentar la matriz logística de la plataforma.