VibeFox Australia Post for WooCommerce — Aide

Prérequis

WordPress : 5.8 ou ultérieur.

WooCommerce : 5.0 ou ultérieur, installé et activé. L'extension refuse de s'activer sans lui.

PHP : 8.0 ou ultérieur.

Clé d'API PAC Australia Post (uniquement pour les tarifs en temps réel) : les tarifs en temps réel utilisent l'API PAC (Postage Assessment Calculator) d'Australia Post. La clé est gratuite : inscrivez-vous pour obtenir une clé d'API PAC sur le Centre pour développeurs d'Australia Post (developers.auspost.com.au). Vous avez aussi besoin du code postal australien à 4 chiffres depuis lequel vous expédiez. Si vous utilisez uniquement des prix fixes par pays, vous n'avez pas besoin de clé d'API.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne pour un seul domaine.

Installation

1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier vfd_australia_post dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox Australia Post, ou cliquez sur Settings sous le nom de l'extension sur la page Plugins.

4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.

5. Choisissez la Rate source. Pour les tarifs en temps réel, saisissez la clé d'API PAC, votre code postal d'expédition et, si la devise de votre boutique n'est pas l'AUD, le taux de conversion en AUD (voir Configuration).

6. Ajoutez VibeFox Australia Post à une zone d'expédition dans WooCommerce > Settings > Shipping > Shipping zones, ou activez Ignore shipping zones et choisissez les pays.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Shipping > VibeFox Australia Post. Ils s'appliquent à toutes les zones d'expédition. Lorsque vous ajoutez la méthode à une zone, la fenêtre de la zone ne comporte qu'un seul champ :

Title (zone) : le nom affiché au client pour cette zone. Laissez-le vide pour utiliser le Method title général.

À chaque enregistrement des réglages, les tarifs Australia Post en cache sont effacés. Si les tarifs en temps réel sont choisis mais que la clé d'API, le code postal d'expédition ou le taux AUD manque, un avertissement s'affiche après l'enregistrement.

General

Enable/Disable : active ou désactive la méthode dans toutes les zones à la fois.

Method title : le nom du mode de livraison affiché au client au paiement. Une zone peut le remplacer par son propre titre. Par défaut : Australia Post.

Tax status : Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas.

Rate source : le mode de calcul du prix.

Les détails des erreurs sont enregistrés dans le journal, jamais montrés au client.

API Australia Post (tarifs en temps réel) (inutile pour les prix fixes)

PAC API key : votre clé d'API PAC Australia Post gratuite. Elle est envoyée à Australia Post dans l'en-tête AUTH-KEY.

Ship-from postcode : le code postal australien à 4 chiffres depuis lequel les colis sont expédiés, par exemple 2000.

Domestic service : utilisé pour les livraisons en Australie (jusqu'à 22 kg, 105 cm par côté) : Parcel Post (par défaut) ou Express Post.

International service : utilisé pour les livraisons hors d'Australie (jusqu'à 20 kg) : International Standard (par défaut), International Express ou International Courier.

Remove GST : divise les prix nationaux de l'API par 1,1. Les prix nationaux d'Australia Post incluent 10 % de GST. Activez cette option lorsque WooCommerce ajoute lui-même la taxe sur la livraison (Tax status = Taxable), afin de ne pas facturer la GST deux fois. Les frais d'envoi internationaux sont exonérés de GST et ne sont jamais modifiés.

AUD → (your currency) rate : les prix d'Australia Post sont en AUD. Si la devise de votre boutique n'est pas l'AUD, indiquez combien d'unités de votre devise vaut un AUD, par exemple 0.61. Sans cette valeur, les tarifs en temps réel ne sont pas utilisés. Si la devise de votre boutique est l'AUD, laissez le champ vide. Le point et la virgule sont tous deux acceptés comme séparateur décimal.

Colis pour les tarifs en temps réel

