Abacus REST

Introduzione

Collegate il vostro sistema e-commerce e POS PepperShop direttamente con l’elaborazione degli ordini Abacus. Approfittate dei processi automatizzati e dell’ampia gamma di funzioni di entrambe le piattaforme.

Partiamo

Per preparare l’integrazione di Abacus e PepperShop, potete iniziare con i seguenti passi:

Installare l’applicazione tramite il Marketplace Abacus. Ottenere le seguenti informazioni:

• URL API
• Numero del cliente
• ID cliente
• Segreto del cliente

Link al video di istruzioni Abacus - PepperShop

Configurazione del modulo

Il modulo viene installato dai nostri tecnici. Dopo l’installazione, lo troverete nell’amministrazione del negozio alla voce “Moduli -> Abacus”.

I passi seguenti dovrebbero aiutarvi a configurare il modulo con successo e a utilizzare efficacemente l’API Abacus.

Ora andiamo al modulo e spuntiamo la casella “Usa API Abacus”. Salvate le impostazioni qui sotto, in modo da rendere visibili le altre schede.

Configurazione generale

Passare alla scheda “Configurazione” e inserire il ClientID e il Client Secret in “Abacus API”, che si trovano in Abacus. Inserire anche l’URL di base e il client prima di salvare le impostazioni.

• Client ID e Client Secret: Provengono da Abacus Q910.
• Endpoint del token: Endpoint per ottenere il token, di solito non è necessario modificarlo.
• Base URL: Dominio del server Abacus
• Client: Client che deve essere connesso

Abacus-API

Nella scheda “Abacus API” si possono ora eseguire diversi lavori. Ad esempio, si apre l’importazione completa facendo clic sulla piccola freccia rivolta verso destra. È possibile automatizzare questo lavoro o eseguirlo manualmente. Lo stesso vale per altri lavori che si possono impostare a seconda delle necessità.

Configurazione

Nella scheda “Configurazione” sono disponibili varie opzioni di impostazione.

• Visualizza ricevute API Abacus:** Il cliente ha la possibilità di recuperare le proprie ricevute da Abacus tramite l’account cliente.

• Usa Abacus E-Business API:** Con l’interfaccia E-Business, Abacus si collega all’API di PepperShop.

• Usa API Abacus:** Con l’API Abacus, PepperShop si connette all’API Abacus.

• Indirizzo e-mail Abacus:** Indirizzo e-mail al quale vengono inviati, ad esempio, i dettagli del pagamento.

Richiesta di prezzi in tempo reale (Abacus Price API)

Domanda di forza: L’ordine può essere completato solo se i prezzi di tutti gli articoli collegati al carrello sono stati ottenuti direttamente dall’API Abacus per i prezzi in tempo reale.

Interrogazione dei prezzi delle sottovoci nella categoria: I prezzi di tutte le sottovoci devono già essere interrogati nella visualizzazione della categoria? Le prestazioni possono peggiorare notevolmente se questa opzione è attivata, soprattutto se il numero di sottovoci per articolo è elevato.

Notifica del problema

per la richiesta di prezzi in tempo reale (Abacus Price API)

• Destinatario:** Inserire uno o più indirizzi e-mail (separati da virgole).
• Intervallo in ore: Tempo di attesa prima dell’invio di una nuova notifica.

per l’esportazione degli ordini

• Destinatario:** Inserire uno o più indirizzi e-mail (separati da virgole).
• Tolleranza in secondi: Tempo di attesa prima dell’invio di una nuova notifica.

Abacus-API

Salvare le masse e i pesi come caratteristiche: Con questa impostazione, le dimensioni e i pesi possono essere visualizzati nel negozio e le varianti possono essere create con questi dati. Tuttavia, se questo campo è attivo, la quantità di dati nel negozio aumenta e rallenta l’importazione e il negozio in generale.

Area commerciale: Selezionare qui l’area commerciale. Questi dati vengono estratti da Abacus. I clienti vengono filtrati di conseguenza.

Impostazioni dell’ordine

Costi di spedizione I costi di spedizione possono essere trasferiti come un articolo, nel qual caso è necessario definire il codice e il prodotto. Oppure le spese di spedizione vengono trasferite come voce speciale di spese di spedizione. L’articolo speciale delle spese di spedizione ha sempre il codice IVA AUT e l’IVA viene assegnata di conseguenza agli articoli dell’ordine.

Impostazioni degli sconti Gli articoli corrispondenti devono essere configurati sia per gli sconti totali sugli articoli che per gli sconti totali. Se una voce di sconto si riferisce a più articoli con codici IVA diversi, l’articolo viene trasferito in forma frazionata. Questo perché un articolo non può avere più aliquote IVA in Abacus. In alternativa, gli sconti totali possono essere trasferiti anche come sconti documento. Questo ha il vantaggio di non dover dividere gli articoli. Tuttavia, ha lo svantaggio che gli sconti sono sempre calcolati in percentuale (solo con 2 cifre decimali) e che ci possono essere al massimo 4 sconti documento. Per utilizzare gli sconti sui documenti, la correzione totale in Abacus deve corrispondere a quella di PepperShop.

Mapping

Nella scheda Mapping si scoprono gli incarichi esistenti e si ha la possibilità di aggiungerne altri. Si può scegliere tra diverse categorie, come articoli, clienti, ordini, ecc. Qui si possono vedere i dati già collegati e si possono collegare altri record di dati.

Stato

La scheda Stato offre una panoramica delle informazioni sullo stato del sistema. Qui è possibile visualizzare il file di registro corrente o cancellare la cache del file. Eventuali errori o avvertimenti vengono visualizzati qui.

Video di istruzioni sulle funzioni REST-API di Abacus

Assistenza ulteriore

Ha bisogno di assistenza ulteriore? PepperShop offre diverse possibilità.

• Spesso un clic sull’icona del punto interrogativo nell’angolo in alto a destra dell’amministrazione può aiutare. Qui può ricevere un aiuto diretto sull’argomento in questione.
• Diverse risposte sono disponibili nelle FAQ, che possono essere consultate anche nell’amministrazione del negozio tramite Supporto&Novità -> Archivio supporto. Oppure tramite la nostra homepage https://www.peppershop.com/de/services/support/faq/
• Nella PepperShop Academy https://www.peppershop.com/de/services/academy/ puo trovare dei video tutorial gratuiti.
• Siamo lieti di aiutarla anche via e-mail o telefono (CHF 185./h). support@glarotech.ch o +41 71 923 08 58