Frames | No Frames

Return to Stylus Studio EDIFACT home page.
Return to Stylus Studio EDIFACT D02B Messages page.

Quantity valuation message

Contr. Agency:UN
SOURCE:D7 Architecture, Engineering and Construction (SWG)

Quantity valuation message
  2. SCOPE
    1. Functional definition
    2. Field of application
    3. Principles
    1. Standard terms and definitions
    1. Segment clarification
      1. Header section
      2. Detail section
      3. Summary section
    2. Segment index (alphabetical sequence by tag)
    3. Message structure
      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

This message also occurs in the following versions of this standard:
D93A, D94A, D94B, D95A, D95B, D96A, D96B, D97A, D97B, D98A, D98B, D99A, D99B, D00A, D00B, D01A, D01B, D01C, D02A, D02B, D03A, D03B, D04A, D04B


This specification provides the definition of the Quantity valuation message (CONQVA) to be used in Electronic Data Interchange (EDI) between trading partners involved in administration, commerce and transport.


1.1. Functional definition

Typically, this message will be used for a contractor to submit progress details to a client or his representative. The message will be used also for subsets of the project where work has been contracted out to other parties. In these cases the exchange would be between the subcontractor and the party that subcontracted the work.

1.2. Field of application

The Quantity valuation message 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.

The following descriptions refer to the construction industry as an example, but do not exclude other business sectors' implementation.

1.3. Principles

This message is to be used to support the business of exchanging progress information for groups of work items which make up a construction project.

There are several examples within the construction process where one party is required to advise another party about the quantity of work performed for a specific time period or since the start of the project.

A project may be subdivided into individual groupings of work referred to as items and it is against these items that progress quantities are reported.

During the design of this message every effort has been made to adopt a "generic" approach and it seems possible that other industries may find this a suitable message to adopt.

This is only one of a number of messages being designed for the Construction industry. This particular message refers to already established items of work, these items will be defined at the start of a project. Work is well advanced on suitable EDI messages to address this part of the process.

Allowance has been made within the CONQVA message for "new" items of work. There are a number of reasons why additional items of work will occur once a project has started.

Each work item may contain more than one quantity and this has been accommodated. An example of this would be the quoting of both a cumulative and a "this period" quantity.


See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 1.


3.1. Standard terms and definitions

See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 2.


4.1. Segment clarification

This section should be read in conjunction with the segment table which indicates mandatory, conditional and repeating requirements.

4.1.1. Header section

Information to be provided in the Header section:

0010 UNH, Message header

A service segment starting and uniquely identifying a message. The message type code for the Quantity valuation message is CONQVA.

Note: Quantity valuation messages conforming to this document must contain the following data in segment UNH, composite S009:

Data element0065CONQVA

0020 BGM, Beginning of message

A segment for unique identification of the Quantity valuation document name, number and function.

0030 DTM, Date/time/period

A segment specifying the dates that apply, e.g. date of valuation, date of submission, acceptance date, etc.

0040 AUT, Authentication result

A segment used to authenticate the message by exchanging a password or some other form of identification agreed between the trading partners.

0050 FTX, Free text

A segment with free text information, in coded or clear form, used for any textual qualification. In computer to computer exchanges, such text will require the receiver to process this segment manually.

0060 Segment Group 1: RFF-DTM

A group of segments for quoting references and their relevant dates that are applicable to the message.

0070 RFF, Reference

A segment for quoting references that are applicable to this message, e.g. contract identity, operational references, former valuation reference number.

0080 DTM, Date/time/period

Date of references quoted in the previous RFF segment.

0090 Segment Group 2: NAD-LOC-FII-SG3-SG4-SG5

A group of segments identifying the parties with associated information.

0100 NAD, Name and address

A segment identifying names and addresses of the parties, in coded or clear form, and their functions relevant to the valuation. It is recommended that where possible only the coded form of the party ID should be specified. e.g. The contractor and client are known to each other, thus only the coded ID is required, but the subcontractors addresses may vary and would have to be clearly specified, preferably in structured format.

0110 LOC, Place/location identification

A segment giving more specific location information of the party specified in the NAD segment e.g. internal site/building number.

0120 FII, Financial institution information

A segment identifying the financial institution (e.g. bank) and relevant account numbers for the contractor, client and where necessary other parties.

0130 Segment Group 3: RFF-DTM

A group of segments for giving references only relevant to the specified party rather than the whole valuation.

0140 RFF, Reference

A segment identifying the reference by its number and where appropriate a line number within a document.

0150 DTM, Date/time/period

A segment specifying the date and/or time related to the reference.

0160 Segment Group 4: DOC-DTM

A group of segments identifying the documentary requirements of the specified party.

0170 DOC, Document/message details

A segment identifying and providing information relating to the documents required by the party specified by the NAD.

0180 DTM, Date/time/period

A segment specifying the date and/or time of the document.

0190 Segment Group 5: CTA-COM

A group of segments giving contact details of the specific person or department within the party identified in the NAD segment.

0200 CTA, Contact information

A segment to identify a person or department, and their function, to whom communications should be directed.

0210 COM, Communication contact

A segment to identify a communications type and number for the contact specified in the CTA segment.

4.1.2. Detail section

Information to be provided in the Detail section:

0220 Segment group 6: BII-RCS-QTY-PRI-SG7-SG9 A group of segments providing the quantities and the corresponding prices of the works performed for each item, or group of items.

