Aller au contenu

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.

shop-expedition

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.

Ce qu'il suppose

Ce module a besoin de :

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_expedier lecture seule

    Liste 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 ? »

  • expeditions lecture seule

    Les 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_lot confirmation demandée

    Gé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-relais
  • s-relais-adresse
  • s-relais-distance
  • s-relais-liste
  • s-relais-nom
  • s-relais-point
  • s-relais-reseau
  • s-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_documents
  • shop_shipments