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 API/XML

Panoramica

Richiedi integrazione API

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.

  1. Accedi al tuo account RicambiPro Manager. Se non hai un account, richiedi l’accesso . È gratis!!!
  2. All’interno del tuo account > Apri la Chat > Richiedi la chiave  API 
  3. 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.

  1. Preleva la documentazione API e richiedi l’abilitazione . È gratis!!!
  2. Riceverai l’ API KEY  e sarai attivo.
  3. Eseguito questo processo nella documentazione  API  alla sezione  PRODOTTI  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
facebook 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.

twitter 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.

image
image
image
image
image
image
image
image
image