EOS Docs – EX096 EOS FOOD Deliveries (EFW)

Docs: Setup

Mon, 01 Jan 0001 00:00:00 +0000

Setup

La pagina Setup Conferimenti è il punto di configurazione centrale per il modulo EOS FOOD Deliveries. È un’unica pagina di setup che raccoglie tutte le opzioni del modulo.

Sezioni di Configurazione

1. Numerazioni

Configurare le numerazioni utilizzate per la numerazione automatica dei documenti:

Campo	Scopo
Nr. Mappature Terreni	Specifica la serie numerica utilizzata per assegnare identificativi univoci ai record di mappatura terreni.
Nr. Disciplinari	Specifica la serie numerica utilizzata per assegnare identificativi univoci ai record disciplinari.
Nr. Ricezione Conferimenti	Specifica la serie numerica utilizzata per assegnare identificativi univoci ai documenti di ricezione conferimenti.
Nr. Ric. Conf. Registrate	Specifica la serie numerica utilizzata per assegnare identificativi univoci ai documenti di ricezione conferimenti registrati.

2. Causali

Configurare le causali predefinite utilizzate nella creazione degli ordini di conferimento:

Campo	Scopo
Cod. Causale Conferimenti	Specifica la causale predefinita applicata alle transazioni di ricezione conferimenti durante la registrazione.
Cod. Causale Conf. Prod. Propria	Specifica la causale predefinita applicata durante la registrazione delle ricezioni conferimenti per articoli di produzione propria.

3. Elaborazione

Configurare il comportamento di creazione dei documenti:

Campo	Scopo
Tipo Documento Conferimenti	Specifica il tipo di documento di acquisto predefinito (Ordine o Ordine Aperto) creato durante la generazione degli ordini di conferimento dalle mappature terreni.
Raggr. Righe Doc. Conferimento	Specifica come vengono raggruppate le righe del documento di acquisto durante la creazione degli ordini di conferimento dalle mappature terreni.
Nr. Fornitore Aziendale	Specifica il numero fornitore che rappresenta l’azienda stessa, utilizzato per i conferimenti di produzione propria.

4. Ricezioni di Conferimento

Campo	Scopo
Abilita Gestione Stato Ricezioni Conf.	Specifica se il flusso di lavoro di gestione stati è abilitato per le ricezioni di conferimento, consentendo le transizioni di stato prima della registrazione.

Checklist di Configurazione

Prima di utilizzare il modulo, assicurarsi che i seguenti elementi siano configurati:

Tutte e quattro le numerazioni sono assegnate
La Causale Conferimenti è impostata
La Causale Conferimenti Prod. Propria è impostata (se si utilizza la produzione propria)
Il Nr. Fornitore Aziendale è impostato (se si utilizzano conferimenti di produzione propria)
Il Tipo Documento Conferimenti è selezionato (Ordine o Ordine Aperto)
Il metodo di Raggruppamento Righe è selezionato
La Gestione Stati è attivata/disattivata secondo le esigenze aziendali

Disciplinari

I Disciplinari definiscono le specifiche di produzione agricola che possono essere associate alle mappature terreni.

Campo	Descrizione
Codice	Specifica l’identificativo univoco del record disciplinare.
Nome Disciplinare	Specifica il nome descrittivo del disciplinare di produzione, come metodi di coltivazione biologica o convenzionale.
Limite Resa	Specifica il limite massimo di resa consentito per questo disciplinare. Utilizzato per controllare le soglie di produzione per mappatura terreno.
Note	Specifica eventuali note o osservazioni aggiuntive sul record disciplinare.

I Disciplinari supportano documenti allegati tramite la factbox standard di BC.

Aree mappatura terreni

Lookup semplice codice/descrizione per la classificazione delle aree geografiche.

Campo	Descrizione
Codice	Specifica il codice univoco che identifica l’area di mappatura terreni.
Descrizione	Specifica una descrizione dell’area di mappatura terreni, come una regione geografica o un nome di zona.

Pese

Registro delle pese utilizzate.

Campo	Descrizione
Nr.	Specifica l’identificativo univoco della pesa.
Nome	Specifica il nome descrittivo o l’etichetta della pesa.

