0. INTRODUCTION
1. SCOPE
   1. Functional definition
   2. Field of application
   3. Principles
2. REFERENCES
3. TERMS AND DEFINITIONS
   1. Standard terms and definitions
4. MESSAGE DEFINITION
   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

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

Typically this message will be used between a contractor and the client's representative, during the process of approving the value and payment for work completed for a given period of time.

The Payment 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.

This message is to be used to support the business process of communicating the value of progress against 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 value of work performed during 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.

Similar exchanges take place on the entire or part of the project and between other parties also involved in the construction of the project.

Within the Construction industry there are numerous rules which govern this part of the process. Although, efforts have been made to keep the design of the message generic, other potential users of this message are cautioned about the specific and original role for which this message has been designed.

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 have been defined at the start of the project. Work is well advanced for suitable EDI messages to address this part of the process.

Allowance has been made within CONPVA 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 inclusion of both a cumulative and a "this period" quantity.

In addition to conveying specific payment values this message is designed to record details of revisions and fluctuation to standard tables of rates and payment factors which are used in the calculation of the payment value.

Confirmation of values processed for direct payment by the client are also catered for. These relate to individual entries within a CONDPV message.

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

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

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

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 Payment valuation message is CONPVA.

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

0020 BGM, Beginning of message

A segment for unique identification of the Payment 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 whole message. e.g. contract identity, operational references, former valuation reference number.

0080 DTM, Date/time/period

Dates 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. Identification of the contractor and client parties is mandatory for the valuation message. It is recommended that where possible only the coded form of the party ID should be specified.

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.

0220 Segment Group 6: CUX-DTM

A group of segments specifying the currencies and related dates/periods valid for the whole valuation. Currency data may be omitted in national applications but will be required for international transactions.

0230 CUX, Currencies

A segment identifying the currencies required in the valuation e.g. the valuation currency. A rate of exchange may be given to convert a reference currency into a target currency.

0240 DTM, Date/time/period

A segment specifying the date/time/period related to the rate of exchange.

0250 Segment Group 7: IND-RFF-DTM

A group of segments to convey the new fluctuation indices values.

0260 IND, Index details

A segment to provide a new value of the quoted index.

0270 RFF, Reference

A segment to indicate the reference of the index.

0280 DTM, Date/time/period

A segment to convey the new date of value of the quoted index.

0290 Segment Group 8: BII-RCS-PAI-PYT-PCD-SG9-SG10-SG19

A group of segments to indicate: - the financial total amounts of the valuation or parts of it - conditions of payments - conditions of allowances and charges, bonuses and penalties - the total amounts to be paid directly to subcontractors (request or confirmation).

0300 BII, Structure identification

A segment to identify the group of items to which the valuation amounts stated in the group of segments apply. The identification of the groups of items referred to here has already been conveyed through another appropriate EDI message.

0310 RCS, Requirements and conditions

A segment to provide requirements that are applicable to the whole group of items referred to in BII.

0320 PAI, Payment instructions

A segment indicating conditions of payment, guarantee and method of payment for the whole group of items referred to in BII.

0330 + PYT, Payment terms

A segment indicating the payment terms, date/time basis, and additional terms valid for the whole group of items referred to in BII.

0340 PCD, Percentage details

A segment used to provide percentages at contract or sub-contract level.

0350 Segment Group 9: APR-DTM

A group of segments to convey the results of the computation of the fluctuation formulas and the relevant dates/periods. This group is used to provide only price variation resulting from the computation of the fluctuation price formula, excluding any amount.

0360 APR, Additional price information

A segment to indicate the price fluctuation computation.

0370 DTM, Date/time/period

A segment to indicate the date or period of application of the factor quoted in APR.

0380 Segment Group 10: ARD-MOA-FTX-SG11-SG12-SG13

A group of segments to convey the financial amounts related to the group of items referred to in BII and their relevant taxes and if necessary the details of their computation.

0390 ARD, Monetary amount function

A segment to convey a financial status of the following information.

0400 MOA, Monetary amount

A segment to convey monetary amounts related to the group of items referred to in BII and to the financial nature quoted in ARD.

0410 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.

0420 Segment Group 11: TAX-MOA-LOC

A group of segments specifying tax related information, and when necessary, the location(s) to which that tax information relates.

0430 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.

0440 MOA, Monetary amount

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

0450 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.

0460 Segment Group 12: APR-RFF-DTM-MOA-TAX

A group of segments used to provide amounts breakdown related to price variation rate. It provides all information needed to compute these amounts.

0470 APR, Additional price information

A segment used to provide the price variation rate which is used as a basis for calculation of the following amounts.

0480 RFF, Reference

A segment used to provide references used as a basis for calculation of the following amounts.

