Sale Product Document Default
Include automaticamente nel PDF del preventivo i documenti di prodotto marcati come predefiniti.
Il problema
Il modulo standard Sales PDF Quotation Builder sa unire un documento di prodotto al PDF del preventivo quando il documento e' configurato con Vendite : visibile in = Nel PDF del preventivo. Il documento resta pero' solo un candidato: qualcuno deve aprire la scheda Quote Builder del preventivo e spuntarlo, riga per riga. Nulla viene selezionato automaticamente, quindi un documento che dovrebbe accompagnare sempre il suo prodotto resta silenziosamente fuori dal PDF ogni volta che il venditore dimentica quel passaggio, ed e' sempre fuori quando il preventivo viene creato via codice: servizi web, agenti AI, eCommerce o modelli di preventivo.
Intestazioni e pie' di pagina che arrivano dal modello di preventivo non sono interessati: il modulo standard li propaga gia'.
La soluzione
Un flag Aggiungi in modo predefinito sul documento di prodotto, con la stessa semantica del flag gia' disponibile su intestazioni e pie' di pagina dei preventivi. I documenti che portano il flag vengono selezionati automaticamente su ogni riga d'ordine che usa quel prodotto, sia nell'interfaccia sia alla creazione del record, quindi l'automatismo copre anche servizi web, strumenti per agenti AI, eCommerce, righe generate da un modello di preventivo e ordini duplicati. La composizione del PDF resta invariata: il modulo standard continua a unire i documenti tra le pagine di intestazione e la tabella del preventivo.
Comportamento
| Dove | Cosa accade |
|---|---|
| Prodotto, scheda Documenti, form del documento | Nuova casella Aggiungi in modo predefinito, visibile quando Vendite : visibile in vale Nel PDF del preventivo |
| Riga di preventivo, prodotto scelto dall'interfaccia | I documenti marcati del prodotto o della variante risultano spuntati nella scheda Quote Builder |
| Riga di preventivo creata via codice | Stessa selezione, senza alcuna interazione con l'interfaccia |
| Prodotto cambiato su una riga esistente | I documenti del prodotto precedente vengono rimossi, quelli marcati del nuovo prodotto vengono aggiunti |
| Selezione manuale gia' effettuata | Viene conservata, la selezione automatica e' additiva e mai distruttiva |
| Documento non impostato su Nel PDF del preventivo | Mai selezionato, il flag non ha effetto |
Campi
| Modello | Campo | Tipo | Descrizione |
|---|---|---|---|
| product.document | add_by_default | Booleano | Aggiunge questo documento in modo predefinito alle righe di preventivo che usano questo prodotto. Riservato al gruppo utenti vendite, come il campo standard di visibilita' commerciale. |
Note tecniche
- Un solo punto d'ingresso — la logica di selezione vive in un unico metodo sulla riga d'ordine, riusato dall'onchange del prodotto e dagli override di create e write.
- Disattivazione — passa skip_default_product_documents nel contesto per disattivare la selezione automatica in una chiamata specifica.
- Duplicazione — duplicando una riga d'ordine i documenti marcati vengono riapplicati, quindi una rimozione manuale non sopravvive alla duplicazione.
- Testato — 8 test automatici coprono il percorso da interfaccia, la creazione dei record, il cambio di prodotto e il contesto di disattivazione.
Requisiti
Odoo 19. Dipende dall'applicazione standard Sales PDF Quotation Builder, installata automaticamente con Vendite. Disponibile in inglese e italiano.
Changelog
| Versione | Note |
|---|---|
| 19.0.1.0.0 | Aggiunge il flag Aggiungi in modo predefinito sui documenti di prodotto e la selezione automatica dei documenti marcati sulle righe di preventivo, nell'interfaccia e alla creazione del record. |
Sviluppato da STeSI Consulting — Francesco Moccia <moccia.f@stesi.consulting>