Guide

Tenir une boutique.

Des produits, des déclinaisons, des abonnements, des codes promo, des commandes et leurs factures — et ce que Google et les assistants en lisent. Ce guide va du premier produit à la première vente, puis au quotidien.

1. Mettre la boutique en ligne

Tout ce qui vaut pour la boutique entière se règle une fois, dans Boutique › Réglages et Boutique › Moyens de paiement.

  1. Boutique en ligne active : tant qu'elle est décochée, les fiches, le panier et le paiement restent fermés au public.
  2. Devise, TVA et prix : les taux de TVA forment une liste (Boutique › Facturation › Réglages de facturation) ; chaque produit en choisit un. Les prix s'affichent TTC ou HT, au choix. La franchise en base (art. 293 B) se règle aussi.
  3. Livraison : des zones (pays, tarif TTC) et un seuil de gratuité. Le port est calculé à l'étape des coordonnées, avec sa part de TVA.
  4. Retours : le nombre de jours, s'il y en a un. Il est repris dans les données lues par Google.
  5. Afficher le panier : une icône dans le menu du site, pour tous les menus à la fois.
  6. Stripe : la clé publique, la clé secrète et le secret du webhook, dans Moyens de paiement. Le webhook pointe vers https://votre-site/shop/webhook/stripe/.

2. Le produit

Un produit, c'est un contenu — une fiche — et une dimension marchande : prix, TVA, stock, référence. On les crée dans cet ordre.

