Satellite de Boutique v1.4.0
Configurer Expédition & étiquettes
Le socle d'expédition : un écran de vérification pré-rempli sur chaque commande, l'étiquette, le retour, le bordereau. Avec un transporteur de test qui marche sans contrat, et les vrais (Colissimo…) qui se branchent dessus.
Ce qu'il fait
Le socle d'expédition de votre boutique : préparez une expédition depuis la commande sur un écran de vérification pré-rempli (adresse, articles, poids, service), générez l'étiquette, l'étiquette retour, le bordereau de remise, et suivez vos colis. Une commande peut donner plusieurs expéditions, chaque expédition ses documents. Ce module inclut un TRANSPORTEUR DE TEST qui fonctionne sans aucun contrat : vous déroulez tout le parcours dès l'installation. Les vrais transporteurs (Colissimo…) se branchent dessus sans rien changer.
- Un écran de vérification pré-rempli, pas un bouton aveugle
- Une commande → plusieurs expéditions → plusieurs documents
- Étiquette, étiquette retour, bordereau de remise
- Un transporteur de test qui fonctionne sans aucun contrat
- Les vrais transporteurs se branchent sans rien réécrire
- Étiquettes en lot depuis la liste des commandes : un écran montre ce qui part et ce qui est à reprendre (vingt commandes par lot), et une commande déjà expédiée n'est jamais régénérée
- Téléchargement groupé des étiquettes : un ZIP de PDF, ou les étiquettes à la suite pour une imprimante thermique (ZPL)
- Le client choisit son point relais sur une carte pendant la commande, et le retrouve sur sa page de commande
- Une commande peut porter plusieurs numéros de suivi, que le client voit sur sa page de commande
- Réglages à l'écran (Boutique → Réglages d'expédition) : adresse d'expéditeur, transporteurs connectés, services proposés, et chaque mode de livraison relié à son transporteur
Ses droits
Ce que chaque rôle peut faire par défaut. Modifiable rôle par rôle depuis l'administration.
| Droit | Clé | Administrateur | Éditeur |
|---|---|---|---|
| Préparer et gérer les expéditions | expedition.manage |
✓ | — |
Ses satellites
Des modules qui se greffent sur celui-ci et s'activent séparément. Chacun a sa page.
- Boutique — Boxtal (quatorze transporteurs) Branche Boxtal sur le socle d'expédition, et avec lui quatorze transporteurs sous un seul contrat
- Boutique — Colissimo (La Poste) Branche Colissimo (La Poste) sur le socle d'expédition : génère vos étiquettes, cherche les points relais, édite le bordereau de…
Ce qu'il suppose
Ce module a besoin de :
- shop ^1.59
Le désactiver arrêterait aussi :
Piloter par une IA
Ce que ce module sait faire quand on le lui demande en langage naturel, et ce que chaque action engage.
-
a_expedierlecture seuleListe les commandes à préparer (celles dont le statut demande une action) et, pour chacune, ce que l'écran d'étiquette proposerait : transporteur, offre, mode (domicile ou relais), poids, destinataire (nom, code postal, ville, pays), PRÊTE ou non, et la raison quand elle ne l'est pas (sans poids, point relais non choisi, étiquette déjà faite…). 50 au plus par appel, `suite` donne l'offset suivant.
« quelles commandes dois-je expédier aujourd'hui ? » « lesquelles sont prêtes pour une étiquette ? »
-
expeditionslecture seuleLes expéditions d'une commande, actives et annulées : transporteur, offre, mode, numéro de suivi et lien, état, test ou réel, et les documents qui existent (étiquette, retour, CN23, bordereau) sans jamais leur chemin. Les fichiers se téléchargent à l'écran.
« quel est le numéro de suivi de la commande CMD-2026-000006 ? »
-
generer_lotconfirmation demandéeGénère les étiquettes d'un lot de commandes à préparer : seules celles qui sont PRÊTES partent (les autres disent pourquoi), une commande qui a déjà une étiquette n'est jamais régénérée. UNE ÉTIQUETTE SE PAIE chez le transporteur (sauf en mode test, dit dans la réponse) : confirmation demandée. 20 commandes au plus par lot ; une commande inconnue ou qui n'est pas « à préparer » refuse tout le lot avant le premier appel. Consulte shop-expedition.a_expedier avant.
Ses points de branchement
Pour greffer du code sans toucher au module : ce qu'il annonce, et ce qu'il écoute.
Ce qu'il annonce 4
colis.expedie- Event — une étiquette vient d'être générée pour cette commande. Args: [array $order]. Un statut réglé sur cet événement y bascule seul.
bordereau.cree- Event — un bordereau de remise vient d'être édité, une fois PAR COMMANDE concernée (un bordereau en couvre plusieurs). Args: [array $order].
shop.transporteurs- Filtre : slug => classe. Un satellite ajoute son transporteur (Colissimo…).
shop.expedition.creee- Événement : une expédition vient d'être créée (expédition, commande).
Ce qu'il écoute 8
shop.documents.delivery_snapshot- priorité 10
shop.order.main.panels- priorité 50
shop.checkout.livraison.apres- priorité 20
shop.order.created- priorité 20
shop.order.adresses.apres- priorité 20
shop.order.public.livraison- priorité 20
shop.hub.tiles- priorité 66
shop.commandes.gestes_groupes- priorité 20
Ses prises front
Les morceaux de page que ce module fournit, et les classes qu'ils posent. Un thème les habille par ces classes : il ne recopie pas le balisage, sinon il rate les corrections des versions suivantes.
views/points-relais.php
8 classes
s-relaiss-relais-adresses-relais-distances-relais-listes-relais-noms-relais-points-relais-reseaus-relais-vide
Ses données
Les tables que ce module crée. Désactiver un module ne les efface pas : ses données restent en base et reviennent s'il est réactivé.
Les tables 2
shop_shipment_documentsshop_shipments