Square è la prima cassa collegata a XPRIO. Il collegamento utilizza il Suo proprio account Square, richiede pochi minuti e non passa da alcun marketplace. Questa guida presuppone che Lei abbia letto il principio generale. Collegare la mia cassa (POS) a XPRIO
Cosa sapere
Square addebita l'1 % per ordine pagato fuori da Square, sul Suo account sviluppatore Square, non a XPRIO. È la tariffa Square per qualsiasi ordine creato da un'applicazione terza e pagato altrove. XPRIO non trattiene nulla.
Square mostra un ordine solo una volta pagato. Un ordine pagato online arriva quindi contrassegnato come pagato. Un ordine in contanti o con carta alla consegna arriva contrassegnato come pagato all'invio, con l'indicazione del metodo di pagamento: Lei incassa dal cliente senza reinserirlo. L'impostazione «Lasciare incassare alla cassa» non esiste con Square.
Le Sue consegne compaiono come ordini «spedizione» con l'indirizzo del cliente, i Suoi ritiri come ritiri con l'orario previsto. Square riserva il proprio tipo «consegna» ai partner certificati; l'informazione è la stessa, cambia solo l'etichetta.
I rimborsi vengono riflessi. Un rimborso totale o parziale effettuato in XPRIO viene registrato in Square per esattamente lo stesso importo.
Gli esauriti vanno da Square a XPRIO, non il contrario: «esaurito» si imposta sulla cassa Square, l'API non lo consente dall'esterno.
Esiste un ambiente di test: Square fornisce un account sandbox gratuito per provare tutto senza toccare la Sua cassa reale.
Passo 1: creare il Suo token di accesso Square
Acceda a developer.squareup.com con il Suo account Square abituale.
Clicchi su + New application (oppure apra un'applicazione esistente). Il nome è libero, ad esempio «XPRIO».
Nell'applicazione, apra Credentials. In alto nella pagina, un interruttore alterna tra Sandbox e Production: scelga Production per la Sua cassa reale.
Copi il Production Access Token (pulsante Show, poi copi). Non lo condivida con nessuno; XPRIO lo cifra e non lo mostra mai più.
Per una prova senza rischi, resti su Sandbox: il Sandbox Access Token si incolla in XPRIO con l'interruttore Modalità test attivo, e la dashboard di test si trova in developer.squareup.com, sezione Sandbox test accounts.
Passo 2: collegare in XPRIO
Menu Configurazione App, Cassa (POS), scelga il negozio, poi Collega sulla scheda Square.
Attivi Modalità test (sandbox) se sta incollando un token sandbox; la lasci disattivata per la Sua cassa reale.
Incolli il token in Token di accesso di produzione e clicchi su Salva e prova.
Scelga il punto vendita (location Square) di questo negozio, poi Attiva.
XPRIO crea in Square, una sola volta, ciò di cui ha bisogno per contrassegnare gli ordini come pagati, poi legge il Suo catalogo Square: articoli, variazioni, elenchi di modificatori, categorie.
Passo 3: gli articoli
Segua il riquadro Passo successivo della scheda: importazione degli articoli Square in XPRIO se il Suo menu non vi si trova ancora, invio del Suo menu XPRIO a Square se il Suo catalogo Square è vuoto, oppure corrispondenza. Con Square, il collegamento si basa sullo SKU di ciascuna variazione: metta questo SKU come PLU del Suo prodotto XPRIO e tutto si collega da solo. Corrispondenza degli articoli tra XPRIO e la mia cassa
Due particolarità di Square:
ogni articolo Square ha almeno una variazione, anche senza taglia o gusto: un prodotto semplice XPRIO si collega a quell'unica variazione, il che è normale;
Square non conosce i meal deal: un meal deal XPRIO si collega a un articolo Square «Menu» di Sua scelta, e i suoi componenti compaiono come modificatori.
Passo 4: ordine di prova, poi ordini reali
Invia un ordine di prova crea in Square un ordine chiamato «XPRIO» contrassegnato come test. Apra Square (dashboard o app Point of Sale): è tra gli ordini, pagato, con la sua nota. Se compare, i Suoi ordini reali seguiranno lo stesso percorso.
In Square, un ordine XPRIO porta:
il nome del ticket XPRIO-numero e la modalità (ritiro, consegna, in loco);
le righe con la variazione collegata, i modificatori collegati o liberi, gli sconti e le spese di consegna;
il pagamento, registrato come pagamento esterno «XPRIO» per un ordine pagato online, o contanti per un ordine in contanti;
per un ritiro, l'orario previsto e il nome del cliente; per una consegna, l'indirizzo completo.
Domande frequenti
Il test di connessione fallisce. Il più delle volte si tratta di un token sandbox incollato senza la modalità test, o viceversa; oppure di un token copiato con uno spazio. Lo rigeneri in Credentials in caso di dubbio.
L'ordine di prova non compare in Square. Verifichi che l'app Point of Sale sia connessa allo stesso punto vendita (location) scelto in XPRIO, e che l'ordine non sia filtrato: Square lo colloca tra gli ordini in corso, non tra le vendite del giorno finché non è completato.
Posso mantenere le mie vendite al banco come prima? Sì. XPRIO si limita ad aggiungere ordini e a leggere il catalogo. Nulla cambia per il resto della Sua attività Square.
Come scollego? Pulsante Scollega sulla scheda. I collegamenti degli articoli vengono rimossi lato XPRIO; nulla viene eliminato in Square.
Articoli correlati