Documentation

Avant de gérer ou intégrer une liste de produit d’un fournisseur, vérifier que celui-ci soit saisi et à disposition de votre organisation dans " Mes fournisseurs ".

Aussi, veuillez noter que vous ne pouvez que gérer les catalogues d’articles et services de fournisseurs privés et limités à votre organisation.

The suppliers referenced by your group are responsible for the data made available to you.available to you.

Comment souhaitez-vous importer et gérer vos produits ?

Manuellement
Par fichier CSV à uploader manuellement
Par fichier CSV uploadé dans un répertoire FTP
API Par API REST

Client(e)

Vous pouvez gérer manuellement la liste des articles que vos fournisseurs privés vous mettent à disposition, à vos conditions.

Aussi, il vous permet de modifier des éléments qui seraient intégrés par le biais d’une autre méthode comme les CSV.

Pour cela, rendez-vous sur la page listant vos fournisseurs privés .

Manuel documentation

Fournisseur

Gérez manuellement vos produits depuis votre compte.

Accédez à cette fonctionnalité via 'Mon compte' => 'Produits'.

Sur cette page, vous pouvez également ajouter, modifier ou supprimer des produits (voir image ci-dessous).

Manuel supplier documentation

Le fichier CSV à uploader manuellement permet une saisie plus rapide et fiable des données de vos fournisseurs privés, car cette méthode permet de visualiser l’ensemble des produits sur le même document.

Explications

Le fichier CSV permet de renseigner les éléments de base d'un produit (nom, description, prix, unité de mesure, catégorie, etc.).

Il permet aussi de saisir des informations plus complexes telles que les délais, jours de livraison, et différents types de colisage. Chaque ligne du fichier représente un produit.
  • Le fichier peut être simple avec une seule ligne par produit, ou plus complexe si vous intégrez différentes contraintes de prix et de livraison, ceci créera plusieurs lignes pour le même produit.
  • Lors de l'intégration d'un fichier CSV, vous obtiendrez un rapport d'importation pour identifier les éventuelles erreurs, ce rapport peut prendre plus ou moins de temps en fonction de la quantité de produits que vous insérez.
  • Une nouvelle importation pour un même produit remplacera les informations antérieures de ce produit
  • Si un produit n'est plus présent dans votre fichier CSV, il sera supprimé de la plateforme.Vous devez donc intégrer la totalité des produits à chaque mise à jour.
Pour l’intégration des produits par CSV, veuillez vous rendre sur votre fournisseur privé, puis sélectionner l’option « liste de produits ». Sélectionnez la case « Ajouter des produits par CSV »,puis choisissez votre fichier avant d’importer les données.

Voici un exemple de fichier CSV, la première ligne représente un produit simple et les lignes suivantes un produit contenant un rabais de quantité.
Télécharger l'exemple

Format du fichier fournisseurs privés

  • Type : CSV
  • Format: utf8
  • Séparateur : " ; "
  • Doit contenir l'intégralité des champs (en-tête), même si vous n'utilisez pas la colonne
Retrouver la liste des champs obligatoires pour la bonne intégration des données ci-dessous

Si vous souhaitez demander à votre fournisseur de saisir les données, copier le lien suivant en l’ajoutant à votre email. Il devra alors vous envoyer le fichier dûment rempli afin que vous puissiez à votre tour l’intégrer.

https://mmc.symposium.ch/docs
Copier le lien



La gestion du fichier CSV par upload sur un répertoire FTP permet de faciliter la mise à jour des données. Cette fonctionnalité est recommandée pour les fournisseurs dont l’assortiment des articles ainsi que la mise à jour d’information telle que les prix évoluent régulièrement.

Plus précisément, ce mode d'intégration, réservé aux fournisseurs, implique de déposer un fichier CSV sur un répertoire que SYMPOSIUM vous fournira. Ce répertoire est consulté une fois par heure pour ajouter ou modifier les articles.

Pour cela, demandez à votre fournisseur de prendre connaissance de la documentation liées aux données nécessaires et de prendre contact avec SYMPOSIUM pour les informations complémentaires :

API

L'API REST vous permet de gérer vos produits directement depuis votre système d'information.

Le login et le mot de passe de votre compte sont nécessaires pour accéder à l'API.

Cette API facilite la gestion de vos produits et la récupération des commandes de vos clients.

Nous vous invitons à consulter notre documentation Swagger pour plus de détails techniques :
https://mmc.symposium.ch/api/v1/documentation