Operatori pese

Registro degli operatori che effettuano le operazioni di pesatura.

Campo	Descrizione
Nr.	Specifica l’identificativo univoco dell’operatore pesa.
Nome	Specifica il nome completo dell’operatore pesa responsabile dell’esecuzione delle misurazioni di peso.

Docs: Mappature terreni

Mon, 01 Jan 0001 00:00:00 +0000

Mappature terreni

Panoramica

Le Mappature Terreni rappresentano i dati catastali e agricoli dei terreni di proprietà dei fornitori. Ogni record di mappatura terreni associa un fornitore a una specifica particella di terreno, la sua area coltivabile, la coltura (articolo) coltivata e la percentuale di resa prevista. Questi dati sono la base per il calcolo delle quantità degli ordini di conferimento.

Campi

Sezione Generale

Campo	Tipo	Descrizione
ID Terreno	Codice	Specifica l’identificativo univoco del record di mappatura terreno. Assegnato automaticamente dalla serie numerica.
Nr. Fornitore	Codice[20]	Specifica il fornitore (coltivatore o produttore) che possiede o gestisce questo terreno.
Anno Rif.	Intero	Specifica l’anno di riferimento per questa mappatura terreno. Le mappature terreni sono gestite annualmente e possono essere copiate da un anno all’altro.
Provincia	Testo	Specifica la provincia in cui si trova il terreno.
Comune	Testo	Specifica la città o il comune in cui si trova il terreno.

Dati Catastali

Campo	Tipo	Descrizione
Foglio	Testo	Specifica il numero di foglio catastale del registro terreni in cui questa particella è registrata.
Particella	Testo	Specifica il numero di particella catastale che identifica questo specifico appezzamento all’interno del foglio.
Sesto	Testo	Specifica il sesto d’impianto o l’identificativo di suddivisione all’interno della particella.
Anno Impianto	Intero	Specifica l’anno in cui le colture o le piante sono state originariamente piantate su questo terreno.
Area Coltivabile (mq)	Decimale	Specifica la superficie coltivabile totale del terreno, misurata in metri quadrati.

Sezione Articolo

Campo	Tipo	Descrizione
Nr. Articolo	Codice[20]	Specifica l’articolo (prodotto) coltivato o raccolto da questo terreno.
Descrizione	Testo	Specifica la descrizione dell’articolo coltivato su questo terreno.
Descrizione 2	Testo	Specifica una descrizione aggiuntiva per l’articolo coltivato su questo terreno.
Resa %	Decimale	Specifica la percentuale di resa prevista per questo terreno, rappresentando il rapporto tra prodotto utilizzabile e raccolto totale.

Varie

Campo	Tipo	Descrizione
Cod. Area	Codice	Specifica il codice area geografica che raggruppa questa mappatura terreno per la reportistica e la creazione degli ordini di conferimento.
Note	Testo	Specifica eventuali note o osservazioni aggiuntive su questo record di mappatura terreno.
Cod. Disciplinare	Codice	Specifica il disciplinare di produzione assegnato a questo terreno, definendo le regole di coltivazione e i limiti di resa applicabili.

Funzioni

La pagina lista Mappature Terreni fornisce tre azioni report principali:

Stampa Mappature Terreni

Genera un report stampabile delle mappature terreni raggruppate per fornitore. Richiede un parametro Anno di Riferimento. Visualizza dati catastali, aree coltivabili, percentuali di resa e descrizioni articoli.

Copia Mappature Terreni

Copia i record di mappatura terreni da un anno di riferimento a un altro. Utilizzare questa funzione all’inizio di ogni stagione di raccolta per portare avanti le configurazioni dei terreni.

Parametri:

Da Anno: Anno di riferimento sorgente
A Anno: Anno di riferimento destinazione

Comportamento:

Se esistono già mappature per l’anno destinazione, il sistema chiede se cancellarle prima
I nuovi record vengono creati con nuovi Land ID (generati automaticamente)
Il filtro fornitore dalla pagina lista viene applicato

Crea Ordini Conferimento

