Guida

1. Piani, quota e crediti extra

Ogni piano include una quota di QR code al mese, che si rinnova a ogni ciclo di fatturazione. La quota è unica per l'intero account: non importa se generi i QR da una raccolta o dal tuo sistema tramite API (vedi la sezione 7), attingono entrambi allo stesso conteggio.

Puoi vedere quanto ne hai a disposizione nella barra quota in cima alla sidebar, o nella Dashboard.

Puoi anche cambiare piano in qualsiasi momento dalla stessa pagina Abbonamento, se ti serve una quota mensile più alta in modo continuativo. La pagina mostra il tuo abbonamento attivo, con ciclo, prossimo rinnovo e codici usati: Dettagli del piano apre l'elenco di tutto ciò che include. Sotto trovi la tabella dei piani, con prezzo mensile, prezzo annuale e quanto risparmi scegliendo l'annuale.

Se ti servono volumi diversi da quelli dei piani, nella sezione prezzi della home trovi Richiedi un preventivo: indica i volumi che ti servono e se preferisci pagare mensilmente o annualmente, e ti rispondiamo con una proposta su misura. Il modulo è aperto anche a chi non ha ancora un account.

Pagamenti e fatture

I pagamenti di Pinbloom sono gestiti da Paddle, il nostro Merchant of Record: un rivenditore autorizzato che incassa per nostro conto e si occupa di tutta la parte fiscale. Per questo, sull'estratto conto della carta e sulla fattura troverai il nome Paddle e non il nostro.

• Fatture e ricevute: le emette Paddle. Le trovi in Impostazioni → Fatture e nei link che accompagnano ogni ricevuta.
• IVA e imposte: i prezzi che vedi sul sito sono al netto dell'IVA. L'imposta dovuta viene calcolata al momento del pagamento, in base al paese e al fatto che tu sia un'azienda con partita IVA o un privato.
• Disdetta: puoi disdire quando vuoi da Impostazioni → Abbonamento. Il servizio resta attivo fino alla fine del periodo già pagato e non ci sono vincoli di durata.
• Rimborsi e contestazioni: passano da Paddle, secondo le sue condizioni. Se non sai a chi rivolgerti, scrivici e ti indirizziamo.

Maggiori dettagli sono nei Termini di servizio.

La prova gratuita

Con «Prova gratis» dalla landing ricevi una prova gratuita, senza carta. Parte quando confermi l'email, o subito se ti registri con Google. Chi sceglie direttamente un piano passa al pagamento e non ha la prova.

• 14 giorni e 50 codici, con le funzioni del piano Micro: 1 chiave sandbox e 1 live, fino a 5 operatori.
• Se scegli un piano, durante la prova o dopo: i codici creati in prova restano e funzionano, e non entrano nel conteggio del piano. I codici della prova non usati non si sommano.
• Alla fine della prova non puoi creare nuovi codici. Quelli creati restano validi per 30 giorni, poi l'account viene sospeso, come descritto in «Quando l'abbonamento finisce».
• Una prova per persona e per azienda. Se l'indirizzo, o il dominio aziendale, ha già avuto una prova, l'account viene creato lo stesso, senza prova, e puoi scegliere subito un piano.
• Email: ti scriviamo all'inizio, a metà, 2 giorni prima della fine, alla fine e 5 giorni prima che i codici smettano di funzionare.

Quando l'abbonamento finisce

Se disdici o smetti di pagare, l'abbonamento resta attivo fino alla fine del periodo già pagato.

• Fino alla scadenza: tutto funziona come sempre.
• Per 6 mesi dopo la scadenza: i codici si validano come sempre, con le loro regole, e i webhook partono. Puoi ancora revocare codici e gestire operatori, chiavi API e webhook. Non puoi creare nuovi codici né modificare le raccolte, anche se hai crediti extra.
• Dopo i 6 mesi: i codici non vengono più validati, in qualunque stato si trovino, e l'app risponde «Servizio scaduto». L'account resta consultabile: puoi vedere i dati, esportare e scaricare i codici, cambiare la password, eliminare l'account o scegliere un piano.
• Email: ti scriviamo quando l'abbonamento finisce e 7 giorni prima che i codici smettano di funzionare.
• Crediti extra: restano sul tuo account e tornano utilizzabili con un nuovo abbonamento.