Le tableau des champs ci-après vous sera également utile.

Référence des champs

Votre fichier CSV doit intégrer la totalité des champs suivants, même si vous n'avez pas l'utilité de certaines colonnes. En dessous du tableau vous retrouverez des références, comme les ID des catégories.

Nom du champ Type Remarques / Exemple
product_reference_supplier
Référence produit du fournisseur.
string:255 unique required
Chaîne de charactères, maximum 255 charactères, champ obligatoire et unique.
Exemple : fr061
product_name_fr
Nom du produit en français.
string:255 nullable
Chaîne de charactères, maximum 255 charactères. Au moins un nom de produit est requis entre les langues.
Ces champs sont utilisés pour le système de recherche. Les abréviations et acronymes sont déconseillés.
Exemple : Si vous appelez votre produit "PDT" et que le client cherche "Pomme de terre", il ne trouvera pas le produit.
product_name_de
Nom du produit en allemand.
string:255 nullable
Chaîne de charactères, maximum 255 charactères. Au moins un nom de produit est requis entre les langues.
Ces champs sont utilisés pour le système de recherche. Les abréviations et acronymes sont déconseillés.
Exemple : Si vous appelez votre produit "PDT" et que le client cherche "Pomme de terre", il ne trouvera pas le produit.
product_name_en
Nom du produit en anglais.
string:255 nullable
Chaîne de charactères, maximum 255 charactères. Au moins un nom de produit est requis entre les langues.
Ces champs sont utilisés pour le système de recherche. Les abréviations et acronymes sont déconseillés.
Exemple : Si vous appelez votre produit "PDT" et que le client cherche "Pomme de terre", il ne trouvera pas le produit.
product_description_fr
Description du produit en français.
text nullable
Chaîne de charactères, maximum 1000
Ce champ est utilisé pour le système de recherche.
Exemple : La description "Pomme de terre de qualité supérieure, idéale pour la purée", permet au client de trouver le produit en cherchant "purée".
product_description_de
Description du produit en allemand.
text nullable
Chaîne de charactères, maximum 1000
Ce champ est utilisé pour le système de recherche.
Exemple : La description "Pomme de terre de qualité supérieure, idéale pour la purée", permet au client de trouver le produit en cherchant "purée".
product_description_en
Description du produit en anglais.
text nullable
Chaîne de charactères, maximum 1000
Ce champ est utilisé pour le système de recherche.
Exemple : La description "Pomme de terre de qualité supérieure, idéale pour la purée", permet au client de trouver le produit en cherchant "purée".
product_allergies_fr
Allergènes en français.
text nullable
Exemple : Lait, gluten, oeufs
product_allergies_de
Allergènes en allemand.
text nullable
Exemple : Lait, gluten, oeufs
product_allergies_en
Allergènes en anglais.
text nullable
Exemple : Lait, gluten, oeufs
product_excluded_organizations
Liste des organisations exclues de la vente du produit.
json, nullable
Choix multiple possible
N'est disponible que pour les fournisseurs référencés. Permet d'exclure des organisations de la vente de ce produit. Les valeurs sont les id des organisations dans Symposium.
Exemple : [1,2,3]
product_active
Produit actif ou non.
boolean, default:true
Permet de désactiver un produit. Si le produit est désactivé, il ne sera plus visible sur le site. 1 = actif, 0 = inactif
Exemple : 1 ou 0
product_image1
URL de l'image principale du produit.
url nullable
Les images doivent faire moins de 4mo, Format JPEG et PNG.
Doit être une URL valide. Pour que votre produit présente le mieux possible, merci d'insérer des images carrées sur fond blanc.
Exemple : https://www.example.com/image.jpg
product_image2
Deuxième image du produit.
url nullable
Les images doivent faire moins de 4mo, Format JPEG et PNG.
Doit être une URL valide. Pour que votre produit présente le mieux possible, merci d'insérer des images carrées sur fond blanc.
Exemple : https://www.example.com/image.jpg
product_image3
Troisième image du produit.
url nullable
Les images doivent faire moins de 4mo, Format JPEG et PNG.
Doit être une URL valide. Pour que votre produit présente le mieux possible, merci d'insérer des images carrées sur fond blanc.
Exemple : https://www.example.com/image.jpg
product_image4
Quatrième image du produit.
url nullable
Les images doivent faire moins de 4mo, Format JPEG et PNG.
Doit être une URL valide. Pour que votre produit présente le mieux possible, merci d'insérer des images carrées sur fond blanc.
Exemple : https://www.example.com/image.jpg
product_image5
Cinquième image du produit.
url nullable
Les images doivent faire moins de 4mo, Format JPEG et PNG.
Doit être une URL valide. Pour que votre produit présente le mieux possible, merci d'insérer des images carrées sur fond blanc.
Exemple : https://www.example.com/image.jpg
product_category_ids
Id de catégorie du produit.
json required
Une valeur existante est requise.
Permet de classer le produit dans le système de recherche. Voir la liste des catégories
Exemple : [1]
product_tva
Définit le taux de TVA du produit..
string required
Une valeur existante est requise.
Permet de définir le taux de TVA du produit. NORMAL = 8.1% / REDUCED = 2.6% / ZERO = 0%
Exemple : NORMAL
product_origin
Pays d'origine du produit..
string required
Code ISO du pays à 2 lettres.
Un produit ne peut avoir qu'une seul origine
Exemple : CH
product_on_offer
Produit sur demande.
boolean default:0
csv_field_product_on_offer_remarks
Exemple : true | 1 | false | 0
deal_rule_minimum_quantity
La quantité minimum du conditionnement pour bénéficier du prix..
integer unsigned default:0
>= 0
Si vous hésitez entre indiquer 1 ou 0, prenez en compte que certaines unités fonctionnent en décimal comme le Kilogramme. Pour cette raison, nous vous conseillons de privilégier le 0, le système proposera de lui-même des unités d'achats en nombre entier quand c'est nécessaire. En cas de chevauchement de quantité entre vos dealRule, le système sélectionnera le prix le moins cher.
deal_rule_maximum_quantity
La quantité maximum du conditionnement pour bénéficier du prix..
integer unsigned default:0
>= 0
Pour une valeur illimité, laisser vide.
deal_rule_price
Le prix net HT pour ce produit.
float unsigned default:0
>= 0
Ce prix correspond au montant qui sera facturé. En fonction de la complexité de votre produit, vous pouvez proposer des prix différents, ceci pour des quantités, des conditionnements ou des clients différents.
deal_rule_raw_price
Prix brut HT pour ce produit..
float unsigned default:0
>= 0
Ce prix correspond au prix public hors rabais
deal_rule_deposit_price
Prix de la consigne par unité..
integer unsigned default:0
>= 0
Si vous vendez des bouteilles consignées, vous pouvez indiquer le prix de la consigne ici.
deal_rule_nb_day_delivery
Nombre de jours avant la livraison.
integer unsigned required
>= 0
Si vous avez un délai de livraison, vous pouvez le préciser ici. 1 jour = livré le lendemain, si les conditions le permettent (heure de commande et jour de livraison).
deal_rule_limit_hour_order
Heure limite pour passer commande.
integer unsigned default:0
>= 0
Indiquez l'heure limite pour passer commande. Exemple si vous indiquez 12 le client peut commander jusqu'à midi pour être livré le lendemain.
deal_rule_delivery_day
Jours de livraison.
string required
Si vous avez des jours de livraison spécifique, vous pouvez les indiquer ici. Par exemple, si vous ne livrez pas le dimanche, vous pouvez indiquer ["mon", "tue", "wed", "thu", "fri", "sat"]. mon = lundi, tue = mardi, wed = mercredi, thu = jeudi, fri = vendredi, sat = samedi, sun = dimanche
Exemple : ["mon", "tue", "wed", "thu", "fri", "sat", "sun"]
deal_rule_unit_id
Unité de vente du produit.
integer unsigned required
Doit faire partie de la liste des unités
L'unité de vente (conditionnement) du produit, voir la liste des unités ici.
deal_rule_unit_comparison
Unité mère du produit.
integer unsigned required
Doit faire partie de la liste des unités de comparaison.
L'unité de mère du produit correspond à l'unité du contenu qui compose l'unité de vente. Par exemple un carton (unité de vente) est composé de bouteille ou de litres (unité mère). Lors de la livraison marchandise, le client peut réceptionner les produits dans les unités mères ou de vente. Voir la liste des unités ici.
deal_rule_qty_unit_parent_to_sell_unit
Quantité de l'unité mère pour vendre une unité de vente.
float required
Permet de connaître la quantité qui est dans l'unité de vente. Exemple : 1 bouteille (unité de vente) = 0.75 litre (unitè mère).
deal_rule_limited_to_organization_id
ID de l'organisation pour laquelle le prix est disponible.
int unsigned nullable
Non compatible avec deal_rule_group les deux champs ne doivent pas être utilisé simultanément dans la même condition. Uniquement pour les fournisseurs referencés
Permet de rendre le prix disponible uniquement pour une organisation. Pour connaître l'ID des organisations, regardez ci-après dans la liste.
deal_rule_rfa_authorize
Défini si la condition de vente du produit est soumise à une ristourne pour le groupement.
boolean default:0
Si 1, le prix est donc soumis.
Exemple : true | 1 | false | 0
deal_rule_default_deal
Non utilisé.
boolean default:0
Doit être indiqué en tant qu'entête dans le fichier CSV
deal_rule_unit_reference_supplier
Référence de l'unité de vente du fournisseur.
string:255 nullable
Chaîne de charactères, maximum 255 charactères, champ optionnel.
Ce champs n’a pas d’impact sur le site et cette information n’est pas indiquée sur le site. Il est utilisé uniquement par un fournisseur qui récupère les commandes par API, et souhaite s’assurer que les conditionnements spécifiques soient bien repris par le système pour retranscrire les commandes.
deal_rule_preparations
Ce champ permet de définir des options de préparation de commande qui n'influencent pas le prix du produit.
array nullable
Tableau de preparation, avec toutes les langues
Lorsque l'utilisateur choisira le produit, il devra choisir le type de préparation. Vous pouvez par exemple proposer une pièce de viande ayant plusieurs types de préparations : haché, coupé au couteau, emballé sous vide, etc. Ce champ n'influence pas le prix unitaire du produit.
Exemple : [{"fr":"haché", "en":"minced", "de":"gechneidet"}, {"fr":"Entier", "en":"Whole", "de":"Ganzer"}]
deal_rule_group
Permet de regrouper les dealRules.
string:255 nullable
Chaîne de caractères, maximum 255 caractères, champ optionnel. Non compatible avec deal_rule_limited_to_organization_id les deux champs ne doivent pas être utilisé en même temps. Vous pourriez regrouper plusieurs conditions pour différentes organisations sous un même indicateur.
Dans la page « clients » vous pouvez définir un filtre (votre filtre), c'est un champ texte. Vous pouvez dans votre CSV utiliser ce champ pour définir un dealRule pour tout un groupe de client.

