Vai al contenuto

Ricerca puntuale per codici OE / AM sul proprio gestionale

Panoramica generale

Integrando il proprio gestionale su Quoting24 è possibile restituire in tempo reale prezzi e disponibilità personalizzate per lo specifico cliente con cui si sta scrivendo quando si cercano dei codici.

In questo modo si ricavano velocemente le condizioni commerciali specifiche del cliente con cui si sta parlando.

L'obiettivo è consentire a Quoting24, una volta identificato un codice prodotto, di recuperare automaticamente:

  • Disponibilità e prezzo netto dello specifico cliente
  • Metadati del prodotto: informazioni descrittive, brand, eventuali promozioni attive e altri attributi correlati.
  • Il flusso è progettato per interfacciarsi in modo trasparente con le API ERP del sistema gestionale del Fornitore.

Parametri di ricerca

Da Quoting24 al Fornitore

Parametri obbligatori

  • Token di autenticazione
    Un token univoco che identifica univocamente i server Quoting24.

  • Codice di ricerca
    Preferibilmente un codice AM o OE.
    La ricerca non dovrebbe essere limitata solo ai codici prodotto esatti, ma dovrebbe anche:

  • Cercare codici alternativi
  • Cercare nelle banche esterne

⚠️ Se questo comportamento non è supportato, deve essere comunicato chiaramente.
Come minimo, la ricerca deve includere i dati anagrafici del prodotto e non solo i codici interni esatti.

Identificazione del cliente

Deve essere fornito almeno uno dei seguenti

  • ID (come anagrafato nel Gestionale) della sede del vs. cliente
  • ID (come anagrafato nel Gestionale) dell'azienda vs. cliente
  • Partita IVA del cliente
  • ID categoria sconto
    Usato per:
  • Clienti non registrati
  • Consentire all'operatore di modificare dinamicamente le regole di sconto

Parametri opzionali

  • ID operatore (opzionale ma raccomandato)
    Utilizzato per tracciare chi ha generato il preventivo.

  • Quantità
    Può essere incluso nella richiesta se strettamente richiesto.
    Approccio preferito: gestione della quantità nella risposta, non nella richiesta.

  • Brand / Produttore
    Per consentire ricerche più precise.

  • Modalità di ricerca
    Parametro opzione ricerca esatta puntuale o ricerca con cross (che produce anche i risultati di prodotti alternativi).

Parametri di risposta

Dal fornitore a Quoting24

La risposta deve contenere un elenco di prodotti, ciascuno con i seguenti campi.

Campi obbligatori (per prodotto)

  • Codice prodotto del fornitore
    Codice d'ordine interno, inclusi i prefissi, esattamente come utilizzato nei sistemi del Fornitore.

  • Produttore
    Nome del produttore (es. LUK, Magneti Marelli, Brembo).
    Può essere strutturato in 2 campi:

  • Versione abbreviata/precodice (es. MAR)

  • Nome completo (es. Magneti Marelli)

  • Prezzo di vendita netto al cliente

  • Prezzo netto (IVA esclusa)
  • Costi di spedizione esclusi

  • Le spese di spedizione possono essere restituite separatamente, se applicabile

  • Disponibilità
    Valore numerico che rappresenta la quantità disponibile in magazzino.

  • Magazzino
    Nome del magazzino, scaffale o riferimento alla posizione interna.

Campi opzionali

  • Descrizione del prodotto
    Testo libero (es. Pastiglie freno) e/o categoria merceologica.

  • Codice identificativo del Costruttore
    Obbligatorio quando il codice prodotto ERP differisce dal codice del produttore.

  • Prezzo di listino
    Non necessario ma riproducibile se necessario.

  • Promozioni

  • Presenza di promozione (binario)
  • Testo della promozione (opzionale)

  • Se il testo è vuoto → promozione non attiva

  • Immagine prodotto

  • URL dell'immagine

  • O immagine Base64

  • URL scheda prodotto
    Link alla pagina dei dettagli del prodotto sull'e-commerce o sul sito esterno.
    Se il collegamento diretto non è possibile:

  • Fornire regole di sintassi URL

  • Oppure restituire un URL generico della pagina di accesso

  • Prezzi basati sulla quantità / Sconti
    Se esistono sconti quantità, restituisci i livelli in qualsiasi formato analizzabile, ad esempio:

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