Made In Show

Classifica il materiale per ROI di finestra: ricavo generato dalle prenotazioni confermate nella finestra diviso il costo medio d’acquisto del prodotto. Default: ultimi 12 mesi. Copre SOLO il materiale mosso nella finestra (un prodotto mai prenotato non compare: assenza dal ranking ≠ ROI zero); i prodotti mossi ma senza costo d’acquisto tracciato sono esclusi dalla divisione e conteggiati in totals.excluded_no_cost — dichiararli sempre. Richiede il permesso sui dati economici.

mis_get_product_roi_ranking

Senza tecnico: catalogo delle competenze con le loro aree e i role_id da usare in mis_find_available_technicians (un’area vale per tutte le sue competenze). Con technician_id oppure technician (nome: cerca fra gli attivi; l’id anche fra gli inattivi): le competenze del tecnico per tipo di tariffa, con stato attiva (nel listino di oggi), cessata (eliminata, «non più competente») o futura, la data da cui vale (since) e il prossimo cambio (next_validity). role filtra per nome di competenza o area; include_history aggiunge lo storico delle righe di listino. Gli importi compaiono solo col permesso sui dati economici e la loro omissione è dichiarata. Lo stato segue il gestionale (ultima riga inserita) e può differire dal badge della scheda su righe retrodatate. La tariffa per prenotare la sceglie mis_reserve_technician.

mis_get_technician_roles

Richieste di disponibilità (composizione squadra) di una produzione o di un raccoglitore, con lo stato delle risposte dei tecnici: in attesa, disponibile, non disponibile, accettato, rifiutato. Specifica esattamente uno fra production_id, prod_binder_id e tcs_id; con production_id include anche le composizioni del suo raccoglitore. limit è il tetto sul numero totale di inviti restituiti. Sola lettura: non invia inviti né conferme. «Accettato» non è una prenotazione: i giorni si prenotano con mis_reserve_technician.

mis_get_team_composition

Ritorna i conflitti di sottoscorta del materiale.

mis_check_material_conflicts

Ritorna i tecnici in doppio turno per giorno civile.

mis_check_technician_conflicts

Aggrega materiale prenotato, extra, forniture esterne/preventivi esterni, copertura dei piani di carico e red flag deterministici di una produzione. L’analisi di merito resta al modello. Richiede l’identificativo numerico della produzione; quando il riferimento iniziale è un nome, l’identificazione avviene prima con mis_search_productions e un risultato ambiguo richiede l’elenco dei candidati senza selezione automatica.

mis_check_production_completeness

Aggrega materiale prenotato, extra, forniture esterne/preventivi esterni, copertura dei piani di carico e red flag deterministici delle produzioni incluse in un raccoglitore. L’analisi di merito resta al modello. Richiede l’identificativo numerico del raccoglitore; quando il riferimento iniziale è un nome, l’identificazione avviene prima con mis_search_productions, che espone prod_binder_id e binder_name di ogni produzione del raccoglitore, e un risultato ambiguo richiede l’elenco dei candidati senza selezione automatica.

mis_check_binder_completeness

Corregge una nota della location della produzione (note_id o match), che vale per ogni produzione nella location; i campi omessi restano. Serve il permesso, anche per le proprie. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_update_location_note

Corregge una nota della produzione (note_id o match); i campi omessi restano. Note altrui solo col permesso. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_update_production_note

