UPS Live Shipping (REST)¶
Con el plugin UPS Live Shipping (REST), calcula los costos de envío en tiempo real a través de la API REST oficial de UPS (OAuth 2.0) – directamente en el pago de Shopware 5. Los costos se basan en las tarifas reales de UPS para la dirección de destino, peso y servicio elegido, incluyendo precios negociados opcionales.
El plugin asigna cada modo de envío de Shopware a un servicio UPS, divide automáticamente los pedidos pesados en múltiples paquetes y proporciona un resultado mediante configuraciones de respaldo incluso si la dirección del cliente o la API no están disponibles.
Highlights
- 🚚 Costos de envío en tiempo real a través de la API REST oficial de UPS (OAuth 2.0)
- 🔀 Modo Sandbox y Production
- 🧭 Asignación de cada modo de envío a un servicio UPS
- ⚖️ División automática de paquetes a partir de 70 kg
- 💶 Precios UPS estándar o negociados
- 🛟 País de respaldo, código postal y costos de envío de reemplazo
- 🐞 Registro de depuración detallado (
[UPS])
❓ FAQ¶
¿De dónde provienen los costos de envío?
Directamente de UPS: El plugin consulta la API REST oficial de UPS (OAuth 2.0) en tiempo de ejecución y calcula los costos según la dirección de destino, peso y servicio UPS elegido.
¿Necesito una cuenta de UPS?
Sí. Registras el ID de cliente y secreto de cliente del portal de desarrolladores de UPS. Para precios negociados, se recomienda tu número de remitente (número de cliente de UPS).
¿Cómo se vinculan los modos de envío de Shopware con los servicios de UPS?
A través del atributo welo_ups_service_id: Cada modo de envío se asigna a un ID de servicio UPS (por ejemplo, 65 → UPS Worldwide Saver). Sin ID de servicio, no se puede realizar ningún cálculo.
¿Qué sucede con los pedidos de más de 70 kg?
UPS permite un máximo de 70 kg por paquete. El plugin detecta automáticamente los pesos totales más altos y los divide en múltiples paquetes (por ejemplo, 210 kg → 3 × 70 kg).
¿Qué sucede si la API de UPS no es accesible?
Las configuraciones de respaldo incluyen un país de destino estándar, código postal estándar y costos de envío de reemplazo definidos, para que el pago continúe funcionando.
¿Puedo rastrear el cálculo?
Sí. Con la depuración habilitada, el plugin registra, entre otros, el peso, código de servicio, clave de caché, carga útil, respuesta sin procesar y códigos de error. Todas las entradas están marcadas con [UPS].
🔧 Instalación¶
- Instalación a través del gestor de plugins de Shopware
- Instalar y activar el plugin
- Realizar la configuración en el backend (ver Configuración abajo)
Luego haz clic en el icono para activar el plugin:
⚙️ Configuración general¶
| # | Configuración | Descripción |
|---|---|---|
| 1 | Seleccionar tienda | Selecciona la tienda correspondiente. |
| 2 | Activar plugin | Activa el cálculo de costos de envío en tiempo real de UPS. |
| 3 | Modo | Elección entre Sandbox (entorno de prueba) y Production (operación en vivo). |
| 4 | ID de cliente | ID de cliente del portal de desarrolladores de UPS. |
| 5 | Secreto de cliente | Secreto de cliente del portal de desarrolladores de UPS. |
| 6 | Número de remitente | Número de cliente de UPS (recomendado para precios negociados). |
| 7 | Tiempo de espera de API | Tiempo de espera en segundos para la solicitud de API de UPS. |
| 8 | País de envío | Código ISO del país de envío (por ejemplo, DE). |
| 9 | Código postal de envío | Código postal del almacén de envío. |
| 10 | Selección de precios | Forzar precios estándar, Forzar precios negociados o Precios negociados si están disponibles. |
| 11 | Guardar configuración | Guardar la configuración. |
🧭 Asignar modos de envío¶
Cada modo de envío de Shopware debe ser asignado a un servicio UPS. Para esto, se utiliza el atributo welo_ups_service_id.
| ID de servicio | Servicio UPS |
|---|---|
65 | UPS Worldwide Saver |
11 | UPS Standard |
07 | UPS Express |
Sin ID de servicio, sin cálculo
Si un modo de envío no tiene un welo_ups_service_id asignado, no se puede realizar ningún cálculo en tiempo real para ese modo de envío.
⚖️ Peso y división¶
UPS permite un máximo de 70 kg por paquete. El plugin detecta automáticamente los pesos totales más altos y los divide en múltiples paquetes.
| Peso total | División automática |
|---|---|
| 100 kg | 2 × 50 kg |
| 210 kg | 3 × 70 kg |
| 350 kg | 5 × 70 kg |
| # | Configuración | Descripción |
|---|---|---|
| 1 | Peso predeterminado | Se usa si un artículo no tiene peso. |
| 2 | Peso mínimo | Límite inferior para el cálculo. |
| 3 | Peso máximo por paquete | Estándar: 70 kg. |
| 4 | Guardar configuración | Guardar la configuración. |
🛟 Configuraciones de respaldo¶
Si el cliente no está conectado o no hay una dirección completa disponible, se aplican las siguientes configuraciones:
| # | Configuración | Descripción |
|---|---|---|
| 1 | País de respaldo | País estándar para invitados. |
| 2 | Código postal de respaldo | Código postal estándar para invitados. |
| 3 | Costos de envío de reemplazo | Se usa si la API de UPS no es accesible. |
| 4 | Guardar configuración | Guardar la configuración. |
Dirección de destino dinámica
Si el cliente selecciona otro país o código postal en el carrito, este se usa dinámicamente para el cálculo.
🐞 Depuración y registro¶
| # | Configuración | Descripción |
|---|---|---|
| 1 | Habilitar depuración | Habilita salidas de registro detalladas. |
| 2 | Guardar configuración | Guardar la configuración. |
Los registros incluyen, entre otros:
- Peso
- Código de servicio
- Clave de caché
- Carga útil a UPS
- Respuesta bruta de la API
- Códigos de error
- Excepciones de API
Todos los registros están marcados con [UPS].
💡 Casos de uso típicos¶
Costos de envío internacionales exactos¶
Muestra a los clientes en el pago las tarifas reales de UPS para su dirección de destino – en lugar de costos de envío fijos.
Pedidos grandes y voluminosos¶
Los pedidos grandes se dividen automáticamente en paquetes conformes a UPS (máx. 70 kg) y se calculan correctamente.
Utilizar condiciones UPS negociadas¶
Con el número de remitente registrado, el plugin calcula tus precios de UPS negociados individualmente.
⭐ Ventajas para operadores de tiendas¶
- Costos de envío precisos y exactos directamente de UPS
- Menos sobrecálculo o subcálculo de costos de envío
- División automática de paquetes sin esfuerzo manual
- Pago confiable gracias a configuraciones de respaldo
- Transparencia completa gracias al registro de depuración detallado
🧩 Alcance funcional¶
- Cálculo de costos de envío en tiempo real a través de la API REST de UPS (OAuth 2.0)
- Modo Sandbox y Production
- Asignación de cada modo de envío a un servicio UPS
- Precios estándar o negociados
- División automática de paquetes a partir de 70 kg
- País de respaldo, código postal y costos de envío de reemplazo
- Registro de depuración detallado con identificación
[UPS]
📬 Soporte¶
Para cualquier pregunta, sugerencia de mejora o adaptación personalizada, contáctanos por correo electrónico a support@cnk-plugins.de.
📬 Support¶
Para preguntas, sugerencias de mejora o personalizaciones, contáctenos por correo electrónico en support@cnk-plugins.de.