La page Catalog Builder avec la carte du connecteur IA, la carte de téléversement du gabarit et la liste des constructions récentes.
Comment y accéder
Entities → ouvrez un marchand → onglet Catalog Builder.Accès
Si le marchand est hors de votre portée ou n’a pas la fonction Catalog, l’onglet vous ramène à Entities avec une explication.
Les deux façons de démarrer
Depuis votre assistant IA
Déposez une photo de menu, un PDF ou un chiffrier non standard dans Claude et demandez-lui de construire le menu. Idéal pour les marchands qui remettent un menu imprimé ou photographié.
Depuis le gabarit Taliup
Remplissez le chiffrier de produits Taliup et téléversez-le ici. Idéal lorsque le marchand a déjà des données propres.
Téléverser le gabarit Taliup
1
Téléchargez le gabarit
Cliquez sur Download template pour obtenir
BulkUploadTemplate.xlsx. Il contient une feuille Guidelines ainsi que les feuilles Products, Attributes et Tags.2
Remplissez-le
Complétez les feuilles. La référence des colonnes est la même que celle des marchands — voir Bulk Import.
3
Téléversez
Glissez le fichier sur la carte de téléversement ou cliquez sur Choose Excel file. Nommez la construction pour la reconnaître plus tard, puis cliquez sur Create draft.
4
Attendez l'ébauche
Le fichier est lu en arrière-plan. La construction passe à Ready for review et ouvre l’écran de révision.
Seul le gabarit Taliup est accepté à ce téléversement. Pour un menu sous toute autre forme — une photo, un PDF, l’export d’un concurrent — utilisez plutôt le connecteur IA.
Limites de taille
La carte de téléversement affiche les deux limites : 20 Mo et 2 000 articles. Le classeur est compté avant d’être stocké, donc un fichier trop gros est refusé immédiatement plutôt que d’échouer plus tard dans la file.Statuts de construction
Réviser l’ébauche
L’écran de révision est l’endroit où tout se joue. Il montre l’ensemble du catalogue proposé et vous permet de tout corriger avant la publication.
L'écran de révision de Catalog Builder avec la bannière de validation, les onglets et l'arborescence des catégories et articles.
Onglets
Décider du sort de chaque ligne
Chaque ligne — article, catégorie, attribut, taxe et étiquette — porte une action.
Catalog Builder compare chaque ligne à ce que le marchand possède déjà et suggère une correspondance. Une pastille de couleur à côté de l’action indique le niveau de confiance.
Cliquez sur la pastille pour ouvrir le sélecteur, chercher vous-même dans le catalogue du marchand et choisir un autre enregistrement. Une correspondance choisie à la main est verrouillée et ne sera pas remplacée par un appariement ultérieur.
Cela compte pour les photos. Link existing n’écrit rien du tout : une image portée par l’ébauche est donc abandonnée — la ligne vous avertit lorsque c’est le cas. Update existing ajoute la photo à un article qui n’en a pas, et laisse intacte une photo existante à moins que vous ne saisissiez vous-même l’URL de l’image dans l’écran de révision.Réimporter un menu que le marchand possède déjà produit surtout des lignes link et update : c’est donc le cas courant quand on ajoute des photos à un catalogue construit plus tôt.
Modifier les articles
Cliquez sur un article pour ouvrir son éditeur. Vous pouvez changer le nom, la description, le prix, le SKU, le coût, le fournisseur, la majoration, le type, les taxes, l’étiquette, les attributs et l’image.- Activez Custom price pour les articles à prix du marché. Le champ de prix se vide et l’article est vendu à un prix saisi sur le PDV.
- Le fournisseur est créé pour le marchand si le nom est nouveau. La majoration (%) est calculée à partir du coût et du prix si vous la laissez vide.
- Image accepte soit une adresse web, soit un fichier de votre propre poste — voir plus bas.
- Sold by weight exige une unité kg, g, lb ou oz, et ne peut pas être combiné au prix personnalisé.
- Passer un article à Service révèle les champs de durée et de réservation.
Photos des articles
Collez une adresse web dans Image et Taliup télécharge la photo et la stocke sur son propre stockage — le catalogue du marchand ne pointe jamais vers le site de quelqu’un d’autre, et n’est donc pas touché si celui-ci disparaît. Les photos sont stockées à 1 200 pixels de large au maximum. Certains sites refusent de servir leurs images aux serveurs de Taliup même si elles s’affichent parfaitement dans votre navigateur. Wix en fait partie. Le cas échéant, cliquez sur Upload a file instead et choisissez la photo sur votre poste : votre navigateur peut récupérer ce que le serveur ne peut pas, et le fichier aboutit exactement au même endroit.Le sommaire de publication compte les photos séparément des enregistrements, et indique lesquelles ont été téléchargées, lesquelles vous avez téléversées, quels articles ont conservé une photo existante, et lesquelles n’ont pas pu être récupérées parce que le site hôte a refusé Taliup. Les photos arrivent une minute environ après la publication — rechargez le produit pour les voir.
Corriger les problèmes avant de publier
La bannière du haut compte deux types de problème.
Les erreurs fréquentes sont un prix manquant sur un article qui n’est pas à prix personnalisé, un attribut sans valeur, et une ligne réglée à Link existing sans enregistrement choisi.
Articles sans prix
Une source qui ne donne aucun prix — une photo de menu dont la colonne est coupée, par exemple — produit un article à prix personnalisé, ce qui oblige la caissière à saisir le prix à chaque vente. C’est une décision prise à votre place : la ligne porte donc un avertissement qui le dit. Pour le retirer, au choix :- saisissez le prix, ou
- confirmez que l’article se facture bel et bien à la caisse, en cochant Custom price sur l’article ou avec l’action groupée Mark as custom price.
Actions groupées
Cochez des articles pour faire apparaître la barre d’actions groupées : passez-les tous à Link existing ou Create new, ajoutez une taxe, déplacez-les vers une autre catégorie, passez-les en prix personnalisé ou ignorez-les. Le menu à côté de Commit applique Link all confident matches ou Create all as new à toute l’ébauche. Mark as custom price est le moyen rapide d’accepter toute une section réellement facturée à la caisse. L’action vide le prix de chaque article, désactive Sold by weight, et lève l’avertissement de prix manquant sur chaque ligne touchée.Enregistrement
Les modifications s’enregistrent automatiquement quelques secondes après que vous cessez de taper, et Save draft force l’enregistrement. L’indicateur à côté du bouton montre l’état actuel.Si quelqu’un d’autre enregistre la même ébauche pendant que vous l’avez ouverte — un autre administrateur, ou votre assistant IA qui met à jour — vous serez averti que l’ébauche a changé et invité à recharger. Recharger abandonne vos modifications non enregistrées : enregistrez tôt.
Publier
Quand le nombre d’erreurs est à zéro et que tout est enregistré, cliquez sur Commit to catalog. Une confirmation détaille exactement combien d’enregistrements seront créés, liés, mis à jour et ignorés.
La confirmation de publication avec la répartition des créations, liens, mises à jour et exclusions par type d'enregistrement.
Si certaines lignes échouent
La construction revient à Ready for review avec les échecs indiqués sur les lignes fautives. Corrigez ces lignes et publiez de nouveau — les lignes déjà réussies sont ignorées, donc rien n’est dupliqué.Constructions récentes
La liste de la page Catalog Builder montre les 25 dernières constructions du marchand avec leur statut, la source, qui les a lancées et les décomptes. Ouvrez une construction pour voir son ébauche ou son sommaire de publication. Les constructions en cours se rafraîchissent d’elles-mêmes. Annulez depuis la liste une construction dont vous ne voulez plus. L’annulation abandonne l’ébauche.Les constructions terminées conservent leur ébauche 7 jours puis sont effacées, et le chiffrier téléversé est supprimé dès la publication. Une construction laissée en révision 30 jours est annulée automatiquement.
Configuration initiale
Cette section s’adresse à qui déploie Taliup HQ. Les administrateurs qui utilisent la fonction n’en ont pas besoin.
1
Exécutez les migrations
php artisan migrate crée la table de suivi des constructions et les tables OAuth du connecteur.2
Générez les clés OAuth
php artisan passport:keys sur chaque environnement. Les clés ne sont pas conservées dans le dépôt.3
Activez le connecteur
Réglez
CATALOG_BUILDER_MCP_ENABLED à vrai, et listez les clients IA autorisés dans MCP_REDIRECT_DOMAINS. Laisser l’indicateur désactivé masque la carte du connecteur et désactive ses points d’accès.MENU_FETCH_ALLOWED_DOMAINS, séparés par des virgules. La liste est vide par défaut, ce qui désactive la fonction. Un domaine couvre ses sous-domaines : exemple.com autorise donc aussi www.exemple.com et commande.exemple.com.
Les photos d’articles importées sont stockées à 1 200 pixels de large au maximum (CATALOG_BUILDER_IMAGE_MAX_WIDTH), et une photo téléversée dans l’écran de révision peut atteindre 10 Mo (CATALOG_BUILDER_IMAGE_UPLOAD_MAX_MB).
Le traitement en arrière-plan — y compris la récupération des photos d’articles — utilise une file dédiée catalog-builder, que le worker doit inclure :
catalog-builder:prune, efface les vieilles ébauches, expire les révisions abandonnées et supprime les photos téléversées pendant la révision qui n’ont jamais été publiées. Elle s’exécute quotidiennement avec le planificateur normal.
Quand les photos n’arrivent pas
Les photos sont récupérées après l’écriture des enregistrements : plusieurs causes distinctes peuvent donc en bloquer une sans bloquer la construction. Deux scripts en lecture seule, à la racine de l’application, y répondent dans l’ordre plutôt qu’au jugé :Une photo qui ne peut pas être téléchargée laisse une tâche en échec et un avertissement dans le journal, avec l’URL et la raison. Ce n’est pas silencieux.