COGSA0 - Gestione prenotazione

Posizione nel menu Programma non a menu Linkage section

Tipo	Dato	Formato	Contenuto
INPUT	COGSA0-OPE	x(20)	Vedi argomenti successivi
	COGSA0-I-PRN-TIP	x(01)	Tipo prenotazione Vedi COGPRENO - Prenotazioni PRN-TIP Potrebbe essere " "; in questo caso si effettua solo la getione del BDP Attenzione: Potrebbe valere anche: CREA-BDP-SINGOLO AGGIUNGI-A-BDP
	COGSA0-I-PRN-CHIAVE		Dipende dal tipo prenotazione
	COGSA0-I-ANA
		x(01)
		9(05)
	COGSA0-I-MERCE	x(09)
	COGSA0-I-BDP
		chiave BDP
		9(04)
	COGSA0-I-MAG	x(01)
	COGSA0-I-DATA	data
	COGSA0-I-QTA	9(12)v999999
	COGSA0-I-ROR
		chiave ordine
		merce
		9(04)
	COGSA0-I-SN	x(30)	Serial number da prenotare
	COGSA0-I-LOTTO-INT	9(06)	Codice lotto interno da prenotare
	COGSA0-I-FL-PROVV	x(01)	In fase di creazione buono di prelievo, se vale "S" il buono sarà definito come "Provvisorio"
	COGSA0-I-PRN-STATO		Permette la ricerca solo delle prenotazioni: Sarà necessario impostare "A" quando ad esempio si inserisce un carico su una riga fornitore con un residuo di ordine, dopo che è stata evasa la prenotazione con un primo carico: in questo modo la gestione dei due carichi permetterà o meno di riaprire la prenotazione, a seconda che sia il carico che la ha chiusa.
	FILLER	x(06)
OUTPUT	COGSA0-O-ESITO	x(01)
	COGSA0-O-ERROR-MSG	x(80)
	COGSA0-O-PRN-TIP	x(01)
	COGSA0-O-PRN-CHIAVE	x(30)
	COGSA0-O-ANA
		x(01)
		9(05)
	COGSA0-O-BDP
		chiave BDP
		9(04)
	COGSA0-O-MERCE	merce
	COGSA0-O-DATA	data
	COGSA0-O-QTA	9(12)v999999
	COGSA0-O-ROR
		chiave ordine
		merce
		9(04)
	COGSA0-O-STATO	x(01)	Stato della prenotazione
	FILLER	x(46)
	FILLER	x(70)

Logica generale Programma che dovrà occuparsi della gestione di una prenotazione. Configurazioni possibili

Gruppo	Parametro	Note

Elaborazione L'elaborazione cambia a seconda dell'operazione richiesta.

Operazione: PRENOTA

Descrizione Effettua una prenotazione: crea un buono di prelievo e lo aggancia all'oggetto richiesto. Se si vuole invece creare un bdp senza agganciarlo ad una prenotazione, usare Operazione: CREA-BDP-SINGOLO Chiamata standard Esempio: una riga ordine fornitore viene prenotata da un ordine cliente

Dato	Contenuto
COGSA0-OPE	"PRENOTA"
COGSA0-I-PRN-TIP	"F"
COGSA0-I-PRN-CHIAVE	Chiave riga ordine fornitore (ROR-CHIA1)
COGSA0-I-ANA	Tipo e codice anagrafico del cliente interessato
COGSA0-I-MERCE	Codice merce sulla riga ordine fornitore
COGSA0-I-MAG	Magazzino su cui viene effettuato l'ordine fornitore
COGSA0-I-DATA	Data di prenotazione
COGSA0-I-QTA	Quantità prenotata (quantità riga ordine fornitore)
COGSA0-I-ROR
	Chiave dell'ordine cliente che prenota la merce

Esempio: un preventivo prenota una materia prima

