0. INTRODUCTION
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.
1. SCOPE
1.1 Functional Definition
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.
1.2 Field of Application
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.
1.3 Principles
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.
2. REFERENCES
See UNTDID, Part 4, Chapter 2.6 UN/ECE UNSM - General Introduction,
Section 1.
3. TERMS AND DEFINITIONS
See UNTDID, Part 4, Chapter 2.6 UN/ECE UNSM - General Introduction,
Section 2.
4. MESSAGE DEFINITION
4.1 Data Segment Clarification
This section should be read in conjunction with the Branching
Diagram and the Segment Table which indicate 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 Payment valuation message is
CONPVA.
Note: Payment valuation messages conforming to this document
must contain the following data in segment UNH, composite S009:
Data element 0065 CONPVA
0052 D
0054 95B
0051 UN
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: APR-DTM
A group of segments to convey the results of the computation
of the fluctuation formulas and the relevant dates/periods.
0350 APR, 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 APR.
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.
4.1.2 Detail section
Information to be provided in the Detail section:
0760 UNS, Section control
A service segment placed at the beginning of the detail section
to avoid 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: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.
0900 APR, Additional price information
A segment to indicate the date or period of application
of the factor quoted in APR.
0910 DTM, Date/time/period
A segment to indicate the date or period of application
of the factor quoted in APR.
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.
4.1.3 Summary section
Information to be provided in the Summary section:
1140 UNS, Section control
A service segment placed at the beginning of the summary
section to avoid 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.
4.2 Data segment index (Alphabetical sequence by tag)
ALC Allowance or charge
ALI Additional information
APR 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
Contents of D.95B