El cliente encuentra un producto, lo añade al carrito e introduce su código postal. La tienda indica que no hay transportistas disponibles. El aviso señala dónde se detuvo la compra, pero todavía no explica la causa. Puede tratarse de una limitación real de cobertura o de una combinación de datos y reglas que está descartando opciones válidas. Antes de cambiar tarifas o activar servicios sin criterio, conviene identificar qué condición produce el problema.
Empieza por un caso que otra persona pueda reproducir
Prepara un carrito sin información personal y registra la referencia del producto, la variante elegida, la cantidad y el código postal utilizado. Anota la hora y el paso del proceso en el que aparece el aviso. Conserva otro caso parecido que sí muestre opciones de envío. Esa comparación permite distinguir una incidencia general de una condición concreta; una captura del aviso suele dejar fuera la diferencia más importante.
Cambia una sola variable cada vez. Mantén el producto y cambia el destino; después conserva ese destino y prueba otro producto. Si hay variantes, repite la comparación con la misma selección. Un carrito que falla no demuestra que toda una ciudad esté fuera de cobertura. El producto, la cantidad y el destino deben acompañar siempre al registro.
Distingue la cobertura real de una restricción de la tienda
Confirma que el servicio admite el origen y el destino del envío. Si el operador dispone de un cotizador, una consulta externa equivalente puede servir como referencia. Compara el mismo paquete, no solo el código postal. Que aparezca una tarifa en la web del transportista no garantiza que la integración deba mostrarla: pueden variar el contrato, los servicios habilitados y la preparación del volumen.
En PrestaShop, revisa las zonas de entrega y las asociaciones del transportista. Comprueba las restricciones por grupo de clientes o tienda si tu instalación las utiliza. Los nombres de los campos dependen de la versión y del módulo. Sigue la regla aplicada al comprador; no amplíes la cobertura comercial como atajo para resolver un error de configuración.
Comprueba los datos del producto y del paquete
Un artículo ligero puede entrar en un servicio que ya no admite varias unidades dentro del mismo carrito. Revisa el peso, las dimensiones y los límites pertinentes. Averigua si la integración envía productos individuales o paquetes ya preparados. No sustituyas medidas reales por cifras inventadas para conseguir que aparezca una modalidad: la tarifa resultante podría no corresponder al envío que puedes despachar.
Como ejemplo específico, la plataforma brasileña Melhor Envio documenta las dimensiones en centímetros y el peso en kilogramos. En Brasil, el código postal se denomina CEP. Esas exigencias no deben trasladarse automáticamente a otros proveedores. Verifica las unidades del módulo y de la API que utilizas, especialmente las conversiones y los valores correspondientes a cada variante.
Busca huecos en los rangos y las condiciones
Cuando el transportista trabaja con rangos, compara el total del carrito con los intervalos configurados y el comportamiento fuera de ellos. Presta atención a los valores cercanos a un límite de peso o precio. Registra qué debería suceder según las reglas aprobadas de la tienda. No improvises una tarifa para cubrir un hueco sin comprobar que la operación puede cumplirla.
Puedes crear una matriz pequeña: producto A con un destino atendido, producto A con el destino que falla, producto B con ese mismo destino y producto A con mayor cantidad. Anota las modalidades visibles en cada caso. Es un método propuesto de investigación, no un conjunto universal de pruebas; adáptalo al catálogo y a las regiones relevantes para tu negocio.
Sigue la cotización integrada hasta su respuesta
Con apoyo técnico, comprueba si la tienda envió la solicitud y qué devolvió el proveedor. Distingue un servicio no disponible de datos rechazados, un fallo de autenticación o una interrupción temporal. Conserva el código del error y la hora sin copiar tokens, credenciales ni direcciones completas en documentos compartidos. Se necesita evidencia suficiente para rastrear el problema, no duplicar los datos del cliente.
Una respuesta válida también debe llegar a la interfaz de compra. Si contiene una modalidad que el cliente no ve, investiga el procesamiento de la respuesta y los filtros posteriores. Si no hubo solicitud, empieza por la condición que impidió enviarla. Cambiar varias configuraciones al mismo tiempo elimina pistas y dificulta explicar qué ajuste resolvió la incidencia.
Corrige la causa y repite los casos de comparación
Una vez confirmada la causa, cambia solo lo necesario y documenta el resultado anterior y posterior. Repite el carrito que fallaba y los que ya funcionaban. Revisa modalidad, precio y plazo mostrados al comprador. Si estabas corrigiendo un rango, no basta con que aparezca cualquier transportista: debe cumplirse el comportamiento esperado.
Esta comprobación normalmente puede detenerse antes de crear un pedido. Las pruebas que impliquen compras, pagos, etiquetas o avisos al cliente requieren un entorno y una autorización adecuados. Evita efectos reales durante la investigación en producción. Del mismo modo, una integración en modo de pruebas no demuestra por sí sola que se haya contratado un envío real.
Conserva un registro útil para la próxima incidencia
Guarda la referencia del escenario, el periodo observado, el resultado esperado y la causa confirmada. Separa las hipótesis de las conclusiones. “Ningún rango cubría este peso” aporta más que “el envío volvió”. Si la causa sigue sin conocerse, describe la recuperación observada y la investigación pendiente, sin presentar el problema como resuelto de forma permanente.
Elige algunos escenarios importantes para revisar después de cambios relevantes y durante campañas. El objetivo es detectar cuándo una combinación deja de ofrecer entrega sin convertir cada comprobación en un pedido real. La cobertura debe representar el catálogo y las zonas de envío, incluyendo las excepciones conocidas y las limitaciones de servicios externos.
Empieza por un carrito reproducible antes de modificar reglas generales. Si necesitas ayuda para investigar el cálculo del envío o el comportamiento de un módulo, contacta con AGTI en agti.eng.br. Lleva un ejemplo sin datos personales y explica el resultado esperado para iniciar la conversación técnica con un caso concreto y verificable.