Flux produits pour ChatGPT : ce que demande la spécification d'OpenAI, champ par champ

ChatGPT ne devine pas votre catalogue : il le lit dans un flux produits que le commerçant lui transmet. La documentation d'OpenAI décrit ce flux avec précision. Nous l'avons lue, sans rien tester. Voici ce qu'elle exige.

Qui peut envoyer un flux

Première limite : l'intégration des flux est, selon le guide de démarrage, réservée aux partenaires approuvés. La demande se fait par un formulaire sur chatgpt.com/merchants. Seconde limite, importante pour un vendeur français : le schéma indique que les envois standards utilisent les États-Unis comme pays cible, et que le format partagé couvre les États-Unis, le Canada et le Mexique. Un champ pays laissé vide ne vaut pas « monde entier ».

Certaines catégories sont exclues, notamment l'alcool, la nicotine, les jeux d'argent, les armes et les médicaments sur ordonnance.

Le principe : un instantané complet, chaque jour

• Le flux est un export intégral du catalogue, pas une liste de modifications.
• OpenAI recommande au moins un envoi par jour, à horaire régulier.
• Le dépôt se fait par SFTP, un transfert de fichiers sécurisé.
• Format préféré : Parquet. Sont aussi acceptés jsonl.gz, csv.gz et tsv.gz, en UTF-8.
• On réécrit toujours le même nom de fichier. Pour un gros catalogue, on découpe en lots de 500 000 articles au plus, en visant moins de 500 Mo environ par fichier.

Un produit absent d'un envoi n'est pas supprimé tout de suite : sa dernière version est conservée jusqu'à 14 jours. Pour le retirer immédiatement de la recherche, il faut le laisser dans le flux avec is_eligible_search à false.

Les neuf champs obligatoires

Champ	Ce qui est attendu
item_id	Identifiant stable et unique, jamais réutilisé
title	Titre concis, 150 caractères au plus de préférence
description	Texte brut et factuel, 5 000 caractères au plus de préférence
url	Adresse publique et stable de la fiche
brand	Marque réelle, telle qu'affichée sur la fiche
seller_name	Nom du vendeur
image_url	Lien direct vers une image de la variante
availability	in_stock, out_of_stock, pre_order, backorder ou unknown
price	Montant puis devise, par exemple 79.99 USD

Une disponibilité absente ou mal écrite fait rejeter la ligne. Le prix s'écrit avec un point décimal, sans séparateur de milliers, suivi du code de devise en majuscules.

Les champs qui font la différence

• Variantes. Tailles et couleurs exigent group_id, listing_has_variations et variant_dict sur chaque ligne.
• Code-barres. Le gtin est facultatif, mais doit être exact : 8, 12, 13 ou 14 chiffres, clé de contrôle valide, conservé comme texte. La documentation demande de ne pas inventer de référence fabricant pour pallier un code manquant.
• Livraison. Un prix de livraison omis signifie « inconnu », pas « gratuit ».
• Retours. Acceptation, délai en jours et lien vers la politique se déclarent séparément.
• Paiement dans ChatGPT. Il est désactivé par défaut. L'activer suppose is_eligible_checkout, plus les liens vers vos conditions de vente et votre politique de confidentialité.

Avant le premier envoi

La documentation conseille de commencer par un échantillon d'une centaine d'articles, puis de contrôler le premier export complet avant d'automatiser. Les trois erreurs les plus fréquentes citées : champ obligatoire manquant, nom de champ périmé, valeur mal formée.

Les limites

Être éligible ne garantit pas d'être affiché : OpenAI l'écrit noir sur blanc. Le commerçant n'a aucune visibilité sur les critères de classement, et OpenAI se réserve le droit de retirer un produit ou un vendeur. C'est une dépendance comparable à celle d'une place de marché.

Notre lecture

Même sans accès aujourd'hui, le travail utile est connu : identifiants stables, codes-barres exacts, variantes proprement regroupées, prix de livraison et conditions de retour renseignés. Ces données servent déjà à Google Merchant Center et aux places de marché. Un catalogue propre sera prêt le jour où l'accès s'ouvrira en France, et il vend mieux dès maintenant.