0490 DTM, Date/time/period

A segment to provide dates used for the calculation of the price variation rate.

0500 MOA, Monetary amount

A segment used to provide the amount to be paid and all amounts used in the calculation of this amount.

0510 TAX, Duty/tax/fee details

A segment used to provide tax related information.

0520 Segment Group 13: ALC-ALI-RFF-DTM-FTX-SG14-SG15-SG16-

SG17-SG18 A group of segments specifying allowances and charges for the group of items referred to in BII. The allowance or charge specified within this Segment group may either relate to the group of items referred to in BII in which case it cannot be overridden at item level, or it can relate to the line items as a default allowance/charge and can be overridden by the ALC Segment group within the item section. Where relevant, additional information, tax and alternate currency details are to be indicated in the TAX and MOA segments. The basis for the calculation of the allowance/charge may be a quantity, a percentage, an amount or a rate and one of the Segment group 14-17 should be used accordingly.

0530 ALC, Allowance or charge

A segment identifying the charge or allowance and, where necessary its calculation sequence.

0540 ALI, Additional information

A segment indicating that allowance or charge specified is subject to special conditions owing to origin, customs preference or commercial factors.

0550 RFF, Reference

To reference rules applied when setting the bonus or penalty. This may apply to price variation calculation formula itself described in price fluctuations above.

0560 DTM, Date/time/period

To provide dates used in setting bonus and penalty.

0570 FTX, Free text

To provide free text information used in setting bonus and penalty. It may be used to provide the nature of the bonus or penalty or to provide complex calculation rules.

0580 Segment Group 14: QTY-RNG

A group of segments specifying the quantity of the allowance or charge with its measure unit specifier. A range to which the allowance or charge applies may be specified. e.g. An allowance of a free quantity of 20 pieces may be specified if the quantity ordered is greater than 1000 pieces.

0590 QTY, Quantity

A segment identifying the type of quantity and the quantity related to the allowance or charge.

0600 RNG, Range details

A segment specifying, if required, the range to which the allowance or charge applies.

0610 Segment Group 15: PCD-RNG

A group of segments specifying the percentage for the allowance or charge, e.g. The allowance/charge amount is calculated as 5% of the goods value or a price reduction of 5% may be specified if the goods quantity ordered is within the range 5 tons to 10 tons.

0620 PCD, Percentage details

A segment identifying the percentage and the percentage basis for the calculation of the allowance or charge.

0630 RNG, Range details

A segment specifying, if required, a range for the application of the percentage.

0640 Segment Group 16: MOA-RNG

A group of segments specifying a monetary amount for an allowance or charge. A range to which the allowance or charge applies can be specified.

0650 MOA, Monetary amount

A segment identifying the monetary amount for the allowance or charge.

0660 RNG, Range details

A segment specifying, if required, a range for the application of the allowance/charge amount.

0670 Segment Group 17: RTE-RNG

A group of segments specifying the rate per unit and basis to which the allowance or charge applies, e.g. The allowance/charge amount is 3 DEM per 10 tons.

0680 RTE, Rate details

A segment specifying the rate per unit and the basis for calculation.

0690 RNG, Range details

A segment specifying, if required, the range for the application of the allowance/charge rate.

0700 Segment Group 18: TAX-MOA

A group of segments specifying tax related information for the allowance or charge and, when necessary, the location(s) to which that tax information relates.

0710 TAX, Duty/tax/fee details

A segment specifying the tax type, category, and rate, or exemption, related to the allowance or charge.

0720 MOA, Monetary amount

A segment specifying the amount for the allowance or charge.

0730 Segment Group 19: NAD-LOC-FII-MOA-SG20-SG21-SG22

A group of segments identifying the parties with associated information for the group of items referred to in BII.

0740 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. Identification of the contractor and client parties is mandatory for the valuation message. 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.

0750 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.

0760 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.

0770 MOA, Monetary amount

To provide amounts to be paid to each beneficiary, especially sub-contractors.

0780 Segment Group 20: RFF-DTM

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

0790 RFF, Reference

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

0800 DTM, Date/time/period

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

0810 Segment Group 21: DOC-DTM

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

0820 DOC, Document/message details

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

0830 DTM, Date/time/period

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

0840 Segment Group 22: CTA-COM

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

0850 CTA, Contact information

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

0860 COM, Communication contact

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

Information to be provided in the Detail section:

0870 UNS, Section control

A service segment placed at the beginning of the detail section to avoid collision.

0880 Segment Group 23: BII-RCS-QTY-PRI-MOA-SG24-SG26-SG27-SG28

A group of segments providing the quantities and the corresponding prices of the works performed for each item, or group of items.

0890 BII, Structure identification

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

0900 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.

0910 QTY, Quantity

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

