
Benvenuti nella nostra sezione API/XML che consente di usare il tuo gestionale e volendo il tuo sito e-commerce esterno a RicambiPro.
In questa sezione troverai tutta la documentazione per interfacciare il tuo software con la nostra struttura e cominciare a gestire tutti i negozi online.
Creata l’interfaccia continuerai a usare il tuo software senza nulla aggiungere e nulla togliere al lavoro che già esegui da anni.
FUNZIONAMENTO INTERFACCIA PER SITO E-COMMERCE ESTERNO
Attraverso l’API potrai prelevare i prodotti dal tuo gestionale di RicambiPro (RPM Plus+) e pubblicare i prodotti sul tuo sito e-commerce.
- Puoi scegliere di usare il gestionale RicambiPro.
- Puoi scegliere di usare il tuo gestionale con l’API.
- Puoi scegliere di usare il tuo gestionale con l’XML.
- Puoi scegliere di usare i gestionali autorizzati Rpm.
- Puoi scegliere usare l’API per gestire il tuo sito e-commerce.
Richiedi l’integrazione desiderata (API/XML)
Panoramica
Scarica la documentazione API
Attraverso il seguente link potrai scaricare la documentazione API per integrarti con RicambiPro Marketplace.
Area di produzione https://preprod.ricambipro.it/pannello/
Username: (attribuito durante la registrazione)
Password: (attribuito durante la registrazione)
Secret Key: (fornito da ricambipro durante la registrazione)
Come ottenere la chiave API?
Prima di iniziare a utilizzare i nostri servizi API, è necessario ottenere la chiave API con il proprio account utente.
- Accedi al tuo account RicambiPro Manager. Se non hai un account, richiedi l’accesso . È gratis!!!
- All’interno del tuo account > Apri la Chat > Richiedi la chiave
API
- Ti sarà inviata immediatamente.
Come prelevare i prodotti da RPM Plus+ per inserirli sul proprio sito e-commerce?
Sia che tu usi direttamente RPM Plus+ o altro gestionale interfacciato puoi usare questa API per gestire il tuo sito e-commerce esterno alla struttura RicambiPro.it.
Lo scopo è quello di poterti far gestire i prodotti che gestisci all’interno del gestionale RicambiPro direttamente sul tuo sito e-commerce personale.
- Preleva la documentazione API e richiedi l’abilitazione . È gratis!!!
- Riceverai l’
API KEY
e sarai attivo. - Eseguito questo processo nella documentazione
API
alla sezionePRODOTTI
troverai le linee guida per prelevare i tuoi prodotti e postarli sul tuo sito e-commerce in modo automatizzato.
ESEMPIO
AUTENTICAZIONE
Metodo
https://ricambipro.it/api/v1/users/authenticate.php
Parametri
array ( string $username, string $password, string $secret )
1. username – e-mail per poter accedere ai siti o all’area pannello di ricambiPro;
2. password – password per poter accedere ai siti o all’area pannello di ricambiPro;
3. secret – secret ricevuto dall’amministratore.
Risultato
Restituisce un oggetto json con l’access token per poter effettuare chiamate alle api.
Esempio
$arrayTest = array('username' => 'info@autodemolitoretestpro.it, 'password' => '********', 'secret' => 'FE4765A6-*******');
$ch = curl_init();
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt_array($ch, array( CURLOPT_RETURNTRANSFER => 1,
CURLOPT_URL => 'https://ricambipro.it/api/v1/users/authenticate.php', CURLOPT_USERAGENT => 'Codular Sample cURL Request', CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => json_encode($arrayTest)));
$result = curl_exec($ch);
$result = json_decode($result);
if ($result->success === FALSE)
die($result->error);
else if ($result->success === TRUE) die($result->token);
SCARICA SUBITO LA DOCUMENTAZIONE COMPLETA!
Scarica la documentazione XML
Attraverso il seguente pulsante potrai scaricare la documentazione XML per integrarti con RicambiPro.it
Funzionamento
Una volta adeguato il file dovrai fornire un link in formato XML con contenuto dinamico del tipo https://www.miaazienda.it/articoli/ricambipro.xml
.
I tecnici lo testeranno e se sarà tutto conforme provvederanno ad integrarlo definitivamente.
Dopo l’importazione massiva e quindi al raggiungimento di tutto il database presente nel link, il contenuto del file va popolato tutti i giorni a seconda della movimentazione di magazzino CARICO/SCARICO.
Ogni giorno ad un orario stabilito il software importerà le nuove disponibilità di magazzino e cancellerà quelle eliminate con scarico prodotti.
XML PARAMETRI DI ESEMPIO
Guida ai valori da utilizzare
CAMPO | VALORE | NOTA |
azione | inserisci | |
quantity | Quantità da caricare | |
price | Prezzo del ricambio | |
prototypeId | prototypes | Ricambio da caricare |
bundleId | bundle | Modello dell’auto del ricambio |
notes | Note aggiuntive sul ricambio | |
year | Anno dell’auto del ricambio | |
cc | Cilindrata dell’auto del ricambio | |
engineType | Alimentazione auto del ricambio | |
km | Kilometri dell’auto del ricambio | |
engineCode | Codice motore dell’auto del
ricambio |
|
plate | Targa dell’auto del ricambio | |
chassis | Codice telaio dell’auto del
ricambio |
|
internalCode | Codice identificativo del ricambio. Serve per poter scaricare i ricambi successivamente al carico. Nel caso si provi a caricare un ricambio con un codice già esistente il
ricambio non verrà caricato. |
|
manufacturerCode | Codice del ricambio | |
kw | Kilowattori dell’auto del ricambio | |
0 – No
1 – Si |
Specifica se caricare il ricambio sulla propria pagina Facebook. Per poter caricare un ricambio bisogna effettuare l’accesso a Facebook, sul pannello RicambiPro, e impostare la pagina Facebook su
cui si vuole condividere il ricambio. |
|
0 – No
1 – Si |
Specifica se caricare il ricambio sul proprio account Twitter. Per poter caricare un ricambio bisogna
effettuare l’accesso a Twitter, sul pannello RicambiPro. |
|
Images > image | Url delle immagini da caricare.
Max 8. |
Hai dubbi o domande?
Richiedi un contatto o una cooperazione.








