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 )restituiscetrue) e- riporta il
residuo(se previsto) al valore dimax_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)
- riporta il
Carnet: proprietà, visibilità, modelli¶
Per i Carnet oggi è importante distinguere tra:
clienti_centro: indica la sede che ha emesso/attivato l'acquistosedi_valide: indica in quali sedi il Carnet è visibile e utilizzabileid_servizio: eventuale modelloelenco_servizida cui deriva il Carnet
Tipi di Carnet¶
-
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_validevuoto, in lettura applicativa viene considerata almeno la sede diclienti_centro.
-
Carnet multisede
- Ha sempre un modello associato di tipo multisede.
- In
sedi_validecontiene più sedi reali. - È visibile e utilizzabile in tutte le sedi indicate in
sedi_valide. - Può essere attivato dalle sedi presenti in
sedi_validedel modello corrispondente.
-
Carnet Ufficiarredati
- Ha sempre un modello associato di tipo Ufficiarredati.
- In
sedi_validecontiene 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 correnteinclude_multisede=true|false: include i Carnet spendibili nella sede corrente tramitesedi_valideinclude_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 consedi_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 |