Movimenti · Core

Tracciabilità completa di ogni transazione: 65+ tipi di movimento per il tuo programma fedeltà

Ogni interazione con il programma fedeltà è registrata come movimento. Vendite con dati di prodotto personalizzabili via JSON, carichi e scarichi wallet, riscatto premi, acquisti coupon, emissione gift card e donazioni — oltre 65 tipi di movimento (MovementKind) garantiscono una tracciabilità senza precedenti.

I campi liberi nelle transazioni di vendita alimentano filtri promozionali avanzati e analisi di dettaglio. Le Purchase Rules definiscono i campi attesi per ogni tipo di vendita, rendendo il modello flessibile quanto serve.

Tipi di movimento

Oltre 65 MovementKind: ogni azione del cliente ha il suo tipo di movimento dedicato

Il cuore del sistema è il catalogo MovementKind: ogni interazione con il programma ha un tipo univoco, categorizzato per area funzionale. Dalla prima registrazione (MOV_NEW_CARD) alle transazioni di vendita, dai movimenti wallet ai premi, fino alle donazioni verso ONG (MOV_DONATION) e agli eventi di gamification come assegnazione di badge e tag.

I movimenti liberi (Open Movements) permettono di definire tipi personalizzati per esigenze specifiche del programma, con le proprie regole e trigger per promozioni.

Tabella di movimenti con cliente, negozio e punti, e SMS collegato all'operazione.

Campi liberi · Purchase Rules

Ogni vendita porta con sé i dati del prodotto: JSON libero per promozioni mirate e analisi avanzate

Il payload di ogni transazione di vendita include un oggetto free_fields completamente configurabile per programma. I campi definiti possono essere brand, categoria prodotto, modello o qualsiasi altra dimensione rilevante per il business.

Le Purchase Rules formalizzano quali campi sono attesi e di che tipo, rendendo i dati affidabili per i filtri del motore promozionale — ad esempio "promozione attiva solo su categoria Footwear" — e per le analisi di dettaglio. I dati vengono salvati con la transazione e rimangono interrogabili nel tempo.

Transazione di vendita · payload JSON
// POST /v2/movements/sale
{
  "card_id": "CRD-00182",
  "shop_id": "SH-MI-001",
  "amount": 89.90,
  "wallet_code": "PUNTI",
  "free_fields": {
    "brand": "Nike",
    "category": "Footwear",
    "product_id": "NK-AF1-WHT",
    "is_sale_item": true
  }
}
Purchase Rule configurata
brandstringrequiredfiltro promo
categorystringrequiredfiltro promo
product_idstringoptionalanalytics
is_sale_itembooleanoptionalanalytics

Storico e annullamenti

Consulta e annulla i movimenti da backoffice, POS e Area Cliente — con stati antifrode in tempo reale

Ogni movimento ha uno dei tre stati antifrode: APPROVED (validato), UNDER_INVESTIGATION (in analisi, valori sospesi e non utilizzabili) o REFUSED (rifiutato). Il backoffice offre una lista con filtri avanzati per tipo, stato, periodo, negozio e cliente.

L'annullamento movimento è configurabile come business rule per programma: il rimborso del wallet avviene in automatico. L'ultimo movimento è consultabile direttamente dal POS e lo storico completo è visibile in Area Cliente.

APPROVED UNDER_INV. REFUSED Tutti i tipi ▾
MOV_SALE
Milano Duomo · Mario R. · € 89,90
+240 pt
APPROVED
MOV_SALE
Roma · Anna T. · € 62,00
180 pt
UNDER_INV.
MOV_DONATION
Online · Luca M. · ONG WWF
−100 pt
APPROVED
↩️
MOV_REFUND · Annullato
Backoffice · rimborso automatico
+310 pt
CANCELLED

Ogni transazione tracciata,
ogni dato pronto per le promozioni

65+ MovementKind

Vendita, wallet, premi, coupon, gift card, donazioni, gamification, sistema — un tipo univoco per ogni interazione con il programma.

TRACCIABILITÀ

Campi liberi JSON

Ogni transazione di vendita porta dati di prodotto configurabili: brand, categoria, modello. Usabili come filtri nel motore promo e nelle analisi.

FLESSIBILITÀ

Purchase Rules

Definisci i campi attesi nel JSON di vendita: tipo, obbligatorietà e uso (filtro promo, analytics). Dati strutturati e affidabili.

REGOLE

Antifrode integrato

Ogni movimento riceve uno stato: APPROVED, UNDER_INVESTIGATION (valori sospesi) o REFUSED. Annullamento con rimborso automatico.

PROTEZIONE
Tutte le caratteristiche

Movimenti e transazioni: la spina dorsale del programma fedeltà

Oltre 65 tipi di movimento (MovementKind): registrazione, vendita, wallet, premi, coupon, gift card, donazione, gamification, sistema.
Campi liberi configurabili nelle vendite (JSON): brand, categoria, prodotto — usabili nei filtri promo e nelle analisi.
Purchase Rules: definizione dei campi attesi per tipo di vendita, con tipo dato e obbligatorietà.
Movimenti liberi (Open Movements): tipi personalizzati per il programma, con proprie regole e trigger promozionali.
Stati antifrode per ogni movimento: APPROVED, UNDER_INVESTIGATION (valori sospesi, non utilizzabili), REFUSED.
Annullamento movimento configurabile come business rule, con rimborso automatico del wallet.
Storico completo consultabile da backoffice (filtri avanzati), POS (ultimo movimento) e Area Cliente.
Donazioni verso ONG (MOV_DONATION): il cliente converte i punti in sostegno a cause sociali configurate nel programma.

Traccia ogni transazione, attiva promozioni in tempo reale

Richiedi una demo e scopri come i dati di prodotto nelle vendite alimentano promozioni mirate e analisi avanzate con Marta Platform.