Corsi e patentini dei tecnici con data di scadenza e stato (scaduto, in scadenza entro 60 giorni, valido, senza scadenza) valutato alla data odierna in Europe/Rome o ad at_date (per esempio l’inizio di una produzione). Filtri combinabili: un tecnico (technician_id oppure technician_name, mai entrambi), un corso per nome anche parziale (course_name: risponde a «chi ha il corso X?» e dice se il corso esiste a catalogo, anche disattivato), solo i corsi che scadono entro expiring_within_days (gli scaduti sono inclusi). technician_name cerca tra i tecnici attivi; per un tecnico disattivato usare technician_id. Senza filtri: quadro completo dei corsi registrati. Include i tecnici con monitoraggio scadenze spento (dichiarato in perimeter). Non copre gli allegati dei corsi né le competenze (ruoli): per quelle usare gli altri tool. Valuta la scadenza della registrazione ATTUALE: non ricostruisce i titoli posseduti in passato né la data di conseguimento. Non risponde da solo a “chi NON ha il corso”: confrontare con l’elenco tecnici.

mis_get_technician_courses

Risolve cliente, stato, date, supervisore, magazzino e location e, con confirm=false, restituisce soltanto il riepilogo senza scrivere, insieme a un confirmation_token. Con confirm=true e il confirmation_token dell’ultimo riepilogo (stessi parametri, stessa sessione) crea la produzione; una confirm=true senza token valido non scrive nulla e restituisce di nuovo il riepilogo con un nuovo token. event_start/event_end ereditano work_start/work_end; location_id è obbligatorio: la location deve già esistere (mis_add_location la crea) e viene denormalizzata sulla produzione, che senza location non può essere salvata. Magazzino preferito: quello predefinito (altrimenti il primo), oppure warehouse (id o nome). Senza prod_binder_id il backend apre un raccoglitore nuovo col nome della produzione; con prod_binder_id (lo espone mis_search_productions per ogni produzione) la nuova produzione entra in quel raccoglitore esistente. Le condizioni economiche non si indicano da qui: il backend applica quelle del cliente in rubrica (altrimenti zero). Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_create_production

Ritorna il dettaglio di una singola fattura, attiva o passiva: testata, righe, scadenze e nota interna

mis_get_invoice

Ritorna i dati generali di una produzione

mis_get_production_general_data

Scheda prodotto completa. include ['composition'] aggiunge i contenitori di un composto con i pezzi dentro (matricola, stato, magazzino; al massimo 5 contenitori, poi comp_container_id; senza costi d’acquisto né fornitore) oppure i componenti di un virtuale con le quantità; include ['history'] aggiunge le ultime versioni storicizzate (stock per magazzino e composizione). Per i composti peso e dimensioni sono la somma dei contenuti. Gli importi compaiono solo con il permesso sui dati economici e la loro omissione è dichiarata, separatamente per scheda e storico. Con un nome usa prima mis_search_product_sheets.

mis_get_product_sheet

Ritorna la giacenza aggregata per stato (status_id, status_desc, quantity) di una scheda prodotto in un magazzino; con production_id la giacenza è storicizzata alla data di inizio lavori. Per il dettaglio dei singoli pezzi (matricola, magazzino, data d’acquisto) usare mis_get_stats con stat: 'warehouse_products' e product_id. NON sottrae le prenotazioni: la disponibilità reale la verifica il pre-check di mis_reserve_product.

mis_get_product_availability

Elimina definitivamente una nota della location della produzione (note_id o match), che vale per ogni produzione nella location. Serve il permesso, anche per le proprie. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_del_location_note

Elimina definitivamente una nota della produzione (note_id o match). Note altrui solo col permesso. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_del_production_note

Invia e-mail e push reali ai tecnici invitati di una richiesta di disponibilità esistente, con anteprima di tutti i destinatari e conferma separata; l'amministratore può tenerlo spento. Una nuova anteprima dell'altro tool invalida la precedente: ordine richiesta → conferma → invio → conferma. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_send_team_availability_request

Restituisce i dati generali e l’albero dei prodotti del preventivo di una produzione. Accetta solo production_id: il ramo raccoglitore non è esposto.

mis_get_estimate

Ritorna l'elenco dei clienti attivi dalla rubrica (aziende e persone fisiche).

mis_list_customers

