Vai al contenuto

Recherche ponctuelle par codes OE / AM dans votre logiciel de gestion

Vue d'ensemble générale

En intégrant votre logiciel de gestion à Quoting24, il est possible de restituer en temps réel des prix et disponibilités personnalisés pour le client spécifique avec lequel vous êtes en train d'écrire lorsque vous recherchez des codes.

De cette manière, vous récupérez rapidement les conditions commerciales spécifiques du client avec lequel vous échangez.

L'objectif est de permettre à Quoting24, une fois un code produit identifié, de récupérer automatiquement :

  • Disponibilité et prix net du client spécifique
  • Métadonnées du produit : informations descriptives, marque, éventuelles promotions actives et autres attributs liés.
  • Le flux est conçu pour s'interfacer de manière transparente avec les API ERP du système de gestion du fournisseur.

Paramètres de recherche

De Quoting24 au fournisseur

Paramètres obligatoires

  • Token d'authentification
    Un token unique qui identifie de manière univoque les serveurs Quoting24.

  • Code de recherche
    De préférence un code AM ou OE.
    La recherche ne devrait pas être limitée uniquement aux codes produit exacts, mais devrait aussi :

  • Rechercher des codes alternatifs
  • Rechercher dans les bases externes

⚠️ Si ce comportement n'est pas pris en charge, cela doit être communiqué clairement.
Au minimum, la recherche doit inclure les données de fiche du produit et pas seulement les codes internes exacts.

Identification du client

Au moins l'un des éléments suivants doit être fourni

  • ID (tel qu'enregistré dans le logiciel de gestion) du site de votre client
  • ID (tel qu'enregistré dans le logiciel de gestion) de l'entreprise de votre client
  • Numéro de TVA du client
  • ID catégorie de remise
    Utilisé pour :
  • Clients non enregistrés
  • Permettre à l'opérateur de modifier dynamiquement les règles de remise

Paramètres optionnels

  • ID opérateur (optionnel mais recommandé)
    Utilisé pour tracer qui a généré le devis.

  • Quantité
    Peut être incluse dans la demande si strictement nécessaire.
    Approche préférée : gestion de la quantité dans la réponse, pas dans la demande.

  • Marque / Fabricant
    Pour permettre des recherches plus précises.

  • Mode de recherche
    Paramètre permettant de choisir entre recherche exacte ponctuelle ou recherche avec cross (qui produit aussi les résultats de produits alternatifs).

Paramètres de réponse

Du fournisseur à Quoting24

La réponse doit contenir une liste de produits, chacun avec les champs suivants.

Champs obligatoires (par produit)

  • Code produit du fournisseur
    Code de commande interne, préfixes inclus, exactement comme utilisé dans les systèmes du fournisseur.

  • Fabricant
    Nom du fabricant (ex. LUK, Magneti Marelli, Brembo).
    Peut être structuré en 2 champs :

  • Version abrégée/précode (ex. MAR)

  • Nom complet (ex. Magneti Marelli)

  • Prix de vente net au client

  • Prix net (TVA exclue)
  • Frais d'expédition exclus

  • Les frais d'expédition peuvent être retournés séparément, le cas échéant

  • Disponibilité
    Valeur numérique représentant la quantité disponible en stock.

  • Entrepôt
    Nom de l'entrepôt, rayon ou référence à l'emplacement interne.

Champs optionnels

  • Description du produit
    Texte libre (ex. Plaquettes de frein) et/ou catégorie marchandise.

  • Code identifiant du constructeur
    Obligatoire lorsque le code produit ERP diffère du code du fabricant.

  • Prix catalogue
    Non nécessaire mais reproductible si besoin.

  • Promotions

  • Présence de promotion (binaire)
  • Texte de la promotion (optionnel)

  • Si le texte est vide → promotion inactive

  • Image produit

  • URL de l'image

  • Ou image Base64

  • URL fiche produit
    Lien vers la page de détail du produit sur l'e-commerce ou sur le site externe.
    Si le lien direct n'est pas possible :

  • Fournir des règles de syntaxe URL

  • Ou retourner une URL générique de la page d'accès

  • Prix basés sur la quantité / Remises
    Si des remises quantité existent, retournez les paliers dans n'importe quel format analysable, par exemple :

{
  "from": 2,
  "to": 10,
  "price": "50.00"
}