Connecter votre site à la boutique pneus

Le principe

Votre site lit les pneus publiés et envoie les demandes et les commandes par l'API de la boutique. Les prix sont calculés par QuotyFast avec la marge boutique — pourcentage, montant fixe par pneu, ou pourcentage avec un minimum — TVA et contribution Recytyre comprises.

Tout passe par une URL de base propre à votre organisation, jeton compris : l'onglet « Pneus › Boutique » l'affiche dans la carte « Boutique en ligne », avec « Copier ».

Donner l'intégration à votre webmaster

1. 1Ouvrez « Pneus », onglet « Boutique ». L'onglet est réservé au propriétaire.
2. 2Dans la carte « Boutique en ligne », dépliez « Connecter votre site ».
3. 3Cliquez sur « Télécharger la fiche d'intégration » : le fichier contient chaque appel, un exemple curl et un exemple côté serveur, avec votre URL de base déjà en place.
4. 4Transmettez la fiche à votre webmaster.

Le jeton reste côté serveur : le site appelle l'API depuis son serveur (PHP, Node…), jamais depuis le navigateur du visiteur. Si un appel depuis le navigateur est indispensable, ajoutez le domaine du site dans « Domaines autorisés » — le jeton devient alors visible de tous les visiteurs.

Les appels

Catalogue — GET tyres/search : les pneus publiés, 24 par page, avec filtres saison, marque, gamme et prix.

Dimensions — GET tyres/sizes/widths, puis aspects et diameters : de quoi construire un sélecteur de dimension.

Recherche par dimension — GET tyres/search?width=205&aspect=55&diameter=16.

Détail d'un article — GET tyres/{id} : prix, disponibilité, étiquette européenne, photo.

Demande de devis — POST quote-request : la demande arrive dans « Demandes web ». Le consentement est obligatoire.

Commande et paiement — POST checkout : la commande est chiffrée par QuotyFast, la réponse donne l'adresse de paiement Mollie vers laquelle envoyer le client. Réservé au mode « Commande payée en ligne ».

Modes de remise — GET fulfilment-options?postalCode=1000&lines=TYRE:123:4 : pour ce code postal, chaque mode (montage au garage, retrait, livraison à domicile, montage à domicile) possible ou pourquoi pas (hors zone, minimum de pneus, complet), ses frais HTVA et TVAC, la livraison offerte et le premier jour ou créneau.

Jours de livraison — GET delivery-days?postalCode=1000&lines=… : les jours libres pour une livraison à domicile ; le jour choisi part en deliveryDate au checkout.

Créneaux du service mobile — GET slots?mode=MOBILE_FITTING&postalCode=1000&lines=… : les créneaux de vos ressources mobiles, trajet compris, indépendants de ceux de l'atelier.

Commande livrée ou montée à domicile — POST checkout avec fulfilmentMode (HOME_DELIVERY ou MOBILE_FITTING), l'adresse (rue, numéro, code postal, ville, complément), le jour de livraison ou le créneau mobile, et pour le montage à domicile le type de lieu et les deux confirmations cochées. Le serveur recalcule la zone, les frais et le total : rien de ce que le site envoie sur les prix n'est cru. Sans fulfilmentMode, la commande se passe comme avant.

Suivi — GET orders/{orderToken} : l'état du paiement et de la commande, sur votre page de retour. Le champ fulfilment donne le mode, l'adresse, le jour ou le créneau et les frais ; l'ancien champ fulfilmentMode est déprécié (MOUNTING : avec montage, PICKUP : sans montage).

Livraison à domicile et montage à domicile

Deux modes de remise de plus pour la commande payée en ligne : la livraison à domicile, sans montage, et le montage à domicile par votre service mobile, chez le client ou sur son lieu de travail. Chacun se règle dans « Pneus › Réglages », carte « Livraison et service mobile ».

Les zones de service listent les codes postaux desservis, séparés par des virgules, avec leurs frais HTVA : livraison, déplacement, et le montant TVAC à partir duquel la livraison est offerte. Un code postal hors zone n'a ni livraison ni montage à domicile. Les frais tombent sur le bon de commande et la facture comme une ligne normale, avec le libellé et la TVA de l'article lié choisi dans la carte.

Le montage à domicile reprend vos forfaits de montage, plus les frais de déplacement. Il se planifie sur une ou plusieurs ressources de l'atelier marquées mobiles, avec leurs propres jours et heures : la durée compte le trajet (45 minutes pour deux pneus, 60 pour quatre par défaut). Le créneau est tenu 15 minutes pendant le paiement, puis devient un rendez-vous « Montage à domicile » du planning Atelier, avec le badge « Mobile » et l'adresse.

La livraison se fait un des jours de livraison réglés, dans la limite du nombre de livraisons par jour, à partir du jour où les pneus sont au garage.

Au paiement, un bon de livraison est créé avec l'adresse et la date ; celui d'un montage à domicile est assigné au technicien lié à la ressource mobile. Le technicien le fait signer sur l'application mobile : la commande passe alors à « Livré » ou « Monté », la facture est émise et envoyée au client, déjà payée. Une commande remboursée avant la livraison n'a pas de facture.

Un mode activé auquel il manque une zone, l'article de ses frais ou une ressource mobile n'est pas proposé sur votre site : la carte et la liste « Il reste à faire » de l'onglet Boutique disent ce qui manque.

Vérifier la connexion

« Vérifier maintenant » appelle la boutique comme votre site le ferait : le jeton, puis le catalogue, les dimensions, un article et la configuration de commande, avec le résultat de chaque appel. La demande de devis et la commande ne sont jamais testées : une vérification ne crée rien.

Le même écran rappelle le dernier appel de votre site et les domaines autorisés.

Activer la commande payée en ligne

Dans la carte « Mode de la boutique », choisissez « Commande payée en ligne ». Tant qu'il manque quelque chose, la liste « Il reste à faire » dit pourquoi chaque point est requis et mène à l'endroit où le régler : compte Mollie ou Stripe, module Commandes & livraisons (une commande payée devient bon de commande, bon de livraison puis facture), URL de retour, URL des conditions générales, forfait montage.