Ritorna l'elenco dei fornitori attivi dalla rubrica, SOLO aziende: i fornitori persona fisica non compaiono. Per un elenco completo usare mis_search_contacts, che marca is_supplier su ogni scheda.

mis_list_suppliers

Ritorna l'elenco dei magazzini configurati in MIS

mis_list_warehouses

Note di una produzione e della sua location, con categoria, visibilità, autore, data e note_id. Le note di location sono un elenco separato, con id di un’altra tabella: non scambiarli. scope solo_pubbliche = il profilo vede solo le note pubbliche. Richiede production_id numerico: con un nome usare prima mis_search_productions.

mis_get_production_notes

Imposta in ordine da 1 a 50 prenotazioni, con esito separato per riga e senza transazione. Le quantità usano il tipo “Altri utilizzi” e sostituiscono ogni prenotazione esistente del prodotto, non si sommano. I nomi prodotto ambigui non vengono scelti automaticamente; disponibilità e magazzino vengono verificati prima di ogni scrittura. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_batch_reserve_products

Imposta la quantità prenotata per tipo e magazzino: sostituisce il valore esistente, non lo incrementa. Prima di scrivere verifica la disponibilità reale nel periodo di lavoro (al netto delle prenotazioni confermate di altre produzioni sovrapposte); le prenotazioni non confermate generano solo un avviso. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_reserve_product

Prenota o toglie un tecnico su una produzione per giorni specifici, con una tariffa del suo listino valida all'inizio lavori. Anteprima obbligatoria: il salvataggio sostituisce tutta la presenza del tecnico sulla produzione, incluse le righe fuori dalla forbice mostrate fra le rimozioni. Non invia notifiche né richieste di disponibilità (quelle sono la composizione squadra). Con un nome ambiguo o più tariffe compatibili elenca i candidati senza scegliere: richiama con technician_id o tech_role_id. hours vale solo per le tariffe orarie [/h], technicians_num solo per i tecnici generici (ditte). Blocca tecnici inattivi e giorni fuori lavorazione; i conflitti confermati e le indisponibilità richiedono accept_conflicts. Importi, alloggio e pasti esistenti sono preservati senza esporli. Richiede production_id numerico: con un nome usare prima mis_search_productions. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_reserve_technician

Aggiunge o rimuove giorni di presenza di un veicolo in produzione. Anteprima obbligatoria: il salvataggio sostituisce tutta la presenza, incluse le righe fuori dalla forbice mostrate fra le rimozioni. Blocca veicoli inattivi e giorni fuori lavorazione; i conflitti confermati e le indisponibilità richiedono accept_conflicts. Gli importi esistenti sono preservati senza esporli. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_reserve_company_vehicle

Cambia tipologia (type, etichetta come Evento, oppure date_type_id), orario di convocazione (call_time HH:MM, ora locale; null lo svuota) e nota (null o vuota la svuota) di giorni già presenti nella lavorazione; mai la forbice né le date. Ogni voce di days ha date oppure date_start e date_end inclusivi; i campi omessi restano come sono. L'anteprima dichiara il materiale che diventa occupato per le altre produzioni (poi mis_check_material_conflicts) e le date evento; il gestionale riallinea poi il planner e cancella le righe fuori forbice, effetto non verificabile da qui. La lettura dei giorni può completare o togliere righe di calendario e riallineare il planner. Serve il permesso, oppure essere creatore o responsabile della produzione. Richiede production_id numerico: con un nome usare prima mis_search_productions. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_update_production_days

Quadro economico di una produzione, come la scheda Dettagli economici del gestionale: quotazione al cliente (final_price null = produzione non da fatturare, 0 = da fatturare con quotazione a zero), sezioni per area con nominale, ricarico e commissione d'agenzia, business unit e produzioni collegate (linked_targets, linked_sources). totals riporta prezzo calcolato, ricarico/sconto e margine operativo, già comprensivi della quota delle collegate (linked_contribution): i totali sono quelli della scheda Dettagli economici: riportali, non ricalcolarli e non sommare da te ricarichi o commissioni; con final_price null il margine della scheda conta zero ricavi. Solo con il permesso sui dati economici, verificato a ogni chiamata: senza, la sezione è non_consentito e l'omissione è dichiarata. Richiede production_id numerico: con un nome usare prima mis_search_productions. Sola lettura: non modifica nulla.

