UN/EDIFACT Message Type : Batch : DAPLOS

__ United Nations Directories for Electronic Data Interchange for Administration, Commerce and Transport __UN/EDIFACT

Message Type : DAPLOS Version : D Release : 08A Contr. Agency: UN Revision : 1 Date : 2008-05-30 SOURCE: TBG1 Supply Chain CONTENTS Data Plot Sheet 0. INTRODUCTION 1. SCOPE 1.1 Functional definition 1.2 Field of application 1.3 Principles 2. REFERENCES 3. TERMS AND DEFINITIONS 3.1 Standard terms and definitions 3.2 Message terms and definitions 4. MESSAGE DEFINITION 4.1 Segment clarification 4.2 Segment index (alphabetical sequence by tag) 4.3 Message structure 4.3.1 Segment table ---------------------------------------------------------------------- For general information on UN standard message types see UN Trade Data Interchange Directory, UNTDID, Part 4, Section 2.3, UN/ECE UNSM General Introduction ---------------------------------------------------------------------- 0. INTRODUCTION This specification provides the definition of the Data Plot Sheet (DAPLOS) to be used in Electronic Data Interchange (EDI) between trading partners involved in administration, commerce and transport. 1. SCOPE The UN Standard DAPLOS may be used for both national and international trade. It is based on universal commercial practice and is not dependent on the type of business or industry. 1.1 Functional definition A message to describe the data plot sheet exchanged between farmers and suppliers. This information includes technical description and information of the crop production in order to give information about traceability to the farmer's partners (cooperatives, manufacturers, suppliers etc.) 1.2 Field of application The Data Plot Sheet may be used for both national and international applications. It is based on universal practice related to administration, commerce and transport, and is not dependent on the type of business or industry. 1.3 Principles This message is an exchange between and agricultural unit and a receiving organisation (such as cooperatives, manufacturers, food industry). This message is divided in two parts: The Header section containing - The document number - The identification of the parties involved The Detail section providing the breakdown of 1 to n plots sheets contained in the exchange: - General points on the plot sheet (dates, species, variety, area, contracts, etc.) - History of the plot (previous crops, enrichment, etc.) - Analysis (details of soil analyses carried out on the plot.) - Events (i.e. all events such as observations, advice, actions taken, etc.) This breakdown will be provided as many times as there are plot sheets in the document. 2. REFERENCES See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 1. 3. TERMS AND DEFINITIONS 3.1 Standard terms and definitions See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 2. 3.2 Message terms and definitions See UNTDID. Part 4, Chapter 2.6 UN/ECE UNSM - General Introduction, Section 2 4. MESSAGE DEFINITION 4.1 Segment clarification This section should be read in conjunction with the segment table which indicates mandatory, conditional and repeating requirements. This section should be read in conjunction with the segment table which indicates mandatory, conditional and repeating requirements. The following guidelines and principles apply to the whole message and are intended to facilitate the understanding and implementation of the message: All specified dates and/or times should be in the format 'ccyymmdd'/'hhmm' unless all parties involved in the transaction agree that there is a functional requirement for an alternative format. Periods should be specified as whole numbers representing the required period as indicated in the date or time or period format qualifier (weeks,months,etc.). Conditional data that is not required in the message should not be included. Care must be taken that the segment qualifier in dependent segments does not conflict with the segment qualifier of the trigger segment of the group. Free text information within the message should be avoided as this inhibits automatic processing. 0010UNH, Message header A service segment starting and uniquely identifying a message. The message type code for the Data Plot Sheet is DAPLOS. Note: Data Plot Sheets conforming to this document must contain the following data in segment UNH, composite S009: Data element 0065 DAPLOS 0052 D 0054 08A 0051 UN 0020BGM, Beginning of message A segment by which the sender must uniquely identify the Data Plot Sheet Message by means of its name and number and when necessary its function. Data element 1225 may be used to identify updates to a previously sent DAPLOS message 0030DTM, Date/time/period A segment specifying general dates and, when relevant, times related to the whole message. The segment must be specified at least once to identify the Data Plot Sheet Message date. The Date/time/period segment within other Segment groups should be used whenever the date/time/period requires to be logically related to another specified data item, for example the availability date for a specified line item (DTM following LIN). 0040IMD, Item description A segment providing the type of agriculture practised in the farm for all crops identified within the message in free format or in coded form and when necessary identifying the language used. It may be repeated as well to provide the name in other languages. 0050 Segment group 1: NAD-RFF A group of segments identifying the parties with associated information relevant to the whole message. 0060NAD, Name and address A segment identifying names and addresses of the parties, in coded or clear form, and their functions relevant to the message. At least one NAD-segment should be provided, for example the farmer, the cooperative, the supplier or message generator. It is recommended that, if possible, only the coded ID of the party is specified. 0070RFF, Reference A segment identifying a reference by its type and number and when appropriate a line number within a document. 0080 Segment group 2: LIN-DTM-PIA-QTY-SG3-SG4-SG6-SG8-SG11-SG12 A group of segments providing details (e.g. crop) of a single plot. 0090LIN, Line item A segment identifying the line item by the line item number, and identifying the plot through a unique plot key. 0100DTM, Date/time/period A segment specifying general dates and, when relevant, times related to the line item. For example the intended year of harvest. 0110PIA, Additional product id A segment providing identification of the crop, e.g. to identify the botanical species, the variety sown. 0120QTY, Quantity A segment identifying the plot expected harvest for the crop. 0130 Segment group 3: CCI-CAV A group of segments specifying the characteristics and their values of the crop mixture on the plot. 0140CCI, Characteristic/class id A segment specifying the characteristics of the crop mixture on the plot. 0150CAV, Characteristic value A segment to specify common characteristics by value in either coded form or free format. 0160 Segment group 4: RFF-SG5 A group of segment giving references to the line item (plot) e.g. providing the surface areas of the arable crop concerned. 0170RFF, Reference A segment identifying a reference by its type and number. For example, it's the name of the arable plot, given by the agricultural unit, the CAP island number, perennial plot number, etc.. 0180 Segment group 5: MEA-GPO A group of segments specifying physical measurements and the location related to the measurement. 0190MEA, Measurements A segment indicating characteristic values being physical measurements (including measurable quantities and surface area) related to specified characteristics (for example, temperature, surface of the event) and where relevant measurement ranges. 0200GPO, Geographical position A segment used to identify the geographical position of the surface area. 0210 Segment group 6: IMD-QTY-NAD-SG7 A group of segment specifying characteristics details of the arable crop, such as the description, the quantities, the relevant parties and references. 0220IMD, Item description A segment providing the description of a characteristic of the arable crop by using specific codes or free text. For example, the type of soil, the type of sub-soil, the soil acidity, the crop residues management, commitments, etc. 0230QTY, Quantity A segment identifying the quantity related to the characteristic specified in the Item description e.g. quantity of crop residues applied. 0240NAD, Name and address A segment identifying names and addresses of the contractor, in coded form, and their functions relevant to the characteristics specified in the Item description. 0250 Segment group 7: RFF-DTM A group of segment specifying the references relevant to the characteristics specified in the Item description e.g. contract. 0260RFF, Reference A segment identifying a reference by its type and number, e.g. contract number. 0270DTM, Date/time/period A segment specifying the date relevant to the referred document, e.g. contract date. 0280 Segment group 8: HYN-PIA-SG9-SG10 A group of segment to identify dependencies among the content of hierarchically related groups of data. It used to identifying the previous crops which were harvested before and which have some consequences on the actual crop. 0290HYN, Hierarchy information A segment identifying the level of the previous crop. The previous arable plot key is based on the same structure of the current arable plot key. 0300PIA, Additional product id A segment to identify a product, e.g. the Botanical species, the variety sown for the previous crop. 0310 Segment group 9: CCI-CAV A group of segments specifying the characteristics of the crop (qualifiers of the botanical species, period of sowing, destination of the crop) and their values, concerning the previous crop. 0320CCI, Characteristic/class id A segment to identify the characteristics of the crop (qualifiers of the botanical species, period of sowing, destination of the crop) 0330CAV, Characteristic value A segment to specify common characteristic by value in either coded form or free format. 0340 Segment group 10: IMD-DTM-QTY-NAD A group of segment specifying the characteristics details of the crop improvement and residues management. 0350IMD, Item description A segment providing the description of the characteristics of the crop improvements and the type of the crop residues. 0360DTM, Date/time/period A segment specifying the date relating to the characteristics described in the Item description, e.g. date of the improvement application. 0370QTY, Quantity A segment identifying the quantity related to the characteristic described in the Item description, e.g. quantity applied. 0380NAD, Name and address A segment identifying names and addresses valid for the characteristics described in the Item description, e.g. party of the improvement. 0390 Segment group 11: DOC-NAD-DTM A group of segment identifying documents and the related party valid for the line item (plot). 0400DOC, Document/message details A segment identifying and providing information relating to the documents, e.g. a soil analysis document. 0410NAD, Name and address A segment identifying names and addresses of the parties in code or clear form, and their functions relevant to the document, e.g. the analysis laboratory. 0420DTM, Date/time/period A segment specifying the date and/or time of the document, e.g. the analysis date, the sampling date. 0430 Segment group 12: EVE-DTM-IMD-NAD-FTX-SG13-SG14-SG15-SG20 A group of segments providing details of an event related to the line item (plot). 0440EVE, Event A segment specifying details about an event. An event is all actions happen on the crop such an input application, a treatment etc. 0450DTM, Date/time/period A segment specifying date and, or time or period details relating to the event item only, for example the date of treatment or the length of the treatment. 0460IMD, Item description Segment providing the description of some characteristics of the event by using specific codes or free text. For example, the stage of cultivation, the type of work, the weather conditions during the event etc. 0470NAD, Name and address A segment identifying name and address of the person who does the event in coded or clear form and its functions. For example internal operator or external operator. 0480FTX, Free text A segment with free text information, in clear form, to give some additional information about the event and when necessary identifying language used. In computer to computer exchanges such text will normally require the receiver to process this segment manually. 0490 Segment group 13: CCI-CAV A group of segments providing characteristics details of the event. For example the target of the action (for example, crop disease, targets pests, etc.) 0500CCI, Characteristic/class id A segment to identify target characteristic in, order to justify a crop treatment (for example, target pests for the use of a pesticide's application, targets weeds for the use of an herbicide, targets diseases) 0510CAV, Characteristic value A segment to specify characteristic by value either in coded form or free format. For example, fusarium for a wheat target pest. 0520 Segment group 14: MEA-GPO A group of segments specifying physical measurements and the location related to the measurement. 0530MEA, Measurements A segment indicating characteristic values being physical measurements (including measurable quantities and surface area) related to specified event characteristics (for example temperature, surface of the event) where relevant measurement ranges. 0540GPO, Geographical position A segment used to identify the geographical position of the surface area of the event. 0550 Segment group 15: IFD-PIA-QTY-NAD-SG16-SG17-SG18-SG19 A group of segment specifying information details, quantities, Parties, component details, specific characteristics and references about an event. 0560IFD, Information detail A segment specifying details about an event (type of input applied on the crop) or an harvest. 0570PIA, Additional product id A segment specifying additional or substitutional product item (input or harvested product) identification codes. 0580QTY, Quantity A segment specifying the quantities of an event applied on the crop for example effective quantity of input, Target dose per hectare etc. 0590NAD, Name and address A segment identifying names and addresses of the parties relevant for the information details of an event, e.g. the livestock effluent origin 0600 Segment group 16: COD-MEA A group of segment providing components details and physical measurements of an object, such as its type ant the material which it is composed. 0610COD, Component details A segment providing components details of an object, e.g. organic and/or mineral fertilization. 0620MEA, Measurements A segment specifying measured amount quantities of the identified component, e.g. the weight of fertilising material units. 0630 Segment group 17: CCI-CAV A group of segment providing characteristics and its relevance related to the specified details of an event. 0640CCI, Characteristic/class id A segment to identify a specific characteristic. 0650CAV, Characteristic value A segment to specify common characteristic by value in coded form of free format. For example livestock effluent or seed qualifiers and destination of the harvested product. 0660 Segment group 18: RFF-QTY-MEA A group of segments used to provide references and where necessary, their quantities or measurements, related to the specific details of an event. 0670RFF, Reference A segment identifying a reference by its type and number for example the batch number of the manufacturer of the input or the batch number of the farmer for the harvested product. 0680QTY, Quantity A segment to specify quantities related to the reference, e.g. for the batch of input or the batch of harvested product. 0690MEA, Measurements A segment enabling the physical measurement related to the reference, e.g. of the main harvested product to be specified where this is required for example the protein content, nitrate content, sizing etc. 0700 Segment group 19: DOC-NAD-DTM A group of segment identifying documents and detail directly related to a specific detail of an event. 0710DOC, Document/message details A segment identifying and providing information relating to documents, e.g. an effluent analysis document. 0720NAD, Name and address A segment identifying names and addresses of the party in code or clear form, and their function relevant to the document, e.g. of the analysis laboratory. 0730DTM, Date/time/period A segment specifying the date and/or time of the document, e.g. the date of the analysis and the sampling date. 0740 Segment group 20: HYN-NAD-FTX-SG21 A group of segments identifying hierarchical connections from the given event to higher or lower levelled like "decision indicator" type of event in link with an other arable plot and/or an other agricultural unit. 0750HYN, Hierarchy information A segment to identify hierarchical connections from the given event to higher or lower level with the related party and the references, like "decision indicator" type of event in link with an other arable plot and/or an other agricultural unit. 0760NAD, Name and address A segment specifying the names and addresses of the party in code or clear form, and their function relevant to the document, e.g. of the other agricultural unit if the given crop belonged to an other farmer, the year before. 0770FTX, Free text A segment with free text information, in clear form, to give some additional information about the link with a "decision indicator" type of event and when necessary identifying language used. In computer to computer exchanges such text will normally require the receiver to process this segment manually. 0780 Segment group 21: RFF-DTM A group of segment identifying an event reference number and an arable crop number and the date relevant to the referred document. 0790RFF, Reference A segment identifying an event reference number and an arable plot number in order to do the link between the actual crop and the previous event or crop. 0800DTM, Date/time/period A segment specifying the date relevant to the referred document, e.g. the intended year of harvest. 0810UNT, Message trailer A service segment ending a message, giving the total number of segments in the message (including the UNH & UNT) and the control reference number of the message. 4.2 Segment index (alphabetical sequence by tag) BGM Beginning of message CAV Characteristic value CCI Characteristic/class id COD Component details DOC Document/message details DTM Date/time/period EVE Event FTX Free text GPO Geographical position HYN Hierarchy information IFD Information detail IMD Item description LIN Line item MEA Measurements NAD Name and address PIA Additional product id QTY Quantity RFF Reference UNH Message header UNT Message trailer

4.3 Message structure 4.3.1 Segment table Pos Tag Name S R 0010UNH Message header M 1 0020BGM Beginning of message M 1 0030DTM Date/time/period M 9 0040IMD Item description C 1 0050 ----- Segment group 1 ------------------ C 9-----------+ 0060NAD Name and address M 1 | 0070RFF Reference C 9-----------+ 0080 ----- Segment group 2 ------------------ C 9999--------+ 0090LIN Line item M 1 | 0100DTM Date/time/period M 9 | 0110PIA Additional product id M 9 | 0120QTY Quantity C 1 | | 0130 ----- Segment group 3 ------------------ C 9----------+| 0140CCI Characteristic/class id M 1 || 0150CAV Characteristic value C 1----------+| | 0160 ----- Segment group 4 ------------------ C 99---------+| 0170RFF Reference M 1 || || 0180 ----- Segment group 5 ------------------ C 9---------+|| 0190MEA Measurements M 1 ||| 0200GPO Geographical position C 9999------++| | 0210 ----- Segment group 6 ------------------ C 99---------+| 0220IMD Item description M 1 || 0230QTY Quantity C 1 || 0240NAD Name and address C 1 || || 0250 ----- Segment group 7 ------------------ C 9---------+|| 0260RFF Reference M 1 ||| 0270DTM Date/time/period C 1---------++| | 0280 ----- Segment group 8 ------------------ C 9----------+| 0290HYN Hierarchy information M 1 || 0300PIA Additional product id C 9 || || 0310 ----- Segment group 9 ------------------ C 9---------+|| 0320CCI Characteristic/class id M 1 ||| 0330CAV Characteristic value C 1---------+|| || 0340 ----- Segment group 10 ------------------ C 9---------+|| 0350IMD Item description M 1 ||| 0360DTM Date/time/period C 1 ||| 0370QTY Quantity C 1 ||| 0380NAD Name and address C 1---------++| | 0390 ----- Segment group 11 ------------------ C 99---------+| 0400DOC Document/message details M 1 || 0410NAD Name and address C 1 || 0420DTM Date/time/period C 9----------+| | 0430 ----- Segment group 12 ------------------ C 999--------+| 0440EVE Event M 1 || 0450DTM Date/time/period C 9 || 0460IMD Item description C 9 || 0470NAD Name and address C 1 || 0480FTX Free text C 9 || || 0490 ----- Segment group 13 ------------------ C 1---------+|| 0500CCI Characteristic/class id M 1 ||| 0510CAV Characteristic value C 99--------+|| || 0520 ----- Segment group 14 ------------------ C 9---------+|| 0530MEA Measurements M 1 ||| 0540GPO Geographical position C 9999------+|| || 0550 ----- Segment group 15 ------------------ C 99--------+|| 0560IFD Information detail M 1 ||| 0570PIA Additional product id C 9 ||| 0580QTY Quantity C 9 ||| 0590NAD Name and address C 1 ||| ||| 0600 ----- Segment group 16 ------------------ C 99-------+||| 0610COD Component details M 1 |||| 0620MEA Measurements C 1--------+||| ||| 0630 ----- Segment group 17 ------------------ C 9--------+||| 0640CCI Characteristic/class id M 1 |||| 0650CAV Characteristic value C 1--------+||| ||| 0660 ----- Segment group 18 ------------------ C 999------+||| 0670RFF Reference M 1 |||| 0680QTY Quantity C 9 |||| 0690MEA Measurements C 1--------+||| ||| 0700 ----- Segment group 19 ------------------ C 99-------+||| 0710DOC Document/message details M 1 |||| 0720NAD Name and address C 1 |||| 0730DTM Date/time/period C 9--------++|| || 0740 ----- Segment group 20 ------------------ C 1---------+|| 0750HYN Hierarchy information M 1 ||| 0760NAD Name and address C 1 ||| 0770FTX Free text C 9 ||| ||| 0780 ----- Segment group 21 ------------------ C 9--------+||| 0790RFF Reference M 1 |||| 0800DTM Date/time/period C 1--------++++ 0810UNT Message trailer M 1