Type de produit « Atelier » — ce que la vente entraîne
└─ Modèle de fiche les champs : durée, niveau, image…
└─ Gabarit la page dessinée une fois pour toutes les fiches
└─ Fiche « Atelier menuiserie » — le contenu, son adresse
└─ Produit prix, TVA, stock, référence ATELIER-01

  1. Cinq natures de type : produit physique (expédié), formation en ligne (ouvre l'accès à la formation), questionnaire, rendez-vous ou crédits, service.
  2. Le prix se saisit HT ou TTC ; le TTC saisi est celui encaissé, au centime.
  3. Le stock se suit ou non. Un produit suivi et épuisé ne se vend plus ; le client peut demander à être prévenu de son retour.
  4. Catégories, produits associés, marque et GTIN servent aux filtres de la boutique, au bloc « Vous aimerez aussi » et à Google Shopping.
  5. Les métadonnées et l'image principale se posent sur la fiche : ce sont elles que lisent Google et les partages sur les réseaux.
  6. Une grille de produits se pose sur une page avec le bloc « Grille de ressources » : elle se tient à jour seule, avec filtres et tri.

3. Les déclinaisons

Une taille, une couleur, une formule : chaque déclinaison a sa référence, son stock et, au besoin, son prix. La fiche montre un seul sélecteur.

  1. Une seule fiche pour toutes les déclinaisons : un seul contenu à tenir, et des avis clients qui valent pour toutes.
  2. Chaque déclinaison a son adresse : /shop/…/REF/?declinaison=REF-ROUGE ouvre la fiche avec cette déclinaison choisie. C'est l'adresse donnée à Google, qui vérifie que la page affiche bien le prix annoncé.
  3. Une déclinaison épuisée reste visible, grisée, avec l'alerte de retour en stock.

4. Abonnements et essai gratuit

Un produit peut se prélever chaque mois ou chaque année. Le paiement se fait sur la page de Stripe, et Stripe fait foi.

Produit « Licence — 1 site »
├─ Déclinaison Mensuel 9 € abonnement : month
└─ Déclinaison Annuel 90 € abonnement : year
Essai gratuit 30 jours, un par compte, carte demandée

  1. Mensuel et annuel sur le même produit : une déclinaison par mode, chacune avec son prix.
  2. L'essai gratuit se règle en jours sur le produit. Rien n'est prélevé avant sa fin ; un seul essai par compte.
  3. Chaque prélèvement devient une commande payée, avec sa facture. Un prélèvement échoué est retenté par Stripe ; le client change sa carte depuis son compte.
  4. Le client gère tout depuis son compte — carte, factures, résiliation — par le portail de Stripe, à activer chez Stripe.
  5. Chez Stripe, le webhook doit envoyer : checkout.session.completed, customer.subscription.*, invoice.paid, invoice.payment_failed.
  6. Un produit à 0 € — un essai sans carte, un échantillon — se commande sans paiement : le client crée son compte et valide.
  7. Un abonnement se commande seul, sans code promo ni livraison.

5. Les codes promo

Boutique › Codes promo. Le client saisit le code dans son panier ; la remise apparaît avant le paiement.

  1. Trois remises : un pourcentage, un montant fixe TTC, ou la livraison offerte.
  2. Des conditions : dates de début et de fin, montant minimum du panier, produits ou types de produit concernés.
  3. Des plafonds : un nombre total d'utilisations et un nombre par client. Pour une offre « les 50 premiers », une commande en cours de paiement réserve son usage trente minutes : deux clients ne prennent pas le dernier en même temps.
  4. Ni sur un abonnement, ni sur un produit gratuit : les abonnements se paient sur la page de Stripe, sans code.

6. Les commandes

Le client passe par trois écrans : le panier, ses coordonnées — un compte se crée à cette étape s'il n'en a pas —, puis le paiement. Le montant payé est celui du récapitulatif, recalculé au dernier moment.

  1. Boutique › Commandes : chaque commande, ses lignes, son paiement et son statut — en préparation, expédiée (avec transporteur et numéro de suivi, envoyés au client), terminée.
  2. « Marquer payée » règle une commande reçue hors ligne (virement, chèque) comme une carte : accès ouverts, stock décompté, confirmation envoyée.
  3. Rembourser tout ou partie, par Stripe ou hors ligne, depuis la fiche de la commande : l'avoir est émis, le stock remis, le client prévenu.
  4. Ventes : le tableau de bord des ventes de la période.
  5. Les relances partent seules : panier abandonné, retour en stock, liste d'envies.
  6. Les avis clients se modèrent dans Boutique › Avis clients ; seuls les avis publiés comptent dans la note.

7. La facturation

Boutique › Facturation. Une commande payée reçoit sa facture ; les devis et factures hors boutique se font à la main, dans la même suite de numéros.

Devis DEV2026-0001 → accepté en ligne par le client
Facture FAC2026-0001 → acompte, puis solde
Avoir AV2026-0001 → corrige une facture émise

  1. Une numérotation sans trou, réglable : préfixe, année, mois. Une suite pour les factures (boutique comprise), une pour les devis, une pour les avoirs.
  2. Une facture émise ne se modifie plus : on la corrige par un avoir, puis une nouvelle facture.
  3. Le lien du client, sans compte : il lit le devis, clique « J'accepte », paie la facture par carte.
  4. Envoi par e-mail avec le PDF, et relances des factures impayées, désactivables.
  5. Export comptable en CSV : les pièces et les règlements d'une période.
  6. L'identité de facturation — raison sociale, adresse, SIRET, TVA, mentions — se règle une fois, dans Réglages de facturation.

8. Google et les assistants IA

Une boutique se vend aussi dans les résultats de Google, dans Google Shopping et dans les réponses des assistants. Tout ce qu'ils lisent est produit seul, à partir des produits — rien à écrire à la main.

  1. Sur chaque fiche, des données structurées (JSON-LD) : nom, description, image, marque, prix, disponibilité, déclinaisons, abonnement, note et avis, livraison et retours.
  2. Le flux Google Shopping : https://votre-site/shop/flux/google.xml — sur jeiko.fr, https://jeiko.fr/shop/flux/google.xml. Une ligne par produit ou par déclinaison, avec son adresse, son image et, pour un abonnement, son coût par mois ou par an. Un produit gratuit n'y figure pas : Google refuse un prix nul.
  3. Le catalogue pour les assistants : /shop/catalogue.json, et la section boutique de /llms.txt.
  4. Le plan du site (/sitemap.xml) liste chaque fiche publiée.

Déclarer le flux dans Google Merchant Center

  1. Créez un compte sur merchants.google.com et faites valider votre site : le plus simple passe par Google Search Console, avec une propriété de domaine (un enregistrement DNS chez votre registraire).
  2. Produits › Ajouter des produits › Ajouter un flux de produits, par « récupération planifiée » : collez l'adresse du flux, une récupération par jour.
  3. Réglez la livraison (« aucune » pour un service ou un produit numérique) et la politique de retour du compte.
  4. Chaque produit a besoin d'une image d'au moins 100 × 100 pixels — l'image principale de sa fiche. Sans elle, Google refuse l'article.

9. L'API, et ce que la boutique ne fait pas

  1. Par l'API et le connecteur Claude, un agent crée et tient les produits, les déclinaisons, les codes promo, les commandes (statut, expédition), les devis et factures, et lit les ventes.
  2. Restent à l'exploitant, à dessein : rembourser et marquer payée — des gestes qui font bouger de l'argent.
  3. La TVA par pays de l'acheteur (guichet unique OSS, ventes à distance dans l'Union au-delà de 10 000 €) n'est pas gérée : un seul taux par produit.
  4. Le libellé d'une déclinaison est le même dans toutes les langues du site ; la fiche, elle, se traduit.

La boutiqueLes paiements