Integrazione del sistema di pagamento Rentportal e Rentplugin
Requisiti di integrazione
Per integrare il sistema di pagamento Rentplugin nel vostro sito, è necessario come prerequisito che difrently integri al proprio interno il vostro catalogo prodotti.
Per consentire l’integrazione è necessario disporre:
- dell'indirizzo URL dove poter scaricare il vostro catalogo (obbligatorio)
- dell'indirizzo URL dove poter scaricare il file delle specifiche tecniche
- del vostro logo
- dell’indirizzo email per comunicazioni relativi a nuovi ordini (obbligatorio)
Di seguito i dettagli inerenti i due file richiesti per il catalogo e per le specifiche tecniche:
Mappatura del catalogo
La mappatura del catalogo avviene mediante la lettura di un file CSV, con campi separati da virgola, contente le seguenti colonne:
| Nome campo | Contenuto |
|---|---|
| SKU | Il vostro codice prodotto |
| Nome Prodotto | Il nome del prodotto |
| Descrizione Lunga | (facoltativo) |
| Descrizione Corta | (facoltativo) |
| Categoria | Relativa categoria difrently |
| Prezzo | Il separatore decimale è il . |
| EAN | (facoltativo) |
| Marca | Inserisci la marca del prodotto |
| Modello (MPN) | (facoltativo) |
| Immagine | URL dell'immagine del prodotto (facoltativo) |
| Quantita | Quantità disponibile a magazzino |
Di seguito un esempio dell'output finale:
Sku,"Nome Prodotto","Descrizione Lunga","Descrizione Corta",Categoria,Prezzo,EAN,Marca,"Modello (MPN)",Immagine,Quantita ABC123,"Il mio prodotto","La descrizione lunga per il mio prodotto","Descrizione corta","audio video e imaging/audio professional/cuffie",12.50,806808260277,Marca,Modello,"https://via.placeholder.com/300",999
Specifiche tecniche dei prodotti
I prodotti a catalogo possono essere dettagliati con le corrispondenti specifiche tecniche.
Il file CSV, contenente tali dettagli, è caratterizzato dalla seguente struttura (con campi separati da virgola):
| Nome campo | Contenuto |
|---|---|
| SKU | Il vostro codice prodotto |
| Gruppo | Il nome del gruppo delle specifiche tecniche. (Es. Batteria) |
| Nome | Il nome della specifica tecnica. (Es. Durata) |
| Valore | Il valore della specifica tecnica. (Es. 4 ore) |
| Categoria | Relativa categoria difrently |
| Prezzo | Il separatore decimale è il . |
| EAN | (facoltativo) |
| Marca | Inserisci la marca del prodotto |
| Modello (MPN) | (facoltativo) |
| Immagine | URL dell'immagine del prodotto (facoltativo) |
| Quantita | Quantità disponibile a magazzino |
Di seguito un esempio dell'output finale:
SKU,Gruppo,Nome,ValoreABC123,Batteria,Durata,"4 ore"ABC123,Batteria,Capacità,"100 Wh"
Mappatura della categorie merceologiche
Per un corretto funzionamento del servizio Rentplugin è necessario conoscere la categoria merceologica di ciascun bene noleggiabile. A tale proposito la mappatura delle categorie avviene attraverso una specifica classificazione, alla quale occorre attenersi in fase di produzione del catalogo prodotti da integrare.
Integrazione del Rentplugin
Una volta soddisfatti i prerequisiti necessari per il funzionamento del servizio Rentplugin, quest’ultimo può essere operativamente fruito tramite chiamate POST al sito Difrently, attenendosi ad una struttura standard predefinita.
Questo è un esempio di applicazione del servizio Rentplugin Checkout per un carrello contenente due prodotti:
<form method="post" action="/noleggia/cart">
<input type="hidden" name="sku[0]" value="TDA-5502960">
<input type="hidden" name="quantity[0]" value="1">
<input type="hidden" name="sku[1]" value="TDA-5508093">
<input type="hidden" name="quantity[1]" value="1">
<input type="submit">
</form>