UPS Live Shipping (REST)¶
Avec le plugin UPS Live Shipping (REST), calculez les frais d'expédition en direct via l'API UPS REST officielle (OAuth 2.0) – directement dans la caisse Shopware 5. Les frais sont basés sur les tarifs UPS réels pour l'adresse de destination, le poids et le service choisi, y compris les prix négociés optionnels.
Le plugin affecte chaque mode d'expédition Shopware à un service UPS, divise automatiquement les commandes lourdes en plusieurs colis et fournit un résultat via des paramètres de secours même si l'adresse du client ou l'API ne sont pas disponibles une fois.
Highlights
- 🚚 Frais d'expédition en direct via l'API UPS REST officielle (OAuth 2.0)
- 🔀 Mode Sandbox et Production
- 🧭 Affectation de chaque mode d'expédition à un service UPS
- ⚖️ Division automatique des colis à partir de 70 kg
- 💶 Prix UPS standard ou négociés
- 🛟 Pays de secours, code postal et frais d'expédition de remplacement
- 🐞 Journalisation de débogage détaillée (
[UPS])
❓ FAQ¶
D'où proviennent les frais d'expédition?
Directement de l'UPS: Le plugin interroge l'API UPS REST officielle (OAuth 2.0) à l'exécution et calcule les frais en fonction de l'adresse de destination, du poids et du service UPS choisi.
Ai-je besoin d'un compte UPS?
Oui. Vous enregistrez l'ID client et le secret client du portail développeur UPS. Pour les prix négociés, votre numéro d'expéditeur (numéro de client UPS) est recommandé.
Comment les modes d'expédition Shopware sont-ils associés aux services UPS?
Via l'attribut welo_ups_service_id: Chaque mode d'expédition est associé à un ID de service UPS (p. ex. 65 → UPS Worldwide Saver). Aucun calcul ne peut être effectué sans ID de service.
Que se passe-t-il pour les commandes de plus de 70 kg?
L'UPS autorise un maximum de 70 kg par colis. Le plugin détecte les poids totaux supérieurs et les divise automatiquement en plusieurs colis (p. ex. 210 kg → 3 × 70 kg).
Que se passe-t-il si l'API UPS n'est pas accessible?
Les paramètres de secours incluent un pays de destination standard, un code postal standard et des frais d'expédition de remplacement définis, pour que la caisse continue de fonctionner.
Puis-je suivre le calcul?
Oui. Avec le débogage activé, le plugin enregistre notamment le poids, le code de service, la clé de cache, la charge utile, la réponse brute et les codes d'erreur. Toutes les entrées sont marquées [UPS].
🔧 Installation¶
- Installation via le gestionnaire de plugins Shopware
- Installer et activer le plugin
- Effectuer la configuration dans le backend (voir Konfiguration ci-dessous)
Cliquez ensuite sur l'icône pour activer le plugin:
⚙️ Paramètres généraux¶
| # | Paramètre | Description |
|---|---|---|
| 1 | Sélectionner la boutique | Sélectionnez la boutique correspondante. |
| 2 | Activer le plugin | Active le calcul des frais d'expédition UPS en direct. |
| 3 | Mode | Choix entre Sandbox (environnement de test) et Production (exploitation en direct). |
| 4 | ID client | ID client du portail développeur UPS. |
| 5 | Secret client | Secret client du portail développeur UPS. |
| 6 | Numéro d'expéditeur | Numéro de client UPS (recommandé pour les prix négociés). |
| 7 | Délai d'attente API | Délai d'attente en secondes pour la demande de l'API UPS. |
| 8 | Pays d'expédition | Code ISO du pays d'expédition (p. ex. DE). |
| 9 | Code postal d'expédition | Code postal de l'entrepôt d'expédition. |
| 10 | Sélection des prix | Forcer les prix standard, Forcer les prix négociés ou Prix négociés si disponibles. |
| 11 | Enregistrer les paramètres | Enregistrer la configuration. |
🧭 Affecter les modes d'expédition¶
Chaque mode d'expédition Shopware doit être affecté à un service UPS. Pour cela, l'attribut welo_ups_service_id est utilisé.
| ID de service | Service UPS |
|---|---|
65 | UPS Worldwide Saver |
11 | UPS Standard |
07 | UPS Express |
Aucun calcul sans ID de service
Si un mode d'expédition n'a pas de welo_ups_service_id affecté, aucun calcul en direct ne peut être effectué pour ce mode d'expédition.
⚖️ Poids et division¶
L'UPS autorise un maximum de 70 kg par colis. Le plugin détecte les poids totaux supérieurs et les divise automatiquement en plusieurs colis.
| Poids total | Division automatique |
|---|---|
| 100 kg | 2 × 50 kg |
| 210 kg | 3 × 70 kg |
| 350 kg | 5 × 70 kg |
| # | Paramètre | Description |
|---|---|---|
| 1 | Poids par défaut | Utilisé si un article n'a pas de poids. |
| 2 | Poids minimum | Limite inférieure du calcul. |
| 3 | Poids max par colis | Standard: 70 kg. |
| 4 | Enregistrer les paramètres | Enregistrer la configuration. |
🛟 Paramètres de secours¶
Si le client n'est pas connecté ou qu'aucune adresse complète n'est disponible, les paramètres suivants s'appliquent:
| # | Paramètre | Description |
|---|---|---|
| 1 | Pays de secours | Pays standard pour les invités. |
| 2 | Code postal de secours | Code postal standard pour les invités. |
| 3 | Frais d'expédition de remplacement | Utilisé si l'API UPS n'est pas accessible. |
| 4 | Enregistrer les paramètres | Enregistrer la configuration. |
Adresse de destination dynamique
Si le client sélectionne un autre pays ou un autre code postal dans le panier, celui-ci est utilisé dynamiquement pour le calcul.
🐞 Débogage et journalisation¶
| # | Paramètre | Description |
|---|---|---|
| 1 | Activer le débogage | Active les sorties de log détaillées. |
| 2 | Enregistrer les paramètres | Enregistrer la configuration. |
Les journaux incluent notamment:
- Poids
- Code de service
- Clé de cache
- Charge utile vers l'UPS
- Réponse brute de l'API
- Codes d'erreur
- Exceptions API
Tous les journaux sont marqués [UPS].
💡 Cas d'utilisation typiques¶
Frais d'expédition internationaux exacts¶
Montrez aux clients à la caisse les tarifs UPS réels pour leur adresse de destination – au lieu de frais d'expédition forfaitaires.
Commandes lourdes et volumineuses¶
Les commandes importantes sont automatiquement divisées en colis conformes à l'UPS (max. 70 kg) et correctement calculées.
Utiliser les conditions UPS négociées¶
Avec le numéro d'expéditeur enregistré, le plugin calcule vos prix UPS négociés individuellement.
⭐ Avantages pour les propriétaires de boutiques¶
- Frais d'expédition précis et au tarif exact directement de l'UPS
- Moins de calculs excessifs ou insuffisants des frais d'expédition
- Division automatique des colis sans effort manuel
- Caisse fiable grâce aux paramètres de secours
- Transparence complète grâce à la journalisation de débogage détaillée
🧩 Étendue fonctionnelle¶
- Calcul des frais d'expédition en direct via l'API UPS REST (OAuth 2.0)
- Mode Sandbox et Production
- Affectation de chaque mode d'expédition à un service UPS
- Prix standard ou négociés
- Division automatique des colis à partir de 70 kg
- Pays de secours, code postal et frais d'expédition de remplacement
- Journalisation de débogage détaillée avec identification
[UPS]
📬 Support¶
Pour toute question, suggestion d'amélioration ou adaptation personnalisée, contactez-nous par e-mail à support@cnk-plugins.de.