Crea ordini di acquisto (o ordini aperti) dalle mappature terreni. Questa è l’azione principale del flusso di lavoro. Vedere 03-OrdiniConsegna.md per i dettagli.

Compilazione Automatica

Quando si crea una nuova mappatura terreni da una vista filtrata per fornitore (es. aperta dalla Scheda Fornitore), il Nr. Fornitore viene compilato automaticamente dal filtro.

Allegati Documenti

I record di Mappatura Terreni supportano gli allegati documenti standard di Business Central tramite il pannello factbox. Gli allegati sono collegati allo specifico record di mappatura terreno.

Calcolo della Resa

Il campo Yield %, combinato con Cultivable Area (mq), determina la quantità di prodotto prevista da questo terreno:

Quantità Conferibile = (Area Coltivabile × Resa %) / 100

Questa formula viene utilizzata dalla funzione Crea Ordini Conferimento per calcolare le quantità delle righe di acquisto.

Docs: Ordini di conferimento

Mon, 01 Jan 0001 00:00:00 +0000

Ordini di conferimento

Panoramica

La funzione Crea Ordini Conferimento è il ponte tra i dati di mappatura terreni e il flusso standard di acquisto di Business Central. Legge i record di mappatura terreni e genera automaticamente ordini di acquisto (o ordini aperti di acquisto) con quantità calcolate in base all’area coltivabile e alle percentuali di resa.

Crea Ordini Conferimento

La funzione viene eseguita in modo interattivo dalla lista Mappature Terreni e non produce alcuna stampa — crea direttamente i documenti di acquisto.

Parametri Pagina Richiesta

Parametro	Descrizione
Document Type	Ordine o Ordine Aperto. Predefinito dal Setup Conferimenti.
Ref. Year	Anno di riferimento/raccolta da elaborare. Obbligatorio.
Group By	Articolo/Area o Articolo/Area/Terreno. Predefinito dal Setup Conferimenti.

Filtro Fornitore

La funzione eredita il filtro fornitore dalla pagina lista Mappature Terreni. È possibile filtrare per creare ordini solo per fornitori specifici.

Logica di Elaborazione

1. Validazione Pre-Elaborazione

Prima dell’esecuzione, la funzione:

Verifica che un Anno di Riferimento sia specificato
Controlla se esistono già ordini di conferimento per l’anno/fornitori selezionati
Se esistono ordini, chiede conferma prima di procedere

2. Flusso di Creazione Documenti

La funzione elabora le mappature terreni ordinate per Anno Rif. → Nr. Fornitore → Nr. Articolo:

