Gettone di assistenza¶

Concetto¶

Il gettone e' un pacchetto contrattuale di prestazioni/materiali pre-concordato. Alla chiusura di un intervento coperto da gettone, le quantita' delle prestazioni incluse nel pacchetto vengono ridotte (o azzerate) e sostituite da una singola voce forfettaria.

Lo scopo e' gestire interventi "a pacchetto" dove alcune prestazioni sono gia' comprese nel canone contrattuale e non devono essere addebitate separatamente.

Tabelle¶

ASNGATES — Testata gettone¶

Campo	Formato	Descrizione
`agat-cod`	x(02)	Codice gettone (chiave primaria)
`agat-des`	x(60)	Descrizione
`agat-tempo-scalare`	s9(04)v99	Ore da scalare dalle prestazioni a tempo
`agat-prest`	merce	Prestazione forfettaria da aggiungere in sostituzione

ASNGADET — Dettaglio gettone¶

Campo	Formato	Descrizione
`agad-cod`	x(02)	Codice gettone (FK → ASNGATES)
`agad-prog`	9(04)	Progressivo prestazione
`agad-merce`	merce	Codice prestazione da scalare
`agad-qta`	s9(04)v999	Quantita' da scalare. Se 9999 → illimitata (azzera completamente)

Collegamento al contratto¶

Il gettone viene associato a livello di matricola contratto (ASNCNMTR):

Campo	Tabella	Descrizione
`acnc-gettone`	ASNCNMTR	Gettone applicabile agli interventi per questa matricola
`acnt-gettone`	ASNCNTES	Gettone a livello di testata contratto (fallback)

Registrazione sull'intervento¶

Campo	Tabella	Descrizione
`acit2-gettone`	ASNINTE2	Codice gettone applicato all'intervento
`acid2-fl-gettone`	ASNINDET	"S" = riga interessata dal gettone
`acid2-qta-orig`	ASNINDET	Quantita' originale prima della riduzione
`acid-qta`	ASNINDET	Quantita' fatturabile dopo la riduzione

Logica di applicazione — ASN140 `g1-calcolo-gettone`¶

Prerequisiti¶

L'applicazione del gettone avviene in fase di chiusura intervento (ASN140) solo se:

L'intervento e' collegato a un contratto (tm-id-contratto <> 0)
Il gettone non e' gia' stato applicato (tm-acit2-gettone = spaces e tm-gettone = spaces)
Non e' stato impostato un importo concordato (tm-imp-concordato = 0)

Determinazione del gettone da applicare¶

Legge la testata contratto (ASNCNTES) → acnt-gettone
Scorre le matricole contratto (ASNCNMTR) collegate all'intervento → acnc-gettone
Se piu' matricole hanno gettoni diversi → errore (conflitto non gestibile)
Priorita': gettone da matricola se presente, altrimenti da testata contratto

Calcolo e riduzione quantita'¶

Per ogni prestazione nell'intervento:

Match con dettaglio gettone: se la prestazione corrisponde a una riga ASNGADET:
Se agad-qta = 9999 → azzera la quantita' (illimitata)
Altrimenti → riduce la quantita' di agad-qta
Se la quantita' risultante e' <= 0 → marca come non fatturabile
Imposta acid2-fl-gettone = "S" e salva acid2-qta-orig
Prestazioni a tempo non in dettaglio: se la prestazione ha UM a tempo e il gettone ha agat-tempo-scalare > 0:
Scala le ore dalla prestazione
Imposta acid2-fl-gettone = "S"
Aggiunta prestazione forfettaria: al termine, se sono state scalate ore:
Aggiunge una nuova riga con agat-prest (la prestazione forfettaria), quantita' 1
Marca con acid2-fl-gettone = "S"

Registrazione¶

acit2-gettone = codice gettone applicato (scritto su ASNINTE2)
Ogni riga interessata ha acid2-fl-gettone = "S" e acid2-qta-orig con il valore precedente

Esempio¶

Gettone "01" configurato:

agat-tempo-scalare = 2.00 (2 ore)
agat-prest = "SRV01" (prestazione forfettaria)
Dettaglio ASNGADET:
- Manodopera "MAN01": scalare fino a 10 ore
- Ricambio "RIC05": scalare 2 pezzi

Intervento prima del gettone:

Prestazione	Qta	Importo
MAN01 (manodopera)	8 ore	400
RIC05 (ricambio)	2 pz	50
TRA01 (trasferta)	2 ore	100
ALT01 (altra)	1 pz	30

Dopo applicazione gettone:

Prestazione	Qta	Flag	Note
MAN01	0 ore	S	Scalata da ASNGADET (8 <= 10)
RIC05	0 pz	S	Scalata da ASNGADET (2 = 2)
TRA01	0 ore	S	Scalata da agat-tempo-scalare (2 ore)
ALT01	1 pz		Non in gettone, fatturata normalmente
SRV01	1 pz	S	Prestazione forfettaria aggiunta

Flusso nei programmi a valle¶

Programma	Comportamento
ASN140	Applica il gettone, registra su ASNINTE2/ASNINDET
ASN350	Consultazione interventi chiusi: mostra `acit2-gettone`
ASN351	Creazione documenti: usa le quantita' gia' ridotte, nessuna logica gettone propria

Configurazione¶

Il gettone viene definito in:

Anagrafica gettoni: programma di gestione ASNGATES/ASNGADET (menu Assist 2.0 → Archivi)
Contratto: pagina "Tariffe e servizi", campo "Gettone di assistenza" (ASN050)
Matricola contratto: associazione specifica per matricola (ASNCNMTR.acnc-gettone)

Vincoli¶

Un intervento con matricole di contratti diversi con gettoni diversi genera errore
Il gettone non viene applicato se e' gia' stato applicato in precedenza
Il gettone non viene applicato se e' presente un importo concordato
In chiusura automatica, i conflitti causano il rifiuto dell'intervento (asn140-o-esito = "N")