Integrazione

Per chi collega RecommenderPro al gestionale o all'e-commerce: il formato del file, le richieste, la risposta e le regole da rispettare. Se preferisci, il collegamento lo seguiamo noi.

Tre passi, con gli esempi

  1. Esporti lo storico

    Un file di testo, senza intestazione. Ogni riga è un acquisto: il cliente, un punto e virgola, il prodotto.

    C0042;caffe-grani-1kg
C0042;decalcificante
C0117;caffe-grani-1kg
C0117;set-tazzine-6

  2. Lo carichi

    Dall'archivio fatti della web app o dall'API. L'importazione avviene in background, a blocchi di 5000 righe, e la segui in "Importazioni recenti". Ricaricare un archivio con lo stesso nome lo sostituisce.

  3. Il tuo sistema chiede i suggerimenti

    Per un cliente fa una richiesta GET con il suo codice. Per un carrello fa una richiesta POST con l'elenco dei prodotti, come nell'esempio più sotto. La risposta ha sempre questa forma.

    GET /api/suggestions/noratings/users/C0042/vendite?minscore=60&max=5

{
  "_count": 1,
  "items": [
    { "prod": "set-tazzine-6", "score": 72.5 }
  ]
}

Per un carrello

Il tuo sistema invia i prodotti che il carrello contiene. La risposta ha la stessa forma di quella per un cliente.

POST /api/suggestions/noratings/products/vendite?minscore=60&max=5

{ "products": ["caffe-grani-1kg", "decalcificante"] }

Parametri

ParametroSignificatoValore predefinito
minscorePunteggio minimo, da 0 a 10060
maxNumero massimo di prodotti restituiti, fino a 10010

Come si calcola il punteggio lo trovi in Come funziona.

Cosa serve

  • Un file con due colonne separate da punto e virgola. Le righe vuote e quelle che iniziano con # sono ignorate. Un campo vuoto fa rifiutare il file, che viene controllato prima del caricamento.
  • Il nome dell’archivio usa lettere, cifre e trattino basso, comincia con una lettera e arriva a 30 caratteri.
  • Gli identificativi usati nelle richieste API contengono lettere, cifre, trattino e trattino basso, fino a 100 caratteri. Gli spazi non sono ammessi.
  • Le richieste di suggerimenti vanno fatte con un token di accesso.

Hai bisogno di una mano?

Il collegamento lo seguiamo noi di bit Time Professionals: formazione sull’integrazione con il software che usi già e assistenza. Ne parliamo dopo la demo.

Vuoi vedere cosa suggerirebbe ai tuoi clienti?

Ti mostriamo la web app e come si collega al tuo e-commerce o al tuo gestionale. Se decidi di partire, ti affianchiamo nell'integrazione.

Richiedi una demo