Home

Acquisti, Omaggi, Carnet, ecc...

Cron

agg. 6/11/2025

  • elaborazione scadenze: due volte al giorno un cron interno gira per verificare quali sono gli acquisti da impostare come scaduti e in scadenza

(da ver 22.4.0): * La Modifica e la Cancellazione definitiva dell'acquisto è determinata dalla funzione current_user_can_edit_this_acquisto eventualmente estesa con il filtro apply_filters('current_user_can_edit_this_acquisto', acquistato_presso_sede_user( $acquisto ), $acquisto ). Allo stato attuale è possibile solo se: - nel caso l'acquisto sia a provvigione, l'acquisto non deve essere più vecchio di ACQUISTI_MAX_DAYS_FOR_EDIT (impostabile nel file config.php) - non deve avere Utilizzi registrati (se previsti) - nel caso l'acquisto sia a provvigione, non deve essere associato a fatture (Se collegato a Fatture in Cloud)

  • La Duplicazione è possibile solo se l'acquisto è stato fatto in una sede dell'utente che sta eseguendo la duplicazione (funzione acquistato_presso_sede_user( $acquisto ) restituisce true) e
    • riporta il residuo (se previsto) al valore di max_utilizzi
    • imposta lo status a publish
    • imposta la data di decorrenza a oggi
    • imposta la data di scadenza in base alla durata del servizio (se prevista)

Carnet: proprietà, visibilità, modelli

Per i Carnet oggi è importante distinguere tra:

  • clienti_centro: indica la sede che ha emesso/attivato l'acquisto
  • sedi_valide: indica in quali sedi il Carnet è visibile e utilizzabile
  • id_servizio: eventuale modello elenco_servizi da cui deriva il Carnet

Tipi di Carnet

  1. Carnet specifico della sede

    • È emesso da una sede ed è visibile solo in quella sede.
    • Può avere oppure no un modello associato (id_servizio).
    • Se ha sedi_valide vuoto, in lettura applicativa viene considerata almeno la sede di clienti_centro.
  2. Carnet multisede

    • Ha sempre un modello associato di tipo multisede.
    • In sedi_valide contiene più sedi reali.
    • È visibile e utilizzabile in tutte le sedi indicate in sedi_valide.
    • Può essere attivato dalle sedi presenti in sedi_valide del modello corrispondente.
  3. Carnet Ufficiarredati

    • Ha sempre un modello associato di tipo Ufficiarredati.
    • In sedi_valide contiene la sede virtuale Ufficiarredati.
    • È visibile e utilizzabile in tutte le sedi del network.
    • Al momento può essere attivato solo dagli amministratori.

Regole di visibilità nelle query

Le query Carnet non si basano più solo su clienti_centro, ma compongono esplicitamente clienti_centro e sedi_valide.

Parametri principali:

  • include_acquisti_sede=true|false: include oppure esclude i Carnet della sede corrente
  • include_multisede=true|false: include i Carnet spendibili nella sede corrente tramite sedi_valide
  • include_ufficiarredati=true|false: include i Carnet Ufficiarredati

Sull'archivio cat_servizi/carnet, se non specificato diversamente, include_multisede e include_ufficiarredati vengono considerati attivi di default.

Questo consente casi d'uso come:

  • mostrare solo i Carnet locali della sede
  • mostrare Carnet locali + multisede
  • mostrare solo Carnet multisede/Ufficiarredati escludendo quelli locali

Note su id_servizio

  • Per i Carnet locali id_servizio è facoltativo.
  • Per i Carnet multisede e Ufficiarredati id_servizio è obbligatorio e deve puntare a un modello coerente con sedi_valide.

Campi:

Core

Nome slug rest note
Titolo title Il nome dell'acquisto
Note content note sull'acquisto compilate daall'operatore quando lo registra
Descrizione excerpt Descrizione dal "Servizio a listino" (vedi CPT Elenco_servizi)
ID Operatore author user ID dell'operatore che ha registrato l'acquisto

Taxonomies