Attention, ce champ n'influence pas les entités qui seraient en-dessous d'un groupe. Pour qu’un prix soit attribué à une organisation parente, et à ces 2 organisations sous-jacentes, la mention doit figurer sur la ligne des 3 entités de la page client.

Vous pourriez regrouper plusieurs conditions pour différentes organisations sous un même indicateur.
Exemple : SECTEUR1 pour un délai de livraison. GROUPE1 pour un prix pour des établissements spécifiques, etc.
product_department_ids
Non utilisé.
json
Doit être indiqué en tant qu'entête dans le fichier CSV. N' est pas utilisé.

Références des catégories

  • Energie
    • 2 - Eau
    • 3 - Electricité
    • 4 - Gaz
    • 5 - Gestion des energies
    • 112 - Essence
  • Boissons
    • 7 - Bière & Cidre
    • 8 - Boissons chaudes
    • 9 - Boissons non alcoolisées
    • 10 - Spiritueux
    • 11 - Vins & Champagnes
    • 12 - Machines à café
  • Alimentation
    • 14 - Boulangerie
    • 15 - Charcuteries
    • 16 - Condiments & Sauces
    • 17 - Crèmerie, fromages & Œufs
    • 18 - Distributeurs automatiques
    • 19 - Epicerie salée
    • 20 - Epicerie Sucrée
    • 21 - Epices du monde
    • 22 - Fruits & légumes
    • 23 - Glaces & Sorbets
    • 24 - Patisserie
    • 25 - Plats préparés
    • 26 - Poissons & Crustacés
    • 27 - Produits de laboratoire
    • 28 - Sandwich & snack
    • 29 - Viandes, volaille & Gibier
    • 113 - Produits Fumeurs
  • Mobilier
    • 31 - Décoration
    • 32 - Lit & matelas
    • 33 - Luminaire
    • 34 - Mobilier de bureau
    • 35 - Mobilier intérieur & extérieur
  • Equipement
    • 37 - Equipement sportif
    • 38 - Matériel & outil de maintenance
    • 39 - Matériel electrique
    • 40 - Minibar et distributeur automatique
    • 41 - Plomberie & equipement sanitaires
    • 42 - Serrure et coffres forts
    • 43 - Signalétique
    • 44 - Textiles
    • 45 - Accessoires
    • 46 - Ambiance olfactive
    • 47 - Amenities Cosmétiques
    • 48 - Art de la table
    • 49 - Objets promotionnels
    • 50 - Couettes, duvets & oreillers
    • 51 - Equipement de buffet
    • 52 - Equipement de nettoyage
    • 53 - Jardinage, plante & fleur
    • 54 - Linge de bain
    • 55 - Linge Spa
    • 56 - Produits à usage unique
    • 57 - Produits cosmétiques pour spa
    • 58 - Produits de nettoyage
    • 59 - Produit de revente
    • 60 - Protection de literie
    • 61 - Recyclage
    • 62 - Equipement en chambre
    • 63 - Matériel de bureau
    • 64 - Equipement de cuisine
    • 66 - Uniformes
    • 67 - Composite
    • 68 - Equipement pour animaux de compagnie
    • 69 - Equipement de blanchisserie
    • 70 - Equipement hvac
    • 73 - Puériculture & espace enfant
    • 114 - Solution de d'emballage et colisage
    • 115 - Equipement médical
  • IT / Digital
    • 75 - Ambiance musicale
    • 76 - Caisse enregistreuse
    • 77 - Imprimantes & scanners
    • 78 - Matériel & salle de réunion
    • 79 - Ordinateurs & serveur
    • 80 - Service & equipement Wifi
    • 81 - Services TV
    • 82 - Signalétique dynamique
    • 83 - Solutions téléphoniques
    • 84 - Systèmes de son & sonorisation
    • 85 - TV equipement
    • 86 - Domotique
    • 87 - Systèmes de gestion
  • Services
    • 89 - Audits & Analyses
    • 90 - Nettoyage à sec pour literie & uniformes
    • 91 - Recyclage et gestion des dechets
    • 92 - Lutte antiparasitaire
    • 93 - Désinfection
    • 94 - Service d'impression
    • 95 - Service de blanchisserie
    • 96 - Service d'archives
    • 97 - Service de stockage et distribution
    • 98 - Agencement
    • 99 - Artisans & menuisier
    • 100 - Ascenceurs, escalators et portes automatiques
    • 101 - Bureaux d'études
    • 102 - Contrôle, inspections et certifications
    • 103 - Entreprises générales du batiment
    • 104 - Hvac maintenance
    • 105 - Maintenance des équipements de cuisine & de blanchisserie
    • 106 - Maintenance multi - technique
    • 107 - Portes & fenêtres
    • 108 - Protection incendie
    • 109 - Service d'entretien
    • 110 - Service de graphisme
    • 111 - Gestion des réseaux sociaux & médias

