progetto-automazione/progestnow-agents

Gestione e diagnosi degli interventi di assistenza tecnica in ProgestNOW. Attiva quando la domanda riguarda interventi (tabella interventi): ricerca per tecnico/impianto/stato/data, creazione e modifica interventi, ricorrenze, cambio stato, fatturazione del lavoro svolto, troubleshooting lista/ricorrenze/collegamento documento, e il flusso scheda-checklist-firma degli interventi su commessa (testacommesse_interventi).

Ricerca, lettura, diagnosi, invio ed eliminazione di allegati in ProgestNOW, e operazioni di upload, ZIP e copia con i tool dedicati della famiglia allegati. Attiva quando la domanda riguarda allegati/attachment/upload di file su record o documenti, allegati mancanti o non scaricabili, ZIP o email di allegati, copia allegati tra documenti, categorie/tag allegati, oggetti orfani o record DEL_.

Verifica lo stato degli effetti documentali (RIBA/RID), analizza anomalie, esegue il ciclo generazione → distinta → file bancario → trasferimento in prima nota → insoluti, e diagnostica i fallimenti, seguendo le regole di CAP-20260812-006.

Creazione, invio, lettura, assegnazione, marcatura letta e diagnosi delle notifiche interne in-app di ProgestNOW (pn_notifications + pn_notifications_users). Attiva quando l'utente chiede di notificare utenti/gruppi dentro il gestionale (campanella del header), di pubblicare un avviso visibile a utenti specifici, di elencare/leggere notifiche, assegnare destinatari, segnare come lette, o diagnosticare notifiche che non compaiono nella barra o contatore non lette che non si azzera.

Procedura obbligatoria per COMMESSE/PRATICHE ProgestNOW (testacommesse, righecommesse). Attivala PRIMA di leggere o aggregare commesse o rispondere su commessa, pratica, cantiere, preventivo/consuntivo, costi/ricavi, margine, scostamenti, centri di costo, documenti o prima nota collegati, budget. Impone di leggere il descrittore di testacommesse (spesso personalizzato). Evita preventivo sommato al consuntivo, ricavi doppi documento+prima nota, righe automatiche modificate a mano.

Procedura obbligatoria per DATI DI ACQUISTO DEGLI ARTICOLI - costo ultimo, prezzo/data dell'ultimo acquisto, fornitore dell'ultimo acquisto o carico, costo ultimo per uno specifico fornitore, confronto costi tra fornitori, fornitore preferenziale/di riassortimento, costi insieme alle giacenze. Attivala prima di cercare costi o ultimi acquisti di articoli: le fonti sono viste gia' pronte, non si ricostruiscono da documenti o movimenti.

Procedura obbligatoria per EVADERE ordini ProgestNOW, fornitore o cliente, creando il documento che li evade (carico da ordine fornitore, DDT o fattura da ordine cliente) con i tool pn_document_evadable_rows e pn_document_session_evade_rows dentro una sessione pn_document_new_*. Attivala quando l'utente chiede di evadere un ordine, caricare la merce arrivata, registrare il DDT del fornitore allegato, fatturare o spedire righe di un ordine cliente, o chiudere a saldo righe d'ordine. Evita gli errori piu costosi gia accaduti - righe ricopiate a mano con row_add (ordine non evaso), doppia fatturazione di righe gia evase, quantita applicate alle righe sbagliate, codice ordine messo nel numero documento d'origine, save prematuro seguito da correzioni.

Procedura obbligatoria per FATTURATO, vendite, ricavi e venduto calcolati dai documenti ProgestNOW. Attivala PRIMA di aggregare documenti di vendita o di rispondere su fatturato per periodo, mese, anno, cliente, agente o articolo, miglior mese, confronto tra periodi, top clienti. Default = imponibile delle fatture (tipologia F) meno note di credito (tipologia C) per data fattura, con TUTTE le causali della tipologia. Evita fatturato su una sola causale, IVA inclusa, autofatture o proforma.

