A G X S D O C U M E N T. Dafne Portal PRODAT Document Format Flat Version /11/2012. Dafne

Transcript

1 Dafne Portal PRODAT Document Format Flat Version /11/2012 Dafne

2 IMPORTANT INFORMATION This document is provided to Consorzio Dafne (Dafne) solely for the purpose of its evaluation. The information contained herein is not intended to be used by Dafne for any other purpose and is not to be disclosed by Dafne to any third party without the prior written consent of GXS, which consent will not arbitrarily or unreasonably be withheld. 2/12

3 INDICE IMPORTANT INFORMATION... 2 INDICE... 3 DOCUMENT HISTORY... 4 INTRODUZIONE... 5 REGOLE GENERALI... 6 STRUTTURA DEL MESSAGGIO... 8 STRUTTURA DEI SEGMENTI... 9 MESSAGE HEADER (DAH, 1)... 9 BEGINNING OF MESSAGE (BGM, 1) DECLARANT NAME AND ADDRESS (NAD, 1) DETAIL (LIN, ) ADDITIONAL PRODUCT ID (PIA, 0..1) MESSAGE TRAILER (DAT, 1) /12

4 DOCUMENT HISTORY Version Revision Date Brief description of change Author(s) Nov 2012 Marco Molino (GXS) Feb 2013 Added ProductDescription and PacksPerRow in segment LIN Marco Molino (GXS) 4/12

5 INTRODUZIONE Il Consorzio DAFNE (DAFNE nel seguito) ha definito una serie di Messaggi di Business, in formato Elettronico, per agevolare lo scambio di transazioni tra gli attori della distribuzione Farmaceutica. Queste transazioni sono state definite in una serie di Messaggi specifici. DAFNE ha scelto due tipi di sintassi per definire questi Messaggi: Una si basa sullo standard EDI (Electronic Data Interchange), adottando le specifiche EDIFACT; L altra, invece, si basa su uno standard privato, definito da DAFNE, per essere utilizzata da quegli utenti che adottano come sistema trasmissivo la rete Internet. Questo standard è stato definito in un progetto denominato EasyDafne nel corso dell anno Il presente documento descrive il Messaggio definito con lo standard EasyDafne Il Messaggio è composto da una serie di segmenti (record), formanti un file sequenziale di tipo testo (FLAT). Il Messaggio è logicamente diviso in parti: una parte di Testata, il Dettaglio ed, eventualmente, la parte di Sommario. Ogni segmento è composto da una serie di campi a lunghezza fissa, che contengono l informazione. Ogni segmento inizia con un campo etichetta (TAG) di tre caratteri che riporta il nome del segmento. La struttura logica del messaggio viene mostrata graficamente in un diagramma che rappresenta le relazioni tra i vari segmenti componenti un messaggio ed i gruppi di cui fanno parte. Il diagramma definisce inoltre l ordine di trasmissione - dall alto al basso e da sinistra a destra - dei segmento rappresentati. Viene inoltre indicato successivamente la definizione dettagliata di ciascun segmento e relativo contenuto secondo quanto definito da DAFNE. 5/12

6 REGOLE GENERALI Di seguito viene fornito un diagramma grafico che illustra la struttura del messaggio ed indica, per ciascun segmento le ripetitività massime, la sequenza logica e l eventuale gruppo di appartenenza. Nel diagramma, la sequenza di lettura è dall alto al basso e da sinistra a destra. Un segmento è identificato da una sigla di tre lettere (TAG) e dal numero di ripetizioni massime permesse. La convenzione utilizzata per la colonna Ripetizione è la seguente: N (Numero fisso) N..M Devono comparire N ripetizioni del record Il record è ripetibile da un minimo di N ad un massimo di M volte. Se N = 0, il record è facoltativo. Tutti i segmenti sono a lunghezza fissa, tale dimensione è differente per ogni tipologia di segmento. Tutti i segmenti devono terminare con i caratteri CR e LF, in esadecimale 0D 0A. Ciascun segmento è composto da più campi, definiti come segue: Field Codice mnemonico del campo Name Descrizione del campo Attributes Definizione del campo, gli attributi specificati sono 3: R Requred Indica se il campo è obbligatorio o facoltativo, si veda la tabella Attributes Required per maggiori dettagli T Type Tipologia del campo, si veda la tablella Attributes Type per maggiori dettagli L Lenght Dimensione massima del campo D Decimal Numero di posizioni decimali, questo valore è un di cui della dimensione massima Notes Eventuali spiegazioni sull uso del campo Offset Posizione di inizio del campo all interno del segmento Caratteri permessi Il set di caratteri permessi nel file sono: Lettere maiuscole (ABC.) e minuscole (abc.) Numeri (0123 ) Lo spazio e i seguenti caratteri: # " % & ' ( ) * +, -. / : ; < > =? 6/12