2. Raccolte

Una raccolta è un gruppo di QR code generati insieme per uno scopo specifico — una fiera, una promozione, una singola stampa. È il modo più diretto per creare QR code da usare nel mondo fisico, senza passare dall'API.

Una raccolta, più lotti

Una raccolta non si genera una volta sola. Dalla pagina della raccolta puoi usare Aggiungi altri QR code quando vuoi: ogni gruppo di QR code generato insieme è un lotto. Ogni lotto può avere un template, una struttura, un CSV, una lingua e dei dati di stampa diversi, mentre nome e validità restano quelli della raccolta. Tutti i QR code dei vari lotti si validano allo stesso modo e li trovi nello stesso elenco.

Solo QR code o template di stampa

Quando generi dei QR code puoi scegliere tra due modi:

• Solo QR code: ottieni i QR code da scaricare, singoli o tutti insieme in uno ZIP, e li usi come vuoi.
• Con template di stampa: i QR code vengono inseriti in una grafica già pronta, come un badge, un biglietto o un buono, e ottieni un PDF da stampare o mandare in tipografia.

I template di stampa dipendono dal piano: con Micro e Starter generi solo QR code, con Pro scegli tra i template della libreria, con Business puoi anche caricare i tuoi.

Dati diversi su ogni pezzo (CSV)

Molti template hanno campi da riempire, ad esempio nome, posto, fila. Per compilarli carichi un file CSV: una riga per ogni QR code, quindi il numero di righe è il numero di QR code che verranno generati. Il CSV deve avere una colonna per ogni campo del template; se ne manca una, ti dice quale. Nel passo QR code puoi scaricare un CSV di esempio già compilato con il formato giusto: ti basta modificarlo.

I template caricati devono usare i font ammessi: l'elenco è nella sezione Template personalizzati.

Validità e scadenza

Quando crei una raccolta puoi indicare, se vuoi, una data di inizio e una di fine.

• Data di inizio: i QR code valgono da quel giorno, dalla mezzanotte nel fuso della raccolta. Scansionati prima, l'app risponde «non ancora validabile» con la data da cui valgono, e il codice resta non usato.
• Data di fine: tutti i QR code della raccolta scadono alla fine di quella giornata. Dopo, uno scan restituisce "scaduto" anche se il QR code non è mai stato usato. Senza data di fine, i QR code non scadono mai.
• Tolleranza oltre la mezzanotte (minuti): per impostazione predefinita i QR code scadono a mezzanotte della data di fine. Se l'uso può avvenire dopo, ad esempio per uno spettacolo che comincia tardi o una festa che finisce all'alba, aggiungi una tolleranza in minuti. Lasciala vuota se l'uso si conclude sempre entro mezzanotte.

Lo stato della raccolta dipende dalla data di fine:

Una raccolta si può eliminare solo se nessuno dei suoi QR code è già stato usato — è una protezione contro la cancellazione accidentale di dati che magari ti servono ancora (chi ha già scansionato cosa).

3. Template personalizzati

Con il piano Business puoi caricare i tuoi template: un file SVG disegnato nel tuo programma di grafica (Illustrator, Inkscape, Figma) in cui il QR code, i dati di ogni persona e quelli della tua azienda finiscono dove li hai messi tu. Quando lo carichi lo controlliamo e, se qualcosa non va bene per la stampa, ti diciamo subito cosa correggere: meglio un rifiuto adesso che un lotto stampato storto.

Dimensioni

Il tag <svg> deve avere width e height in un'unità di stampa: mm, cm, in, pt o pc. I pixel e i numeri senza unità non sono ammessi, perché la loro misura reale dipende dalla risoluzione e non si può sapere come uscirà la stampa.

<svg xmlns="http://www.w3.org/2000/svg" width="100mm" height="150mm">