Nome slug rest note
Tipo acquisto cat_servizi Indica il tipo di acqsuito (Omaggi, A Provvigione, ecc..)
Tipo utilizzi tipo_utilizzi Indica il tipo utilizzi che vengono scalati (se previsti) (Ingressi, Euro, Crediti, Consumazioni, ...)
Acquisto da fatturare fatturazione_acquisti Indica se da fatturare o già fatturato (soprattutto per acquistui a provvigione da Ottomedia
Spendibile presso... sedi_valide In quali sedi è utilizzabile questo Acquisto. Nei Carnet governa visibilità e spendibilità, non solo l'uso operativo.

Meta

Nome slug rest note
ID Azienda cliente_id post ID dell'Azienda che ha acqsuitato da 6.0
ID Sede center_id ID Sede presso cui si effettua l'acquisto. In caso di Acquisti da Ottomedia per le Sedi, qui c'è la sede presso cui l'Acquisto è attivato (per esempio: la sede che utilizza Virtuoso, o che ha accesso ai contratti ecc. In questo modo anche nel caso di società che hanno più business centers possiamo attivare certi acquisti solo a una o più sedi).
Prezzo prezzo Il prezzo di vendita. 0 per gratuito
Numero utilizzi massimo max_utilizzi Il numero massimo di utilizzi, che potrà essere scalato e registrato nel campo "utilizzato". Impostare a un numero intero maggiore di 0, per prevedere la registrazione a scalare a partire da quel numero. Impostare a 'illimitati' se l'acquisto dovrà registrare gli utilizzi ma senza scalare. Impostare a -1 se l'acquisto non dovrà avere nessun tipo di registrazione di utilizzi.
Numero utilizzi residuo residuo Quanti utilizzi restano (valido per gli acquisti a scalare)
Acquisto non ripetibile servizio_singolo Se ogni "parent" può avere un solo servizio di questo tipo attivo (vedi cpt elenco_servizi e taxonomy cat_servizi; usato per ora solo per gli ingressi omaggio)
Decorrenza decorrenza La data di decorrenza dell'acquisto/contratto. ISO GMT
Scadenza scadenza La data di scaddenza dell'acquisto/contratto. ISO GMT
ID Servizio id_servizio Il POST ID del servizio "tipo" utilizzato. Per i Carnet locali è facoltativo; per i Carnet multisede/Ufficiarredati è obbligatorio.
ID Segnalazione origine segnalazione_id ID Segnalazione che ha originato l'acquisto (usato per contratti a provvigione)
ID Open Card card_id ID della Card eventualmente utilizzata per Acquisto
Valore commissione commission_value La percentuale di provvigione o l\'ammontare fisso
Durata commissione commission_duration La durata del rapporto provvigionale su questo acquisto. In anni
Tipo commissione commission_type Se la provvigione è a percentuale o a importo fisso (indicare "fixed" o "percent")
Scadenza commissione commission_scad La data di scadenza del rapporto provvigionale. data decorrenza + commission_duration
Contratto rinnovato con id: rinnovato_in l'id del nuovo contratto, che è rinnovo di questo
Questo contratto è un rinnovo di id: rinnovo_da l'id del contratto precedente
Info cambio status status_{status-slug} array con chiavi date => data cambio status, user_id => l'operatore che ha effettuato l'operazione
Fatture provvigioni associate fattura_FiC_token Le fatture per le provvigioni a Ottomedia emesse per l'acquisto. Si tratta di token di Fatture in Cloud, account Ottomedia srl

Status:

Nome slug note
Attivo publish
Scaduto scaduto Ha superato la data di scadenza indicata nel meta scadenza. Impostato in autoamatico.
Cessato cessato Terminato. viene impostato dall'operatore, quindi è uno stato definitivo (per esempio per "confermare" lo stato "scaduto" impostato in automatico)
Esaurito esaurito Terminati gli UTILIZZI. Impostato in automatico quando il meta residuo raggiunge 0
Revocato revocato Se l'operatore lo revoca.
Rimborsato rimborsato Concluso e restituiti i soldi
In scadenza in-scadenza Impostato in automatico un mese prima della scadenza
Rinnovato rinnovato Scaduto e impostato rinnovo con nuovo acquisto