Scarica l'app
e provala subito
Il tuo gestionale non emette scontrini?
Integra Scontrina in pochi minuti!
Scontrina è la soluzione semplice e immediata per il tuo gestionale
Ricordiamo che Scontrina è un'applicazione per smartphone e tablet che rivoluziona il processo di emissione degli scontrini elettronici. Eliminando la necessità di un tradizionale registratore di cassa, consente alle attività di emettere scontrini con facilità e rapidità, senza dover investire in un costoso registratore di cassa telematico.
Modalità di Integrazione
Esistono diverse modalità di integrazione con Scontrina. Dall'integrazione per dispositivi offline, tramite QrCode all'integrazione di piattaforme ecommerce come WooCommerce e Shopify.
In questa pagina, tuttavia, ci focalizziamo sulla modalità che definiamo integrazione "light" con DeepLink. Si tratta di una soluzione snella e veloce, che consente di integrare il proprio gestionale in pochi minuti con estrema facilità.
Vantaggi dell'Integrazione con DeepLink
- un'integrazione semplice e immediata: l'integrazione richiede pochi minuti, dimentica integrazioni che richiedono complessità e ore di sviluppo;
- nessun accreditamento: non è richiesto alcun accreditamento con Scontrina, puoi rendere compatibile il tuo gestionale ora!
- risparmio economico per te: l'integrazione è semplice e non dovrai investire in competenze o ore di sviluppo;
- risparmio economico per i tuoi clienti: offri ai tuoi clienti un modo più economico di gestire gli scontrini senza la necessità di investire in costosi dispositivi telematici.
Generazione del DeepLink
Dal punto di vista tecnico, da parte tua, dovrai solo preoccuparti di generare il DeepLink con le corrette informazoni. Questo potrebbe ad esempio essere generato a partire da un ordine che contiene le informazioni dello scontrino da emettere (voci scontrino, importo, eventuali sconti, ecc.). Il DeepLink dovrà contenere le informazioni attese da Scontrina, con il seguente formato JSON:
{
"scontrina" : {
// voci dello scontrino
"entries": [
{
"description": "Descrizione dell'articolo",
"price": 10.99,
"quantity": 2,
"vatCode": "22"
},
// ... altre voci dell'elenco
],
"paidCash": 5.0,
"paidElectronic": 5.0,
"noPaid": [
{
"amount": 10.0,
"type": "Tipo di pagamento non effettuato"
},
// ... altri dettagli di pagamento non effettuato
],
"lotteryCode": "Codice della lotteria",
"paidTicketInfo": {
// Dettagli aggiuntivi sull'importo pagato tramite ticket restaurant
},
"operatorId": "ID dell'operatore",
"operatorName": "Nome dell'operatore",
"channelId": "Riferimento del tuo gestionale, utile per la riconciliazione"
}
}
// JSON root
interface IDeepLinkCodeEmitRequest {
scontrina: IEmitRequest;
}
interface IEmitRequest {
entries: ICheckoutEntry[];
paidCash?: number;
paidElectronic?: number;
noPaid?: { amount: number, type: NoPaidType }[];
lotteryCode?: string;
paidTicketInfo?: IPaidTicketInfo;
operatorId?: string;
operatorName?: string;
channelId?: string;
}
interface ICheckoutEntry {
description: string;
price: number; // should be greater than 0
quantity: number; // should be greater than 0
vatCode: string; // should be one of the supported codes:
4, 5, 10, 22, N1, N2, N3, N4, N5, N6
}
Come generare il DeepLink
Di seguito riportiamo un esempio di come può essere generato il link. Potrai adattare lo stesso in base al linguaggio o framework adottati dalla tua app.
// Oggetto 'doc' contenente i dettagli dello scontrino
const doc = {
scontrina: {
entries: [
{
description: "Descrizione dell'articolo",
price: 10,
quantity: 2,
vatCode: "22"
}
],
channelId: "externalId_1234"
}
};
// Serializzazione dell'oggetto 'doc' in formato JSON
const payload = JSON.stringify(doc);
// URL di callback per reindirizzare alla tua app
const callbackURL = "http://linktoyourapp.com";
// URL personalizzato per l'operazione scontrina
const scontrinaCustomURL = "scontrina://";
const scontrinaOperation = "issue/1.0";
// Creazione del deep link concatenando i parametri
const deepLink = `${scontrinaCustomURL}${scontrinaOperation}?p=${encodeURIComponent(payload)}&c=${encodeURIComponent(callbackURL)}`;
// Stampa del deep link generato (solo per debugging)
console.log(deepLink);
Esempio di DeepLink
Ecco un esempio di DeepLink che puoi utilizzare per sperimentare immediatamente il servizio.
Assicurati di avere installato Scontrina sul tuo dispositivo.
Clicca sul link che segue dal dispositivo con il quale hai installato Scontrina: CLICCA QUI DA UN DISPOSITIVO CON SCONTRINA INSTALLATA
Rimani in contatto
Sebbene non sia necessario alcun accreditamento, consigliamo caldamente di segnalare la tua email al nostro team tecnico che potrà tenerti aggiornato sulle novità dell'integrazione, inviandoti informazioni importanti. Ti consigliamo caldamente di registrarti contattandoci tramite email o tramite il nostro supporto via chat.
Integrare il tuo gestionale con Scontrina è facile e veloce. Per ulteriori dettagli tecnici, consulta la nostra documentazione o contattaci.
