Généralités
Les éléments et sous-nœuds supportés par Onventis sont listés dans les tableaux. Les modifications par rapport à la norme BMEcat 1.2 sont mises en évidence en rouge.
Les sous-nœuds avec leurs propres éléments sont signalés par un fond bleu et une double bordure. Le nom lié du sous-nœud vous permet d’accéder au tableau.
Les champs spécifiques à Onventis qui n’existent pas dans le standard BMEcat sont mis en évidence par un fond vert.
D’autres informations et conseils sont listés en bas de page.
Il est possible de revenir à la table des matières via la flèche bleue située sous les tableaux.
NOEUDS | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
NOM | Chaîne | Élément avec écart dans la longueur maximale du champ | 100 | X |
CHAMP LIÉ | Nœud inférieur lié | |||
ONV_DATA | Chaîne | Champ spécifique à Onventis | 100 | X |
Structure générale du catalogue BMEcat
Un catalogue BMEcat se compose des éléments “HEADER” et “T_NEW_CATALOG”, qui doivent être présents dans l’élément principal “BMECAT”. Ces deux éléments sont expliqués dans les chapitres suivants.
Figure 1 : Structure générale du catalogue BMEcat
Zone d’en-tête – HEADER
Dans l’en-tête du catalogue, il suffit d’indiquer dans l’élément “CATALOGUE” des informations concernant le catalogue. Il est en outre possible de prédéfinir le répertoire dans lequel se trouvent les pièces jointes. Tous les autres éléments du standard BMEcat sont ignorés, car ils doivent être définis dans le job d’importation. C’est pourquoi ce chapitre ne décrit que la structure de l’élément “CATALOGUE”.
Informations sur le catalogue – CATALOGUE
CATALOGUE | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
LANGUAGE | Chaîne | Définit la langue du catalogue, par exemple “DEU”. | 3 | X |
CATALOG_ID | Chaîne | Désignation univoque du catalogue | 20 | X |
CATALOG_VERSION | Chaîne | version du catalogue. Seulement pour T_NEW_CATALOG | 7 | X |
MIME_ROOT | Chaîne | Répertoire ou URL auquel les données de MIME_SOURCE font référence | 100 |
exemple:
<HEADER>
<CATALOGUE>
<LANGUAGE>DEU</LANGUAGE>
<CATALOG_ID>123456789</CATALOG_ID>
<CATALOG_VERSION>1.0</CATALOG_VERSION>
<MIME_ROOT>/Fichiers Mime/</MIME_ROOT>
</CATALOGUE>
</HEADER>
Structure du catalogue – T_NEW_CATALOG
La structure du catalogue est divisée en catégories, qui sont importées via l’élément “CATALOG_GROUP_SYSTEM”, les articles, élément “ARTICLE”, ainsi que l’attribution des articles à une catégorie via l’élément “ARTICLE_TO_CATALOGGROUP_MAP”.
Structure du catalogue
Catégories – CATALOG_GROUP_SYSTEM
CATALOG_GROUP_SYSTEM contient l’ensemble des catégories du catalogue, qui sont importées via l’élément “CATALOG_STRUCTURE”. Cet élément doit être indiqué par catégorie.
Pour chaque élément “CATALOG_STRUCTURE”, le type de la catégorie doit être transmis. Cela se fait via type=”…”, par exemple <CATALOG_STRUCTURE type=”feuille”.>
Les valeurs suivantes peuvent être passées comme type :
– “root” à Désigne la catégorie principale sous laquelle sont classées toutes les autres catégories. Celle-ci doit être présente une fois, mais peut être ignorée lors de l’importation.
– “node” à Catégorie qui ne contient pas d’articles, mais d’autres sous-catégories.
– “leaf” à Catégorie inférieure dans laquelle les articles sont déposés.
CATALOG_STRUCTURE | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
GROUP_ID | Chaîne | Numéro unique de la catégorie | 50 | X |
GROUP_NAME | Chaîne | Catégorie Désignation qui doit être affichée dans le système | 50 | X |
PARENT_ID | Chaîne | Le numéro de la catégorie parente. Pour la catégorie principale qui n’a pas de catégorie parent, il faut indiquer 0. | 50 | X |
GROUP_ORDER | Chaîne | Ordre d’affichage des catégories au sein d’un niveau, par ordre croissant | 5 | |
MIME_INFO | Nom de fichier ou chemin des images à afficher pour le nœud de catégorie concerné. |
exemple:
<CATALOG_STRUCTURE type=”racine”>
<GROUP_ID>1234567</GROUP_ID>
<GROUP_NAME>Racine</GROUP_NAME>
<GROUP_DESCRIPTION>Racine</GROUP_DESCRIPTION>
<ID_PARENT>0</ID_PARENT>
</CATALOG_STRUCTURE>
<CATALOG_STRUCTURE type=”nœud”>
<GROUP_ID>585861654</GROUP_ID>
<GROUP_NAME>Outils à main</GROUP_NAME>
<GROUP_DESCRIPTION />
<ID_PARENT>1234567</ID_PARENT>
</CATALOG_STRUCTURE>
<CATALOG_STRUCTURE type=”feuille”>
<GROUP_ID>112233</GROUP_ID>
<GROUP_NAME>Tournevis</GROUP_NAME>
<GROUP_DESCRIPTION />
<ID_PARENT>585861654</ID_PARENT>
<MIME_INFO>
<MIME>
<MIME_TYPE>image/jpeg</MIME_TYPE>
<MIME_SOURCE>exemple.jpg</MIME_SOURCE>
<MIME_PURPOSE>normal</MIME_PURPOSE>
</MIME>
</MIME_INFO>
</CATALOG_STRUCTURE>
Article – ARTICLE
Un article est défini par l’élément “ARTICLE”.
L’attribut mode=”delete” permet d’indiquer que l’article doit être supprimé. Contrairement à ce qui est recommandé dans le standard BMEcat, cela est possible chez Onventis dans le nœud “T_NEW_CATALOG”.
ARTICLE | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
SUPPLIER_AID | Chaîne | Numéro d’article unique du fournisseur | 32 | X |
ARTICLE_DETAILS | Contient toutes les informations qui décrivent l’article | X | ||
ARTICLE_FEATURES | Caractéristiques de l’article | |||
ARTICLE_ORDER _DÉTAILS |
Informations sur les conditions telles que les unités de commande, etc. | |||
ARTICLE_PRICE _DÉTAILS |
Informations sur le prix de l’article | |||
ARTICLE_REFERENCE | Affectation à un article supérieur. | |||
MIME_INFO | Données médias et fichiers joints de l’article | |||
USER_DEFINED _EXTENSIONS |
Contient plusieurs champs spécifiques à Onventis |
ARTICLE_DETAILS
Dans ARTICLE_DETAILS sont enregistrées toutes les informations qui identifient ou décrivent l’article.
ARTICLE_DETAILS | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
DESCRIPTION_SHORT | Chaîne | Titre de l’article | 500 | X |
DESCRIPTION_LONGUE | Chaîne | Description de l’article | 10.000 | |
SUPPLIER_ALT_AID | Chaîne | Numéro d’article supplémentaire. Si celui-ci est passé, SUPPLIER_AID ne sera pas affiché comme numéro d’article. | 35 | |
EAN | Chaîne | Numéro d’article européen | 35 | |
NOM_DU_FABRICANT | Chaîne | Nom du fabricant | 50 | |
MANUFACTURER_AID | Chaîne | Numéro d’article du fabricant | 35 | |
BUYER_AID | Chaîne | Numéro d’article du client. Pour cela, le client doit être sélectionné lors de l’importation sous “Numéros et groupes de matériaux pour les clients”. | 35 | |
ERP_GROUP_BUYER | Chaîne | Groupe d’articles du client. Pour cela, il faut également sélectionner le client comme décrit dans BUYER_AID. | 35 | |
MOT-CLÉ | Chaîne | Mots-clés pris en compte dans la recherche | 10.000 | |
ARTICLE_ORDER | Entier | Ordre de présentation | 3 | |
ARTICLE_STATUS type=’others |
Chaîne | Indique qu’un article est un “article spécial”, ce qui est signalé par une étoile. L’article est ainsi présenté en première position. Pour cela, la valeur “onventis-important” doit être transmise. Avec “onventis-not-important”, le code peut être à nouveau désactivé par importation. | 50 | |
ARTICLE_STATUS type=’core_sortiment’ (gamme de produits) |
Chaîne | Indique qu’un article est un “article de l’assortiment principal”, ce qui est signalé par une étoile ou un logo individuel. L’article est ainsi présenté en première position. Pour cela, la valeur “onventis-important” doit être transmise. Avec “onventis-not-important”, le code peut être à nouveau désactivé par importation. | 50 | |
DELIVERY_TIME | Entier | Délai de livraison en jours | 6 |
ARTICLE_FEATURES
Plusieurs propriétés d’un article peuvent être enregistrées dans ARTICLE_FEATURES. Chaque propriété est déposée via un nœud FEATURE.
ARTICLE_FEATURES | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
FEATURE | Valeurs des propriétés | X |
FEATURE
FEATURE | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
FNAME | Chaîne | Nom unique de la propriété au sein du groupe de propriétés actuel | 500 | X |
FORDER | Entier | Ordre dans lequel les propriétés doivent être affichées dans l’article | 6 | |
FUNIT | Chaîne | Unité de mesure de la propriété | 500 | |
FVALUE | Chaîne | Valeur de la propriété, peut être indiquée plusieurs fois. | 500 | X |
ARTICLE_ORDER_DETAILS
Informations sur les conditions de commande et les unités d’emballage d’un article.
ARTICLE_ORDER_DETAILS * |
||||
Élément | Type de données | Description | Longueur | Obligatoire |
ORDER_UNIT | Chaîne | Unité de quantité. Si elle n’est pas indiquée, l’unité par défaut de l’organisation est utilisée. | 20 | X |
NO_CU_PER_OU | Entier | Les valeurs des deux champs et ORDER_UNIT sont utilisées pour assembler le texte de l’unité d’emballage[1]. | 6 | |
CONTENT_UNIT | Chaîne | 20 | X | |
PRICE_QUANTITY | Entier | Unité de prix, standard = 1 | 6 | |
QUANTITY_MIN | Chaîne | Quantité minimale de commande, standard = 1 | 18,4 | |
QUANTITY_INTERVAL | Entier | Taille des étapes de la commande, par exemple par pas de 100 | 6 |
! Attention: pour les unités de commande et de contenu, veillez à respecter les consignes de votre client.
* Facultatif: l’ensemble du nœud <ARTICLE_ORDER_DETAILS> et <ARTICLE_PRICE_DETAILS> peut également être omis dans le BMEcat. Pour cela, il faut sélectionner l’option“pas de conditions” dans la configuration BCJob et charger un fichier de conditions correspondant par la suite. Cela vous permet de gérer séparément les informations sur les produits et les informations sur les conditions.
exemple:
<ARTICLE_ORDER_DETAILS>
<ORDER_UNIT>Paquet</ORDER_UNIT>
<CONTENT_UNIT>pcs</CONTENT_UNIT>
<NO_CU_PER_OU>50</NO_CU_PER_OU>
<PRICE_QUANTITY>1</PRICE_QUANTITY>
<QUANTITY_MIN>1</QUANTITY_MIN>
<QUANTITY_INTERVAL>1</QUANTITY_INTERVAL>
</ARTICLE_ORDER_DETAILS>
ARTICLE_PRICE_DETAILS
Indications sur le prix de l’article.
ARTICLE_PRICE_DETAILS | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
DATETIME
type=”valid_start_date” |
DateTime | Date de début de validité, format YYYY-MM-DD. Est indiqué dans le sous-nœud <DATE>. | 10 | |
DATETIME
type=”valid_end_date” |
DateTime | Date de fin de validité, format YYYY-MM-DD. Est indiqué dans le sous-nœud <DATE>. | 10 | |
ARTICLE_PRICE | Indications du prix de l’article, peut être présent plusieurs fois | X |
ARTICLE_PRICE
Les règles suivantes sont appliquées pour trouver le nœud ARTICLE_PRICE :
1. si la monnaie et le type de condition sont indiqués lors de l’importation, les nœuds correspondants sont recherchés (PRICE_CURRENCY et dans le nœud ARTICLE_PRICE dans l’attribut price_type)
2. si aucun nœud n’est trouvé, la recherche porte uniquement sur le type de condition (dans le nœud ARTICLE_PRICE attribut price_type).
3. si seule la devise est indiquée lors de l’importation, elle est recherchée et si rien n’est trouvé, le nœud lui-même est recherché sans caractéristiques particulières.
4. si seul le type de condition est indiqué lors de l’importation, il sera toujours recherché.
ARTICLE_PRICE | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
LOWER_BOUND | Entier | Quantités échelonnées, 0-5 quantités possibles, standard = 1 | ||
PRICE_AMOUNT | Décimal | Prix échelonnés, 0-5 prix possibles | 18,4 | X |
TAX | Décimal | Taux d’imposition, 0-5 taux d’imposition possibles (par ex. – 0.19 = 19%), par défaut = 0 | 4,2 | |
PRICE_CURRENCY | Ignoré ! La devise est définie dans l’interface du logiciel lors de l’importation. |
exemple:
<ARTICLE_PRICE_DETAILS>
<DATETIME type=”valid_sart_date”>
<DATE>2009-04-01</DATE>
</DATETIME>
<DATETIME type=”valid_sart_date”>
<DATE>2009-12-31</DATE>
</DATETIME>
<ARTICLE_PRICE price_type=”net_customer”>
<PRICE_AMOUNT>15.20</PRICE_AMOUNT>
<PRICE_CURRENCY>EUR</PRICE_CURRENCY>
<TAX>0.19</TAX>
<LOWER_BOUND>1</LOWER_BOUND>
</ARTICLE_PRICE>
<ARTICLE_PRICE price_type=”net_customer”>
<PRICE_AMOUNT>12.04</PRICE_AMOUNT>
<PRICE_CURRENCY>EUR</PRICE_CURRENCY>
<TAX>0.19</TAX>
<LOWER_BOUND>5</LOWER_BOUND>
</ARTICLE_PRICE>
</ARTICLE_PRICE_DETAILS>
ARTICLE_REFERENCE
Cet élément permet de représenter des variantes d’un article principal. Pour ce faire, le numéro d’article de l’article principal doit être enregistré pour chaque article à variantes.
ARTICLE_ REFERENCE | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
ART_ID_TO type=’others |
Chaîne | Numéro de l’article principal. Cela permet de définir les articles comme des variantes d’un article.
Seul type=’others’ est supporté |
X |
MIME_INFO
MIME_INFO permet d’ajouter plusieurs images et fichiers joints à un article. Chaque annexe doit être définie par un nœud MIME.
MIME_INFO | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
MIME | Fichier joint ou image d’article | X |
MIME
MIME | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
MIME_SOURCE | Chaîne | Nom de fichier de la pièce jointe | 200 | X |
MIME_PURPOSE | Chaîne | Motif de l’utilisation Par défaut = others, Valeurs possibles : logo, normal, vignette, détail, data_sheet, others, seal |
20 | |
MIME_TYPE | Chaîne | Type de mime de la pièce jointe, par exemple image/jpeg, image/gif, application/pdf | 30 | |
MIME_DESCR | Chaîne | Titre de la pièce jointe. Si non spécifié, le nom du fichier est utilisé comme titre | 200 |
USER_DEFINED_EXTENSIONS
Ce nœud permet d’importer d’autres champs spécifiques à Onventis.
USER_DEFINED_EXTENSIONS | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
UDX.ONV.GROUP_ARTICLE | Booléen | Si cela est défini, la balise VARIANT_ARTICLE n’est pas autorisée. La valeur n’a pas d’importance – seulement si le nœud existe ou non | 1 | |
UDX.ONV.VARIANT_ARTICLE | Booléen | Si cela est défini, la balise GROUP_ARTICLE n’est pas autorisée. La valeur n’a pas d’importance – seulement si le nœud existe ou non | 1 | |
UDX.ONV.NUMÉRO_DE_CATALOGUE | Chaîne | Numéros de catalogue supplémentaires, plusieurs fois possible | 35 | |
UDX.ONV.ECLASS_ID | Chaîne | Numéro d’écolage | 35 | |
UDX.ONV.UNSPSC_ID | Chaîne | Numéro UNSPSC | 35 | |
UDX.ONV.SALES_MARK | Chaîne | Affecte 0 à n groupes d’articles à l’article | 35 | |
UDX.ONV.AVAILABILITY | Entier | Disponibilité (affichage des feux de signalisation)
0 – pas d’affichage 5 – non disponible (feu rouge) 10 – disponible sous conditions (feu orange) 15 – disponible (feu vert) |
2 | |
UDX.ONV.PRIX_REMARK | Chaîne | Remarque externe sur la condition | 10.000 | |
UDX.ONV.DISPLAY_FEATURES / UDX.ONV.FEATURE |
Chaîne | Liste des numéros de propriétés (actuellement, le titre de la propriété est utilisé comme numéro) des articles à variantes – Si indiqué, seules ces propriétés sont affichées dans la liste des articles à variantes, 0-n possible | 200 | |
UDX.ONV.PAYS_DE_ORIGINE | (AF-Afghanistan, AL-Albania etc.) | |||
UDX.ONV.CUSTOMS_TARIF_NUMÉRO | (numéros existants si sélectionnables) | |||
UDX.ONV.CUSTOMS_WEIGHT | ||||
UDX.ONV.CUSTOMS_WEIGHT_TYPE | (0-g, 1-kg, 2-t). |
Affectation des articles aux catégories – ARTICLE_TO_CATALOGGROUP_MAP
Ce nœud permet de définir l’appartenance d’un article à une catégorie et doit donc être indiqué pour chaque article.
ARTICLE_TO_CATALOGGROUP_MAP | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
ART_ID | Chaîne | Numéro d’article unique | X | |
CATALOG_GROUP_ID | Chaîne | Numéro unique de la catégorie | X | |
ARTICLE_TO_CATALOGGROUP_MAP_ORDER | Ordre de présentation dans la catégorie |
Système de groupes de caractéristiques – FEATURE_SYSTEM
Ce nœud sert à construire un système de groupes de caractéristiques. En général, les caractéristiques sont toutefois lues directement à partir de l’article dans le nœud ARTICLE_FEATURES.
FEATURE_SYSTEM | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
SYSTÈME_DE_CARACTÈRES
NOM |
Chaîne | Désignation du système de groupes de caractéristiques | 50 | X |
SYSTÈME_DE_CARACTÈRES
DESCR |
Chaîne | Description du système de groupes de caractéristiques | 10.000 | |
FEATURE_GROUP | Groupes de caractéristiques | X |
FEATURE_GROUP
FEATURE_GROUP | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
FEATURE_GROUP_ID | Chaîne | Numéro de groupe de propriétés unique | 35 | X |
FEATURE_GROUP_
NOM |
Chaîne | Titre du groupe de propriétés | 50 | X |
FEATURE_TEMPLATE
type=” |
Caractéristiques. Type=’default’ est ignoré. | X |
FEATURE_TEMPLATE
FEATURE_TEMPLATE | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
FT_NAME | Chaîne | Titre de la propriété
|
60 | X |
FT_UNIT | Chaîne | Unité de la propriété | 20 | |
FT_ORDER | Entier | Ordre de présentation | 3 |
exemple:
<FEATURE_SYSTEM>
<FEATURE_SYSTEM_NAME>Exemple</FEATURE_SYSTEM_NAME>
<FEATURE_SYSTEM_DESCR>FEATURE SYSTEM pour la documentation</FEATURE_SYSTEM_DESCR>
<FEATURE_GROUP>
<FEATURE_GROUP_ID>123</FEATURE_GROUP_ID>
<FEATURE_GROUP_NAME>Clé à chocs</FEATURE_GROUP_NAME>
<FEATURE_TEMPLATE type=”free_entry” (entrée libre)>
<FT_NAME>Schlagwerk</FT_NAME>
<FT_UNIT/>
<FT_ORDER>1</FT_ORDER>
</FEATURE_TEMPLATE>
<FEATURE_TEMPLATE type=”free_entry” (entrée libre)>
<FT_NAME>Couple</FT_NAME>
<FT_UNIT>Nm</FT_UNIT>
<FT_ORDER>2</FT_ORDER>
</FEATURE_TEMPLATE>
<FEATURE_TEMPLATE type=”free_entry” (entrée libre)>
<FT_NAME>Vitesse</FT_NAME>
<FT_UNIT>tr/min</FT_UNIT>
<FT_ORDER>3</FT_ORDER>
</FEATURE_TEMPLATE>
<FEATURE_TEMPLATE type=”free_entry” (entrée libre)>
<FT_NAME>Poids</FT_NAME>
<FT_UNIT>kg</FT_UNIT>
<FT_ORDER>4</FT_ORDER>
</FEATURE_TEMPLATE>
</FEATURE_GROUP>
</FEATURE_SYSTEM>
Système de classification – CLASSIFICATION_SYSTEM
Comme le FEATURE_SYSTEM, il permet de créer un système de classification. Dans Onventis, seuls les champs du sous-nœud CLASSIFICATION_GROUPS sont pris en compte.
CLASSIFICATION_GROUPS | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
CLASSIFICATION_ GROUP |
Groupe de propriétés, y compris ses caractéristiques | X |
CLASSIFICATION_GROUP
CLASSIFICATION_GROUP | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
CLASSIFICATION_GR
OUP_ID |
Chaîne | Numéro de groupe de propriétés | 35 | X |
CLASSIFICATION_GR
OUP_NAME |
Chaîne | Titre du groupe de propriétés | 50 | X |
CLASSIFICATION_ GROUP_FEATURE_ TEMPLATES |
Caractéristiques du groupe de propriétés | X |
CLASSIFICATION_GROUP_FEATURE_TEMPLATES
Les caractéristiques peuvent être affectées au groupe de propriétés via CLASSIFICATION_GROUP_FEATURE_TEMPLATES.
CLASSIFICATION_GROUP_FEATURE_TEMPLATES | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
GROUP_FEATURE_ TEMPLATE |
Caractéristique du groupe de propriétés | X |
GROUP_FEATURE_TEMPLATE
GROUP_FEATURE_TEMPLATE | ||||
Élément | Type de données | Description | Longueur | Obligatoire |
FT_IDREF | Chaîne | Titre de la propriété. Également utilisé comme numéro unique (du groupe). | 35 | X |
FT_ORDER | Entier | Ordre | 3 | |
FT_UNIT | Chaîne | Unité de la propriété | 20 |
[1] 1 ORDER_UNIT = NO_CU_PER_OR CONTENT_UNIT (par ex. 1 paquet = 50 pièces)