Dato	Contenuto
COGSA0-OPE	"PRENOTA"
COGSA0-I-PRN-TIP	"P"
COGSA0-I-PRN-CHIAVE	Chiave riga preventivo (RPR-CHIA1)
COGSA0-I-ANA	Tipo e codice anagrafico del cliente interessato (il cliente del preventivo)
COGSA0-I-MERCE	Codice materia prima interessata (non la merce sulla riga preventivo)
COGSA0-I-MAG	Magazzino su cui effettuare la prenotazione
COGSA0-I-DATA	Data di prenotazione
COGSA0-I-QTA	Quantità prenotata (quantità riga preventivo)
COGSA0-I-ROR	In questo caso non viene indicato nulla

Elaborazione * Input: * Tipo oggetto (vedi COGPRENO.PRN-TIP) * Chiave oggetto a cui collegare la prenotazione * Cliente per cui prenotare * Merce * Quantità * Output: * Riferimento bdp creato Cercare su COGPRENO se esiste già un bdp agganciato all'oggetto da cercare. Se non esiste Si dovrà procedere all'inserimento di un BDP, usando cliente, merce e q.ta passati in input, e aumentando la q.ta prenotata. Agganciare il BDP all'oggetto passato inserendo un record su COGPRENO. Se esiste Leggere il BDP esistente e modificare i dati sensibili: cliente, merce e quantità. Se modificata la quantità, variare di conseguenza la q.ta prenotata.

Operazione: CREA-BDP-SINGOLO

Descrizione Creazione di un BDP che potrà essere successivamente agganciato ad un altro oggetto dal programma chiamante Chiamata standard Esempio: richiesta di creazione di un BDP singolo In questo caso il bdp rimane fine a se stesso, o agganciato a qualcos'altro da un programma chiamante (vedi ASN541)

Dato	Contenuto
COGSA0-OPE	"CREA-BDP-SINGOLO"
COGSA0-I-ANA	Tipo e codice anagrafico del cliente/fornitore interessato
COGSA0-I-MERCE	Codice merce
COGSA0-I-MAG	Magazzino
COGSA0-I-DATA	Data di prenotazione
COGSA0-I-QTA	Quantità prenotata (qta BDP)
COGSA0-I-SN	L'eventuale s/n da agganciare al bdp NB: per il momento solo 1
COGSA0-I-PRN-TIP	"N"
COGSA0-I-PRN-CHIAVE	Chiave riga consegna cliente

Elaborazione * Input: * Cliente per cui prenotare * Merce * Quantità * Output: * Riferimento bdp creato Si dovrà procedere all'inserimento di un BDP, usando cliente, merce e q.ta passati in input, e aumentando la q.ta prenotata. Se la merce passata in input è gestita a s/n, potrebbe anche essere passato in input il dato COGSA0-I-SN: permetterà l'aggancio del s/n al buono di prelievo. In questo caso, per il momento, la quantità sarà 1 L'aggancio avviene scrivendo un apposito record su COGGENER

Operazione: AGGIUNGI-A-BDP

Descrizione CreazioneSu un BDP esistente verrà accodata una riga con l'articolo passato in input. Chiamata standard

Dato	Contenuto
COGSA0-OPE	"AGGIUNGI-A-BDP"
COGSA0-I-MERCE	Codice merce
COGSA0-I-QTA	Quantità prenotata (qta BDP)
COGSA0-I-SN	L'eventuale s/n da agganciare al bdp NB: per il momento solo 1
COGSA0-I-BDP-TESTA	Chiave BDP da modificare
COGSA0-I-PRN-TIP	"N"
COGSA0-I-PRN-CHIAVE	Chiave riga consegna cliente

Elaborazione

Operazione: CANCELLA

Descrizione Cancella una prenotazione esistente Chiamata standard Esempio: una riga ordine fornitore viene cancellata, e si deve rimuovere la prenotazione

