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

1. un'integrazione semplice e immediata: l'integrazione richiede pochi minuti, dimentica integrazioni che richiedono complessità e ore di sviluppo;
2. nessun accreditamento: non è richiesto alcun accreditamento con Scontrina, puoi rendere compatibile il tuo gestionale ora!
3. risparmio economico per te: l'integrazione è semplice e non dovrai investire in competenze o ore di sviluppo;
4. 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.

Come funziona

L'integrazione con DeepLink consente alla tua app (o webapp) di aprire l'app Scontrina per richiedere l'emissione di uno scontrino. Scontrina si occupa di tutto il processo di emissione e, una volta emesso lo scontrino, Scontrina porterà l'utente nuovamente sulla tua app.

Potrai fornire tutte le informazioni inerenti lo scontrino da emettere, come le voci scontrino, la modalità di pagamento e così via.

Ecco i semplici passaggi:

• Generazione del link: il tuo gestionale genera un apre un link contenente tutte le informazioni necessarie per l'emissione dello scontrino.
• Emissione dello scontrino: l'app Scontrina viene automaticamente aperta sullo smartphone o tablet. L'utente potrà confermare l'emissione, eventualmente apportando ulteriori modifiche prima della stessa.
• Ritorno alla tua app: una volta emesso il documento fiscale, Scontrina passerà il controllo nuovamente alla tua app che verrà aperta automaticamente. La tua app otterrà contestualmente il numero del documento fiscale appena emesso.

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.