Unités mères

  • id: 6 - Piece
  • id: 12 - Litre
  • id: 17 - Kilogramme
  • id: 23 - Heure
  • id: 28 - Année
  • id: 30 - Mois
  • id: 32 - Metre carré
  • id: 34 - Forfait
  • id: 35 - Container (exemple poubelle)
  • id: 36 - License
  • id: 37 - kilowatt
  • id: 38 - Personne
  • id: 39 - Metre
  • id: 40 - Megabits

Références des unités de vente

  • 1 - Palette
  • 2 - Carton
  • 3 - Bouteille
  • 4 - Boite
  • 5 - Unités
  • 6 - Piece
  • 7 - Harasse
  • 8 - Fût
  • 9 - Sachet
  • 10 - Bidon
  • 11 - Hectolitre
  • 12 - Litre
  • 13 - Centilitre
  • 14 - Decilitre
  • 15 - Millilitre
  • 16 - Tonne
  • 17 - Kilogramme
  • 18 - Gramme
  • 19 - Decigramme
  • 20 - Centigramme
  • 21 - Milligramme
  • 22 - Microgramme
  • 23 - Heure
  • 24 - Minute
  • 25 - Seconde
  • 26 - Milliseconde
  • 27 - Microseconde
  • 28 - Année
  • 29 - Jour
  • 30 - Mois
  • 31 - Metre cube
  • 32 - Metre carré
  • 33 - Hectare
  • 34 - Forfait
  • 35 - Container (exemple poubelle)
  • 36 - License
  • 37 - kilowatt
  • 38 - Personne
  • 39 - Metre
  • 40 - Megabits
  • 41 - Pot
  • 42 - Barquette
  • 43 - Seau
  • 44 - Paquet

Votre vie privée est importante pour nous