Il riquadro del QR code

Il template deve contenere un solo elemento con id="pinbloom:code", con x, y, width e height: è lo spazio in cui inseriamo il QR code, quindi posizione e dimensione le decidi tu. Il modo più semplice è disegnare un <rect>. Deve essere quadrato (width e height uguali) e di almeno 20 mm per lato: un codice stirato o più piccolo si legge male.

<rect id="pinbloom:code" x="60" y="90" width="30" height="30" />

Testi da compilare

Dove vuoi un dato diverso su ogni pezzo scrivi un segnaposto come testo, ad esempio {{nome}} o {{posto}}. Ogni segnaposto corrisponde a una colonna del CSV, con lo stesso nome: se nel CSV manca una colonna, ti diciamo quale. Le diciture fisse, cioè i testi senza segnaposto, scrivile in inglese: vengono tradotte nella lingua scelta per il lotto.

<text x="10" y="20">Ciao {{nome}}, il tuo posto è {{posto}}</text>

nome,posto
Marta,A12
Luca,A13

Dati e logo dell'azienda

I dati della tua azienda, presi dalle Impostazioni, si inseriscono con i campi elencati qui sotto.

• [[azienda.nome]]
• [[azienda.sito]]
• [[azienda.email]]
• [[azienda.telefono]]
• [[azienda.indirizzo]]
• [[azienda.piva]]

Quando crei la raccolta, nel passaggio di stampa trovi un campo per ciascuno di quelli che il template usa: puoi lasciare il valore delle Impostazioni o cambiarlo, e la modifica vale solo per quella raccolta. Un campo lasciato vuoto non viene stampato. Un campo diverso da quelli elencati rende il template rifiutato.

<text x="10" y="140">[[azienda.nome]] · [[azienda.sito]]</text>

Per mostrare il logo dell'azienda (quello delle Impostazioni, o un altro scelto per la raccolta) aggiungi un <rect> con id="azienda:logo" e con x, y, width e height. Quel riquadro è lo spazio che gli dai: il logo vi entra intero, centrato e senza deformarsi. Se conosci la forma del tuo logo, dagli un riquadro della stessa proporzione e non resta spazio vuoto.

<rect id="azienda:logo" x="10" y="10" width="60" height="30" />

Se invece il logo non cambia mai, puoi anche inserirlo direttamente nel disegno, come qualsiasi altra immagine: in quel caso non serve alcun id.

Font ammessi

Il template richiama un font per nome e quel font deve essere installato sul nostro sistema di stampa. Un font incorporato nel file SVG non viene letto. Per evitare stampe con un carattere diverso da quello che hai scelto, rifiutiamo i template che usano font non disponibili. Quelli ammessi sono:

• Archivo
• DejaVu Sans
• DejaVu Sans Mono
• DejaVu Serif
• Inter
• Liberation Mono
• Liberation Sans
• Liberation Serif
• Lora
• Montserrat
• Open Sans
• Oswald
• Playfair Display
• Raleway
• Roboto
• Roboto Mono
• Source Serif 4
• Work Sans

E se vuoi un altro font? Nel tuo programma di grafica converti il testo fisso in tracciati: così diventa un disegno e il font non serve più. Questo vale per titoli e diciture che non cambiano. I testi che si compilano dal CSV, cioè i segnaposti come {{nome}}, devono invece restare testo e usare uno dei font ammessi.

Perché un caricamento viene rifiutato

Ogni rifiuto indica cosa cambiare. Questi sono tutti i motivi:

4. Stati dei QR code

Ogni QR code, che sia nato da una raccolta o dall'API, passa per gli stessi stati — vale ovunque nell'app.

Scaduto non compare come stato in tabella: viene verificato nel momento della scansione. Per questo un QR code con la data di fine passata può risultare ancora "Non usato" nell'elenco, ma l'operatore che lo scansiona lo vedrà come scaduto.

5. Operatori: account vs raccolta

Un operatore è una persona autorizzata a validare i QR code con l'app sul campo. Puoi invitarlo in due modi diversi, a seconda di quanto ampio deve essere il suo accesso.