mis_get_production_economics

Quadro di una produzione in una sola lettura: testata con stato e date di lavorazione ed evento, tag, squadra tecnici (chi, ruolo, giorni), veicoli aziendali (quali, giorni, km), materiale di consumo prenotato e fatture collegate. Ogni sezione ha un esito separato: ok, vuoto, non_consentito o errore. Gli importi compaiono solo con il permesso sui dati economici e la loro omissione è dichiarata. Non contiene margini né quotazione: per quelli usare mis_get_production_economics; il preventivo è in mis_get_estimate. mis_get_production_general_data fornisce soltanto dati generali (id, nome, date, luogo); mis_check_production_completeness segnala red flag su materiale e piani di carico. Richiede production_id numerico: con un nome usare prima mis_search_productions; un risultato ambiguo richiede i candidati senza selezione automatica. Sola lettura: non modifica nulla. Tipologia, orario di convocazione e note dei singoli giorni non sono inclusi.

mis_get_production_overview

Filtra le fatture nel modulo Company Management. active è obbligatorio: true = ciclo attivo (emesse), false = ciclo passivo (ricevute). supplier_name filtra l’emittente; sul ciclo attivo il cliente si filtra con customer_pd_id (da mis_search_contacts).

mis_get_invoices

Ricerca materiale con disponibilità nel periodo; i prodotti senza disponibilità o prenotazioni nel periodo non compaiono.

mis_search_available_products

Ricerca produzioni o eventi nel dominio Production

mis_search_productions

Esegue una ricerca testuale nella rubrica MIS

mis_search_contacts

Filtra le scadenze amministrative nel modulo Company Management. Richiede ALMENO un filtro: il backend rifiuta la ricerca senza criteri (usare ad es. from_date/to_date per un periodo). Senza active il filtro per nome viene cercato su entrambi i lati del ciclo; per restringere a incassi o pagamenti passare active (true = incassi, false = pagamenti).

mis_get_schedules

Cerca schede prodotto a magazzino. query: testo su marca, modello e descrizione (massimo 50 risultati dal backend). category: nome o category_id di una categoria o sottocategoria (una principale include le sue sottocategorie; nome ambiguo → candidati), con query facoltativa come filtro. list_categories: true restituisce l’albero delle categorie, i cui category_id valgono anche per mis_search_available_products (il conteggio delle schede può mancare per permessi). qty conta i pezzi Disponibili o In vendita fuori dai composti e NON è al netto delle prenotazioni: per un periodo usa mis_check_product_availability o mis_search_available_products.

mis_search_product_sheets

Invita tecnici a una richiesta di disponibilità, nuova (production_id e num_required) o esistente (tcs_id), senza contattarli: e-mail e push solo con mis_send_team_availability_request. Una nuova anteprima dell'altro tool invalida la precedente: ordine richiesta → conferma → invio → conferma. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_request_team_availability

Ritorna il riepilogo amministrativo per anno corrente e anno di confronto

mis_get_company_summary

Rimuove i giorni di indisponibilità esistenti di un tecnico. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_del_technician_unavailability

Rimuove i giorni di indisponibilità esistenti di un veicolo. Non eseguire subito: mostra il riepilogo all'utente e fermati in attesa della sua risposta. Solo quando l'utente, in un messaggio successivo, dà il suo OK esplicito, richiama con confirm:true e questo confirmation_token. Non confermare mai al posto dell'utente: la richiesta iniziale non vale come conferma.

mis_del_vehicle_unavailability