# Documentation des champs produits Kiubi

## Informations propres au produit

| Nom du champ | Valeur attendue | Description |
|---|---|---|
| `produit_id` | Nombre entier positif ou `#` | Numéro d’identifiant Kiubi unique d’un produit.<br><br>`#` : crée un nouveau produit.<br>`N°` : met à jour le produit ayant le même numéro.<br>Champ vide : crée une variante rattachée au produit précédemment déclaré. |
| `type_produit` | Chaîne de caractères | Nom du répertoire figurant dans `/theme/fr/produits/`, correspondant au type de fiche produit souhaité. |
| `activer` | `Oui` ou `Non` / `1` ou `0` | Paramètre d’affichage du produit. |
| `favoris` | `Oui` ou `Non` / `1` ou `0` | Produit vedette. |
| `date_dispo` | Date : `aaaa-mm-jj`, `aaaa/mm/jj`, `jj-mm-aaaa` ou `jj/mm/aaaa` | Date de disponibilité. |
| `lg` | `fr` | Paramètre de langue. Inutilisé actuellement. |
| `intitule_produit` | Chaîne de caractères | Intitulé. |
| `chapo_produit` | Chaîne de caractères / Code HTML | Chapô : description courte, habituellement utilisée dans les listings. |
| `desc_produit` | Chaîne de caractères / Code HTML | Description. |
| `tags_raw` | Chaîne de caractères | Tags séparés par des virgules. |
| `nom_optim` | Chaîne de caractères | Nom optimisé constituant la partie de l’URL de la fiche produit comprise entre `www.societe.com/catalogue/` et `.html`. |
| `title` | Chaîne de caractères | Titre de la page, contenu de la balise `<title>`. |
| `meta_desc` | Chaîne de caractères | Méta description. |
| `meta_keys` | Chaîne de caractères | Méta keywords. |
| `meta_image` | Chaîne de caractères | Image d'indexation pour le produit. |
| `js_head` | Chaîne de caractères / Code HTML | Scripts insérés avant `</head>`, à la fin de l’en-tête HTML de la fiche produit. |
| `js_body` | Chaîne de caractères / Code HTML | Scripts insérés avant `</body>`, à la fin du corps HTML de la fiche produit. |
| `categories_ids` | Nombre entier positifn séparés par des virgules | Identifiants Kiubi des catégories.<br><br>Le premier identifiant correspond à la catégorie principale. Les catégories doivent déjà exister dans le catalogue.<br><br>Ce champ prime sur `categories`. |
| `categories` | Chaîne de caractères | Intitulés des catégories, séparés par des virgules.<br><br>Le premier intitulé correspond à la catégorie principale. Les catégories inexistantes sont créées automatiquement.<br><br>`categories_ids` doit être vide pour que ce champ soit pris en compte. |
| `marque` | Chaîne de caractères | Nom de la marque. |
| `illustrations_ids` | Nombres entiers positifs séparés par des virgules | Identifiants Kiubi des illustrations du produit.<br><br>Le premier identifiant correspond à l’illustration principale. Les illustrations doivent déjà exister dans la médiathèque.<br><br>Ce champ prime sur `illustrations`. |
| `illustrations` | Noms de fichier, séparés par des virgules| Noms des fichiers des illustrations.<br><br>Le premier fichier correspond à l’illustration principale. Les fichiers doivent déjà exister dans la médiathèque, quel que soit leur dossier.<br><br>`illustrations_ids` doit être vide pour que ce champ soit pris en compte. |
| `texte1` à `texte15` | Chaîne de caractères / Code HTML | Valeurs des champs `texte1` à `texte15`. Par défaut, ces champs ne sont pas affichés dans le type de produit « produit simple ». |
| `suivi_stock` | `Oui` ou `Non` / `1` ou `0` | Notification en cas de passage du stock sous le seuil de réapprovisionnement. |
| `tarif_degressif` | Entier | Identifiant de la grille de tarif dégressifs.

## Informations propres aux variantes du produit

| Nom du champ | Valeur attendue | Description |
|---|---|---|
| `reference` | Chaîne de caractères | Référence de la variante. Il est recommandé que chaque variante dispose d’une référence unique dans le catalogue. |
| `code_barre` | Chaîne de caractères | Code barre de la variante. |
| `condition` | `neuf`, `occasion`, `reconditionné` ou vide | État. |
| `taxe` | Nombre décimal positif, séparateur `.` | Taux de taxe (TVA) de la variante. |
| `prix_HT` | Nombre décimal positif, séparateur `.` | Prix HT de la variante.<br><br>Si le champ est vide, il est calculé automatiquement à partir du taux de taxe et du prix TTC. |
| `prix_TTC` | Nombre décimal positif, séparateur `.` | Prix TTC de la variante.<br><br>Si le champ est vide, il est calculé automatiquement à partir du taux de taxe et du prix HT.<br><br>Si la valeur ne correspond pas au prix HT augmenté du taux de taxe, le prix TTC est recalculé automatiquement. |
| `promo_HT` | Nombre décimal positif, séparateur `.` | Prix promotionnel HT de la variante. Il doit être inférieur au prix HT. |
| `promo_TTC` | Nombre décimal positif, séparateur `.` | Prix promotionnel TTC de la variante. Il doit être inférieur au prix TTC.<br><br>Si la valeur ne correspond pas au prix promotionnel HT augmenté du taux de taxe, le prix promotionnel TTC est recalculé automatiquement. |
| `eco_taxe` | Nombre décimal, séparateur `.` | Montant de l’éco-taxe de la variante. |
| `poids` | Nombre entier positif | Poids de la variante en grammes. |
| `stock_illimite` | `Oui` ou `Non` / `1` ou `0` | Stock illimité ou non. |
| `stock` | Nombre entier positif | Niveau de stock de la variante. |
| `intitule_variante` | Chaîne de caractères | Intitulé de la variante. |
| `extra_livraison_HT` | Nombre décimal positif, séparateur `.` | Frais de port additionnels hors taxe. |
| `illustration_variante_id` | Entier | Identifiant de l'illustration de la variante. |
| `illustration_variante` | Chaine de caractère | Nom de fichier de l'illustration de la variante. |