Procedura obbligatoria per IDENTIFICARE ARTICOLI del catalogo a partire da codici e descrizioni scritti da terzi (bolle, ordini, listini, offerte, file Excel/PDF, codici citati dall'utente). Attivala prima di inserire articoli in un documento o in un listino quando l'articolo non e' gia' noto, e per domande come "che articolo e' il codice X del fornitore Y". Copre Ns./Vs. codice, EAN, codici fornitore e cliente, codici di listino.

Procedura obbligatoria per INCASSI di FATTURE ATTIVE. Attivala PRIMA di rispondere su incassato, da incassare, residuo, fatture pagate/non pagate/parziali, insoluti, crediti aperti di un cliente, incassi di un periodo, o PRIMA di registrare un incasso. Fonti: qryfatture_situazione_incassi (stato per fattura), qryfatture_incassi (movimenti), partitario, pn_document_receipts_status, pn_document_receipt_register. Evita incassato gonfiato da insoluti, partite condivise e righe banca.

Procedura obbligatoria per OFFERTE e PIPELINE COMMERCIALE (offerte a clienti: tipologia R con causale cliente, kanban opportunità). Attivala PRIMA di rispondere su offerte aperte, pipeline, preventivi, trattative, opportunità, funnel, tasso di conversione, offerte vinte o perse, offerte per agente, offerte scadute, previsione di chiusura, o prima di cambiare stato o fase di un'offerta. Evita pipeline gonfiata da offerte ferme o revisionate, tassi di vincita falsi, fasi orfane, agenti mancanti. Un'offerta non è fatturato.

Procedura obbligatoria per ORDINI CLIENTI e PORTAFOGLIO ORDINI in lettura. Attivala PRIMA di rispondere su ordini aperti, da evadere, inevasi, backlog, portafoglio, ordinato, residuo, consegne in ritardo, stato di un ordine, evasione parziale, ordini fermi, ordini per agente o cliente, offerta di origine o DDT e fatture che evadono un ordine. Legge prima la configurazione del tenant (causali O, stati ordine). Evita backlog con ordini annullati, evasione ricalcolata dai documenti a valle, valore residuo preso dalla testata.

Procedura obbligatoria per ORDINI A FORNITORE e MERCE IN ARRIVO in lettura. Attivala PRIMA di rispondere su ordini fornitore aperti, merce da ricevere, in arrivo, ordinato a fornitore, consegne in ritardo, ricevimenti parziali, puntualità fornitori, stato di un ordine fornitore, residuo da ricevere, carichi che evadono un ordine. Legge prima la configurazione del tenant (causali T, stati, valute). Evita di confondere richieste d'offerta e carichi con ordini, ricevuto gonfiato da chiusure a saldo, valute sommate.

Punto di ingresso per qualsiasi richiesta sul gestionale ProgestNOW del tenant collegato. Usala quando l'utente parla di clienti, fornitori, articoli, fatture, ordini, DDT, offerte, note credito, scadenze, incassi, pagamenti, commesse, statistiche, agenda, allegati, attività, TabellaBase o stampe, anche se non nomina ProgestNOW.

Procedura obbligatoria per le STATISTICHE di vendita/acquisto della pagina Statistiche di ProgestNOW (fatturato, ordinato, offerto, acquistato) per 1-5 raggruppamenti (anno, mese, cliente, agente, articolo, categoria, zona, fornitore...), top clienti/articoli, confronto con l'anno precedente, margine e costo. Attivala PRIMA di pn_statistiche_query/pn_statistiche_catalog o quando l'utente chiede "come nella pagina Statistiche". Evita acquistato che somma ordini fornitore e carichi, totali sommati a mente, margini senza copertura del costo.

Procedura obbligatoria per leggere dati da qualsiasi TabellaBase ProgestNOW con i tool pn_tabellabase_catalog, pn_tabellabase_descriptor, pn_tabellabase_list, pn_tabellabase_single, pn_tabellabase_aggregate, pn_tabellabase_list_view_create e pn_coge_partitario_search. Attivala PRIMA di cercare un record, elencare righe, filtrare per data o codice, calcolare totali, medie, conteggi o confronti tra periodi, estrarre dataset per Excel o sandbox, o creare una vista personalizzata delle colonne della lista. Evita gli errori piu costosi: filtri che ritornano 0 righe per nome campo sbagliato, liste grasse in contesto, paginazione a mano, sandbox usato per OR, ordinamenti, top N, duplicati o confronti tra campi che il search v2 fa da solo, freesql rifiutato.

Ricerca, lettura, creazione, modifica, completamento, eliminazione e diagnosi delle attività/task (pn_tasks) e dei relativi promemoria/reminders (pn_tasks_alerts) in ProgestNOW. Attiva quando la domanda riguarda attività, task, ToDo, cose da fare collegate a un record, scadenze e promemoria di un task, task collegati a documenti/clienti/strutture, task non in agenda, promemoria non arrivati, modifica/aggiunta/eliminazione dei reminders di un task specifico.

Ricerca, lettura, creazione, modifica ed eliminazione dei messaggi/discussioni (pn_threads) in ProgestNOW, e diagnosi delle anomalie (messaggi non visibili, notifiche non arrivate). Attiva quando la domanda riguarda messaggi, discussioni o scambi in stile forum tra utenti collegati a un record (task, ticket, pratica, documento...), commenti su una scheda, notifiche email di nuovi messaggi, o messaggi da aggiungere/modificare/eliminare su un record specifico. Attiva anche quando l'utente chiede di "aggiungere un messaggio/commento/nota su un record" e va chiarito se intende un messaggio forum (pn_threads) o un campo del record stesso.