LogoLogo
V2.0.3
V2.0.3
  • 🏠Carta Giovani Nazionale - Documentazione Tecnica
  • 🕐Storico delle modifiche
  • 📑Premessa
  • 🤝aderire al programma
    • Come si diventa Partner
    • I requisiti
  • ✍️il convenzionamento
    • Il convenzionamento
      • Dettaglio dati: Operatore
    • Firma della convenzione
    • Esito della richiesta di convenzionamento
  • 🪄Le opportunità
    • Cos'è un'opportunità
    • Come creare un'opportunità
      • Dettaglio dati: opportunità
    • Le modalità di riconoscimento e validazione delle opportunità
      • 1️⃣Presenza fisica del Beneficiario
      • 2️⃣Modalità API
      • 3️⃣Modalità codice sconto statico
      • 4️⃣Modalità lista di codici statici
      • 5️⃣Modalità landing page
    • Stati delle opportunità
    • Riconoscimento delle opportunità ai titolari di EYCA
  • 🖍️Manuale di scrittura per gli operatori
    • Guida alla scrittura
    • La scheda dell'Operatore
    • La scheda dell'opportunità
  • 🔄RICHIESTE DI MODIFICA
    • Come modificare la scheda operatore e delle opportunità
    • Come aggiungere, sostituire e/o cancellare un Referente
  • 🔵l'app IO
    • La Carta Giovani Nazionale nell'App IO
    • Lista delle opportunità visibile su App IO
  • ⬇️appendice
    • Assistenza
    • Glossario
    • Branding
    • Ulteriori termini e condizioni d'uso del Portale
Powered by GitBook
On this page

Was this helpful?

  1. Le opportunità
  2. Le modalità di riconoscimento e validazione delle opportunità

Modalità lista di codici statici

PreviousModalità codice sconto staticoNextModalità landing page

Was this helpful?

Nel caso in cui l’Operatore abbia deciso di aderire al Programma attraverso il proprio sito web e/o e-commerce e tramite il Modello lista di codici, deve comunicare la lista (bucket) dei codici statici contestualmente alla definizione della singola opportunità, caricando sul Portale un file in formato .csv contenente un numero minimo di 10.000 (diecimila) codici.

Di seguito un file di esempio di corretta formattazione:

I codici che compongono la lista:

  • sono alfanumerici (devono contenere almeno una lettera e almeno un numero);

  • possono contenere il carattere "-";

  • non devono superare i 20 caratteri.

Una volta caricato il file contenente la lista di codici occorre attendere i tempi tecnici necessari per consentire l'importazione e scrittura dei codici stessi sui sistemi CGN. Durante questa procedura viene visualizzata una progress bar all’interno di un apposito modulo informativo nella schermata di dettaglio dell’opportunità. Le opportunità potranno essere pubblicate solo quando la procedura è completata.

Opportunità diverse devono essere associate a liste di codici statici diversi per una maggiore sicurezza. I codici statici presenti devono essere accettati dall’Operatore sui propri sistemi fino al loro utilizzo per tutta la durata dell’opportunità erogata ai Beneficiari.

L’esperienza per i Beneficiari in App IO è identica a quella del codice statico, ma per questa modalità è previsto un sistema di monitoraggio relativo al consumo dei codici sconto dalla lista, onde consentire all’Operatore di caricare ulteriori codici da rendere disponibili ai Beneficiari delle opportunità.

In particolare, al raggiungimento delle soglie del 50%, 25%, 10% di codici residui, l’Operatore riceverà una comunicazione recante invito a caricare una nuova lista di codici per consentire la fruizione delle opportunità collegate ai beneficiari.

La "nuova" lista di codici verrà visualizzata solo dopo che saranno stati utilizzati tutti i codici precedentemente caricati.


Cosa succede se si esauriscono i codici?

Qualora vengano esauriti tutti i codici relativi ad una certa opportunità, l'Operatore riceverà un'e-mail automatica generata dal Portale che comunica l'esaurimento dei codici e invita a caricare una nuova lista di codici. Contestualmente sul Portale l’opportunità passerà in stato “Sospesa” e non sarà più visibile su App IO.


L’identificazione del Beneficiario da parte dell’Operatore avviene secondo questi passaggi:

  • Il Beneficiario accede alla sua CGN nell’App IO e seleziona l’Operatore di suo interesse nella lista esercenti visualizzata;

  • il Beneficiario seleziona l’opportunità di suo interesse e, premendo su "Attiva il codice sconto", visualizza uno dei codici statici che verrà scelto dalla lista di codici caricati dall’Operatore relativamente a quella opportunità, con possibilità di copiarlo direttamente dall’App per incollarlo successivamente nei sistemi dell’Operatore;

  • in fase di finalizzazione dell’acquisto sul portale dell’Operatore, il Beneficiario incolla il codice nell’apposito campo e, se non ci sono stati errori nella digitazione del codice e questo è ancora valido, l’opportunità verrà applicata al carrello.

L’esperienza utente è identica a quella generata dal modello “codice sconto statico”.

Se l’Operatore implementa un processo di invalidazione dei codici effettivamente utilizzati sui propri sistemi, raccomandiamo la massima attenzione in fase di caricamento dei codici: la lista non deve contenere codici duplicati o già presenti nelle liste precedenti in quanto questi potrebbero risultare invalidati e quindi non permettere l’accesso all’opportunità, creando un disservizio ai Beneficiari.

Al momento della visualizzazione del codice sconto in App IO, lo stesso verrà considerato consumato a prescindere dal suo effettivo inserimento o utilizzo sull’e-commerce dell’Operatore, pertanto non sarà più reso visibile ai Beneficiari (incluso allo stesso Beneficiario che dovesse visualizzare il codice per quell’opportunità in un secondo momento).

🪄
4️⃣
39B
test-codes.csv
Template per caricamento lista codici statici su Portale