Dato	Contenuto
COGSA0-OPE	"CANCELLA"
COGSA0-I-PRN-TIP	"F"
COGSA0-I-PRN-CHIAVE	Chiave riga ordine fornitore (ROR-CHIA1)

Esempio: un bdp viene cancellato, e si deve rimuovere la prenotazione

Dato	Contenuto
COGSA0-OPE	"CANCELLA"
COGSA0-I-PRN-TIP	" "
COGSA0-I-PRN-CHIAVE	" "
COGSA0-I-BDP-TESTA	Chiave BDP da cancellare

Elaborazione In questo caso recuperare e cancellare il bdp collegato all'oggetto, se esistente, avendo cura di ripristinare il prenotato e di rimuovere il collegamento all'oggetto. NB: nel caso in cui viene passato in input il bdp e non l'oggetto, eseguire la cancellazione del bdp. Verificare comunque la presenza del collegamento; se esiste rimuoverlo. Se viene richiesta la cancellazione del BDP, si cercherà comunque l'eventuale prenotazione esistente collegata e sarà rimossa. Eventuali collegamenti esterni tra il bdp e altri oggetti non saranno rimossi

Operazione: MODIFICA

Descrizione Modifica una prenotazione esistente, partendo da una riga ordine fornitore. * La prenotazione deve essere aperta * Il BDP esistente viene solamente variato (potrà essere cambiata la quantità, il cliente, la data, la merce); per il momento non è prevista la modifica del magazzino (comporterebbe una cancellazione completa della struttura bdp-prenotazione e il successivo reinserimento) * La modifica determina anche la variazione della quantità prenotata; diamo per scontato che il bdp abbia già aggiornato in precedenza la qta prenotata. * Il record di collegamento su COGPRENO con la riga ordine fornitore rimane invariato * Il record di collegamento con l'ordine cliente potrà essere aggiunto, cancellato, modificato, a seconda della situazione * Si dà per scontato che la riga ordine cliente sia sempre indicata; quindi se non è presente il collegamento verrà rimosso Chiamata standard

Dato	Contenuto
COGSA0-OPE	"MODIFICA"
COGSA0-I-PRN-TIP	"F"
COGSA0-I-PRN-CHIAVE	Chiave riga ordine fornitore (ROR-CHIA1)
COGSA0-I-ANA	Tipo e codice anagrafico del cliente interessato
COGSA0-I-MERCE	Codice merce sulla riga ordine fornitore
COGSA0-I-MAG	Magazzino su cui viene effettuato l'ordine fornitore
COGSA0-I-DATA	Data di prenotazione
COGSA0-I-QTA	Quantità prenotata (quantità riga ordine fornitore)
COGSA0-I-ROR	Chiave dell'ordine cliente che prenota la merce

Elaborazione

Operazione: RICERCA

Descrizione Verifica se esiste una prenotazione relativamente all'oggetto passato in input Chiamata standard

Dato	Contenuto
COGSA0-OPE	"RICERCA"
COGSA0-I-PRN-TIP	Tipo oggetto per cui eseguire la ricerca
COGSA0-I-PRN-CHIAVE	Chiave oggetto per cui eseguire la ricerca
COGSA0-I-PRN-STATO	Permette la ricerca solo delle prenotazioni: Sarà necessario impostare "A" quando ad esempio si inserisce un carico su una riga fornitore con un residuo di ordine, dopo che è stata evasa la prenotazione con un primo carico: in questo modo la gestione dei due carichi permetterà o meno di riaprire la prenotazione, a seconda che sia il carico che la ha chiusa.

Elaborazione Cercare l'esistenza del bdp collegato all'oggetto e restituire le informazioni in output. In output restituirà: * * Riferimento bdp trovato * Cliente a cui fa riferimento la prenotazione * Merce * Quantità * Chiave ordine cliente per cui è stata effettuata la prenotazione * Stato della prenotazione

Operazione: CHIUDI-OC