Per ogni Fornitore (nuova Testata Ordine Acquisto):
│
├── Imposta Tipo Ordine Conferimento:
│ ├── "Conferimento Produzione Propria" se Fornitore = Nr. Fornitore Aziendale
│ └── "Conferimento" per tutti gli altri fornitori
│
├── Imposta Causale (dal Setup)
├── Imposta Anno Rif.
│
└── Per ogni Mappatura Terreni:
│
├── Calcola quantità:
│ Qtà = (Area Coltivabile × Resa %) / 100
│ (arrotondata secondo le impostazioni di quantità dell'articolo)
│
└── Crea/Aggiorna Riga Acquisto:
├── Raggruppamento Articolo/Area: accumula qtà sulla stessa riga
└── Raggruppamento Articolo/Area/Terreno: nuova riga per terreno

3. Modalità di Raggruppamento Righe

Raggruppamento Articolo/Area

Più mappature terreni con lo stesso Nr. Articolo e Codice Area vengono combinate in un’unica riga di acquisto. La quantità è la somma di tutte le singole quantità calcolate.

Esempio: 3 mappature terreni per lo stesso fornitore, stesso articolo “Uva”, stessa area “NORD”:

Terreno A: 1000 mq × 80% = 800 kg
Terreno B: 500 mq × 75% = 375 kg
Terreno C: 750 mq × 85% = 637,5 kg
→ Una riga di acquisto: 1.812,5 kg

Raggruppamento Articolo/Area/Terreno

Ogni mappatura terreni genera la propria riga di acquisto. Il Land ID viene memorizzato sulla riga di acquisto per la tracciabilità.

Esempio: Stesse 3 mappature → Tre righe di acquisto con quantità individuali e Land ID.

4. Campi Riga Acquisto

Ogni riga di acquisto creata include:

Campo	Valore
Tipo	Articolo
Nr.	Nr. Articolo dalla mappatura terreni
Quantità	Quantità conferibile calcolata
Codice Area	Codice Area dalla mappatura terreni
Land ID	Land ID (solo in modalità Articolo/Area/Terreno)

5. Post-Elaborazione

Dopo la creazione di tutti i documenti:

Un messaggio riepilogativo mostra il numero di documenti creati
Viene chiesto all’utente se aprire i documenti creati
Se confermato, il sistema apre la lista Ordini di Acquisto o Ordini Programmati, filtrata sui documenti creati

Assegnazione Tipo Ordine Conferimento

La funzione determina automaticamente il Tipo Ordine Conferimento in base al fornitore:

Condizione	Tipo Ordine	Causale
Nr. Fornitore = Nr. Fornitore Aziendale (dal Setup)	Conferimento Produzione Propria	Causale Conferimento Prod. Propria
Qualsiasi altro fornitore	Conferimento	Causale Conferimento

Docs: Ricezioni conferimenti

Mon, 01 Jan 0001 00:00:00 +0000

Ricezioni conferimenti

Panoramica

Le Ricezioni di Conferimento sono i documenti operativi principali nel modulo EOS FOOD Deliveries. Rappresentano l’arrivo fisico delle merci alla stazione di pesatura, catturando i dati di peso, tracciabilità lotto, dettagli di spedizione e collegando la ricezione a una specifica riga di ordine di acquisto per la registrazione.

Ciclo di Vita della Ricezione

Gestione Stati (Opzionale)

Quando Enable Deliv. Rcpt. Status Mgt è attivato nel Setup:

┌──────────┐ ┌────────────┐ ┌──────────┐
│ Nuovo │───▶│ Accettato │───▶│ Pesato │
└──────────┘ └────────────┘ └──────────┘
│ │
└──────────────────────────────────┘
(salto diretto consentito)

Nuovo: Stato iniziale dopo la creazione
Accettato: Conferimento accettata al cancello (ispezione superata)
Pesato: Pesatura completata — pronto per la registrazione

Quando la gestione stati è disabilitata, le ricezioni possono essere registrate indipendentemente dallo stato.

Azioni sulla Ricezione

Rileva Peso Lordo / Rileva Tara

Legge il peso lordo e la tara direttamente dalla pesa collegata e compila i campi corrispondenti sulla ricezione.

Collega a Ordine

Collega manualmente la ricezione a una riga di ordine di acquisto idonea. Il sistema cerca righe di acquisto corrispondenti a:

Tipo Documento = Ordine
Stesso fornitore
Tipo Ordine Conferimento ≠ vuoto
Anno Rif. ≠ 0
Tipo = Articolo
Stesso articolo e variante
Quantità Residua > 0

Se la ricezione è già collegata, il sistema chiede conferma prima di ricollegare.

Scollega da Ordine

Rimuove il collegamento tra la ricezione e la sua riga di ordine di acquisto, cancellando Nr. Ordine e Nr. Riga Ordine.

Cambia Stato

Transizioni dello stato della ricezione. Le transizioni disponibili dipendono dallo stato attuale:

Da Nuovo: Può cambiare ad Accettato o Pesato
Da Accettato: Può cambiare a Pesato

Richiede conferma prima di cambiare.

Registra (F9)

Registra la ricezione di conferimento, creando un carico di acquisto e chiudendo la ricezione di conferimento. Vedere Processo di Registrazione di seguito.

Creazione Ricezioni di Conferimento

Le ricezioni possono essere create in tre modi:

1. Dalla Sottoform Ordine di Acquisto

Sulla Sottoform Ordine di Acquisto, azioni a livello riga:

Crea Ricezione Conferimento: Apre una request page permettendo di specificare:
- Numero di Ricezioni da Creare: Quante ricezioni creare per la riga (default 1, utile per conferimenti multipli sulla stessa riga ordine)
- Data Registrazione: La data di registrazione da impostare sulle ricezioni create
Il sistema verifica che l’ordine di acquisto sia un ordine di conferimento e che la riga sia di tipo Articolo. Dopo la creazione, offre di aprire la scheda ricezione (singola) o la lista ricezioni (multiple).
Collega a Ricezione Conferimento: Mostra le ricezioni esistenti non collegate corrispondenti ai criteri della riga per la selezione

2. Dalla Lista Ricezioni di Conferimento

Creare un nuovo record direttamente nella pagina lista o scheda. La ricezione deve poi essere collegata manualmente a un ordine di acquisto utilizzando l’azione “Collega a Ordine”.

Processo di Registrazione

Quando una ricezione di conferimento viene registrata (dalla scheda ricezione o dall’ordine di acquisto):

Validazione Pre-Registrazione

Il sistema valida:

Controllo	Errore se
Data Registrazione	Non impostata
Nr. Fornitore	Non impostato
Nr. Articolo	Non impostato
Nr. Lotto	Non impostato e l’articolo richiede tracciabilità lotto
Peso Lordo	Zero o negativo
Tara	Zero o negativa
Peso Netto	Zero o negativo
Qtà da Ricevere	Zero o negativa
Stato	Non “Pesato” (se gestione stati abilitata)
Consistenza	Fornitore/Articolo/Variante/Ubicazione non corrispondono alla riga acquisto

Passi della Registrazione

Quando una ricezione viene registrata, il sistema:

Imposta la quantità da ricevere sulla riga dell’ordine di acquisto collegata in base alla ricezione
Applica il numero di lotto per la tracciabilità
Aggiorna l’ordine di acquisto con la data di registrazione e il riferimento di spedizione
Riceve la merce tramite la registrazione di acquisto standard di Business Central
Archivia la ricezione come Ricezione Conferimento Registrata con un riferimento al carico di acquisto
Rimuove la ricezione aperta originale

Registrazione dall’Ordine di Acquisto

Quando si registra un ordine di acquisto che ha il Tipo Ordine Conferimento impostato:

La conferma standard di registrazione viene intercettata
Solo le ricezioni con Qtà da Ricevere > 0 vengono considerate
Se la gestione stati è abilitata, solo le ricezioni “Pesate” sono idonee
L’utente può selezionare quali ricezioni registrare (se multiple)
La Qtà da Ricevere sulle righe acquisto è controllata dalle ricezioni, non modificabile direttamente

Protezione Righe Ordine di Acquisto

Quando una riga di ordine di acquisto è collegata a ricezioni di conferimento:

Il campo Qtà da Ricevere diventa di sola lettura (gestito dalle ricezioni)
Il Nr. Articolo non può essere cambiato (errore generato)
Il Cod. Variante non può essere cambiato (errore generato)
Il Nr. Fornitore sulla testata non può essere cambiato
Il Tipo Ordine Conferimento sulla testata non può essere cambiato

Generazione Numero Lotto

Il campo Nr. Lotto supporta AssistEdit:

Cliccare il pulsante assist-edit
Il sistema chiede: “Vuoi generare un numero lotto?”
Se confermato, genera il numero successivo dalla numerazione Lotto dell’articolo

Docs: Ricezioni conferimenti registrate

Mon, 01 Jan 0001 00:00:00 +0000

Ricezioni conferimento registrate

Panoramica

Le Ricezioni di Conferimento Registrate sono l’archivio permanente delle transazioni di conferimento completate. Ogni ricezione registrata rappresenta un ricevimento merce riuscito che è stato elaborato attraverso la routine standard di registrazione acquisti di Business Central.

Indicatori Visivi

Nella lista Ricezioni di Conferimento Registrate:

I record che sono stati annullati (hanno un movimento di annullamento) vengono visualizzati con stile Sfavorevole (tipicamente rosso/grassetto) per distinguere visivamente i movimenti stornati
Il flag Correction identifica il record di storno stesso

Processo di Annullamento

Quando un Annullamento Carico Acquisto standard BC viene eseguito su una riga di carico creata da una ricezione di conferimento:

Cosa Succede

Creazione Annullamento Ricezione Conferimento Registrata
Viene creata una nuova ricezione di conferimento registrata con:
- Qtà Ricevuta negativa (storno)
- Correction = true
- Collega-a Ricezione Conferimento Reg. = Nr. ricezione originale
Nuova Ricezione di Conferimento Riaperta
Viene creata una nuova ricezione di conferimento aperta dai dati della ricezione registrata:
- Stesso fornitore, articolo, lotto, pesi, dettagli spedizione
- Ricollegata alla riga dell’ordine di acquisto originale
- Pronta per la ri-modifica e ri-registrazione

Flusso di Annullamento

Ricezione Conferimento Registrata (originale, qtà positiva)
│
├── Annullamento Carico Acquisto attivato
│
├──▶ Nuova Ricezione Conferimento Registrata (qtà negativa, Correction=true)
│ └── Collega-a: ricezione originale
│
└──▶ Nuova Ricezione di Conferimento (aperta, collegata alla riga ordine)
└── Pronta per modifica e ri-registrazione

Risultato Visivo

Dopo un annullamento, la lista Ricezioni Conferimento Registrate mostra:

Ricezione originale — quantità positiva, evidenziata con stile sfavorevole (ha annullamento)
Ricezione di storno — quantità negativa, Correction=true
La nuova ricezione aperta appare nella lista Ricezioni di Conferimento

Relazione con i Documenti Standard BC

Ogni ricezione di conferimento registrata è collegata a un carico acquisto standard BC:

Ricezione Conferimento Registrata
│
├── Nr. Carico Acquisto ──▶ Testata Carico Acquisto
├── Nr. Riga Carico Acquisto ──▶ Riga Carico Acquisto
│
└── Tramite Carico Acquisto ──▶ Movimento Contabile Articolo
└── Tipo Ordine Conferimento

Il Tipo Ordine Conferimento viene riportato fino al Movimento Contabile Articolo, consentendo analisi e reportistica filtrata per tipo di conferimento rispetto ai ricevimenti standard.

Docs: Registrazione ordini di conferimento

Mon, 01 Jan 0001 00:00:00 +0000

Registrazione ordini di conferimento

Intercettazione della Registrazione

Quando un utente tenta di registrare un ordine di acquisto conferimento (tramite F9 o l’azione standard Registra):

La conferma standard di registrazione viene soppressa
Il sistema cerca ricezioni di conferimento con Qtà da Ricevere > 0
Se la gestione stati è abilitata, vengono considerate solo le ricezioni “Pesate”
All’utente viene mostrata una conferma personalizzata
Se esistono multiple ricezioni, l’utente seleziona quali registrare
Ogni ricezione selezionata viene registrata individualmente (un carico acquisto per ricezione)
Dopo la registrazione di tutte le ricezioni, le quantità rimanenti delle righe vengono azzerate

Diagramma Flusso Registrazione

L'utente clicca Registra sull'Ordine di Acquisto
│
├── È un Ordine Conferimento? (Tipo impostato + Anno Rif. impostato)
│ ├── No → Registrazione standard BC
│ └── Sì ↓
│
├── Trova ricezioni con Qtà da Ricevere > 0
│ └── (Opzionale: filtra per Stato = Pesato)
│
├── Conferma con l'utente
│
├── Per ogni ricezione:
│ ├── Valida controlli pre-registrazione
│ ├── Imposta Qtà da Ricevere di questa riga dalla ricezione
│ ├── Applica numero lotto (se applicabile)
│ ├── Riceve la merce
│ ├── Crea Ricezione Conferimento Registrata
│ └── Rimuove ricezione originale
│
└── Azzera righe rimanenti non elaborate

Propagazione Dati

Il Tipo Ordine Conferimento fluisce attraverso la catena di registrazione:

Testata Ordine Acquisto
└── Tipo Ordine Conferimento
│
├──▶ Riga Registrazioni Articoli
│ └── Tipo Ordine Conferimento
│
└──▶ Movimento Contabile Articolo
└── Tipo Ordine Conferimento

Questo consente reportistica e analisi sui movimenti contabili articolo per tipo di conferimento.