Modalità di Integrazione

Esistono diverse modalità di integrazione con Scontrina. Alcune di queste seguono protocolli standard, come ad esempio l'integrazione che Scontrina offre per integrare il proprio ecommerce sviluppato con WooCommerce.

In questa pagina, tuttavia, ci focalizziamo sulla modalità che definiamo integrazione "light" con QrCode, una soluzione snella e veloce, ideale per gestionali principalmente utilizzati su PC, tablet o dispositivi isolati dalla rete.

Vantaggi dell'Integrazione con QrCode

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 QrCode è molto semplice sia dal punto di vista tecnico, che per l'utente. Consiste in quattro fasi:

• Generazione del QrCode: Il tuo gestionale genera un QrCode contenente tutte le informazioni necessarie per l'emissione dello scontrino.
• Inquadramento del QrCode: Con Scontrina sullo smartphone o tablet, l'utente inquadra il QrCode generato dal tuo gestionale.
• Emissione del documento fiscale: Scontrina interpreta il QrCode e procede con l'emissione dello scontrino, tutto in modo rapido e intuitivo.
• Invocazione del tuo webhook [coming soon]: se un webhook è stato inserito nel QrCode, Scontrina invocherà il tuo endpoint una volta emesso il documento fiscale. Oltre all'esito dell'operazione troverai le informazioni fiscali che potrai registrare nel tuo sistema. Se il webhook non viene passato, sarà l'utente a confermare manualmente l'emissione dello scontrino nell'interfaccia del tuo gestionale. Contattaci per saperne di più su questa funzionalità.

Generazione del QrCode

Dal punto di vista tecnico, da parte tua, dovrai solo preoccuparti di generare il QrCode. 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.). Per la generazione del QrCode, potrai far uso di una qualunque libreria disponibile e adatta per il tuo framework o linguaggio di programmazione (se non trovi una libreria per il tuo framework/linguaggio non esitare a contattare il nostro reparto tecnico). Il QrCode 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": 25.0,
      "paidElectronic": 50.0,
      "noPaid": [
      {
        "amount": 15.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"
    }
  }
              

  interface IQrCodeEmitRequest {
      scontrina: IEmitRequest; // JSON root of your generated QrCode
  }
  
  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
  }
  
            

Esempio di QrCode

Ecco un esempio di QrCode che puoi utilizzare per sperimentare immediatamente il servizio.

Puoi inquadrare questo QrCode con Scontrina, dopo aver abilitato la funzionalità di QrCode nella sezione Menu > Integrazione. Dopo aver abilitato l'integrazione con QrCode trovi il pulsante nella schermata principale di Scontrina, in alto.

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.