• Operatore per raccolta — invitato dal tab "Operatori" dentro una raccolta specifico. Può validare solo i QR code di quella raccolta.
• Operatore a livello di account — invitato dalla pagina "Operatori" nel menu principale. Può validare qualsiasi QR code dell'account: sia quelli generati via API sia quelli di qualunque evento.

Il meccanismo è identico per entrambi: l'operatore riceve un'email che lo avvisa dell'autorizzazione e non deve confermare nulla. Per accedere all'app inserisce la propria email e il codice a 6 cifre che riceve via email. L'autorizzazione vale da subito, finché non la revochi: puoi farlo in qualsiasi momento dalla stessa pagina da cui hai invitato l'operatore. Ogni operatore usa l'app su un solo telefono alla volta: se accede da un altro telefono, la sessione sul primo si chiude. I piani Micro e Starter hanno un numero massimo di operatori: 5 per Micro, 20 per Starter. Pro e Business non hanno limiti. Lo stesso operatore su più raccolte conta una volta, e un operatore revocato non conta.

6. Validare i QR code con l'app

L'operatore usa l'app Pinbloom (su qualsiasi telefono Android o iOS), inquadra il QR code e vede subito l'esito:

• Valido (verde): il QR code è buono e da questo momento risulta Usato. Se il QR code porta dei dati, come posto, fila o nome, l'operatore li vede subito.
• Già usato (rosso): il QR code è stato validato in precedenza; l'app indica quando.
• Scaduto o Revocato: il QR code non è più valido e viene rifiutato, con un messaggio che dice il motivo.

Ogni scansione viene registrata con il suo esito. Per vedere chi ha validato cosa e quando, apri Operatori e clicca l'icona dello storico accanto all'operatore: trovi data, QR code, raccolta ed esito di ogni scansione.

Senza rete: se la rete manca, l'app continua a funzionare. Gli esiti delle scansioni vengono sincronizzati con il server appena il telefono torna online.

Caratteristiche di sistema consigliate

Per l'esperienza migliore, soprattutto in caso di assenza temporanea della rete:

7. Collegare il tuo sistema (per sviluppatori)

Se hai un e-commerce o un gestionale, puoi far generare i QR code direttamente al tuo sistema, senza passare dal pannello, e fargli reagire a ciò che succede sul campo.

• API: il tuo sistema chiede a Pinbloom di generare un QR code (o un codice a barre) e lo inserisce dove serve, ad esempio nella conferma d'ordine. I QR code generati così attingono alla stessa quota dei tuoi eventi.
• Chiavi API: si creano da Impostazioni → Sviluppatori, una per ogni integrazione. Esiste anche una chiave di prova (sandbox) per provare senza consumare quota.
• Webhook: a ogni scansione Pinbloom avvisa il tuo sistema con una richiesta firmata. Così puoi aggiornare i tuoi dati in automatico: ad esempio, quando un cliente ritira la merce e lo scan va a buon fine, il tuo sistema segna l'ordine come "ritirato".

Esempi, formati e dettagli tecnici sono nella Documentazione, consultabile anche senza registrarsi.

8. Supporto

Per domande o problemi puoi aprire un ticket direttamente dall'area riservata, senza passare dalla posta.

• Aprire un ticket: dalla voce Supporto in basso nel menu a sinistra scegli Nuovo ticket, scrivi l'oggetto e descrivi il problema.
• Le risposte: rispondiamo dall'area riservata e ti avvisiamo anche per email, nella tua lingua. Nella pagina del ticket trovi tutta la conversazione e puoi aggiungere altri messaggi.
• Stato: un ticket è «In attesa di risposta» se deve rispondere il nostro team, «Risposta ricevuta» se ora tocca a te, «Chiuso» quando è risolto.
• Chiudere e riaprire: puoi chiudere un ticket quando hai risolto, e riaprirlo scrivendo di nuovo. Se è stato chiuso dal nostro team non si riapre: per altre richieste apri un nuovo ticket.