0230 BII, Structure identification

A segment to identify the item of work (or group of items) to which the quantities apply.

0240 RCS, Requirements and conditions

A segment to provide requirements that are applicable to the whole group of segments: financial status (when an item is added to the BOQ, dayworks for example), and an action request.

0250 QTY, Quantity

A segment giving the quantity of works performed, in cumulative, last period cumulative, quantity of the period, and other forms as required.

0260 PRI, Price details

A segment used to indicate the unit price of the items. This segment is to be used in conjunction with SG7 and SG9 when an item is created in the quantity valuation, e.g. dayworks.

0270 Segment Group 7: LIN-SG8

A group of segments to record descriptive text for items that are added into existing groups during the completion of the works, e.g. dayworks.

0280 LIN, Line item

A segment to record a qualifier specifying that we are at item level.

0290 Segment Group 8: IMD-RFF-GEI

A group of segments to record the description line details together with text reference numbers and change action codes used to identify who is authorised to apply changes.

0300 IMD, Item description

This segment is used to convey any descriptive material to be recorded for the item. This descriptive material can apply to the item description and item heading information.

0310 RFF, Reference

A segment used to record up to two text reference numbers per item description line.

0320 + GEI, Processing information

A segment used to record up to two text change action codes per item description line. In this context suppression is not allowed.

0330 Segment Group 9: TAX-MOA-LOC

A group of segments specifying tax related information for this item when it is specific to this item or different from the group to which it belongs, and when necessary, the location(s) to which that tax information relates. This group is to be used only when the item is created in the quantity valuation, e.g. dayworks and the relevant tax is different to the one described to group referred to in BII.

0340 TAX, Duty/tax/fee details

A segment specifying a tax type, category and rate, or exemption, relating to the group of items referred to in BII, e.g. Value Added Tax at the standard rate is applicable for all items.

0350 MOA, Monetary amount

A segment specifying the amount for the identified tax/fee.

0360 LOC, Place/location identification

A segment indicating the location to which the tax or exemption specified in the TAX segment applies, e.g. city or state or country tax.

4.1.3. Summary section

Information to be provided in the Summary section:

0370 CNT, Control total

A segment by which control totals may be provided by the sender for checking by the receiver.

0380 UNT, 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)

AUT Authentication result
BGM Beginning of message
BII Structure identification
CNT Control total
COM Communication contact
CTA Contact information
DOC Document/message details
DTM Date/time/period
FII Financial institution information
FTX Free text
GEI Processing information
IMD Item description
LIN Line item
LOC Place/location identification
MOA Monetary amount
NAD Name and address
PRI Price details
QTY Quantity
RCS Requirements and conditions
RFF Reference
TAX Duty/tax/fee details
UNH Message header
UNT Message trailer

4.3. Message structure

4.3.1. Segment table

├─UNH Message header ×1 (M)
├─BGM Beginning of message ×1 (M)
├─DTM Date/time/period ×9 (M)
├─AUT Authentication result ×2 (C)
├─FTX Free text ×5 (C)
├─Segment Group 1 ×9 (C)
├─RFF Reference ×1 (M)
└─DTM Date/time/period ×5 (C)
├─Segment Group 2 ×9 (M)
├─NAD Name and address ×1 (M)
├─LOC Place/location identification ×25 (C)
├─FII Financial institution information ×5 (C)
├─Segment Group 3 ×10 (C)
├─RFF Reference ×1 (M)
└─DTM Date/time/period ×5 (C)
├─Segment Group 4 ×5 (C)
├─DOC Document/message details ×1 (M)
└─DTM Date/time/period ×5 (C)
└─Segment Group 5 ×5 (C)
──├─CTA Contact information ×1 (M)
──└─COM Communication contact ×5 (C)
├─Segment Group 6 ×10000 (C)
├─BII Structure identification ×1 (M)
├─RCS Requirements and conditions ×1 (C)
├─QTY Quantity ×6 (M)
├─PRI Price details ×1 (C)
├─Segment Group 7 ×100 (M)
├─LIN Line item ×1 (M)
└─Segment Group 8 ×1000 (C)
──├─IMD Item description ×1 (M)
──├─RFF Reference ×5 (C)
──└─GEI Processing information ×5 (C)
└─Segment Group 9 ×5 (C)
──├─TAX Duty/tax/fee details ×1 (M)
──├─MOA Monetary amount ×1 (C)
──└─LOC Place/location identification ×5 (C)
├─CNT Control total ×5 (C)
└─UNT Message trailer ×1 (M)

Change indicators
plus sign An addition.
asterisk Addition/substraction/change to a code entry for a particular data element.
hash or pound sign Changes to names.
vertical bar Changes to text for descriptions, notes and functions.
minus sign A deletion.
letter X Marked for deletion.

Return to Stylus Studio EDIFACT D02B Messages page.
EDI to XML Mapping for EDIFACT/X12 Convert EDIFACT/X12 Schemas to XML Schema Legacy Data Conversion Tools Access Relational Data as XML Visual XSLT and XQuery Mapping Tools EDIFACT to XML
Return to Stylus Studio EDIFACT home page.

Return to Stylus Studio home page.
Site Map | Privacy Policy | Terms of Use | Trademarks
Stylus Scoop XML Newsletter:
W3C Member
Stylus Studio® and DataDirect XQuery ™are from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2016 All Rights Reserved.