Descrizione Serve per liberare la prenotazione effettuata su un ordine cliente: quindi chiude i buoni di prelievo collegati ad esso, e scarica il prenotato. Chiamata standard

Dato	Contenuto
COGSA0-OPE	"CHIUDI-OC"
COGSA0-I-TOR	Testata ordine per cui effettuare l'operazione

Elaborazione Se esegue la ricerca su COGPRENO di tutti i bdp collegati alla testata ordine cliente (PRN-TIP = 'C') Per ciascun bdp ancora aperto: * Si toglie il prenotato * Si chiude il bdp

Operazione: ATTIVA-BDP

Descrizione Questa operazione viene effettuata quando si effettua il carico di una riga ordine collegata ad una prenotazione, e serve ad "attivare" il nuovo di prelievo, che diventerà effettivo e quindi aumenterà la qta prenotata sull'articolo intererssato. La prenotazione viene marcata come "Evasa" quando la quantità ordine è stata evasa completamente. Chiamata standard

Dato	Contenuto
COGSA0-OPE	"ATTIVA-BDP"
COGSA0-I-PRN-TIP	"E"
COGSA0-I-PRN-CHIAVE	Riga del documento di carico
COGSA0-I-BDP-TESTA	Chiave del BDP oggetto della prenotazione
COGSA0-I-QTA	Quantità caricata

Elaborazione Buono di prelievo * Non più provvisorio * COGTESBP.TBP-FL-PROVVISORIO = " " * La quantità viene adeguato se necessario: * COGRIGBP.RBP-QTA = COGSA0-I-QTA (nel caso in cui sia stata variata) * Sulla riga viene riportato il riferimento alla prima consegna utile collegata alla riga ordine cliente (in modo che sia possibile effettuare l'evasione del BDP contestualmente alla consegna) * Questo meccanismo funziona bene se ogni riga ordine cliente ha solo una consegna: l'ideale sarebbe gestire la data consegna sulla riga ordine) Prenotazione * Viene aggiunto il raccordo con la riga di carico * La prenotazione viene chiusa * COGPRENO.PRN-STATO = 'C' per tutte le righe

Operazione: DISATTIVA-BDP

Descrizione Questa operazione viene effettuata quando si cancella un carico o una riga di carico collegata ad una prenotazione, e serve ad "disattivare" il nuovo di prelievo, che non sarà più evadibile, e riapre di conseguenza la prenotazione stessa su COGPRENO. Chiamata standard

Dato	Contenuto
COGSA0-OPE	"DISATTIVA-BDP"
COGSA0-I-PRN-TIP	"F"
COGSA0-I-PRN-CHIAVE	Chiave riga ordine fornitore (ROR-CHIA1)

Elaborazione * COGTESBP.TBP-FL-PROVVISORIO = "P" * COGPRENO.PRN-STATO = 'A' (per tutte le righe collegate al BDP) Buono di prelievo * Ritorna "provvisorio" * COGTESBP.TBP-FL-PROVVISORIO = "P" Prenotazione * Viene effettuata la cancellazione del raccordo con la riga di carico * La prenotazione viene riaperta * COGPRENO.PRN-STATO = 'A' per tutte le righe

Operazione: CONTROLLA-QTA-PRENO

Descrizione Riceve in input un BDP, e verifica se è nella condizione di movimentare la quantità prenotata per i suoi articoli Attualmente la condizione è: Se il BDP è collegato ad una prenotazione aperta, e la prenotazione è collegata ad una riga ordine fornitore, questo deve essere evaso: in presenza di riga ordine fornitore aperta significa che la merce prenotata non è ancora arrivata, quindi non deve essere evidenziata la quantità prenotata relativa. Chiamata standard

I/O	Dato	Contenuto
Input	COGSA0-OPE	"CONTROLLA-QTA-PRENO"
	COGSA0-I-BDP
		Testata BDP da controllare
Output	COGSA0-O-ESITO

Elaborazione

---

Estratto da documentazione interna ClickUp