Le panier est envoyé comme un seul colis. Les poids et dimensions des produits sont convertis des unités de votre boutique en kg et en cm. Les valeurs ci-dessous sont utilisées pour les produits sans poids ni dimensions.

Default product weight (kg) : utilisé pour chaque produit sans poids, dans la requête à Australia Post et dans le contrôle de Min cart weight / Max cart weight. Par défaut : 1.

Default parcel length (cm) : utilisé lorsqu'aucun produit du panier n'a de dimensions. Par défaut : 22.

Default parcel width (cm) : utilisé lorsqu'aucun produit du panier n'a de dimensions. Par défaut : 16.

Default parcel height (cm) : utilisé lorsqu'aucun produit du panier n'a de dimensions. Par défaut : 8.

Prix fixes (utilisés avec les prix fixes et comme solution de repli des tarifs en temps réel)

Country prices : un tableau de codes pays à 2 lettres (AU, NZ, US, etc.) et de prix dans la devise de votre boutique. Cliquez sur + Add row pour ajouter un pays et sur le bouton de suppression pour en retirer un. Utilisez * pour tous les autres pays. Un pays sans prix (et sans ligne *) n'a pas de tarif fixe, la méthode est donc masquée pour lui. Le tableau est vide tant que vous n'avez pas saisi de prix.

Fixed price per : Order facture le prix une seule fois. Item (price × quantity) le multiplie par le nombre d'articles du panier. Cela ne s'applique qu'aux prix fixes. Les tarifs en temps réel sont toujours calculés pour le colis entier.

Conditions

Min cart weight (kg) : masque la méthode en dessous de ce poids de panier. 0 signifie aucune limite.

Max cart weight (kg) : masque la méthode au-dessus de ce poids de panier. Par défaut : 22. 0 signifie aucune limite. Colis Australia Post : 22 kg en national, 20 kg à l'international.

Minimum order amount : affiche la méthode seulement lorsque le sous-total du panier atteint ce montant. Laissez vide pour l'afficher toujours.

Excluded shipping classes : masque la méthode si un article du panier appartient à l'une de ces classes d'expédition WooCommerce.

Free shipping : active la livraison gratuite à partir du montant indiqué ci-dessous.

Free shipping from : le sous-total du panier à partir duquel la livraison est gratuite. Dans ce cas, aucune requête n'est envoyée à l'API.

Disponibilité sans zones d'expédition

Ignore shipping zones : propose la méthode pour les pays indiqués ci-dessous, quelle que soit la zone correspondante.

Countries : les pays de destination pour ce mode. Laissez vide pour utiliser tous les pays vers lesquels votre boutique expédie. Utilisé uniquement avec Ignore shipping zones.

Avancé

Debug log : enregistre les calculs de tarifs dans WooCommerce > Status > Logs, source « vfd-australia-post ». Les erreurs de l'API sont toujours enregistrées. La clé d'API et les codes postaux des clients ne sont pas enregistrés.

Remove data on uninstall : lorsque cette option est activée, la suppression de l'extension efface ses réglages, ses méthodes de zone et ses tarifs en cache. La désactivation de l'extension ne supprime jamais rien.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif à l'extension. L'extension vérifie d'abord le poids du panier, le Minimum order amount et les Excluded shipping classes. Si la livraison gratuite s'applique, le tarif est de 0 et aucune requête n'est envoyée à Australia Post.