0920 PRI, Price details

A segment used to indicate the unit price of the items.

0930 MOA, Monetary amount

A segment used to indicate monetary amount which are the computation of the unit price and quantities quoted in QTY.

0940 Segment Group 24: LIN-SG25

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.

0950 LIN, Line item

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

0960 Segment Group 25: 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.

0970 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.

0980 RFF, Reference

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

0990 + 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.

1000 Segment Group 26: APR-DTM

A group of segments to convey the results of the computation of the fluctuation formulas and the relevant dates/periods for this item when it is different from the group to which this item belongs.

1010 APR, Additional price information

A segment to indicate the date or period of application of the factor quoted in APR.

1020 DTM, Date/time/period

A segment to indicate the date or period of application of the factor quoted in APR.

1030 Segment Group 27: 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.

1040 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.

1050 MOA, Monetary amount

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

1060 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.

1070 Segment Group 28: ALC-ALI-SG29-SG30-SG31-SG32-SG33

A group of segments specifying allowances and charges for the item referred to in BII where this is different to or not specified within the group of items to which it belongs.

1080 ALC, Allowance or charge

A segment identifying the charge or allowance and, where necessary its calculation sequence.

1090 ALI, Additional information

A segment indicating that allowance or charge specified is subject to special conditions owing to origin, customs preference or commercial factors.

1100 Segment Group 29: QTY-RNG

A group of segments specifying the quantity of the allowance or charge with its measure unit specifier. A range to which the allowance or charge applies may be specified. e.g. An allowance of a free quantity of 20 pieces may be specified if the quantity ordered is greater than 1000 pieces.

1110 QTY, Quantity

A segment identifying the type of quantity and the quantity related to the allowance or charge.

1120 RNG, Range details

A segment specifying, if required, the range to which the allowance or charge applies.

1130 Segment Group 30: PCD-RNG

A group of segments specifying the percentage for the allowance or charge, e.g. The allowance/charge amount is calculated as 5% of the goods value or a price reduction of 5% may be specified if the goods quantity ordered is within the range 5 tons to 10 tons.

1140 PCD, Percentage details

A segment identifying the percentage and the percentage basis for the calculation of the allowance or charge.

1150 RNG, Range details

A segment specifying, if required, a range for the application of the percentage.

1160 Segment Group 31: MOA-RNG

A group of segments specifying a monetary amount for an allowance or charge. A range to which the allowance or charge applies can be specified.

1170 MOA, Monetary amount

A segment identifying the monetary amount for the allowance or charge.

1180 RNG, Range details

A segment specifying, if required, a range for the application of the allowance/charge amount.

1190 Segment Group 32: RTE-RNG

A group of segments specifying the rate per unit and basis to which the allowance or charge applies, e.g. The allowance/charge amount is 3 DEM per 10 tons.

1200 RTE, Rate details

A segment specifying the rate per unit and the basis for calculation.

1210 RNG, Range details

A segment specifying, if required, the range for the application of the allowance/charge rate.

1220 Segment Group 33: TAX-MOA

A group of segments specifying tax related information for the allowance or charge and, when necessary, the location(s) to which that tax information relates.

1230 TAX, Duty/tax/fee details

A segment specifying the tax type, category, and rate, or exemption, related to the allowance or charge.

1240 MOA, Monetary amount

A segment specifying the amount for the allowance or charge.

Information to be provided in the Summary section:

1250 UNS, Section control

A service segment placed at the beginning of the summary section to avoid collision.

1260 Segment Group 34: TAX-MOA

A group of segments specifying taxes totals for the valuation.

1270 TAX, Duty/tax/fee details

A segment specifying the tax type to be summarized.

1280 MOA, Monetary amount

A segment specifying the amount for the tax specified.

1290 CNT, Control total

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

1300 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.

	ALC	Allowance or charge
	ALI	Additional information
	APR	Additional price information
	ARD	Monetary amount function
	AUT	Authentication result
	BGM	Beginning of message
	BII	Structure identification
	CNT	Control total
	COM	Communication contact
	CTA	Contact information
	CUX	Currencies
	DOC	Document/message details
	DTM	Date/time/period
	FII	Financial institution information
	FTX	Free text
	GEI	Processing information
	IMD	Item description
	IND	Index details
	LIN	Line item
	LOC	Place/location identification
	MOA	Monetary amount
	NAD	Name and address
	PAI	Payment instructions
	PCD	Percentage details
	PRI	Price details
	PYT	Payment terms
	QTY	Quantity
	RCS	Requirements and conditions
	RFF	Reference
	RNG	Range details
	RTE	Rate details
	TAX	Duty/tax/fee details
	UNH	Message header
	UNS	Section control
	UNT	Message trailer

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.