7 Attributes Requred Value Description Notes M Mandatory Deve essere espresso un valore Obbligatorio C Conditional Deve essere o un valore o una stringa a spazi Facoltativo NU Not Used Non usato Deve essere lasciata una stringa a spazi Attributes Type Value Description Notes an Alfanumerico Sono possibili caratteri a spazio all interno del campo. Campo allineato a sinistra. n Numerico Campo allinato a destra, riempito di zeri a sinistra, con eventuale parte decimale allineata a sinistra con zeri nella parte non significativa. I separatori delle migliaia e dei decimali non vengono indicati. Se viene indicato un campo numerico con: Attributes Lenght = 9 Attributes Decimal = 3 Si sta parlando di un numero con parte intera di 6 digit e parte decimale di 3 digit, con questo formato il numero 2100,3 verrà scritto come: d8 Data Data, lunga 8 caratteri nel formato YYYYMMDD t4 Ora Ora, lunga 4 caratteri nel formato HHMM 7/12

8 STRUTTURA DEL MESSAGGIO PRODAT From To Product data Dati di prodotto Warehouse / Company Farmadati TAG Level Description Occurrences DAH Message Header 1 BGM Beginning of Message 1 NAD Declarant Name and Address 1 LIN Detail PIA Additional Product ID 0..1 DAT Message Trailer 1 I segmenti modificati sono stati evidenziati con il colore: 8/12

9 STRUTTURA DEI SEGMENTI MESSAGE HEADER (DAH, 1) Field Name Description Attributes Notes Offset R T L D DAH0101 TAG M an 3 DAH 1 DAH DocumentType Document name M an 6 PRODAT 4 DAH DocumentTypeVersion Document version M an DAH AddressFrom Sender mailbox M an address DAH AddressTo Receiver mailbox M an address DAH CreateDate File creation date M d DAH DocumentID Document number M an DAH DocumentIDVersion Transmission reference M an 14 Transmission reference Il sistema controlla la univocità di questo dato e se trova un altro invio con lo stesso valore non inoltra il messaggio e da errore di duplicazione /12

10 BEGINNING OF MESSAGE (BGM, 1) Field Name Description Attributes Notes Offset R T L D BGM0201 TAG M an 3 BGM 1 BGM DocumentType Document Type M an 3 Values: 4 6 Product specification report BGM DocumentStatus Document Status NU an 3 7 BGM DocumentDate Document Date M d8 8 Data di creazione del 10 messaggio yyyymmdd 17 DECLARANT NAME AND ADDRESS (NAD, 1) Field Name Description Attributes Notes Offset R T L D NAD0201 TAG M an 3 NAD 1 NAD Qualifier Qualifier M an 3 Values: 4 DT Declarant NAD ID Code M an 35 Codice anagrafico (1) Codice anagrafico, vedi codifica siti logistici del Ministero della Salute jsp?menu=strumenti&id= /12

11 DETAIL (LIN, ) Field Name Description Attributes Notes Offset R T L D LIN0201 TAG M an 3 LIN 1 LIN ID Row number C an 6 Numero di riga 4 LIN Action Action request M an 3 Operazione richiesta 10 Values: 1 Add 2 Delete 3 Change LIN ProductID Product ID M an 35 Codice Prodotto 13 LIN ProductQualifier Product Qualifier M an 3 Qualificatore Codice 48 Prodotto (1) Values: ZZZ Ministero Sanità FD Farmadati CC Codifa FF Federfarma EN EAN SA Codice fornitore LIN ProductDescription Product Description M an 40 Descrizione prodotto 51 LIN UpdateDate Update Date M d8 8 Data aggiornamento 91 LIN PacksPerStandardBox Packs per standard box M n 6 Numero confezioni prodotto per cartone standard LIN PacksPerBundle Packs per bundle C n 6 Numero confezioni prodotto per fardello LIN PacksPerRow Packs Per Row C n 6 Numero confezioni per fila, da indicare nel caso in cui non è presente la fardella LIN PacksPerPallet Packs per pallet C n 6 Numero confezioni prodotto per bancale LIN SinglePackGrossWeight Single pack gross C n 6 Peso lordo confezione weight singola espresso in g LIN SinglePackHeight Single pack height C n 6 Misura altezza confezione singola espresso in mm LIN SinglePackWidth Single pack width C n 6 Misura larghezza confezione singola espresso in mm LIN SinglePackDepth Single pack depth C n 6 Misura profondità confezione singola espresso in mm LIN StandardBoxTare Standard box tare C n 6 Peso del cartone (tara) espresso in g I codici sono da usarsi in sequenza, quindi è obbligatorio utilizzare il codice ZZZ, se esiste. In caso contrario si passa al codice successivo FD, e così via /12

12 ADDITIONAL PRODUCT ID (PIA, 0..1) Field Name Description Attributes Notes Offset R T L D PIA0301 TAG M an 3 PIA 1 PIA ProductID Product ID M an 35 Codice Prodotto 4 PIA ProductQualifier Product Qualifier M an 3 Qualificatore Codice 39 Prodotto Values: EN EAN 41 MESSAGE TRAILER (DAT, 1) Field Name Description Attributes Notes Offset R T L D DAT0101 TAG M an 3 DAT 1 DAT DocumentCheck Checksum M n 6 Number of records 4 DAH and DAT included DAT DocumentID Document Number M an 35 Document Number Same value reported in DAH /12