En mode prix fixes, le prix est pris dans le tableau. En modes tarifs en temps réel, l'extension envoie à Australia Post le poids du colis et, pour les livraisons nationales, les codes postaux d'expédition et de livraison ainsi que la taille du colis ; pour les livraisons internationales, le pays de destination. Un tarif en temps réel national n'est demandé qu'après que le client a saisi un code postal à 4 chiffres. Aucune requête n'est envoyée si le colis dépasse les limites d'Australia Post (22 kg ou 105 cm en national, 20 kg à l'international). Le prix en AUD est converti avec votre taux, et la GST est retirée des prix nationaux si Remove GST est activé.

Chaque réponse valide est mise en cache pendant 1 heure, afin que le même panier ne déclenche pas une nouvelle requête. Une requête en échec est mise en cache pendant 10 minutes, pour que le paiement n'attende pas Australia Post à chaque actualisation. Les erreurs de l'API ne sont jamais affichées au client : la méthode est masquée ou, en mode de repli, le prix fixe est utilisé.

La méthode fonctionne sur le paiement classique et sur les blocs Panier et Paiement. Elle est compatible avec le stockage haute performance des commandes de WooCommerce (HPOS).

L'extension calcule uniquement des tarifs. Elle ne crée pas d'étiquettes d'expédition, d'envois eParcel ou MyPost Business, ni de manifestes, ne suit pas les colis et ne permet pas au client de choisir des casiers ou des bureaux de poste. Le panier est toujours tarifé comme un seul colis. Les lettres, les satchels et les tarifs sous contrat (eParcel) ne sont pas inclus.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Shipping > VibeFox Australia Post. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche l'état, par exemple la date jusqu'à laquelle la licence est active, et votre domaine. Utilisez Check now pour vérifier de nouveau l'état, Change key pour saisir une autre clé et Remove key pour la retirer de ce site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.

Une clé fonctionne pour un seul domaine. Retirer la clé d'un site ne libère pas l'emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, Australia Post n'est pas affiché aux clients au paiement. Les gestionnaires connectés de la boutique le voient toujours, avec la mention (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Un rappel apparaît sur la page Plugins et sur les pages WooCommerce. Les commandes existantes ne sont pas concernées.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. L'état est vérifié de nouveau automatiquement en arrière-plan.

Dépannage

Australia Post n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que la méthode est ajoutée à la zone du pays du client (ou que Ignore shipping zones est activé et que le pays est autorisé). Contrôlez les limites de poids du panier, le Minimum order amount et les Excluded shipping classes. En mode prix fixes, vérifiez que le pays ou * a un prix.

Les tarifs en temps réel n'apparaissent pas : activez le Debug log, rechargez la page de paiement et ouvrez WooCommerce > Status > Logs (source « vfd-australia-post »). Le journal indique la raison : pas de clé d'API ou de code postal d'expédition, pas encore de code postal de livraison à 4 chiffres, colis au-delà des limites, pas de taux de conversion AUD, ou le message d'erreur d'Australia Post. Avec Live rates, fixed price if the API gives no rate, les clients reçoivent toujours le prix fixe pendant que vous corrigez le problème.

Ma boutique n'est pas en AUD : saisissez le taux de conversion (combien d'unités de votre devise vaut un AUD) dans AUD → (your currency) rate. Les prix fixes sont toujours exprimés dans la devise de votre boutique.

La GST est facturée deux fois sur la livraison : les prix nationaux d'Australia Post incluent 10 % de GST. Si Tax status est Taxable, activez Remove GST.

Le prix est trop élevé ou trop bas : vérifiez les poids et dimensions des produits ainsi que les valeurs par défaut de Parcel for live rates. Avec Item (price × quantity), les prix fixes sont multipliés par le nombre d'articles.

Les tarifs semblent obsolètes après une modification : enregistrez la page des réglages. Cela efface les tarifs Australia Post en cache.

Le bloc de licence affiche une erreur : suivez le message affiché dans le bloc. Par exemple, si la clé est déjà utilisée sur un autre domaine, libérez un emplacement dans votre compte vibefox.net puis cliquez sur Check now. Si l'adresse du site a changé, cliquez sur Check now pour activer la clé sur le nouveau domaine. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier état connu.

Désinstallation

La désactivation de l'extension conserve toutes les données. Pour la supprimer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et l'état de licence de cette extension sont toujours supprimés. Les réglages, les méthodes de zone et les tarifs en cache ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les commandes existantes conservent leurs lignes de livraison.

Australia Post est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à Australia Post ni approuvée par elle.