{"id":6169,"date":"2026-08-16T00:00:52","date_gmt":"2026-08-15T23:00:52","guid":{"rendered":"https:\/\/www.atlantisevo.com\/doc\/?post_type=manual_documentation&p=6169"},"modified":"2026-08-16T00:00:52","modified_gmt":"2026-08-15T23:00:52","slug":"messaggi-automatici","status":"publish","type":"manual_documentation","link":"https:\/\/www.atlantisevo.com\/doc\/manuale\/archivi\/tabelle\/tabelle-documenti\/messaggi-automatici\/","title":{"rendered":"Messaggi automatici"},"content":{"rendered":"
<\/div>

Un messaggio automatico<\/strong> \u00e8 una frase che Atlantis aggiunge da sola in fondo al corpo di un documento, quando il documento risponde a certe condizioni.<\/p>\n

Serve per tutte quelle diciture che oggi si scrivono a mano ogni volta: “Merce resa franco nostro stabilimento”, “Operazione non soggetta a IVA ai sensi dell’art. 41\u2026”, “Pagamento a mezzo Ri.Ba. 60 gg – si prega di non effettuare bonifici”, le note per i clienti esteri, i riferimenti a una promozione valida fino a fine mese.<\/p>\n

Il funzionamento si regge su tre cose:<\/p>\n

    \n
  1. un testo<\/strong> (fisso, tradotto per lingua, oppure calcolato da uno script);<\/li>\n
  2. dei filtri di attivazione<\/strong>, che decidono su quali documenti il messaggio deve comparire;<\/li>\n
  3. un articolo descrittivo<\/strong>, che \u00e8 la riga tecnica con cui il testo viene materialmente scritto nel corpo del documento.<\/li>\n<\/ol>\n

    L’archivio \u00e8 per azienda<\/strong>.<\/p>\n

    \"Messaggi<\/p>\n

    \n

    1. Testata<\/h2>\n\n\n\n\n\n\n
    Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
    Codice<\/strong><\/td>\nnumero progressivo, assegnato automaticamente<\/strong> in inserimento<\/td>\n<\/tr>\n
    Descrizione<\/strong><\/td>\na cosa serve questo messaggio, fino a 50 caratteri. \u00c8 il nome con cui lo ritrovi in elenco, non il testo che esce sul documento<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n

    2. Campi filtro attivazione<\/h2>\n

    Sono le condizioni che il documento deve soddisfare perch\u00e9 il messaggio venga inserito.<\/p>\n\n\n\n\n\n\n\n\n\n\n
    Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
    Tipo documento<\/strong><\/td>\nsu quale tipo di documento agisce (fattura, DDT, ordine\u2026). Va sempre indicato<\/strong><\/td>\n<\/tr>\n
    Causale<\/strong><\/td>\nlimita a una singola causale documento. L’elenco proposto \u00e8 filtrato sul tipo documento scelto sopra<\/td>\n<\/tr>\n
    Soggetto<\/strong><\/td>\nlimita a un singolo cliente o fornitore<\/td>\n<\/tr>\n
    Nazione<\/strong><\/td>\nlimita ai soggetti di una nazione<\/td>\n<\/tr>\n
    Pagamento<\/strong><\/td>\nlimita ai documenti con una certa condizione di pagamento<\/td>\n<\/tr>\n
    Data inizio \/ fine validit\u00e0<\/strong><\/td>\nlimita nel tempo, confrontando con la data del documento<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    La regola dei campi vuoti<\/h3>\n

    Un campo lasciato vuoto significa “vale per tutti”.<\/strong> Un messaggio con il solo tipo documento compilato esce su tutti i documenti di quel tipo; aggiungendo la nazione esce solo per i soggetti di quella nazione; aggiungendo anche il pagamento, solo quando ricorrono entrambe le condizioni.<\/p>\n

    Le date funzionano allo stesso modo: lasciandole vuote il messaggio \u00e8 sempre valido, compilandone una sola si ottiene un “da\u2026” o un “fino a\u2026”.<\/p>\n

    \u26a0\ufe0f Attenzione al caso contrario.<\/strong> Il confronto avviene solo se il documento ha quel dato valorizzato. Se il documento non ha<\/strong> condizione di pagamento, il filtro sul pagamento non viene applicato<\/strong> e un messaggio riservato a un pagamento specifico esce lo stesso. Vale anche per causale, soggetto e nazione. Se un messaggio compare dove non te lo aspetti, la causa \u00e8 quasi sempre questa: sul documento manca il dato su cui avevi filtrato.<\/p><\/blockquote>\n

    Pi\u00f9 messaggi possono scattare insieme<\/strong>: se tre messaggi soddisfano le condizioni, vengono aggiunte tre righe. Non c’\u00e8 una priorit\u00e0 n\u00e9 una scelta del “pi\u00f9 specifico” – escono tutti.<\/p>\n

    \n

    3. Il testo del messaggio<\/h2>\n

    Scheda “Messaggio”<\/h3>\n

    \u00c8 il testo base, fino a 2048 caratteri, quello usato quando non c’\u00e8 una traduzione applicabile.<\/p>\n

    Scheda “Messaggi in lingua”<\/h3>\n

    Una riga per ogni lingua: si indica il codice lingua<\/strong> e il testo tradotto<\/strong>, poi Conferma riga<\/strong>. Se il documento \u00e8 intestato a un soggetto con una lingua e per quella lingua esiste la traduzione, viene usata la traduzione al posto del testo base.<\/p>\n

    \u26a0\ufe0f Trappola da conoscere.<\/strong> Se un messaggio ha traduzioni ma nessuna<\/strong> per la lingua del documento, il messaggio non viene inserito affatto<\/strong> – non ripiega sul testo base. Il ripiego sul testo base funziona solo per i messaggi che non hanno alcuna traduzione.<\/p>\n

    In pratica: o non inserisci traduzioni (e vale sempre il testo base), oppure le inserisci per tutte le lingue<\/strong> che usi davvero sui documenti.<\/p><\/blockquote>\n

    \n

    4. Parametri messaggio<\/h2>\n\n\n\n\n\n\n\n
    Campo<\/th>\nA cosa serve<\/th>\n<\/tr>\n<\/thead>\n
    Articolo<\/strong><\/td>\nl’articolo descrittivo con cui viene creata la riga nel corpo<\/td>\n<\/tr>\n
    Comportamento in variazione doc.<\/strong><\/td>\nNon aggiornare<\/strong> oppure Inserisci \/ aggiorna<\/strong><\/td>\n<\/tr>\n
    Script di generaz. descrizione<\/strong><\/td>\nuno script che calcola il testo al posto di scriverlo<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    L’articolo<\/h3>\n

    La riga con il messaggio viene scritta nel corpo del documento usando un articolo di tipo descrittivo<\/strong>: quantit\u00e0 zero, prezzo zero, nessun movimento di magazzino.<\/p>\n

      \n
    • Lasciando il campo vuoto<\/strong> viene usato l’articolo per descrizioni generale<\/strong>, quello impostato nei dati fissi dell’azienda. Se non \u00e8 impostato nemmeno quello, al salvataggio del documento compare l’errore “Articolo per descrizioni non definito per inserimento messaggi automatici su documenti”<\/em> e la riga non viene creata.<\/li>\n
    • Indicando un articolo, deve essere di tipo descrittivo<\/strong>: il salvataggio del messaggio viene bloccato con “L’articolo indicato non \u00e8 di tipo descrittivo!”<\/em>.<\/li>\n<\/ul>\n

      Conviene indicare un articolo dedicato per ogni messaggio<\/strong> quando si vuole poterlo ritrovare, aggiornare o togliere dal documento in un secondo momento – ed \u00e8 obbligatorio farlo se si usa l’aggiornamento in variazione.<\/p>\n

      Comportamento in variazione<\/h3>\n

      Decide cosa succede quando si rimette mano a un documento gi\u00e0 salvato<\/strong>:<\/p>\n

        \n
      • Non aggiornare<\/strong> (impostazione base) – il messaggio viene inserito solo alla creazione<\/strong> del documento. Modificando il documento non succede nulla: la riga gi\u00e0 presente resta com’\u00e8, e se le condizioni sono cambiate non ne viene aggiunta una nuova.<\/li>\n
      • Inserisci \/ aggiorna<\/strong> – a ogni salvataggio Atlantis cerca nel corpo la riga con quel codice articolo: se la trova, ne riscrive il testo<\/strong>; se non c’\u00e8, la aggiunge<\/strong>. \u00c8 la scelta giusta per i messaggi calcolati da script, che devono restare allineati ai dati del documento.<\/li>\n<\/ul>\n

        Con Inserisci \/ aggiorna<\/em> l’articolo \u00e8 obbligatorio<\/strong>: senza, il salvataggio viene bloccato con “Se attivato aggiornamento in variazione \u00e8 necessario indicare un articolo”<\/em>. E quell’articolo deve comparire una sola volta<\/strong> nel documento: se ne trova due, l’aggiornamento si ferma segnalando “E’ presente pi\u00f9 di una riga descrittiva con il codice articolo: \u2026”<\/em>.<\/p>\n

        Lo script<\/h3>\n

        Indicando uno script, il testo base e le traduzioni vengono ignorati<\/strong>: il messaggio \u00e8 quello che lo script restituisce. Serve per i messaggi che dipendono dai dati del documento – il totale, le scadenze, il peso, un conteggio.<\/p>\n

        Il pulsante con la i<\/strong> accanto al campo mostra lo schema di partenza e le variabili disponibili:<\/p>\n\n\n\n\n\n\n\n\n\n
        Variabile<\/th>\nContenuto<\/th>\n<\/tr>\n<\/thead>\n
        _ditta<\/code><\/td>\ncodice azienda<\/td>\n<\/tr>\n
        _TIPO_DOC<\/code><\/td>\ntipo documento (FATT_OUT<\/code>, DDT_OUT<\/code>, \u2026)<\/td>\n<\/tr>\n
        _N_DOC<\/code><\/td>\nnumero documento<\/td>\n<\/tr>\n
        _SERIE_DOC<\/code><\/td>\nserie documento<\/td>\n<\/tr>\n
        _ESERCIZIO_DOC<\/code><\/td>\nesercizio documento<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

        Lo script deve restituire il testo<\/strong> del messaggio:<\/p>\n

        function process(){\r\n    return \"prova messaggio\";\r\n}\r\nprocess();<\/code><\/pre>\n
        Se lo script non viene trovato o va in errore, al salvataggio del documento compare la segnalazione e la riga non viene scritta.<\/p>\n
        \n
        5. Quando scatta<\/h2>\n
        Il messaggio viene valutato e inserito al salvataggio del documento<\/strong>, sia alla creazione sia – se configurato con Inserisci \/ aggiorna<\/em> – a ogni successiva modifica. Vale per i documenti compilati a mano e per quelli generati dalle procedure: generazione fatture da DDT, generazione documenti automatica, vendite da punto cassa.<\/p>\n
        La riga viene aggiunta in fondo al corpo<\/strong>. Se non ti trovi bene con quella posizione, dopo l’inserimento puoi spostarla come qualsiasi altra riga descrittiva.<\/p>\n
        \n
        6. Esempi<\/h2>\n
        Dicitura fissa su tutte le fatture<\/strong><\/p>\n\n\n\n\n\n\n\n\n
        <\/th>\n<\/th>\n<\/tr>\n<\/thead>\n
        Tipo documento<\/td>\nFattura di vendita<\/td>\n<\/tr>\n
        Tutti gli altri filtri<\/td>\nvuoti<\/td>\n<\/tr>\n
        Messaggio<\/td>\n“Merce resa franco nostro magazzino.”<\/td>\n<\/tr>\n
        Comportamento in variazione<\/td>\nNon aggiornare<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
        Nota per i clienti esteri, in lingua<\/strong><\/p>\n\n\n\n\n\n\n\n\n
        <\/th>\n<\/th>\n<\/tr>\n<\/thead>\n
        Tipo documento<\/td>\nFattura di vendita<\/td>\n<\/tr>\n
        Nazione<\/td>\nil codice della nazione<\/td>\n<\/tr>\n
        Messaggio<\/td>\ntesto in italiano<\/td>\n<\/tr>\n
        Messaggi in lingua<\/td>\nla traduzione per tutte le lingue<\/strong> usate su quei clienti<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
        Promozione a tempo<\/strong><\/p>\n\n\n\n\n\n\n\n
        <\/th>\n<\/th>\n<\/tr>\n<\/thead>\n
        Tipo documento<\/td>\nOrdine cliente<\/td>\n<\/tr>\n
        Data inizio \/ fine validit\u00e0<\/td>\nil periodo della promozione<\/td>\n<\/tr>\n
        Messaggio<\/td>\n“Promozione primavera: trasporto gratuito per ordini superiori a\u2026”<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
        Finito il periodo il messaggio smette da solo di comparire: non serve ricordarsi di disattivarlo.<\/p>\n
        Messaggio calcolato<\/strong><\/p>\n\n\n\n\n\n\n\n\n
        <\/th>\n<\/th>\n<\/tr>\n<\/thead>\n
        Tipo documento<\/td>\nFattura di vendita<\/td>\n<\/tr>\n
        Articolo<\/td>\nun articolo descrittivo dedicato, es. MSG_SCAD<\/code><\/td>\n<\/tr>\n
        Comportamento in variazione<\/td>\nInserisci \/ aggiorna<\/td>\n<\/tr>\n
        Script<\/td>\nrestituisce il testo con il riepilogo scadenze del documento<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
        \n
        7. Promemoria<\/h2>\n
          \n
        • Il tipo documento va sempre indicato<\/strong>: senza, il messaggio non si attiva mai.<\/li>\n
        • Prova sempre su un documento reale<\/strong> dopo aver creato un messaggio: \u00e8 il modo pi\u00f9 rapido per accorgersi di un filtro troppo largo o troppo stretto.<\/li>\n
        • Un messaggio che esce dove non deve: controlla se sul documento il campo su cui hai filtrato \u00e8 vuoto<\/strong> (vedi \u00a7 2).<\/li>\n
        • Un messaggio che non esce mai su documenti esteri: controlla le traduzioni mancanti<\/strong> (vedi \u00a7 3).<\/li>\n
        • Le righe gi\u00e0 scritte nei documenti restano come sono<\/strong>: modificando o cancellando un messaggio cambiano solo i documenti successivi. I documenti gi\u00e0 emessi non vanno ritoccati da soli – ed \u00e8 giusto cos\u00ec, visto che possono essere gi\u00e0 stati stampati o inviati.<\/li>\n
        • Se il messaggio deve poter essere aggiornato o ritrovato, dagli un articolo descrittivo dedicato<\/strong>: \u00e8 l’unico aggancio che Atlantis ha per riconoscere la riga.<\/li>\n<\/ul>\n","protected":false},"author":1,"featured_media":0,"parent":1169,"menu_order":1,"template":"","manualdocumentationcategory":[55],"manual_doc_tag":[],"_links":{"self":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/6169"}],"collection":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation"}],"about":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/types\/manual_documentation"}],"author":[{"embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":2,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/6169\/revisions"}],"predecessor-version":[{"id":6172,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/6169\/revisions\/6172"}],"up":[{"embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_documentation\/1169"}],"wp:attachment":[{"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/media?parent=6169"}],"wp:term":[{"taxonomy":"manualdocumentationcategory","embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manualdocumentationcategory?post=6169"},{"taxonomy":"manual_doc_tag","embeddable":true,"href":"https:\/\/www.atlantisevo.com\/doc\/wp-json\/wp\/v2\/manual_doc_tag?post=6169"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}