0. INTRODUCTION
1. SCOPE
   1. Functional definition
   2. Field of application
   3. Principles
2. REFERENCES
3. TERMS AND DEFINITIONS
4. MESSAGE DEFINITION
   1. Data segment clarification
      1. Header section
      2. Detail section
      3. Summary section
   2. Data segment index (alphabetical sequence)
   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.

This message type may be applied for both national and international trade. It is based on universal practice 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.6 UN/ECE UNSM - General Introduction, Section 1.

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

This section should be read in conjunction with the Branching Diagram and the Segment Table which indicate 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-PAT-SG9-SG10-SG18

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 PAT, Payment terms basis

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

0340 Segment Group 9: API-DTM

A group of segments to convey the results of the computation of the fluctuation formulas and the relevant dates/periods.

0350 API, Additional price information

A segment to indicate the price fluctuation computation.

0360 DTM, Date/time/period

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

0370 Segment Group 10: ARD-MOA-FTX-SG11-SG12

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.

0380 ARD, Amounts relationship details

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

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

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

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

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

0430 MOA, Monetary amount

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

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

0450 Segment Group 12: ALC-ALI-SG13-SG14-SG15-SG16-SG17

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 13-16 should be used accordingly.

0460 ALC, Allowance or charge

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

0470 ALI, Additional information

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

0480 Segment Group 13: 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.

0490 QTY, Quantity

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

0500 RNG, Range details

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

0510 Segment Group 14: 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.

0520 PCD, Percentage details

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

0530 RNG, Range details

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

0540 Segment Group 15: 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.

0550 MOA, Monetary amount

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

0560 RNG, Range details

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

0570 Segment Group 16: 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.

0580 RTE, Rate details

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

0590 RNG, Range details

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

0600 Segment Group 17: 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.

0610 TAX, Duty/tax/fee details

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

0620 MOA, Monetary amount

A segment specifying the amount for the allowance or charge.

0630 Segment Group 18: NAD-LOC-FII-SG19-SG20-SG21

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

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

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

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

0670 Segment Group 19: RFF-DTM

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

0680 RFF, Reference

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

0690 DTM, Date/time/period

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

0700 Segment Group 20: DOC-DTM

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

0710 DOC, Document/message details

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

0720 DTM, Date/time/period

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

0730 Segment Group 21: CTA-COM

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

0740 CTA, Contact information

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

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

0760 UNS, Section control

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

0770 Segment Group 22: BII-RCS-QTY-PRI-MOA-SG23-SG25-SG26-SG27

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

0780 BII, Structure identification

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

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

0800 QTY, Quantity

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

0810 PRI, Price details

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

0820 MOA, Monetary amount

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

0830 Segment Group 23: LIN-SG24

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.

0840 LIN, Line item

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

0850 Segment Group 24: IMD-RFF-GIS

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.

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

0870 RFF, Reference

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

0880 GIS, General indicator

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

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

0900 API, Additional price information

A segment to indicate the price fluctuation computation.

0910 DTM, Date/time/period

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

0920 Segment Group 26: 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.

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

0940 MOA, Monetary amount

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

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

0960 Segment Group 27: ALC-ALI-SG28-SG29-SG30-SG31-SG32

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.

0970 ALC, Allowance or charge

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

0980 ALI, Additional information

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

0990 Segment Group 28: 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.

1000 QTY, Quantity

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

1010 RNG, Range details

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

1020 Segment Group 29: 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.

1030 PCD, Percentage details

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

1040 RNG, Range details

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

1050 Segment Group 30: 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.

1060 MOA, Monetary amount

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

1070 RNG, Range details

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

1080 Segment Group 31: 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.

1090 RTE, Rate details

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

1100 RNG, Range details

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

1110 Segment Group 32: 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.

1120 TAX, Duty/tax/fee details

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

1130 MOA, Monetary amount

A segment specifying the amount for the allowance or charge.

Information to be provided in the Summary section:

1140 UNS, Section control

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

1150 Segment Group 33: TAX-MOA

A group of segments specifying taxes totals for the valuation.

1160 TAX, Duty/tax/fee details

A segment specifying the tax type to be summarized.

1170 MOA, Monetary amount

A segment specifying the amount for the tax specified.

1180 CNT, Control total

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

1190 UNT, Message trailer

A service segment ending a message, giving the total number of segments in the message and the control reference number of the message.

	ALC	Allowance or charge
	ALI	Additional information
	API	Additional price information
	ARD	Amounts relationship details
	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
	GIS	General indicator
	IMD	Item description
	IND	Index details
	LIN	Line item
	LOC	Place/location identification
	MOA	Monetary amount
	NAD	Name and address
	PAI	Payment instructions
	PAT	Payment terms basis
	PCD	Percentage details
	PRI	Price details
	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.